mcpField
S
segmenting-datacloud

segmenting-datacloud

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

segmenting-datacloud について

Salesforce Data Cloud のオーディエンスやインサイトを扱うスキルです。セグメントと計算インサイトの作成、公開、確認、トラブルシューティングを支援し、件数や SQL で結果を検証します。

主な機能

  1. 01セグメントと計算インサイトの作成・確認
  2. 02セグメントの公開と計算インサイトの実行
  3. 03件数や SQL による結果検証
  4. 04セグメント SQL とメンバー数のトラブルシューティング

活用シーン

  1. 01オーディエンスセグメントの作成と公開
  2. 02計算インサイトを実行して集計結果を確認
  3. 03空のセグメントやメンバー数の問題を調査

インストール

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

$npx skills add https://github.com/forcedotcom/sf-skills --skill segmenting-datacloud

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

同梱ファイルCREDITS.mdREADME.md

詳細

segmenting-datacloud：Data Cloud セグメントフェーズ

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

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

次の作業には segmenting-datacloud を使用します。

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

次の場合は、ほかのスキルに委ねます。

  • Data Model Object（DMO）、マッピング、または ID 解決を引き続き構築している → harmonizing-datacloud
  • セグメントを下流で有効化している → activating-datacloud
  • 読み取り専用 SQL または検索インデックスのクエリを作成している → retrieving-datacloud

最初に収集する必須情報

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

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

基本的な運用ルール

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

推奨ワークフロー

1. セグメント作業の準備状況を分類する
node ../orchestrating-datacloud/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 対応