mcpField
A
activating-datacloud

activating-datacloud

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

activating-datacloud について

Salesforce Data Cloud の下流配信向けスキルです。sf CLI でアクティベーションターゲット、アクティベーション、データアクションを管理し、上流データと配信先を確認してから設定を検証します。

主な機能

  1. 01利用可能なアクティベーション基盤とターゲットを確認
  2. 02アクティベーションおよびデータアクションのターゲットを作成
  3. 03アクティベーションとデータアクションを作成
  4. 04下流配信の設定を検証

活用シーン

  1. 01公開済みオーディエンスを下流配信に設定
  2. 02データアクションのターゲットを設定・確認
  3. 03アクティベーションデータと配信準備状況を確認

インストール

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

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

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

同梱ファイルCREDITS.mdREADME.md

詳細

activating-datacloud：Data Cloud のアクティベーションフェーズ

アクティベーション、アクティベーションターゲット、データアクション、または Data Cloud の出力を他のシステムに送信するなど、下流への配信作業が必要な場合にこのスキルを使用します。

このスキルが担当する作業

次の作業が含まれる場合は、activating-datacloud を使用します。

  • sf data360 activation *
  • sf data360 activation-target *
  • sf data360 data-action *
  • sf data360 data-action-target *
  • 下流への配信設定の確認

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

最初に確認する必須情報

次の情報を尋ねるか、状況から推測します。

  • 対象の組織エイリアス
  • 配信先のプラットフォームまたは下流システム
  • セグメントがすでに存在し、公開済みかどうか
  • ユーザーが作成、確認、更新、削除のどれを必要としているか
  • タスクがアクティベーション中心か、データアクション中心か

基本的な運用ルール

  • 下流配信アセットを作成する前に、上流のセグメントまたはインサイトが正常な状態であることを確認します。
  • アクティベーションアセットを変更する前に、共通の準備状況分類を実行します：node ../orchestrating-datacloud/scripts/diagnose-org.mjs -o <org> --phase act --json。
  • アクティベーション設定を変更する前に、利用可能なプラットフォームとターゲットを確認します。
  • 可能な場合は、配信先の定義を決定的で再利用可能なものにします。
  • 下流の認証情報とプラットフォームの制約は、それぞれ個別の検証事項として扱います。
  • 配信先の状態が不明な場合は、まず読み取り専用で確認します。

推奨ワークフロー

1. アクティベーション作業の準備状況を分類する
node ../orchestrating-datacloud/scripts/diagnose-org.mjs -o <org> --phase act --json
2. まず配信先を確認する
sf data360 activation platforms -o <org> 2>/dev/null
sf data360 activation-target list -o <org> 2>/dev/null
sf data360 data-action-target list -o <org> 2>/dev/null
3. アクティベーションの前に配信先を作成する
sf data360 activation-target create -o <org> -f target.json 2>/dev/null
sf data360 data-action-target create -o <org> -f target.json 2>/dev/null
4. アクティベーションまたはデータアクションを作成する
sf data360 activation create -o <org> -f activation.json 2>/dev/null
sf data360 data-action create -o <org> -f action.json 2>/dev/null
5. 下流への配信準備状況を確認する
sf data360 activation list -o <org> 2>/dev/null
sf data360 activation data -o <org> --name <activation> 2>/dev/null

特に注意すべき点

  • アクティベーションの設計は、公開済みの上流セグメントが正常であることを前提とします。
  • 通常、アクティベーションの作成より先に配信先を設定します。
  • 下流の認証情報やプラットフォームの制約は、Data Cloud CLI 以外の場所に存在することがあります。
  • 配信先の設定が不明な場合は、読み取り専用で確認するのが最も安全な最初の手順です。
  • CdpActivationTarget または CdpActivationExternalPlatform は、現在の組織／ユーザーではアクティベーション機能が制限されていることを示します。何も考えずに再試行するのではなく、アクティベーションの設定、権限、配信先の設定を案内してください。

出力形式

Act task: <activation / activation-target / data-action / data-action-target>
Destination: <platform or target>
Target org: <alias>
Artifacts: <definition files / commands>
Verification: <listed / created / blocked>
Next step: <destination validation or downstream testing>

参考資料

コメント

Markdown 対応