本文へ移動
cccskills
無料GitHub で公開

data-cloud-segmentation

Create, filter, refresh, and activate audience segments in Salesforce Data Cloud: segment types (Standard, Real-Time, Waterfall, Dynamic, Data Kit), segment refresh schedules, activation field mapping, audience publishing. NOT for the SQL metrics a segment filters on - use admin/data-cloud-calculated-insights. NOT for ingestion, DLO to DMO mapping and identity resolution - use data/data-cloud-data-streams.

インストール方法を見る

含まれるファイル(7)

  • SKILL.md14.5 KB
  • references/examples.md5.3 KB
  • references/gotchas.md5.7 KB
  • references/llm-anti-patterns.md7.4 KB
  • references/well-architected.md4.9 KB
  • scripts/check_data_cloud_segmentation.py11.1 KB
  • templates/data-cloud-segmentation-template.md3.1 KB

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

Data Cloud Segmentation

This skill activates when a practitioner needs to create, configure, publish, or troubleshoot audience segments in Salesforce Data Cloud. It covers the full segment lifecycle: building filter logic against Unified Profiles, choosing the right segment type and refresh schedule, mapping attributes to activation targets, and diagnosing why contacts are missing from downstream systems.


Before Starting

Gather this context before working on anything in this domain:

  • Confirm Data Cloud is provisioned and at least one data stream is ingested and identity-resolved. Segments without a populated Unified Individual DMO return empty populations.
  • Know the org's current Rapid Publish segment count. The hard org-wide limit is 20 Rapid Publish segments. Exceeding it silently prevents creation of new Rapid Publish segments without surfacing an obvious error.
  • Identify whether the target activation system (Salesforce CRM, Marketing Cloud Engagement, cloud storage) is already configured as an activation target in Data Cloud setup. Activation cannot proceed without a named target.
  • Clarify the segment's population size expectation. Segments with populations over 10 million Unified Profiles cannot use related attributes in activations.

Core Concepts

Segment Types

Data Cloud supports five segment types, each with different use cases and constraints:

TypeDescriptionKey Constraint
StandardFilter-based segment refreshed on a scheduleDefault; 12–24 hour refresh cycle
Real-TimeEvaluated near-continuously for use in real-time personalizationRequires real-time data stream; higher processing cost
WaterfallMutually exclusive priority-ordered bucketsContacts can appear in only one bucket
DynamicSegment membership driven by changes to a related data objectUseful for event-triggered audiences
Data KitSegments packaged and distributed via Data KitsCross-org distribution pattern

The org-wide hard limit is 9,950 total segments across all types.

Segment Refresh Schedules

Segment refresh and activation delivery are independently configured. Refreshing a segment more frequently does not accelerate when activation data lands in the destination system.

Three refresh options exist:

  • Standard refresh — runs every 12–24 hours; evaluates the full data history for the segment's date range.
  • Rapid Publish — runs every 1–4 hours but only considers the last 7 days of data. Hard org limit: 20 Rapid Publish segments total. Segments requiring history older than 7 days will silently under-count members if Rapid Publish is selected.
  • Incremental refresh — evaluates only records that changed since the last run; reduces compute but requires a change-detection-compatible data model.

Activation and Field Mapping

An activation connects a segment to a named activation target and specifies which attributes to publish alongside the segment membership record. Limits:

  • Maximum 20 related attributes per activation (attributes pulled from objects related to the Unified Individual, not direct profile attributes).
  • Maximum 100 activations with related attributes per org.
  • Segments with 10M+ population cannot include any related attributes; only core identity fields are supported.

Activation has its own refresh schedule that is separate from the segment refresh. A segment that refreshes every 2 hours on Rapid Publish may still deliver to a Marketing Cloud activation only once per day if the activation is configured for daily refresh.

Null Email Addresses and Contact Completeness

Data Cloud activates segment members regardless of whether the contact has an email address unless the segment filter explicitly excludes null email. This is a platform default that frequently causes unexpected deliverability failures in downstream systems. Always add an explicit filter: Email IS NOT NULL (or the equivalent on the activation target's required identity field) when the downstream system requires a valid contact identifier.


Common Patterns

Pattern: Standard Segment with CRM Activation

When to use: Sending a daily audience of qualified leads or contacts from Data Cloud back to a Salesforce CRM campaign or list for Sales Cloud follow-up.

How it works:

  1. In Data Cloud, navigate to Segments and create a new Standard segment.
  2. Define filter criteria on the Unified Individual DMO (e.g., LifetimeValue > 500, LastPurchaseDate within 90 days, Email IS NOT NULL).
  3. Set refresh schedule to Standard (every 12 hours is sufficient for CRM use cases).
  4. Navigate to Activations, create a new activation pointing to the Salesforce CRM activation target.
  5. Map the segment to the target CRM object (Contact or Lead), map required fields (Email, FirstName, LastName), and optionally add up to 20 related attributes.
  6. Set the activation publish schedule (independent of segment refresh).
  7. Publish manually to validate the first run, then confirm records appear in the CRM target list.

Why not a simpler approach: Reports and list views in CRM cannot pull cross-cloud data or apply Data Cloud identity resolution. Only activation delivers a refreshed, deduplicated list.

Pattern: Rapid Publish Segment for Real-Time Personalization

When to use: Feeding a segment into a personalization engine (e.g., Marketing Cloud Personalization or a connected CDP activation) where audience membership needs to reflect behavior from the last few hours.

How it works:

  1. Verify the org has fewer than 20 existing Rapid Publish segments before creating a new one.
  2. Create a segment with filter criteria scoped to attributes that change within a 7-day window (e.g., CartAbandonedDate within 2 days, Email IS NOT NULL).
  3. Set refresh to Rapid Publish (1–4 hour cadence).
  4. Do not use Rapid Publish for segments that require historical lookback longer than 7 days — lifetime spend, multi-year engagement — because older data is excluded from the evaluation window.
  5. Create the activation with a matching high-frequency publish schedule.

Why not Standard: Standard refresh runs every 12–24 hours; for cart abandonment or browse behavior, that lag misses the engagement window.


Decision Guidance

SituationRecommended ApproachReason
Daily campaign audience for CRM outreachStandard segment + Standard activationNo need for sub-24h freshness; avoids Rapid Publish quota
Cart abandonment or time-sensitive behavior in last 48hRapid Publish segmentRefreshes every 1–4 hours; fits 7-day lookback window
Need 30-day or longer historical lookbackStandard segmentRapid Publish only looks back 7 days
Org already has 20 Rapid Publish segmentsStandard segment with shortest allowed scheduleCannot exceed 20 Rapid Publish cap
Segment population > 10 million profilesStandard segment, no related attributes on activationRelated attributes not supported above 10M
Mutually exclusive VIP / Standard / Lapsed tiersWaterfall segmentEnsures each profile lands in exactly one bucket
Contacts missing from activation with no errorAdd Email IS NOT NULL filter, check activation refresh scheduleNull emails pass through; activation has its own schedule

Recommended Workflow

Step-by-step instructions for an AI agent or practitioner working on this task:

  1. Confirm prerequisites — Verify Data Cloud is provisioned, at least one data stream is ingested and identity-resolved, and an activation target is configured. Check the org's current Rapid Publish segment count if planning a high-frequency segment.
  2. Define segment type and filter logic — Choose the segment type (Standard, Real-Time, Waterfall, Dynamic, Data Kit) based on the audience use case. Build filter criteria against the Unified Individual DMO. Add an explicit Email IS NOT NULL filter (or equivalent required identity field) unless the downstream system can handle null identifiers.
  3. Select refresh schedule — Choose Standard (12–24h) for most use cases. Use Rapid Publish only if the use case requires sub-4-hour freshness AND the data lookback fits within 7 days AND the org has fewer than 20 existing Rapid Publish segments. Use Incremental for large data volumes where change detection is feasible.
  4. Create and configure the activation — Navigate to Activations, select the segment and activation target, map required identity fields, and add up to 20 related attributes. Set the activation's own publish schedule independently of the segment refresh.
  5. Publish and validate — Trigger a manual publish on the first run. Confirm member count in the segment preview matches expectations. Confirm records appear in the activation target within the expected delivery window.
  6. Monitor for limit violations — After publishing, verify segment population count, check activation delivery logs, and confirm Rapid Publish quota is not exceeded at the org level.

Review Checklist

Run through these before marking work in this area complete:

  • Segment filter includes explicit null exclusion on required identity field (Email IS NOT NULL or equivalent)
  • Segment type is appropriate for the use case (Standard for daily; Rapid Publish only for <7-day lookback and org count <20)
  • Activation refresh schedule is explicitly configured and matches the delivery SLA (not assumed to inherit segment schedule)
  • Related attribute count per activation does not exceed 20
  • Segment population is below 10M if related attributes are mapped in the activation
  • Org-wide Rapid Publish count verified before selecting Rapid Publish refresh
  • Org-wide segment count checked against the 9,950 limit for large deployments

Salesforce-Specific Gotchas

Non-obvious platform behaviors that cause real production problems:

  1. Rapid Publish silently under-counts when data is older than 7 days — Rapid Publish evaluates only the last 7 days of data regardless of how the segment filter is written. A filter for LastPurchaseDate within 30 days will appear to work but will only evaluate events from the past 7 days, silently missing contacts whose last purchase was 8–30 days ago.
  2. Segment refresh schedule and activation publish schedule are independent — Increasing segment refresh frequency does not change how often the activation delivers data to the downstream system. Both must be configured separately. A Rapid Publish segment paired with a daily activation schedule delivers no faster than once per day.
  3. Null email addresses are activated by default — Data Cloud includes contacts with null email in segment membership. Unless a filter explicitly excludes nulls, the activation will attempt to send contacts with no email to the downstream system, causing silent failures or malformed records in Marketing Cloud or CRM.
  4. 9,950 segment limit is org-wide and hard — There is no UI warning as the org approaches the limit. At exactly 9,950 segments, creation fails with a generic error. Large orgs with automated segment generation must track count proactively.
  5. Related attribute cap blocks activation setup for large segments — The 20 related attribute limit per activation and 100 total activations-with-related-attributes limit per org are enforced at save time. For segments over 10M profiles, the activation form will not allow related attribute selection at all.

Output Artifacts

ArtifactDescription
Published segmentA named Data Cloud segment with filter criteria, population count, and refresh schedule
Activation configurationMapping of segment to activation target with field mappings and publish schedule
Segment filter specificationDocumented filter logic including null exclusions and date range constraints
Refresh strategy decision recordRationale for Standard vs. Rapid Publish vs. Incremental choice

Related Skills

  • admin/data-cloud-identity-resolution — identity resolution must be completed before segment population reflects unified profiles; run this skill first
  • admin/data-cloud-provisioning — org must be provisioned with Data Cloud before segments can be created
  • admin/data-cloud-calculated-insights — calculated insights can be used as filter attributes in segments; use when segment criteria require aggregated metrics
  • admin/data-cloud-activation-development — for custom activation targets beyond Salesforce CRM, Marketing Cloud, and native connectors

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

Use this skill when writing test-first, behavior-driven acceptance criteria in Given/When/Then format for a Salesforce user story. Covers happy path, edge cases, negative paths, permission boundaries, and data-state preconditions so the AC block can drive UAT scripts and Apex test design downstream. Trigger keywords: given when then, gherkin, behavior driven AC, test first acceptance criteria, scenario outline, BDD acceptance criteria. NOT for the user-story format itself (use admin/user-story-writing-for-salesforce). NOT for UAT script writing (use admin/uat-test-case-design). NOT for Apex test method generation (use agents/test-class-generator). NOT for high-level UAT planning (use admin/uat-and-acceptance-criteria). More triggers: acceptance criteria record, ac_id, req_id on a criterion, artefact under test, negative case for a rule-type requirement, no-match fall-through criterion, oracle for a Then clause, test type apex flow manual, criteria linter, check_ac_format.py, --manifest-dir.

日本語の概要は準備中です。原文の説明を表示しています。

PranavNagrecha/AwesomeSalesforceSkills192026年10月4日 更新

Task and Event objects: polymorphic WhatId/WhoId, Activity object model, ActivityHistory vs OpenActivity, activity timeline customization, bulk task creation, Einstein Activity Capture boundaries. NOT for turning on EAC or calendar sync — use admin/einstein-activity-capture-setup. NOT for Email-to-Case — use admin/case-management-setup. Covers ActivitiesSettings metadata, enableActivities, shared Task/Event custom fields and FLS, TaskStatus value sets, Shared Activities and TaskRelation/EventRelation, recurring and child activities, and partial-success bulk DML on Task.

日本語の概要は準備中です。原文の説明を表示しています。

PranavNagrecha/AwesomeSalesforceSkills192026年10月4日 更新

Design Invocable Apex actions that return deterministic, agent-friendly errors instead of surfacing raw exceptions to the LLM. NOT for authoring the action itself — @InvocableMethod schema, labels, security context — use agentforce/custom-agent-actions-apex. NOT for the Apex tests that force each error branch — use agentforce/agent-action-unit-tests.

日本語の概要は準備中です。原文の説明を表示しています。

PranavNagrecha/AwesomeSalesforceSkills192026年10月4日 更新

Use when designing how an Agentforce agent extracts structured input parameters (slots) from a user's natural-language utterance to invoke an action. Triggers: 'agent extract date from user', 'agent action argument extraction', 'agentforce slot filling', 'agent invocable input mapping', 'agent fails to fill required parameter'. NOT for action authoring (use agentforce/agent-actions) or for prompt-template variable binding (use agentforce/prompt-builder-templates).

日本語の概要は準備中です。原文の説明を表示しています。

PranavNagrecha/AwesomeSalesforceSkills192026年10月4日 更新

Apex test patterns for @InvocableMethod agent actions: per-reason-code branch coverage, bulk safety, callout mocking, deterministic assertions. NOT for testing whether the agent routes to the right topic or answers well — use agentforce/agent-testing-and-evaluation. NOT for designing the error envelope the tests assert on — use agentforce/agent-action-error-handling.

日本語の概要は準備中です。原文の説明を表示しています。

PranavNagrecha/AwesomeSalesforceSkills192026年10月4日 更新

Designing or reviewing Agentforce actions: Flow actions, Apex invocable actions, prompt-template actions, action naming, input and output contracts, confirmation requirements, and safe error behavior. Triggers: 'agent actions', 'build an agent that can look up an order', 'make the agent able to check order status', 'give the agent a capability', 'agent that can retrieve a record', 'flow action for agent', 'agent invocable action', 'action schema design'. NOT for writing the Apex class itself — use agentforce/custom-agent-actions-apex. NOT for the reason_code error envelope that stops an agent retry loop — use agentforce/agent-action-error-handling.

日本語の概要は準備中です。原文の説明を表示しています。

PranavNagrecha/AwesomeSalesforceSkills192026年10月4日 更新

PranavNagrecha のスキルをすべて見る

このスキルの問題を報告する