mcpField
D
data360-segment

data360-segment

github.com/forcedotcomデータ・データベース1.1k3.8k 回インストール1 日前に更新
リポジトリ

data360-segment について

data360-segment は、Salesforce Data Cloud のセグメントや計算インサイトを作成・検証するスキルです。公開、メンバー数の確認、セグメント SQL のトラブルシューティングも扱います。

主な機能

  1. 01セグメントの作成と確認
  2. 02公開とメンバー数の確認
  3. 03計算インサイトの作成と実行
  4. 04セグメント SQL の問題診断
  5. 05件数や SQL による結果検証

活用シーン

  1. 01オーディエンスセグメントの作成と公開
  2. 02セグメントのメンバー数の確認
  3. 03計算インサイトの実行と検証
  4. 04セグメント SQL の問題診断

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/forcedotcom/sf-skills --skill data360-segment

インストール後、Claude Code で/data360-segmentを入力して読み込まれたか確認します。

同梱ファイルREADME.md

詳細

data360-segment：Data Cloud セグメントフェーズ

ユーザーがオーディエンスやインサイトに関する作業（セグメント、計算済みインサイト、公開ワークフロー、メンバー数、Data Cloud セグメント SQL のトラブルシューティング）を必要としている場合に、このスキルを使用します。

このスキルが担当するタスク

次の作業には data360-segment を使用します。

  • sf data360 segment *
  • sf data360 calculated-insight *
  • セグメントの公開ワークフロー
  • メンバー数とセグメントのトラブルシューティング
  • 計算済みインサイトの実行と検証

次の場合は、別のスキルに委任します。

  • Data Model Object（DMO）、マッピング、または ID 解決をまだ構築中の場合 → data360-harmonize
  • セグメントを下流で有効化する場合 → data360-activate
  • 読み取り専用の SQL または検索インデックスクエリを作成する場合 → data360-query

事前に収集する必要があるコンテキスト

次の情報を確認するか、推測します。

  • 対象の組織エイリアス
  • 統合 DMO（Data Model Object）またはベースエンティティ名
  • ユーザーが作成、公開、調査、またはトラブルシューティングのどれを希望しているか
  • アセットがセグメントか、計算済みインサイトか
  • 期待する成功指標：メンバー数、集計値、または公開ステータス

基本的な運用ルール

  • Data Cloud のセグメント SQL は CRM SOQL とは異なるものとして扱います。
  • オーディエンスアセットを変更する前に、data360-orchestrate スキルの共通準備状況分類器を実行します：node ../data360-orchestrate/scripts/diagnose-org.mjs -o <org> --phase segment --json。
  • 繰り返し行うセグメントや CI の作成には、再利用可能な JSON 定義を優先します。
  • 新しいデフォルト設定でセグメントの作成が不安定な場合は、--api-version 64.0 を使用します。
  • 公開や実行の後は、成功したと決めつけず、件数または SQL で検証します。
  • 人が読み取れるメンバーの詳細が必要な場合は、segment members ではなく SQL の結合を使用します。

推奨ワークフロー

1. セグメント作業に向けて準備状況を分類する
node ../data360-orchestrate/scripts/diagnose-org.mjs -o <org> --phase segment --json
2. 現在の状態を調査する
sf data360 segment list -o <org> 2>/dev/null
sf data360 calculated-insight list -o <org> 2>/dev/null
3. 再利用可能な JSON 定義を使って作成する
sf data360 segment create -o <org> -f segment.json --api-version 64.0 2>/dev/null
sf data360 calculated-insight create -o <org> -f ci.json 2>/dev/null
4. 明示的に公開または実行する
sf data360 segment publish -o <org> --name My_Segment 2>/dev/null
sf data360 calculated-insight run -o <org> --name Lifetime_Value 2>/dev/null
5. 件数または SQL で検証する
sf data360 segment count -o <org> --name My_Segment 2>/dev/null
sf data360 query sql -o <org> --sql 'SELECT COUNT(*) FROM "UnifiedssotIndividualMain__dlm"' 2>/dev/null

特に注意すべき点

  • セグメントの作成には --api-version 64.0 が必要になることがあります。
  • segment members は不透明な ID を返します。人が読み取れるメンバーの詳細が必要な場合は、SQL の結合を使用します。
  • セグメント SQL は SOQL ではありません。
  • 計算済みインサイトのアセットとセグメント SQL では、制限事項が異なります。
  • 公開や実行の手順では、コマンドがすぐに返ってきても非同期処理が開始されることがあります。
  • セグメントまたは計算済みインサイトの一覧が空の場合、通常は利用できないのではなく、モジュールにはアクセスできるものの設定されていないことを意味します。

出力形式

Segment task: <segment / calculated-insight>
Action: <create / publish / inspect / troubleshoot>
Target org: <alias>
Artifacts: <definition files / commands>
Verification: <member count / query result / publish state>
Next step: <act / retrieve / follow-up>

参考資料

コメント

Markdown 対応