概要

すべての AdCP Media Buy タスクの完全なリファレンスです。各タスクは、広告ワークフローの特定部分を AI エージェントが自動化できるよう設計されています。

​

すべてのタスク概要

​

レスポンスタイムのカテゴリ

AdCP のタスクは 4 つのレスポンスタイムカテゴリに分類されます。

​

🟢 即時（約 1 秒）

簡単なデータベース参照

• list_creative_formats - フォーマット仕様
• list_creatives - クリエイティブライブラリ検索

​

🟡 処理中（約 60 秒）

バックエンドと連携した AI/LLM 推論

• get_products - 自然言語によるプロダクト探索
• get_media_buy_delivery - パフォーマンスデータ集計

​

🟠 非同期（数分～数日）

人による承認が入る可能性のある複雑な処理

• create_media_buy - キャンペーン作成と検証
• update_media_buy - キャンペーンの変更
• sync_creatives - クリエイティブアセット処理

​

ワークフロー別のタスク分類

​

ディスカバリーと計画

利用可能な内容を把握し、キャンペーンを計画する起点。

• get_adcp_capabilities - エージェントの機能、ポートフォリオ、サポート機能を発見（プロトコルレベルのタスク）
• get_products - 自然言語ブリーフを使う中核のディスカバリータスク
• list_creative_formats - クリエイティブ要件を把握

​

メディアバイ管理

広告キャンペーンを作成・管理します。

• create_media_buy - 発見したプロダクトからキャンペーンを作成
• update_media_buy - 予算、ターゲティング、設定を変更

​

クリエイティブ管理

クリエイティブアセットのライフサイクル全体を扱います。

• sync_creatives - アセットを中央ライブラリにアップロード
• list_creatives - クリエイティブライブラリを検索・管理

​

パフォーマンスと最適化

キャンペーンパフォーマンスを監視・最適化します。

• get_media_buy_delivery - 配信と成果指標を追跡

​

スキーマリファレンス

すべてのタスクにはリクエストとレスポンスの JSON スキーマ定義が含まれます。

• Request Schemas: /schemas/v2/media-buy/[task-name]-request.json
• Response Schemas: /schemas/v2/media-buy/[task-name]-response.json

タスク管理: すべての AdCP ドメインにわたる非同期処理の追跡については Task Lifecycle を参照してください。 スキーマは実行時にドキュメントサーバー経由で参照でき、バリデーションやツールで利用できます。

​

共通パターン

​

エラーハンドリング

すべてのタスクは一貫したエラーパターンに従います。

• エラータイプに応じた HTTP ステータスコード
• 文脈を含む構造化されたエラーメッセージ
• 一時的な失敗に対するリトライ指針

​

認証

タスクは適切な認証を必要とします。

• サービス間呼び出しには API キー
• マルチテナント運用にはプリンシパルコンテキスト
• リソースアクセスにはパーミッション検証

​

非同期処理

長時間実行タスクは以下を提供します。

• オペレーション ID を含む即時レスポンス
• 進捗確認用のステータスポーリングエンドポイント
• 完了を通知する Webhook

​

はじめに

1. 機能を発見する: get_adcp_capabilities でエージェントの対応状況を把握する
2. 在庫を見つける: get_products で関連在庫を探す
3. フォーマットを理解する: list_creative_formats で要件を確認する
4. キャンペーンを作成: 選択したプロダクトで create_media_buy を実行する
5. クリエイティブをアップロード: sync_creatives でアセットを管理する
6. 成果を監視: get_media_buy_delivery で結果を追跡する

​

関連ドキュメント

• Product Discovery - 自然言語による在庫探索
• Media Buys - キャンペーンライフサイクル管理
• Creatives - クリエイティブアセット管理
• Advanced Topics - ターゲティング、セキュリティ、アーキテクチャ