すべてのタスク概要
レスポンスタイムのカテゴリ
AdCP タスクは四つのレスポンスタイムのカテゴリに分かれます:🟢 即時（約 1 秒）
単純な参照とイベント取り込みlist_creative_formats- フォーマット仕様list_creatives- クリエイティブライブラリの照会get_media_buys- メディアバイのステータスとクリエイティブ承認provide_performance_feedback- パフォーマンスシグナルの送信sync_event_sources- イベントソースの設定log_event- イベントの取り込み
🟡 処理中（約 60 秒）
バックエンドシステムを伴う AI/LLM 推論get_products- 自然言語のプロダクトディスカバリーと絞り込みget_media_buy_delivery- パフォーマンスデータの集計
🟠 非同期（数分〜数日）
人による承認の可能性を伴う複雑な操作create_media_buy- キャンペーンの作成と検証update_media_buy- キャンペーンの変更sync_catalogs- カタログフィードの処理とレビューsync_creatives- クリエイティブアセットの処理sync_audiences- オーディエンスのマッチングと処理
ワークフロー別のタスク分類
アカウント管理
メディアバイを行う前に、セラーとの商業的関係を確立します。これらのタスクはすべてのベンダープロトコルで共有され、コマースプロトコルのセクションに存在します:sync_accounts- ブランド/オペレーターのペアと請求を宣言し、セラーがアカウントをプロビジョニングするlist_accounts- アカウントのステータスを確認し、アクティブなaccount_idの値を取得する
ディスカバリーと計画
何が利用可能かを理解し、キャンペーンを計画するにはここから始めます。get_adcp_capabilities- エージェントのケイパビリティ、ポートフォリオ、サポートされる機能を発見する（プロトコルレベルのタスク）get_products- 自然言語ブリーフを使う中核のディスカバリータスクlist_creative_formats- クリエイティブ要件を理解する
メディアバイ管理
広告キャンペーンを作成し管理します。create_media_buy- 発見したプロダクトからキャンペーンを作成するupdate_media_buy- 予算、ターゲティング、設定を変更する
カタログ管理
プロダクトフィード、在庫、店舗データをセラーアカウントに同期します。sync_catalogs- プラットフォームのレビューと承認を伴ってカタログフィードをプッシュする
クリエイティブ管理
クリエイティブアセットをライフサイクル全体にわたって扱います。sync_creatives- エージェントがホストするクリエイティブライブラリにアセットをアップロードするlist_creatives- クリエイティブライブラリを検索・管理する（クリエイティブプロトコル）- インラインの
packages[].creatives- セラーがクリエイティブライブラリなしでinline_creative_managementを表明する場合に、パッケージスコープのクリエイティブ本体を添付または置換する
パフォーマンスと最適化
キャンペーンのパフォーマンスをモニタリングし最適化します。get_media_buys- キャンペーンのステータス、クリエイティブ承認、ほぼリアルタイムの配信スナップショットを確認するget_media_buy_delivery- レポートのために配信とパフォーマンス指標を追跡するprovide_performance_feedback- パブリッシャーの最適化のためにパフォーマンスシグナルを送信する
コンバージョントラッキング
イベントソースを設定し、アトリビューションのためにマーケティングイベントを送信します。sync_event_sources- セラーアカウント上のイベントソースを設定するlog_event- アトリビューションのためにマーケティングイベントを送信する
オーディエンス管理
ターゲティングのためにファーストパーティ CRM オーディエンスをアップロードし管理します。sync_audiences- ハッシュ化された顧客リストをアップロードし、マッチングステータスを確認する
スキーマリファレンス
すべてのタスクには、リクエストとレスポンスの JSON スキーマ定義が含まれます:- リクエストスキーマ:
/schemas/v3/media-buy/[task-name]-request.json - レスポンススキーマ:
/schemas/v3/media-buy/[task-name]-response.json
共通パターン
タスク命名規約
タスク名は snake_case を使い、メディアバイ全体で一貫して動詞優先のセマンティクスに従います:get_*: 現在の状態またはスコープされたデータセットを取得する（例:get_products、get_media_buys、get_media_buy_delivery）list_*: 任意のフィルタリングを伴ってコレクションを列挙する（例:list_creative_formats、list_creatives）create_*: 新しいリソースを作成する（create_media_buy）update_*: 既存のリソースに部分更新を適用する（update_media_buy）sync_*: 外部の状態をアップサート的な振る舞いでセラーシステムに突き合わせる（sync_catalogs、sync_creatives、sync_event_sources）log_*: 追記専用のイベントレコードを取り込む（log_event）provide_*: 最適化またはフィードバックのシグナルを送信する（provide_performance_feedback）
エラーハンドリング
すべてのタスクは、次を伴う一貫したエラーパターンに従います:- 異なるエラータイプに対する HTTP ステータスコード
- コンテキストを持つ構造化されたエラーメッセージ
- 一時的な失敗に対するリトライのガイダンス
認証
タスクは次を通じて適切な認証を要求します:- サービス間呼び出しのための API キー
- マルチテナント操作のための認証済みエージェントとアカウントのスコープ
- リソースアクセスのための権限検証
非同期オペレーション
長時間実行のタスクは次を提供します:- 操作 ID を伴う即時レスポンス
- 進捗のためのステータスポーリングエンドポイント
- 完了のためのウェブフック通知
はじめに
- ケイパビリティを発見する:
get_adcp_capabilitiesを使って、エージェントが何をサポートするかを理解する - 在庫を見つける:
get_productsを使って、関連する在庫を見つける - プロダクトを絞り込む:
buying_mode: "refine"を指定してget_productsを再呼び出しし、予算、価格、ターゲティングを反復する - フォーマットを理解する: 要件について
list_creative_formatsを確認する - カタログを同期する:
sync_catalogsを使って、プロダクトフィードをアカウントにプッシュする - クリエイティブを供給する: ライブラリを持つセラーには
sync_creativesを、インライン専用のセラーにはインラインのpackages[].creativesを使う - キャンペーンを作成する: 選択したプロダクトで
create_media_buyを使う - 運用状態を確認する: ステータス、承認、不足フォーマットについて
get_media_buysを使う - パフォーマンスをモニタリングする:
get_media_buy_deliveryでレポート指標を追跡する
get_media_buy_delivery を権威ある請求グレードの情報源として扱います。get_media_buys のスナップショットは運用モニタリングにのみ使います。
関連ドキュメント
- プロダクトディスカバリー - 自然言語による在庫の発見
- メディアバイ - キャンペーンのライフサイクル管理
- クリエイティブ - クリエイティブアセットの管理
- 高度なトピック - ターゲティング、セキュリティ、アーキテクチャ