segmenting-datacloud

segmenting-datacloudについて

Salesforce Data CloudのSegment段階で使用されるスキルで、オーディエンスやインサイトの管理を担います。具体的には、セグメントの作成・公開、計算されたインサイトの管理、セグメントの件数やメンバーシップの確認、オーディエンス関連SQLのトラブルシューティングなどが含まれます。このスキルはsf data360 segmentおよびsf data360 calculated-insightコマンドを通じて機能し、セグメントの作成、ワークフローの公開、メンバー数の確認、セグメントのトラブルシューティングといったタスクで適用されます。付随する作業は別のスキルに委譲されており、DMOやマッピング、アイデンティティ解決のタスクはharmonizing-datacloudが、ダウンストリームでのアクティベーションはactivating-datacloudが、読み取り専用のSQLや検索インデックスクエリはretrieving-datacloudが、Standard Data Modelやセッショントレースはobserving-agentforceがそれぞれ担当します。

実行前に、このスキルは対象組織のエイリアス、統一されたDMOまたはベースエンティティ名、作成・公開・確認・トラブルシューティングのいずれを行うか、対象がセグメントか計算されたインサイトか、期待される成功指標（メンバー数、集計値、公開ステータス）といった必要な情報を収集します。動作ルールとして、Data Cloudセグメント用SQLはCRM SOQLとは別物として扱い、アセットを変更する前にorchestrating-datacloudスキルから共有されている準備状況判定コード（diagnose-org.mjsで--phase segmentオプションを使用）を実行し、繰り返し作成が必要な場合は再利用可能なJSON定義を優先します。また、新しいデフォルト設定ではセグメント作成が不安定な場合は--api-version 64.0を使用し、公開後やステップ実行後は成功を前提とせずに件数やSQLで確認を行い、メンバーの詳細情報が必要な場合はセグメントメンバーよりもSQLジョインを優先します。

推奨されるワークフローは、準備状況の判定、現在のセグメントや計算されたインサイトの確認、JSON定義に基づく作成、明示的な公開または実行、件数やSQLによる確認という流れで進みます。注意すべきポイントとして、セグメント作成には64.0 APIバージョンが必要になる場合があること、セグメントメンバーは非公開のIDを返すこと、コマンドが迅速に返答しても公開や実行時に非同期処理が開始されること、空のリストが表示される場合はモジュール自体はアクセス可能だが設定が行われていないことを意味することが多い点が挙げられます。定義された出力形式では、セグメントタスク、実行内容、対象組織、生成されたアーティファクト、確認結果、次のステップが報告されます。このスキルの動作には外部コミュニティ製のsf data360 CLIプラグインおよびData Cloud対応の組織が必要で、orchestrating-datacloudスキル内にある共有定義テンプレートや参照情報が利用されます。

よくある質問

このスキルが直接処理するタスクと委譲するタスクは何ですか？

セグメント、計算されたインサイト、ワークフローの公開、メンバー数の確認、セグメントSQLのトラブルシューティングを直接処理します。DMOやマッピング、アイデンティティ解決はharmonizing-datacloudに、アクティベーションはactivating-datacloudに、読み取り専用のSQLや検索インデックスクエリはretrieving-datacloudに、STDMやセッショントレースはobserving-agentforceにそれぞれ委譲されます。

実行するために何が必要ですか？

外部コミュニティ製のsf data360 CLIプラグインとData Cloud対応の組織が必要です。また、オーディエンスアセットを変更する前にorchestrating-datacloudスキルから共有されている準備状況判定コード（diagnose-org.mjsで--phase segmentオプションを使用）も実行されます。

なぜセグメント作成に特定のAPIバージョンが必要なのですか？

新しいデフォルト設定ではセグメント作成の動作が不安定になることがあるため、動作の信頼性を保つためにセグメント作成時には--api-version 64.0を指定することが推奨されます。

セグメントから読み取り可能なメンバー詳細を取得するにはどうすればよいですか？

セグメントメンバーコマンドよりもSQLジョインを使用してください。なぜならセグメントメンバーは非公開のIDを返すからです。また、Data Cloudセグメント用SQLはCRM SOQLとは別物であることにも注意してください。

公開や実行後の成功をどのように確認すればよいですか？

コマンドが迅速に返答しても公開や実行時に非同期処理が開始される可能性があるため、成功を前提とせずにメンバー数やSQLクエリで確認する必要があります。