クリエイティブ仕様

3.1 の正準フォーマット: このページは v1 の仕様モデルを説明します。正準フォーマットのモデル（プロダクト上のインライン format_options、validate_input プリミティブ）については、canonical-formats とマイグレーションガイドを参照してください。

​

概要

​

プロトコル概要

• 完全な技術仕様を持つフォーマット発見
• フォーマット要件に対するマニフェスト検証
• AI 搭載のクリエイティブ生成と変換
• クリエイティブ検証のためのプレビューレンダリング
• クロスプラットフォームトラッキング用ユニバーサルマクロ

​

トランスポート要件

{
  "$schema": "https://adcontextprotocol.org/schemas/v3/protocol/get-adcp-capabilities-response.json",
  "status": "completed",
  "adcp": {
    "major_versions": [2],
    "idempotency": { "supported": true, "replay_ttl_seconds": 86400 }
  },
  "supported_protocols": ["creative"],
  "creative": {
    "has_creative_library": true,
    "supports_generation": false,
    "supports_transformation": true,
    "supports_compliance": false
  }
}

​

コアコンセプト

​

クリエイティブエージェント

• 自身が所有するフォーマットを定義・文書化します
• フォーマット要件に対してマニフェストを検証します
• クリエイティブがどのようにレンダリングされるかを示すプレビューを生成します
• オプションで自然言語ブリーフからクリエイティブを生成または変換します

​

インタラクションモデル

• 変換: list_creative_formats → build_creative（creative_manifest + target_format_id を使用）
• 生成: list_creative_formats → build_creative（message + target_format_id を使用）
• ライブラリ取得: list_creatives → build_creative（creative_id + target_format_id を使用）

​

フォーマットオーソリティ

{
  "format_id": {
    "agent_url": "https://creative.adcontextprotocol.org",
    "id": "display_300x250_image"
  }
}

​

フォーマット

• メディアファミリ（display、video、audio、dooh）
• 必須および任意アセットタイプ
• 技術的制約（ディメンション、デュレーション、ファイルサイズ、コーデック）
• レンダリング動作とインタラクション期待値

​

アセット

• image: 静止画像（JPEG、PNG、WebP、GIF）
• video: ビデオファイル（MP4、WebM、MOV）または VAST タグ
• audio: オーディオファイル（MP3、M4A）または DAAST タグ
• text: ヘッドライン、説明文、CTA
• html: HTML5 クリエイティブまたはサードパーティタグ
• javascript: JavaScript タグ
• url: トラッキングピクセル、クリックスルー URL

​

マニフェスト

• フォーマット参照（agent_url + id）
• フォーマットの asset_id をキーとしたアセット値
• トラッキング URL とマクロ

​

ユニバーサルマクロ

• {TIMESTAMP}: Unix タイムスタンプ
• {CACHEBUSTER}: ランダムなキャッシュ無効化値
• {CLICK_URL}: クリックトラッキング URL
• {REDIRECT_URL}: 最終宛先 URL

​

クリエイティブステータスのライフサイクル

sync_creatives ──▶ processing ──▶ pending_review ──▶ approved
                       │                 │              │
                       │                 │              ├──▶ suspended ──▶ approved
                       │                 │              │        │
                       │                 │              │        └──▶ rejected
                       │                 │              ├──▶ pending_review
                       │                 │              ├──▶ rejected
                       │                 │              └──▶ archived
                       │                 │
                       └──────▶ rejected ◀──────────────┘
                                  │
                                  └── buyer fixes + resubmits ──▶ processing

archived ── buyer unarchives ──▶ approved (or pending_review when re-review is required)

• processing → pending_review: 取り込みとトランスコードが成功したときに自動
• processing → rejected: 処理が失敗したときに自動（破損ファイル、サポートされないコーデック、制約違反）
• pending_review → approved: セラーがコンテンツポリシーのレビュー後に承認
• pending_review → rejected: セラーが rejection_reason とともに拒否
• approved → suspended: セラーが回復可能な依存関係/認可の喪失を検出（例: published_post 参照の identity_authorization_revoked、identity_authorization_expired、source_private）。セラーは影響を受けるアクティブなバイに対応する impairment を表面化しなければなりません（MUST）。
• suspended → approved: セラーが依存関係が回復されたことを観測し、必要な再レビューが通る。
• suspended → rejected: セラーが、以前は回復可能だった依存関係/認可の喪失をこのクリエイティブについて回復できない、または置換/再提出が必要と判断。例: published_post 参照の失効したアイデンティティ/投稿の認可を再認可できない。セラーは、クリエイティブが置換・再割り当てされるか、パッケージ/バイがそれ以外の方法で是正されるまで、影響を受けるアクティブなバイを impaired に保たなければなりません（MUST）。
• approved → archived（バイヤー起点）: バイヤーが sync_creatives を通じてアーカイブを発行
• approved → archived（セラー起点）: セラーが、非アクティブ、フライト後の期限切れ、またはストレージポリシーのために未割り当てのクリエイティブをアーカイブ。セラーは、アクティブなパッケージ割り当てを持つクリエイティブをセラーアーカイブしてはなりません（MUST NOT）——アクティブな配信が関与する場合、影響を受けるバイに impairment を伴う approved → rejected（失効）のパスが唯一の準拠ルートです。セラー起点のアーカイブの状態変更の可観測性はクリエイティブ保持の契約に従います——最小限、新しい status が次の list_creatives の読み取りで可視でなければなりません（MUST）。
• archived → approved: sync_creatives を通じたバイヤー起点（アーカイブ解除）。セラーは再レビューを要求し、代わりに pending_review へ遷移してもよい（MAY）。
• rejected → processing: バイヤーがクリエイティブを修正し sync_creatives を通じて再提出。クリエイティブは完全な処理とレビューのパイプラインに再入します。
• approved → pending_review: セラー起点の再レビュー（例: ポリシー変更）。以前承認されたクリエイティブが再レビューのために引き戻されたとき、セラーは creative.status_changed を通じてサブスクライバーに通知しなければなりません（MUST）（event_types[] にこの値を含む各 notification_configs[] サブスクライバーに発火——下記を参照）。

​

ライフサイクルウェブフック

• creative.status_changed — すべてのセラー起点またはシステム起点の遷移で発火: pending_review → approved/rejected、approved → pending_review（再レビュー）、approved → suspended（回復可能な依存関係/認可の喪失）、suspended → approved（回復）、suspended → rejected（終端の依存関係/認可の喪失）、approved → rejected（承認後の失効）、approved → archived（セラー起点）。ペイロード: creative-status-changed-webhook.json。
• creative.purged — クリエイティブが破棄されたときに発火（保持のスイープ、テイクダウン、法的消去）。soft パージは list_creatives（include_purged: true）上に 30 日間トゥームストーンを保持します。hard パージはレコードを保持しません——ウェブフックがバイヤーの唯一のシグナルです。ペイロード: creative-purged-webhook.json。

​

価格

​

価格発見の面

• list_creatives — アドサーバーとライブラリベースのエージェントは、各クリエイティブに pricing_options[] を公開します。バイヤーは使いたい特定のクリエイティブの価格を発見します。
• list_creative_formats — 変換および生成エージェントは、各フォーマットに pricing_options[] を公開します。バイヤーは、クリエイティブが存在する前に、エージェントが生成できるフォーマットの価格を発見します。

​

価格のフロー

1. アカウントのセットアップ — レートカードが合意されます。後続のすべての操作の価格を決定します。
2. 発見 — account と include_pricing: true を伴う list_creatives または list_creative_formats が pricing_options[] を返します。ベンダーは複数のオプションを提供できます（ボリュームティア、コンテキスト固有のレート、プロダクトラインごとの異なるモデル）。
3. ビルド — account を伴う build_creative。エージェントがコストを計算し、レスポンスで pricing_option_id、vendor_cost、currency、consumption を返します。
4. レポート — 照合のための creative_id と pricing_option_id を伴う report_usage。

​

価格モデル

​

消費の詳細

​

アカウントの要件

​

バンドルモード

​

タスク

​

list_creative_formats

• クリエイティブエージェントは自身が所有するフォーマットの完全なフォーマット仕様を返さなければなりません (MUST)
• クリエイティブエージェントは各フォーマットの権威あるエージェントを識別する agent_url を含めなければなりません (MUST)
• クリエイティブエージェントはフォーマット定義に技術的制約（ディメンション、デュレーション、ファイルタイプ）を含めなければなりません (MUST)
• クリエイティブエージェントは追加フォーマットを提供する他のクリエイティブエージェントへの参照を含めてもよい (MAY)
• format_ids でフィルタリングする場合、クリエイティブエージェントはリクエストされたフォーマットのみを返さなければなりません (MUST)

​

list_transformers

• creative.supports_transformers: true を設定するクリエイティブエージェントは list_transformers を実装しなければなりません（MUST）
• クリエイティブエージェントは、呼び出し元のアカウント向けにトランスフォーマー、その列挙可能なオプション値、価格を解決しなければなりません（MUST）——そのアカウント向けに設定されたカスタム値（例: クローンされた声）を含む
• クリエイティブエージェントは、expand_params で名指しされた各 field について、アカウントスコープのオプション値を params[].options[] にインラインで返さなければならず（MUST）、それ以外では省略すべきです（SHOULD）
• include_pricing が true の場合、課金するクリエイティブエージェントは各トランスフォーマーに pricing_options（per_unit モデル）を含めなければなりません（MUST）

​

build_creative

1. 生成: ブリーフまたはシードアセットからマニフェストを作成します
2. 変換: 既存のマニフェストを別のフォーマットに適応させる
3. ライブラリ取得: エージェントのライブラリから creative_id を解決し、広告配信アセット（HTML/JavaScript/VAST タグ）を含むマニフェストを返す

• クリエイティブエージェントはフォーマット要件に対して入力マニフェストを検証しなければなりません (MUST)
• クリエイティブエージェントは成功時にターゲットフォーマットの有効なマニフェストを返さなければなりません (MUST)
• クリエイティブエージェントは変換が完了できない場合に検証エラーを返さなければなりません (MUST)
• クリエイティブエージェントは変換中にトラッキング URL とマクロを保持すべきだ (SHOULD)
• クリエイティブエージェントはジェネレーティブタスクの quality を尊重すべきだ (SHOULD)（"draft" は高速反復、"production" は最終配信）。非ジェネレーティブ変換では無視してもよい (MAY)
• クリエイティブエージェントは item_limit が存在する場合、item_limit とフォーマットの max_items の小さい方を使用すべきだ (SHOULD)
• クリエイティブエージェントは生成タスクに AI/LLM 処理を使用してもよい (MAY)
• creative_id が提供された場合、クリエイティブエージェントはライブラリからクリエイティブを解決しなければなりません (MUST)
• macro_values が提供された場合、クリエイティブエージェントは出力マニフェストのアセット内で指定されたマクロを代入し、未解決のマクロを {MACRO} プレースホルダーとして残すべきだ (SHOULD)
• クリエイティブエージェントは macro_values の未認識のマクロキーを無視しなければなりません (MUST) — 未知のマクロはエラーではありません
• クリエイティブエージェントはグローバルに一意な creative_id 値を割り当てるべきだ (SHOULD)。一意性を保証できない場合、concept_id は build_creative リクエストで曖昧さを解消するために REQUIRED だ
• build_creative は重大な時間がかかる生成および変換タスクに対して非同期レスポンス（context_id ポーリングを持つ status: "working"）をサポートします。ライブラリ取得は通常同期的です
• account が提供されエージェントが課金する場合、レスポンスは pricing_option_id、vendor_cost、currency を含めなければなりません（MUST）。consumption オブジェクトは関連する場合に含めるべきです（SHOULD）
• 非同期ビルドでは、価格フィールドは中間のステータスレスポンスではなく、最終的な完了レスポンスにのみ現れます
• 課金するクリエイティブエージェントが account なしで build_creative リクエストを受け取り、そのエージェントがアカウントを必要とする場合、エージェントはエラーを返さなければなりません（MUST）

​

preview_creative

• クリエイティブエージェントはプレビュー生成前にマニフェストを検証しなければなりません (MUST)
• クリエイティブエージェントは有効なマニフェストのプレビュー URL または HTML を返さなければなりません (MUST)
• クリエイティブエージェントは、プレビュー URL をその expires_at タイムスタンプまで参照解決可能に保たなければなりません（MUST）。expires_at が省略された場合、プレビュー URL はプロトコル層では期限切れにならず、エージェントが帯域外で明示的に失効させるまで有効なままです。
• クリエイティブエージェントは、時間制限付きのプレビュー URL には expires_at を含めるべきだ (SHOULD)
• クリエイティブエージェントは複数のクリエイティブのバッチプレビューをサポートすべきだ (SHOULD)
• クリエイティブエージェントは複数の出力フォーマット（URL、HTML、画像）をサポートしてもよい (MAY)

​

list_creatives

• エージェントは認証済みアカウントからアクセス可能なクリエイティブを返さなければなりません (MUST)
• エージェントは各クリエイティブの承認ステータスを含めなければなりません (MUST)
• エージェントはフォーマット、ステータス、タグ、日付範囲によるフィルタリングをサポートすべきだ (SHOULD)
• プラットフォームがクリエイティブをコンセプトに整理する場合、エージェントは concept_ids と format_ids によるフィルタリングをサポートすべきだ (SHOULD)
• エージェントは include_variables=true の場合にダイナミックコンテンツ変数定義を含めてもよい (MAY)
• エージェントは include_snapshot=true の場合に軽量な配信スナップショットを含めてもよい (MAY)。スナップショットは「このクリエイティブはアクティブか?」「最後にいつ配信されたか?」などの運用上の質問のためにライフタイムインプレッションと最終配信日時を提供する — 詳細分析は get_creative_delivery が担う
• account と include_pricing=true が提供された場合、課金するエージェントは各クリエイティブに pricing_options——vendor-pricing-option オブジェクトの配列——を含めなければなりません（MUST）。ベンダーはクリエイティブごとに複数のオプションを提供できます（ボリュームティア、コンテキスト固有のレート、異なる価格モデル）。

• サービスに課金するクリエイティブエージェントは、Accounts プロトコルを実装しなければなりません（MUST）。これは価格を持つ任意のクリエイティブエージェントに適用されます——アドサーバー、生成プラットフォーム、使用に課金する変換エージェント。
• ライブラリをホストするが課金しないクリエイティブエージェントは、バイヤーがクエリ前にアクセスを確立できるよう Accounts プロトコルを実装すべきだ（SHOULD）。
• これはセールスエージェントが使用するのと同じ accounts プロトコルだ — 別バージョンはない。
• メディアバイのために accounts を既に実装しているセールスエージェントは追加対応不要です。

​

sync_creatives

• エージェントはフォーマット仕様に対してクリエイティブを検証しなければなりません (MUST)
• エージェントは非準拠クリエイティブの検証エラーを返さなければなりません (MUST)
• エージェントはクリエイティブが使用可能になる前に承認を要求してもよい (MAY)
• エージェントは変更を適用せずに検証するための dry_run をサポートすべきだ (SHOULD)
• エージェントは delete_missing: true と creative_ids を組み合わせるリクエストを拒否しなければなりません (MUST) — delete_missing はライブラリ全体に適用され、フィルタされたサブセットには適用されない
• メディアバイも管理するエージェントは一括クリエイティブ-パッケージマッピングのための assignments フィールドをサポートすべきだ (SHOULD)
• メディアバイを管理しないスタンドアロンクリエイティブエージェントは assignments フィールドを無視すべきだ (SHOULD)

​

get_creative_delivery

• エージェントはリクエストされたクリエイティブの配信データを返さなければなりません (MUST)
• エージェントは利用可能な場合にバリアントレベルの内訳を含めるべきだ (SHOULD)
• クリエイティブプロトコルを実装するセールスエージェントは、自身のプロダクトがクリエイティブバリアントを生成または最適化する場合にこのタスクをサポートすべきだ (SHOULD)

​

エラー処理

• REFERENCE_NOT_FOUND: リクエストされたフォーマットが存在しない、またはアクセスできない（error.field が format_id を特定する）
• VALIDATION_ERROR: マニフェストがフォーマット検証に失敗しました
• ASSET_MISSING: 必須アセットがマニフェストに提供されていません
• ASSET_INVALID: アセットがフォーマット制約を満たさない
• GENERATION_FAILED: クリエイティブ生成を完了できなかった

​

セキュリティの考慮事項

​

トランスポートセキュリティ

​

アセットセキュリティ

• クリエイティブエージェントはアセット URL がアクセス可能であることを検証すべきだ (SHOULD)
• クリエイティブエージェントはマルウェアと悪意あるコンテンツのためにアセットをスキャンすべきだ (SHOULD)
• クリエイティブエージェントは検証中に信頼されていない JavaScript を実行してはなりません (MUST NOT)

​

プレビューセキュリティ

• プレビュー URL は時間制限があるべきだ (SHOULD)（expires_at で示されます）
• プレビュー URL は、エージェントが URL の表明されたライフタイムにわたってその状態を保証できない限り、ポッドローカルまたはプロセスローカルの状態に依存してはなりません (MUST NOT)
• クリエイティブエージェントはスクリプト実行を防ぐために HTML プレビューをサンドボックス化すべきだ (SHOULD)
• output_format: "html" の消費者は信頼されたクリエイティブエージェントのみを使用しなければなりません (MUST)

​

適合性

​

クリエイティブエージェントの適合性

1. 指定されたトランスポート（MCP または A2A）のうち少なくとも1つをサポートします
2. フォーマット発見のための list_creative_formats を実装します
3. 自身が所有するフォーマットの権威あるフォーマット定義のみを返す
4. フォーマット仕様に対してマニフェストを検証します
5. 指定されたエラーコードを使用します

1. クリエイティブ生成のための build_creative を実装します
2. プレビューレンダリングのための preview_creative を実装します
3. トラッキング URL でユニバーサルマクロをサポートします
4. エージェントがクリエイティブライブラリをホストする場合、list_creatives を実装します
5. エージェントがクリエイティブアップロードを受け入れる場合、sync_creatives を実装します
6. エージェントがクリエイティブライブラリをホストする場合、build_creative で creative_id をサポートします
7. クリエイティブライブラリをホストする場合、accounts プロトコル（sync_accounts / list_accounts）を実装します
8. バイヤーが正しいインタラクションモデルを判断できるよう get_adcp_capabilities で supports_generation、supports_transformation、has_creative_library を宣言します

​

コンシューマの適合性

1. フォーマット ID の agent_url を使用して権威あるクリエイティブエージェントを識別します
2. 提出前にフォーマット仕様に対してマニフェストを検証します
3. 検証エラーを適切に処理します
4. 無限ループを避けるためにフォーマットを再帰的に発見する際に訪問済み URL を追跡します

​

実装ノート

​

レスポンスタイムの期待値

​

再帰的フォーマット発見

{
  "creative_agents": [{
    "agent_url": "https://creative.adcontextprotocol.org",
    "agent_name": "AdCP Reference Creative Agent",
    "capabilities": ["validation", "assembly", "preview"]
  }]
}

​

フォーマット対応検証

1. 権威あるクリエイティブエージェントからフォーマット定義を検索します
2. マニフェストの各アセットについて、フォーマットの assets 配列内の対応するエントリを見つける
3. フォーマットで定義されたタイプと制約に対してアセット値を検証します

​

標準フォーマットとカスタムフォーマット

• 標準フォーマット: IAB 仕様に基づき、リファレンスクリエイティブエージェント（https://creative.adcontextprotocol.org）がホスト
• カスタムフォーマット: 特殊なインベントリのために個別のパブリッシャーやクリエイティブプラットフォームが定義

​

スキーマリファレンス