仕組み
セールスエージェントはget_adcp_capabilities でクリエイティブプロトコルのサポートを宣言する:
inline_creative_management(購入時にパッケージにクリエイティブを付与するメディアバイ機能)とクリエイティブプロトコルサポートは独立していることに注意。セールスエージェントはどちらか一方または両方をサポートできます。
inline_creative_management は create_media_buy でクリエイティブをパッケージに直接付与することを許可する — クリエイティブは購入注文とともに移動します。クリエイティブプロトコルサポート(supported_protocols の "creative")は、エージェントが build_creative、list_creative_formats、sync_creatives などのクリエイティブタスクを実装することを意味します。セールスエージェントはクリエイティブプロトコルを実装せずにインラインクリエイティブ管理をサポートする場合がある(バイヤーは外部でクリエイティブを管理し、購入で参照するだけ)、またはインライン管理なしでクリエイティブプロトコルを実装する場合もある(クリエイティブはパッケージに割り当てる前に sync_creatives で別途同期されます)。
バイヤーはすべてのタスク — メディアバイとクリエイティブ — を同じエージェント URL で呼び出す。タスクが属するプロトコルがスキーマを決定し、エージェントのタイプは関係ありません。
利用可能なクリエイティブタスク
セールスエージェントがsupported_protocols に "creative" を宣言すると、任意のクリエイティブプロトコルタスクを実装できる:
| タスク | 実装するタイミング |
|---|---|
list_creative_formats | 常に — バイヤーがサポートされているフォーマットを発見する必要がある |
sync_creatives | エージェントがクリエイティブライブラリをホストする場合。セールスエージェントはクリエイティブとパッケージの一括マッピングのために assignments フィールドをサポートすべきです。 |
list_creatives | バイヤーがライブラリを参照する必要がある場合 |
build_creative | エージェントがクリエイティブを生成または変換する場合 |
preview_creative | エージェントがプレビューをレンダリングできる場合 |
get_creative_delivery | エージェントがバリアントレベルの配信データを報告できる場合 |
クリエイティブレビュー
クリエイティブを受け取るセールスエージェント —create_media_buy のインライン付与または sync_creatives 経由 — は、配信前にクリエイティブレビューを実施する場合があります。これは、クリエイティブがポリシーコンプライアンス、マルウェア、またはブランドセーフティ違反のためにスキャンされる実際のパブリッシャーおよび SSP ワークフローを反映しています。
クリエイティブレビューの状態は2つのレベルでサーフェスされます:
- クリエイティブライブラリ:
list_creativesの各クリエイティブのstatusフィールドはクリエイティブステータス列挙型を使用します:processing、pending_review、approved、rejected、archived。 - パッケージレベル:
get_media_buysレスポンスの各クリエイティブのapproval_statusフィールドはクリエイティブ承認ステータス列挙型を使用します:pending_review、approved、または人間が読める説明付きのrejected。却下されたクリエイティブにはrejection_reasonが含まれます。
approved でも、プレースメント固有のポリシーに違反する場合はパッケージレベルで rejected になる可能性がある(例: オーディオのみのプレースメントでのビデオクリエイティブ)。
バイヤーは、特に厳格なクリエイティブポリシーを持つパブリッシャーの場合、新しいクリエイティブを含むメディアバイを同期または提出した後、list_creatives または get_media_buys をポーリングすべきです。
配信時にセラーが生成する生成フォーマットの場合、クリエイティブレビューは個々のクリエイティブではなくブリーフとブランドアイデンティティに適用されます。セラーはブリーフの制約とブランドアセットが生成が始まる前にポリシーを満たしているかを検証します。
プラットフォームとコミュニティガイドライン: ソーシャルプラットフォーム、UGC サイト、コミュニティ主導のパブリッシャーは、標準的な広告ポリシーを超えたコンテンツポリシー(例: コミュニティスタンダード、プロモートコンテンツガイドライン、カテゴリ固有の制限)を執行することが多い。これらのプラットフォーム固有のポリシーは同じ rejection_reason フィールドを通じてサーフェスされる — バイヤーはそれらを処理するために別のメカニズムを必要としません。コミュニティガイドライン違反でクリエイティブが却下された場合、rejection_reason はどのポリシーが違反されたかを説明し、バイヤーが修正して再提出できるようにします。
生成クリエイティブの実装チェックリスト
生成クリエイティブを提供するセールスエージェントは以下を行うべきだ:-
ケイパビリティを宣言する
get_adcp_capabilitiesで:- クリエイティブケイパビリティの
supports_generation: true supported_protocolsの"creative"- クリエイティブがメディアバイとともに移動する場合は
inline_creative_management: true
- クリエイティブケイパビリティの
-
list_creative_formatsを通じて生成フォーマットを定義する —format_id.agent_urlが自分のエージェントを指します。記述的なフォーマット名とアセット要件(最低限briefアセット)を含めます。 -
preview_creativeを実装する — フライト前レビューのための代表的なプレビューを返します。バイヤーが異なる配信時の条件をシミュレートできるようcontext_descriptionインプットをサポートします。会話型フォーマットの場合、サンドボックステスト用のinteractive_urlを含めます。 -
get_creative_deliveryを実装する — 何が生成され配信されたかを示すバリアントマニフェストを返します。バリアントごとのgeneration_context(context_type、topic、device_class)と配信メトリクスを含めます。バリアント保持を計画する: フライト後の監査のために少なくとも 90 日間のバリアントデータを保持します。 -
購入時にブリーフを検証する — バイヤーが
create_media_buyでブリーフを提出する際、ブリーフの制約(ブランドアイデンティティ、ガードレール、必須開示)が生成ケイパビリティと互換性があることを検証します。そうでない場合は明確なエラーで拒否します。 -
ブリーフのクリエイティブレビューを処理する — 生成フォーマットでは、レビューは個々のクリエイティブではなくブリーフとブランドアイデンティティに適用されます。
get_media_buysのパッケージのapproval_statusを通じてレビュー状態を伝える。
セールスエージェントの生成フォーマット
配信時にクリエイティブを生成するセラー — コンテキスト広告、ページマッチドディスプレイ、AI 生成ネイティブ — は独自の生成フォーマットをホストします。format_id.agent_url はセールスエージェント自体を指す:
list_creative_formats を通じてこのフォーマットを発見し、メディアバイ作成時にブリーフを提供します:
build_creative 呼び出しは不要 — ブリーフはメディアバイとともに移動します。
規制対象カテゴリ(金融サービス、製薬)の場合、エージェントのクリエイティブケイパビリティで supports_compliance: true を確認します。コンプライアンス対応エージェントは生成中に必須開示と規制要素を検証する — エージェントが執行できるよう、ブリーフにコンプライアンス要件を含めます。
生成出力のプレビュー
生成フォーマットでは、preview_creative は2つの目的を果たす:
キャンペーン前 — ブリーフマニフェストと context_description インプットを渡して、エージェントが生成できるものの代表的なサンプルを確認します:
quality: "draft" を使用し、ステークホルダーレビューには quality: "production" を使用します。これらのプレビューは例示的なもの — 実際の出力は配信時のライブシグナルに依存します。プレビューはアクティブなメディアバイを必要としない — create_media_buy を呼び出す前にプレビューできます。
キャンペーン後 — get_creative_delivery の variant_id を渡して、実際に配信されたものを再生する:
配信レポート
両プロトコルを実装するセールスエージェントは、配信データの2つの補完的なビューを提供します:| タスク | プロトコル | 提供する内容 |
|---|---|---|
get_media_buy_delivery | メディアバイ | どこで、どれだけ: インプレッション、支出、プレースメントデータ、オプションの by_creative ブレークダウン |
get_creative_delivery | クリエイティブ | 何が実行されたか、どのように: バリアントマニフェスト、生成コンテキスト、バリアントレベルのメトリクス |
media_buy_id と creative_id を結合キーとして使用して、両レスポンスのデータを関連付ける。
生成フォーマットでは、get_creative_delivery がバイヤーが実際に生成されたものを見る場所です。各バリアントにはマニフェスト(実際のレンダリングされたクリエイティブ — ヘッドラインテキスト、画像 URL、フォーマット)と生成コンテキスト(ページトピックやデバイスクラスなど、生成をトリガーしたシグナル)が含まれます。get_media_buy_delivery は支出、ペーシング、次元ブレークダウンを含む集計ビューを提供します。
例: セールスエージェントのバリアントレベルレポート
別のクリエイティブエージェントを使う場合
以下の場合、別のクリエイティブエージェントが適している:- クリエイティブサービスがセラーから独立している — クリエイティブ管理プラットフォーム、広告サーバー、フォーマット変換サービス
- 複数のセラーが同じクリエイティブを配信する必要がある — バイヤーが1か所でクリエイティブを管理して配布します
- バイヤーがセラー間で集中型クリエイティブアナリティクスを望む
ケイパビリティの発見
バイヤーはget_adcp_capabilities を確認して、セールスエージェントがサポートしているものを理解する:
関連ドキュメント
- クリエイティブ仕様 — クリエイティブエージェントのプロトコル要件
- クリエイティブエージェントの実装 — スタンドアロンクリエイティブエージェントの実装ガイド
- 生成クリエイティブ — AI 駆動生成のための
build_creativeの使用 - get_creative_delivery — バリアントレベルの配信レポート
- get_media_buy_delivery — メディアバイ配信レポート