Documentation Index
Fetch the complete documentation index at: https://adcp-docs-ja.pier1.co.jp/llms.txt
Use this file to discover all available pages before exploring further.
本ガイドは、クリエイティブフォーマットを定義・管理するクリエイティブエージェントの実装方法を解説します。
クリエイティブエージェントとは
クリエイティブエージェントは次を行うサービスです。
- フォーマットを定義 - 必要なアセットとその構造を指定
- マニフェストを検証 - クリエイティブマニフェストがフォーマット要件を満たすか確認
- プレビューを生成 - クリエイティブのレンダリング結果を表示
- クリエイティブを構築(任意) - 自然言語ブリーフからマニフェストを生成、既存マニフェストを別フォーマットへ変換、またはライブラリから配信可能なマニフェストとして取得
- クリエイティブライブラリをホスト(任意) - バイヤーが既存クリエイティブをブラウズ・フィルタリングできるようにします
広告サーバー(CM360、Flashtalking)、クリエイティブ管理プラットフォーム、クリエイティブエージェンシー、パブリッシャー、セールスエージェントがクリエイティブエージェントを実装できます。Media Buy Protocol と Creative Protocol を両方実装するセールスエージェントは、単一エンドポイントから双方の役割を担います — セールスエージェントのクリエイティブ機能 を参照してください。
主要要件
1. フォーマット ID の名前空間化
定義するすべてのフォーマットで、競合を避けるために agent URL 付きの構造化フォーマット ID を使用します。
{
"format_id": {
"agent_url": "https://youragency.com",
"id": "video_story_15s"
}
}
ルール:
agent_url はエージェントの URL と一致させる
id は名前空間内で説明的かつ一意にします
- 一貫性のため小文字とアンダースコアを使用します
2. フォーマットの検証
フォーマットがあなたの agent_url を参照する場合、あなたが次の権威となります。
- フォーマット仕様
- アセットの検証ルール
- 技術要件
- プレビュー生成
フォーマット定義例:
{
"format_id": {
"agent_url": "https://youragency.com",
"id": "story_sequence_5frame"
},
"name": "5-Frame Story Sequence",
"type": "display",
"min_frames": 5,
"max_frames": 5,
"frame_schema": {
"assets": [
{
"asset_type": "image",
"asset_role": "frame_image",
"required": true,
"requirements": {
"width": 1080,
"height": 1920,
"file_types": ["jpg", "png", "webp"],
"max_file_size_kb": 500
}
},
{
"asset_type": "text",
"asset_role": "caption",
"required": false,
"requirements": {
"max_length": 100
}
}
]
},
"global_assets": [
{
"asset_type": "image",
"asset_role": "brand_logo",
"required": true,
"requirements": {
"width": 200,
"height": 200,
"transparency_required": true
}
}
]
}
必須タスク
クリエイティブエージェントは次の 2 つのタスクを実装しなければなりません。
エージェントが定義するすべてのフォーマットを返します。バイヤーはこれによってサポートするクリエイティブフォーマットを発見します。
主な責務:
- 必須・任意を含むすべての
assets を備えた完全なフォーマット定義を返す
- 各フォーマットに自分の
agent_url を含めます
format_id 値に適切な名前空間を使用します
完全な API 仕様は list_creative_formats task reference を参照してください。
preview_creative
マニフェストがあなたのフォーマットでどのように描画されるかを示すビジュアルプレビューを生成します。
主な責務:
- マニフェストをフォーマット要件に照らして検証します
- マニフェストが無効な場合は検証エラーを返す
- ビジュアル表現(URL、画像、または HTML)を生成します
- プレビューは少なくとも 24 時間アクセス可能にします
完全な API 仕様は preview_creative task reference を参照してください。
任意タスク
build_creative
自然言語ブリーフからクリエイティブマニフェストを生成、既存マニフェストを別フォーマットへ変換、またはライブラリクリエイティブを配信可能なマニフェストとして取得します。
主な責務:
- 自然言語ブリーフを解析するか、ライブラリの
creative_id を解決します
- 適切なアセットを生成または調達します
- ターゲットフォーマットに有効なマニフェストを返す
- 提供された場合は
macro_values をサービングタグに代入します
- 任意でプレビュー URL を返す
完全な API 仕様は build_creative task reference を参照してください。
list_creatives
ライブラリ内のクリエイティブをブラウズ・フィルタリングします。クリエイティブライブラリをホストしており、バイヤーがクエリする必要がある場合に実装します。
主な責務:
- 認証済みアカウントからアクセス可能なクリエイティブを返す
- フォーマット、ステータス、タグ、日付範囲によるフィルタリングをサポートします
- 大規模ライブラリのページネーションをサポートします
- 任意でクリエイティブごとの動的クリエイティブ最適化(DCO)変数定義を含めます
完全な API 仕様は list_creatives task reference を参照してください。
sync_creatives
クリエイティブアセットのアップロードをライブラリに受け入れます。プラットフォームがバイヤーによるアセットのプッシュを許可する場合に実装します。
主な責務:
- フォーマット仕様に対してクリエイティブを検証します
- プラットフォームが割り当てた ID を含むクリエイティブごとの結果を返す
- アップサートセマンティクスをサポートする(
creative_id で作成または更新)
- 任意で一括パッケージアサインメントをサポートする(メディアバイも管理するエージェント向け)
- 任意でブランドセーフティレビューのための非同期承認ワークフローをサポートします
完全な API 仕様は sync_creatives task reference を参照してください。
検証のベストプラクティス
マニフェストの検証
マニフェストを検証する際は次を行います。
- format_id を確認 - あなたのエージェントを参照しているか
- 必須アセットを検証 - 必須アセットがすべて存在するか
- アセットタイプを確認 - 指定されたタイプと一致するか
- 要件を検証 - 寸法、ファイルタイプ、サイズなど
- URL の到達性 - アセット URL にアクセスできるか(任意だが推奨)
検証エラーの例:
{
"status": "error",
"error": "validation_failed",
"validation_errors": [
{
"asset_id": "frame_1_image",
"error": "missing_required_asset",
"message": "Required asset 'frame_1_image' is missing"
},
{
"asset_id": "brand_logo",
"error": "invalid_dimensions",
"message": "Logo must be 200x200px, got 150x150px"
}
]
}
ディスクロージャー要件
クリエイティブブリーフに compliance.required_disclosures が含まれる場合、クリエイティブエージェントは各ディスクロージャーが生成されたクリエイティブに確実に表示されるようにしなければなりません。ワークフローは次の通り:
-
フォーマットのサポートを確認 — 各
required_disclosures[].position をフォーマットの supported_disclosure_positions または disclosure_capabilities と照合します。必要なポジションがフォーマットでサポートされていない場合、暗黙に省略するのではなくバリデーションエラーを返します。disclosure_capabilities が存在する場合はそれを使って永続性を考慮したマッチングを行い、フォーマットが必要なポジションと必要な永続性モードの両方をサポートするか確認します。
-
永続性を尊重する — ブリーフが必要なディスクロージャーに
persistence を指定している場合、クリエイティブエージェントはフォーマットの disclosure_capabilities でその永続性モードをサポートするポジションを使用してこれを満たさなければなりません。たとえば EU AI Act のディスクロージャーに "continuous" 永続性が必要な場合、フォーマットはそのポジションを disclosure_capabilities で "continuous" を持つと宣言していなければなりません。ブリーフが persistence を省略した場合、フォーマットがそのポジションでサポートする最も厳格な永続性モードを使用します。
-
ディスクロージャーを描画する — サポートするポジションに対して:
footer, overlay, end_card, prominent: ディスクロージャーの text をクリエイティブ内の指定ポジションに描画します
audio, pre_roll: 音声として読み上げる。min_duration_ms が指定されていれば尊重します
subtitle: 動画クリエイティブ内にテキストトラックとして含めます
companion: プライマリクリエイティブと併せてコンパニオン広告ユニットで配信します
-
管轄の範囲を尊重する —
jurisdictions: ["US"] が指定されたディスクロージャーは米国でのみ法的に必要です。ブリーフごとに単一のクリエイティブを生成するエージェントはすべての管轄のディスクロージャーを含めるべきです。管轄ごとのバリアントを生成できるエージェントは、jurisdictions フィールドでディスクロージャーをフィルタリングします。
-
出所情報に伝播させる — ブリーフが必要なディスクロージャーに
persistence と position を指定している場合、これらをクリエイティブマニフェストの provenance.disclosure.jurisdictions[].render_guidance に伝播させる。ブリーフは生成時のドキュメントであり、配信時にパブリッシャーが持つのはブリーフではなくクリエイティブとその出所情報です。クリエイティブエージェントが永続性を出所情報に伝播させない場合、パブリッシャーは規制が要求する永続性を知る方法がない。
-
再生成時も保持する — クリエイティブを再生成またはリサイズする際は、マニフェストに添付された
BriefAsset からすべてのディスクロージャーを引き継ぐ。BriefAsset とはフォーマットの assets 配列の brief タイプのアセットであり、フォーマット変換を経てもディスクロージャーが残存するようクリエイティブブリーフをマニフェスト内に保持します。
例: ブリーフが overlay ポジションに persistence: "continuous" を指定した "KI-generiert" ディスクロージャー(eu_ai_act_article_50 向け)を要求しています。フォーマットは disclosure_capabilities: [{ "position": "overlay", "persistence": ["continuous", "initial"] }] を宣言しています。フォーマットは continuous overlay をサポートしているため、クリエイティブエージェントはコンテンツ全体を通じて表示される持続的なオーバーレイとしてディスクロージャーを描画します。またエージェントは provenance.disclosure.jurisdictions[] の EU 管轄エントリに render_guidance: { "persistence": "continuous", "positions": ["overlay"] } を伝播させる。
フォーマットの進化
フォーマット定義を更新する際は次を考慮します。
- 追加的な変更(
assets への required: false な新しい任意アセット)は安全
- 破壊的変更(アセット削除や要件変更)は新しい format_id が必要
youragency.com:format_name_v2 のようなバージョニングを検討
- 可能な限り後方互換性を維持
デプロイチェックリスト
クリエイティブエージェントを公開する前に確認してください。
インテグレーションパターン
パターン 1: クリエイティブエージェンシー
ブランド向けにカスタムフォーマットを構築するクリエイティブエージェンシーの場合:
{
"format_id": {
"agent_url": "https://brandstudio.com",
"id": "hero_video_package"
},
"name": "Hero Video Package",
"type": "video",
"description": "Premium video creative with multiple aspect ratios",
"assets": [
{"asset_role": "hero_video_16x9", "...": "..."},
{"asset_role": "hero_video_9x16", "...": "..."},
{"asset_role": "hero_video_1x1", "...": "..."}
]
}
パターン 2: プラットフォーム固有フォーマット
専門フォーマットを定義するプラットフォームの場合:
{
"format_id": {
"agent_url": "https://platform.com",
"id": "interactive_quiz"
},
"name": "Interactive Quiz Ad",
"type": "rich_media",
"description": "Engagement-driven quiz format",
"assets": [
{"asset_role": "question_1", "asset_type": "text", "...": "..."},
{"asset_role": "answer_1a", "asset_type": "text", "...": "..."}
]
}
パターン 3: フォーマット拡張サービス
標準フォーマットの拡張版を提供する場合:
{
"format_id": {
"agent_url": "https://enhanced.com",
"id": "video_30s_optimized"
},
"name": "Optimized 30s Video",
"type": "video",
"extends": "creative.adcontextprotocol.org:video_30s",
"description": "Standard 30s video with automatic optimization",
"assets": [
],
"enhancements": {
"auto_transcode": true,
"quality_optimization": true,
"format_variants": ["mp4", "webm", "hls"]
}
}
パターン 4: フィードネイティブ/ソーシャルフォーマットエージェント
プラットフォームのフィード内にネイティブコンテンツとして描画する広告フォーマットをホストする場合:
{
"format_id": {
"agent_url": "https://ads.socialplatform.com",
"id": "promoted_post"
},
"name": "Promoted post",
"type": "native",
"description": "Sponsored content that appears in the feed alongside organic posts. Renders with platform chrome (user avatar, engagement buttons, community badge).",
"assets": [
{
"item_type": "individual",
"asset_id": "headline",
"asset_type": "text",
"required": true,
"requirements": { "max_length": 300 }
},
{
"item_type": "individual",
"asset_id": "body",
"asset_type": "text",
"required": false,
"requirements": { "max_length": 1000 }
},
{
"item_type": "individual",
"asset_id": "image",
"asset_type": "image",
"required": false,
"requirements": { "max_width": 1200, "max_height": 628, "accepted_types": ["image/jpeg", "image/png"] }
},
{
"item_type": "individual",
"asset_id": "click_url",
"asset_type": "url",
"required": true,
"requirements": {}
}
]
}
プラットフォーム固有の描画(ダークモード、コミュニティコンテキスト、エンゲージメント UI)はエージェントがプレビューと配信時に処理します。フォーマット定義で指定するのはバイヤーが提供するアセットのみです。エージェントはこれらのアセットをプラットフォームのネイティブクロームでラップします。
バイヤーがフィードネイティブフォーマットに対して preview_creative を呼び出すと、プレビューはバイヤーのアセットをプラットフォームの UI(アバター、エンゲージメントボタン、コミュニティバッジなど)内に描画します。
{
"request_type": "single",
"creative_manifest": {
"format_id": {
"agent_url": "https://ads.socialplatform.com",
"id": "promoted_post"
},
"assets": {
"headline": { "content": "Introducing our new trail running collection" },
"body": { "content": "Built for the mountains. Tested on every terrain." },
"image": { "url": "https://cdn.acme-example.com/trail-hero.jpg", "width": 1200, "height": 628 },
"click_url": { "url": "https://acme-example.com/trail-running" }
}
},
"inputs": [
{ "name": "Running community", "context_description": "Appears in r/trailrunning feed between user posts" },
{ "name": "General feed", "context_description": "Appears in home feed between mixed content" }
]
}
プレビューレスポンスは各コンテキストでの広告の見え方を示します。バイヤーが他の場所ではプレビューできないコミュニティ固有のクロームも含まれます。これがプラットフォームがシンプルなフォーマットでも preview_creative を実装すべき理由です。プラットフォームのクロームが差別化要素となるからです。
プラットフォームのマッピング
既存の広告サーバーやクリエイティブ管理プラットフォームをラップする場合、このセクションでは一般的なプラットフォームの概念がクリエイティブプロトコルにどう対応するかを示します。
概念のマッピング
| プラットフォームの概念 | AdCP の対応 | 備考 |
|---|
| 広告主 / アカウント | アカウント(accounts protocol 経由) | バイヤーはライブラリへのクエリ前にアクセスを確立する |
| クリエイティブコンセプト / グループ / テンプレートフォルダ | list_creatives の concept_id | サイズ/フォーマットをまたいだ関連クリエイティブをグループ化(Flashtalking のコンセプト、Celtra のキャンペーンフォルダ、CM360 のクリエイティブグループ) |
| クリエイティブ | list_creatives レスポンスのクリエイティブアイテム | |
| クリエイティブタイプ + サイズ | format_id(agent_url, id, 寸法を持つ構造化オブジェクト) | AdCP はタイプとサイズを単一のフォーマット参照に統合 |
| テンプレート(Celtra の用語) | フォーマット(list_creative_formats 経由) | Celtra のテンプレートは構造と利用可能なプロパティを定義、AdCP のフォーマットは構造と利用可能なアセットを定義 |
| テンプレートオブジェクトプロパティ(Celtra) | variables 配列 | 型付きの名前付きスロット(text, color, image, video, number, boolean)— ほぼ完全な対応 |
| Active / archived / pending | status フィールド | |
| 広告タグ / サービングタグ | クリエイティブマニフェスト内のアセット(html, javascript, または vast タイプ) | タグは単なるアセット — 特別な概念なし |
| プレースメント / 広告ユニット | メディアバイ内のパッケージ | クリエイティブがアサインされる購入コンテキスト |
| DCO 変数 / 動的フィールド | variables 配列(include_variables=true 経由) | 型とデフォルト値を持つ名前付きスロット |
| データフィード / ターゲティングルール | モデル化なし | AdCP は変数のスロットをモデル化するが、最適化ルールはモデル化しない |
| CTV/OTT 広告サーバー(Innovid、Brightcove) | 広告サーバーと同様、さらに VAST/SSAI 配信モデルを追加 | vast タイプのアセットに VAST タグ。コンパニオン広告はマルチレンダーフォーマット経由 |
タグ生成モデル
広告サーバーによってサービングタグの生成方法は異なります。クリエイティブプロトコルの build_creative は creative_id、target_format_id、オプションの media_buy_id/package_id の組み合わせにより、一般的なモデルすべてに対応します。
ユニバーサルタグ(Celtra、Flashtalking)— 複数の環境(Web、アプリ内)に適応する単一タグ。プレースメントコンテキスト不要 — build_creative(creative_id, target_format_id) でトラフィック先を問わず動作するタグを生成。最終的なトラフィック先が予測しにくいエージェンシー/プログラマティック用途に最適で、トラフィッキングエラーを削減。
シングルプレースメントタグ(Celtra、Flashtalking、CM360)— 特定のサイズとプレースメントにスコープされたタグ。target_format_id で正確な寸法(例: 300x250 Web)を指定。トラフィック先が既知のパブリッシャーテンプレートのユースケースで最も一般的。
マルチプレースメントタグ(Celtra)— 1 つの環境で複数のサイズをカバーするタグ。target_format_id はサポートするサイズを renders 配列で定義するフォーマットを参照。複数のサイズ(例: 300x250 + 320x50 + 728x90 Web)が必要だが単一タグでトラフィックしたいパブリッシャーテンプレートに便利。
プレースメントレベルタグ(CM360)— プラットフォームがクリエイティブではなくプレースメントごとにタグを生成。呼び出し元は media_buy_id とオプションの package_id でトラフィッキングコンテキストを提供。CM360 アダプターはメディアバイコンテキストを使用してターゲットフォーマットにスコープされたタグを生成。
モデルの選択はキャンペーンコンテキストの判断であることが多く、プラットフォームの制約ではありません。同じクリエイティブエージェントが呼び出し元のニーズに応じて異なるタグタイプを生成する場合があります。
| ユースケース | タグタイプ | build_creative パラメータ |
|---|
| エージェンシー/プログラマティック(トラフィック先不明) | ユニバーサル | creative_id + target_format_id(ユニバーサルフォーマット) |
| パブリッシャーテンプレート(プレースメント既知) | シングルプレースメント | creative_id + target_format_id(特定サイズ) |
| パブリッシャーテンプレート(複数サイズ) | マルチプレースメント | creative_id + target_format_id(マルチレンダーフォーマット) |
| トラフィッキングコンテキストのある広告サーバー | プレースメントレベル | creative_id + target_format_id + media_buy_id + package_id |
すべてのケースで出力は同じです: html または javascript アセットにサービングコードを持つクリエイティブマニフェスト。
変数モデル
プラットフォームによって動的コンテンツの表現方法は異なります。クリエイティブプロトコルの variables 配列は一般的なパターンに対応します。
名前付き変数スロット(Flashtalking)— 各クリエイティブは ID、名前、型を持つ明示的な変数を持ちます。creative-variable.json に直接マッピング。
テンプレートオブジェクトプロパティ(Celtra)— テンプレートは特定のコンポーネントとサイズバリアントにスコープされた型付き properties(text, color, image, video, percentage, hidden)を持つ templateObjects を定義します。Celtra アダプターはこれらを variables 配列にフラット化し、テンプレートオブジェクトラベルとプロパティラベルを使って variable_id と name を構築します。
ルールベースのアセット選択(CM360)— 動的クリエイティブはデータフィードから供給されるターゲティングルールを持つ dynamicAssetSelection を使用します。このモデルは変数ベースではなく — CM360 アダプターは通常 variables 配列を持たず、has_variables フィルタリングは適用されない。
マクロ処理
プラットフォームは内部で独自のマクロ構文を使用します。build_creative の macro_values パラメータにより、呼び出し元はユニバーサルマクロ値(例: CLICK_URL)を渡し、クリエイティブエージェントがプラットフォームのネイティブ構文に変換して出力タグに代入します。
| ユニバーサルマクロ | CM360 相当 | Flashtalking 相当 |
|---|
CLICK_URL | %c | [clickTag] |
CACHEBUSTER | %n | [timestamp] |
TIMESTAMP | %t | [timestamp] |
クリエイティブエージェントが変換を処理するため、呼び出し元は常にユニバーサルマクロを使用します。
拒否後の再提出
sync_creatives またはクリエイティブレビューで拒否が発生した場合、修正と再提出のフローはアップサートセマンティクスを使用します。
list_creatives(ライブラリの status: "rejected")または get_media_buys(パッケージの approval_status: "rejected" と rejection_reason)で拒否理由を確認します
- クリエイティブを修正する(アセットの更新、コピーの調整、メディアの差し替え)
- 同じ
creative_id で sync_creatives を再提出 — エージェントは既存のクリエイティブを更新してレビューを再トリガーします
status が pending_review から approved または rejected に変わるまで list_creatives をポーリングします
再提出はレビュークロックをリセットします。エージェントは更新されたクリエイティブをレビュー目的の新しい提出として扱います。
実装するタスクの選択
クリエイティブプロトコルはすべてのクリエイティブエージェントに list_creative_formats と preview_creative を要求します。次の表は各プラットフォームタイプが実装すべき追加タスクと機能を示します。
| プラットフォームタイプ | コアタスク | 推奨タスク | 機能 |
|---|
| クリエイティブライブラリのある広告サーバー(CM360、Flashtalking) | list_creative_formats, preview_creative | list_creatives, sync_creatives, build_creative | has_creative_library: true |
| クリエイティブ管理プラットフォーム(Celtra) | list_creative_formats, preview_creative | list_creatives, sync_creatives, build_creative | has_creative_library: true, supports_transformation: true |
| 生成系クリエイティブツール | list_creative_formats, preview_creative | build_creative | supports_generation: true |
| フォーマット変換サービス | list_creative_formats, preview_creative | build_creative | supports_transformation: true |
| クリエイティブ機能のあるセールスエージェント | list_creative_formats, preview_creative | sync_creatives(assignments 付き), get_creative_delivery, build_creative | supports_generation: true または has_creative_library: true |
バイヤーエージェントが試行錯誤なしに正しいインタラクションモデルを判断できるよう、get_adcp_capabilities でこれらの機能を宣言してください。仕様のインタラクションモデルを参照。
クリエイティブライブラリを持つプラットフォームは、バイヤーがクエリ前にアクセスを確立できるよう accounts protocol も実装すべきです。これはセールスエージェントがメディアバイで使用するのと同じ accounts protocol です。
関連ドキュメント