data360-activate について
data360-activate は、Data Cloud の出力を下流システムへ届けるためのスキルです。アクティベーション先、アクティベーション、データアクションの設定と配信準備の確認を扱います。
主な機能
- 01アクティベーションプラットフォームと先の確認
- 02アクティベーション先とアクション先の作成
- 03アクティベーションとデータアクションの作成
- 04下流配信設定の検証
活用シーン
- 01Data Cloud 出力の送信先設定
- 02公開済みセグメントの外部システムへの配信
- 03データアクション先の設定
- 04アクティベーション準備と配信状況の確認
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ forcedotcom/ sf-skills --skill data360-activateインストール後、Claude Code で/data360-activateを入力して読み込まれたか確認します。
同梱ファイルREADME.md
詳細
data360-activate:Data Cloud のアクティベーションフェーズ
ユーザーが下流へのデリバリー作業(アクティベーション、アクティベーションターゲット、データアクション、Data Cloud の出力を他のシステムへ送信する作業)を必要としている場合に、このスキルを使用します。
このスキルが担当するタスク
次の作業には data360-activate を使用します。
sf data360 activation *sf data360 activation-target *sf data360 data-action *sf data360 data-action-target *- 下流へのデリバリー設定の検証
次の場合は、別のスキルに委任します。
- オーディエンスまたはインサイトをまだ作成中の場合 → data360-segment
- クエリ/検索または検索インデックスを調べている場合 → data360-query
- 基本接続またはデータ取り込みを設定している場合 → data360-connect、data360-prepare
最初に確認する必須コンテキスト
次の情報を確認または推定します。
- 対象の組織エイリアス
- 接続先プラットフォームまたは下流システム
- セグメントがすでに存在し、公開されているかどうか
- ユーザーが作成、確認、更新、削除のどれを必要としているか
- タスクがアクティベーション中心か、データアクション中心か
基本的な運用ルール
- 下流へのデリバリー用アセットを作成する前に、上流のセグメントまたはインサイトが正常な状態であることを確認します。
- アクティベーションアセットを変更する前に、共通の準備状況判定を実行します:
node ../data360-orchestrate/scripts/diagnose-org.mjs -o <org> --phase act --json。 - アクティベーション設定を変更する前に、利用可能なプラットフォームとターゲットを確認します。
- 可能な場合は、接続先の定義を決定的で再利用可能な形にします。
- 下流の認証情報とプラットフォームの制約は、別々の検証項目として扱います。
- 接続先の状態が不明な場合は、まず読み取り専用で確認します。
推奨ワークフロー
1. アクティベーション作業の準備状況を判定する
node ../data360-orchestrate/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>
参考資料
- ../data360-orchestrate/assets/definitions/activation-target.template.json
- ../data360-orchestrate/assets/definitions/activation.template.json
- ../data360-orchestrate/assets/definitions/data-action-target.template.json
- ../data360-orchestrate/assets/definitions/data-action.template.json
- ../data360-orchestrate/references/plugin-setup.md
- ../data360-orchestrate/references/feature-readiness.md
コメント
Markdown 対応