Skip to main content
AdCP 3.0 はプロトコルをメディアバイを超えて、ブランドアイデンティティ、ガバナンス、メディアプランニング、会話型ブランド体験まで拡張します。

一覧

エリアv2.xv3.x
プロトコルスコープメディアバイ、シグナル、クリエイティブブランドプロトコル、ガバナンス、スポンサードインテリジェンスを追加
ブランドアイデンティティ標準的なメカニズムなしbrand.json + コミュニティブランドレジストリ
ガバナンスブランドスーツアビリティプロトコルなしプロパティリスト、コンテンツスタンダード、キャンペーンガバナンス、ポリシーレジストリ、ブランドキャリブレーション
スポンサードインテリジェンス会話型ブランドプロトコルなしAI アシスタントでの同意優先ブランドセッション
アカウントプロトコル正式なアカウントモデルなし名前付きプロトコルレイヤー: sync_accountslist_accountsreport_usage、ブランドレジストリに基づくアイデンティティ
カタログpromoted_offerings クリエイティブアセット13のカタログタイプを持つファーストクラスの sync_catalogs タスク
メディアプランニングプロダクトのみ予算配分 + デリバリー予測を持つプロポーザル
ブランド権利ライセンスプロトコルなしHMAC 認証 Webhook を持つ get_rightsacquire_rightsupdate_rights
ビジュアルガイドライン構造化されたブランドビジュアルなしジェネラティブクリエイティブシステム向け brand.jsonvisual_guidelines
クリエイティブワークフロー基本的なビルド / プレビュー / シンクの分離インラインプレビュー、マルチフォーマット build_creative、ライブラリ取得、品質ティア、カタログ item_limit
クリエイティブライブラリメディアバイ中心のクリエイティブ読み書きlist_creatives / sync_creatives をクリエイティブプロトコル操作として、supports_generationsupports_transformationhas_creative_library の探索も追加
クリエイティブガバナンスクリエイティブ評価プロトコルなしセキュリティスキャン、品質、コンテンツ分類のための get_creative_features
ディスクロージャーマッチング位置のみのディスクロージャー処理位置 + 持続性を考慮したディスクロージャーマッチング(continuousinitialflexible
番組とエピソードコンテンツプログラミングモデルなし配信 ID、エピソードライフサイクル、ブレークベースのインベントリを持つプロダクトの shows
プランニングの利便性time_budgetpreferred_delivery_typesexclusivity、パッケージレベルフライトなしtime_budget + incompletepreferred_delivery_typesexclusivity、オプションの delivery_measurement、パッケージレベルの start_time / end_time
チャンネルモデル9チャンネル20のプランニング指向チャンネル(sponsored_intelligence を含む)
ケイパビリティ探索エージェントカード拡張ランタイム get_adcp_capabilities タスク
サンドボックス探索機能位置が混在認証モデルに require_operator_auth、サンドボックスサポートに account.sandbox
クリエイティブアサインメントシンプルな ID 配列プレースメントターゲティング付きのウェイト付きアサインメント
ジオターゲティング暗黙的な米国中心明示的な名前付きシステム(グローバル)
キーワードターゲティングキーワードサポートなしマッチタイプと入札価格を持つ keyword_targets
最適化単一の最適化目標メトリックとイベントタイプを持つマルチゴール optimization_goals 配列
デリバリーレポーティング集計デリバリーのみオプトインのディメンションブレークダウン(ジオ、デバイス、オーディエンス、プレースメント、キーワード)
シグナル価格シンプルな CPM構造化された価格モデル(CPM、メディア費用の割合、固定料金)
デバイスターゲティングフォームファクターターゲティングなしdevice_platform(OS)とは別の device_type(デスクトップ、モバイル、タブレット、ctv、dooh、unknown)
近接ターゲティングポイントベースのジオターゲティングなし移動時間、半径、GeoJSON メソッドを持つ geo_proximity
リファインメントproposal_id を持つ自由テキストセラーの承認付きの型指定された変更リクエスト配列
エラー処理構造化されていないエラーrecovery フィールド(transient、correctable、terminal)+ 18の標準エラーコード
AI プロベナンスプロベナンスモデルなしIPTC ソースタイプ、C2PA 参照、規制ディスクロージャーを持つ provenance オブジェクト
クリエイティブコンプライアンスブリーフでのコンプライアンスなしrequired_disclosuresprohibited_claims、ディスクロージャー位置
エージェント利便性毎回フルペイロードfields プロジェクション、オプトインブレークダウン、プリフライトケイパビリティフィルタリング
シグナルライフサイクルアクティベートのみactivate_signal での activate / deactivate アクション

新機能

ブランドプロトコル

/.well-known/brand.json によるバイサイドアイデンティティ。パブリッシャーが adagents.json でプロパティと認証済みエージェントを宣言するのと同様に、ブランドは brand.json でアイデンティティ、ブランド階層、認証済みオペレーターを宣言します。
セルサイドバイサイド
パブリッシャーハウス(企業エンティティ)
プロパティブランド(広告アイデンティティ)
adagents.jsonbrand.json
4つのバリアント: House Portfolio(完全なブランド階層をインライン)、Brand Agent(MCP 経由で動的)、House Redirect(サブブランドからハウスドメインへ)、Authoritative Location(ホストされた URL)。 任意のドメインが与えられると、プロトコルは正規ブランドに解決する:
shoes.novabrands.example.com
  -> fetch /.well-known/brand.json
  -> { "house": "novabrands.example.com" }
  -> fetch novabrands.example.com/.well-known/brand.json
  -> search brands[] for property matching "shoes.novabrands.example.com"
  -> Result: { house: "novabrands.example.com", brand_id: "nova_athletics" }
ユースケース: クリエイティブ生成(ドメインをブランドアイデンティティに解決)、ブランド検証(authorized_operators を確認)、レポーティングロールアップ(キャンペーンをハウスでグループ化)。

ブランドプロトコル

brand.json バリアント、解決フロー、ブランドアイデンティティを含む完全な仕様。

ブランド権利ライフサイクル

ブランドとコンテンツオーナー間のライセンスと使用権のための3つのタスク:
タスク目的
get_rightsブランドのコンテンツで利用可能な権利を発見する
acquire_rights権利取得を要求・交渉する
update_rightsアクティブな権利を変更する(延長、制限、取り消し)
権利にはジェネレーション資格情報(ライセンスされたコンテンツにアクセスするための API キーまたはトークン)、クリエイティブ承認 Webhook(クリエイティブがレビューに提出されたときの HMAC-SHA256 認証コールバック)、取り消し通知が含まれます。プロトコルは実行可能な拒否(修正して再送信)と最終的な拒否(再試行しない)を区別します。 brand.json の構造化された visual_guidelines は権利を補完し、ジェネラティブクリエイティブシステムに写真スタイル、グラフィック要素、構成、モーション、ロゴ配置、カラーウェイ、タイプスケール、制限のための構造化ルールを提供します。

ブランド権利

権利の発見、取得、管理のタスクリファレンス。

番組とエピソード

プロダクトはポッドキャスト、TV シリーズ、YouTube チャンネルなどの永続的なコンテンツプログラムを shows で参照できるようになりました。showspublisher_properties と同じパブリッシャースコープのセレクターパターンに従う。番組はパブリッシャーの adagents.json で宣言され、プロダクトはパブリッシャードメインと番組 ID で参照します。バイヤーは adagents.json から完全な番組オブジェクトを解決します。番組にはクロスセラーマッチングのための配信識別子、エピソードライフサイクル状態(scheduled、tentative、live、postponed、cancelled、aired、published)、ブレークベースの広告インベントリ設定、brand.json へのタレントリンク、国際コンテンツレーティングシステムが含まれます。 番組は関係(スピンオフ、コンパニオン、続編、前編、クロスオーバー)と派生コンテンツ(クリップ、ハイライト、リキャップ)をサポートし、包括的なコンテンツモデリングを実現します。

番組とエピソード

番組スキーマ、エピソードライフサイクル、ブレークベースのインベントリを含む完全な仕様。

レジストリ API

AgenticAdvertising.org レジストリはブランドとプロパティの解決、エージェント探索、認証検証のためのパブリック REST API を提供します。ほとんどのエンドポイントは認証不要です。
ケイパビリティエンドポイント説明
ブランド解決/api/brands/resolveドメインを正規ブランドに解決する
プロパティ解決/api/properties/resolveパブリッシャードメインをプロパティ情報に解決する
エージェント探索/api/registry/agentsケイパビリティを持つ登録エージェントをリストする
認証チェック/api/registry/validate/property-authorizationリアルタイムの認証検証
検索/api/searchブランド、パブリッシャー、プロパティを横断して検索する
コミュニティブランド/api/brands/saveブランドデータを提供する(認証必要)
レジストリはプロトコルを補完する: REST API でエンティティを解決し、MCP/A2A タスクでトランザクションを実行します。

レジストリ API

認証とレート制限を含む完全なエンドポイントリファレンス。

プロポーザルとデリバリー予測

パブリッシャーはプロダクトと共にプロポーザル(バイヤーが create_media_buy で直接実行できるパーセンテージベースの予算配分を持つ構造化メディアプラン)を返せる。プロポーザルはパブリッシャーの専門知識を体現し、アドホックなプロダクトリストを実行可能な購買戦略に置き換える。セッション継続性によりリファインメントができる — 同じセッション内での後続の get_products 呼び出しが会話履歴を引き継ぐ。 デリバリー予測はプロポーザルと配分に付属します。各予測には支出が増えるにつれてデリバリーがどのようにスケールするかを示すメトリック範囲(low/mid/high)を持つ予算ポイントが含まれます。3つの予測メソッド: estimate(大まかな近似)、modeled(予測モデル)、guaranteed(契約でコミット済み)。予測はデリバリーメトリック(インプレッション、リーチ、GRP)と成果(購入、リード、アプリインストール)を予測できます。TV とラジオの予測は GRP ベースのプランニングのために demographic_systemdemographic を使用します。

プロポーザルと予測

予算カーブ、CTV、リテールメディア、放送オーディオの例を含む完全なドキュメント。

アカウント

v2 からの移行? アカウントは v3 で完全に新しく、移行元の v2 に相当するものはない。セットアップガイドとしてアカウントとエージェントを参照。
sync_accounts によるバイヤーとセラー間の正式な請求関係。 4つのエンティティ:
エンティティ問い識別方法
ブランド誰の製品を広告するか?brand.json 経由のハウスドメイン + brand_id
アカウント誰が請求されるか?アカウント参照list_accounts からの account_id または自然キー
オペレーター誰がブランドの代わりに操作するか?ドメイン(例: acmeagency.example.com
エージェントどのソフトウェアが購買を行うか?認証済みセッション
2つの請求モデル: operator(オペレーターまたはブランドが直接購買して請求されます)と agent(エージェントが請求を統合)。2つの信頼モデル: エージェント信頼(デフォルト、エージェントがブランド/オペレーターを宣言)とオペレータースコープ(セラーがオペレーターレベルの資格情報を要求)。 ワークフロー: get_adcp_capabilities -> sync_accounts -> account 付きの get_products -> account 付きの create_media_buy

アカウントプロトコル

アカウントプロトコルの概要: アイデンティティ検証、請求モデル、決済。

カタログ

sync_catalogs によるファーストクラスのカタログライフサイクル。13のカタログタイプ: 構造的(offeringproductinventorystorepromotion)と業界垂直型(hotelflightjobvehiclereal_estateeducationdestinationapp)。垂直型には Google Ads、Meta、LinkedIn、Microsoft フィード仕様から引用した正規のアイテムスキーマがあります。 フォーマットは必要なカタログを catalog_requirements で宣言します。クリエイティブはアセットにアイテムを埋め込む代わりに、catalog_id で同期されたカタログを参照します。カタログはアトリビューション整合のために conversion_eventscontent_id_type を宣言します。

カタログ

カタログタイプ、同期ワークフロー、フォーマット要件、コンバージョンイベントを含む完全なドキュメント。

ケイパビリティ探索

get_adcp_capabilitiesadcp-extension.json と MCP エージェントカードの両方をランタイムケイパビリティ探索に置き換える。サポートされるプロトコル、アカウント請求モデル、ポートフォリオ情報、ターゲティングシステム、ガバナンス機能を返す — すべてスキーマ検証済み。
エージェントカードと adcp-extension.json はもはや不要です。 バイヤーは adagents.json でセラーを発見し、ランタイムに get_adcp_capabilities を呼び出す。エージェントカード拡張からケイパビリティデータを読んでいる v2 インテグレーションがある場合は、get_adcp_capabilities に切り替えること。

get_adcp_capabilities

リクエスト/レスポンススキーマを含む完全なタスクリファレンス。

ガバナンスプロトコル

ブランドスーツアビリティとインベントリキュレーション。ガバナンスエージェントはプロパティリスト(ターゲティングまたは除外のためのプロパティのキュレートされたセット)とコンテンツスタンダード(カテゴリごとのブロック/許可ルールを持つブランドスーツアビリティポリシー)を管理します。バイヤーはフィルタリングされたインベントリ探索のために get_products にプロパティリストを渡し、ブランドとガバナンスエージェント間の共同調整のために calibrate_content を使用します。ガバナンスエージェントはクリエイティブポリシーで provenance_required を強制でき、プロベナンスクレームの verification 配列を介したサードパーティ AI コンテンツ検証をサポートします。 キャンペーンガバナンスは sync_planscheck_governancereport_plan_outcomeget_plan_audit_logs によるプランレベルのポリシーと予算執行でこれを拡張します。ガバナンスエージェントは auditadvisoryenforce モードで動作でき、委譲された権限に対してセラーサイドのアクションを検証し、共有ポリシーレジストリを通じて標準化されたポリシーを解決します。

ガバナンスプロトコル

プロパティリスト、コンテンツスタンダード、キャリブレーションを含む完全な仕様。

スポンサードインテリジェンスプロトコル

AI アシスタントでの会話型ブランド体験。SI は AI アシスタントが会話の流れを断ち切ることなく、リッチなエンゲージメント(テキスト、音声、UI コンポーネント)のためにブランドエージェントをどのように呼び出すかを定義します。セッションは同意優先モデルに従う: ユーザーが興味を表明し、同意を付与すると、ブランドエージェントがオプションのトランザクション引き渡しとともに会話的にエンゲージします。

SI チャットプロトコル

セッションライフサイクル、エージェントの実装、ホストの実装を含む完全な仕様。

データプロバイダーのシグナルカタログ

データプロバイダーはパブリッシャーがプロパティを宣言するのと同じパターンに従い、adagents.json でシグナルカタログを公開できます。
パブリッシャーデータプロバイダー
プロパティを宣言するシグナルを宣言する
property_ids / property_tags を使用signal_ids / signal_tags を使用
バイヤーは publisher_domain で検証するバイヤーは data_provider_domain で検証する
シグナルは型付きターゲティングを持つ明示的な value_type(バイナリ、カテゴリ、数値)と、データプロバイダーのカタログを参照する構造化された signal_id オブジェクトを持ちます。

データプロバイダーガイド

シグナルカタログ公開のための完全な実装ガイド。

rc.1 から rc.2 のハイライト

このページは v2 → v3 の全シフトをカバーします。すでに 3.0.0-rc.1 を採用している場合、アップグレード前に確認すべき最も重要な rc.2 の変更点は以下のとおり。

クリエイティブワークフローとライブラリの変更

build_creative はインラインプレビュー(include_preview)、マルチフォーマット出力(target_format_ids)、品質ティア、カタログ駆動の item_limit、オプションの concept_idmedia_buy_idpackage_idmacro_values を持つ creative_id を使ったライブラリ取得をサポートします。preview_creative も品質コントロールを追加します。クリエイティブライブラリ操作は明示的にクリエイティブプロトコルタスクになった: list_creativessync_creatives はクリエイティブライフサイクルの残りとともにあり、ケイパビリティ探索はバイヤーが意図的にリクエストをルーティングできるように supports_generationsupports_transformationhas_creative_library を追加します。

プランニング、アカウント、サンドボックスの改良

account_resolution が削除され、バイヤーは require_operator_auth を使って認証とアカウントモデルを判定します。サンドボックスサポートは account.sandbox に移動し、サンドボックスは暗黙的なアカウントフローの自然なアカウントキーに参加できます。プロダクト探索は preferred_delivery_typesexclusivitytime_budget を追加し、セラーがリクエストされた予算内で完了できない場合はレスポンスに incomplete を返します。パッケージとプロダクト配分はパッケージレベルの start_time / end_time を持てるようになり、delivery_measurement はプロダクトでオプションになりました。

コンプライアンスとガバナンスの改良

クリエイティブコンプライアンスに位置と期間に加えてディスクロージャー持続性のセマンティクスが含まれ、フォーマットが強制できる持続性モードを宣言できるようになりました。キャンペーンガバナンスも rc.2 で sync_planscheck_governancereport_plan_outcomeget_plan_audit_logs、正規のプラン抽出のための governance_context とともに追加されました。 網羅的な rc.2 の変更リストはリリースノートCHANGELOG.md を参照。

破壊的変更

メディアチャンネルタクソノミー

v2 の 9 チャンネルが 20 のプランニング指向チャンネルに置き換えられます。5つのチャンネルはそのまま(displaysocialctvpodcastdooh)。残りの4つは分割、削除、または名前変更されました。
チャンネル値を読み書きするすべてのコードを更新する必要があります。
v2 チャンネルv3 チャンネル注記
displaydisplay変更なし
videoolvlinear_tvcinema配信コンテキストで分割(ctv は v2 ですでに別)
audioradiostreaming_audio配信で分割(podcast は v2 ですでに別)
native削除フォーマットレベルのプロパティを使用する
socialsocial変更なし
ctvctv変更なし
podcastpodcast変更なし
doohdooh変更なし
retailretail_media明確化のために名前変更
v3 の新チャンネル(v2 に相当なし): searchlinear_tvradiostreaming_audiooohprintcinemaemailgamingretail_mediainfluenceraffiliateproduct_placementsponsored_intelligence
gaming チャンネルはゲーム内インリンシック広告、リワード動画、プレイアブル広告をカバーします。ゲームアプリのリワード動画は olv に分類することもできる — インベントリがゲーミング予算から来る場合は gaming を使用します。

チャンネルの詳細

各 v2 チャンネル、マルチチャンネルプロダクト、ケイパビリティ探索の例を含む完全なマッピングガイド。

価格オプションフィールドの名前変更

v3 はハード制約(パブリッシャーが適用する価格)とソフトヒント(過去のパーセンタイル)を分離します。fixed_ratefixed_price になり、price_guidance.floor はトップレベルの floor_price に移動します。
v2 フィールドv3 フィールド注記
fixed_ratefixed_price明確化のために名前変更(レートではなく価格)
price_guidance.floorfloor_priceハード制約としてトップレベルに移動
これらのフィールドは標準的なディールタイプにマッピングされます: fixed_price はプログラマティックギャランティード(PG)とプリファードディールに、floor_price はプライベートマーケットプレイス(PMP)オークションに対応します。オープンオークションインベントリは両方のフィールドを省略します。

価格の詳細

固定価格とオークションの例、価格ガイダンスのスキーマ、フラットレート価格、最低支出、移行期間の対応。

ウェイト付きクリエイティブアサインメント

creative_ids 文字列配列がデリバリーウェイト付けとプレースメントターゲティングをサポートする creative_assignments オブジェクトに置き換えられます。
v2 フィールドv3 フィールド
creative_ids(文字列配列)creative_assignmentscreative_idweightplacement_ids を持つオブジェクト配列)

クリエイティブの詳細

ウェイト付きアサインメント、プレースメントターゲティング、統合 assets 配列によるアセット探索、繰り返し可能なグループ、フォーマットカード。

名前付きシステムによるジオターゲティング

メトロと郵便ターゲティングには明示的なシステム仕様が必要になり、グローバル市場をサポートします。値は { "system": "...", "values": [...] } オブジェクトを使ってシステムでグループ化されます。
v2 フィールドv3 フィールド
geo_metros(文字列配列)geo_metros(system/values オブジェクト)
geo_postal_codes(文字列配列)geo_postal_areas(system/values オブジェクト)
v3 はネガティブターゲティング(例: ニューヨーク DMA を除く米国をターゲット)のために geo_metros_excludegeo_postal_areas_exclude も追加します。

ジオターゲティングの詳細

メトロと郵便システムのリファレンステーブル、除外ターゲティング、ケイパビリティ探索、完全なターゲティング例。

その他のターゲティング変更

v3 はジオ以外にいくつかのターゲティングフィールドを追加します:
フィールド説明
daypart_targets時間帯と曜日のターゲティングウィンドウ
age_restriction制限コンテンツの年齢ゲーティング
device_platformOS ターゲティング(iOS、Android、Windows、tvOS など)
device_typeデバイスフォームファクターターゲティング(desktop、mobile、tablet、ctv、dooh、unknown)
languageコンテンツ言語ターゲティング
keyword_targets / negative_keywordsマッチタイプ(broad、phrase、exact)とキーワードごとの入札価格を持つ検索とリテールメディア向けキーワードターゲティング
device_type_excludeネガティブデバイスフォームファクターターゲティング
geo_proximity移動時間アイソクロン、半径、GeoJSON ジオメトリによるポイントベースの近接ターゲティング
これらのフィールドはオプションの追加 — v2 のフィールドを置き換えるものではありません。

統合アセット探索

フォーマットは assets_required の代わりに required ブールを持つ assets 配列を使用するようになりました。クリエイティブの詳細を参照。

カタログが promoted_offerings を置き換える

promoted_offerings クリエイティブアセットタイプと promoted_offering 文字列フィールドが削除されました。カタログは独自の同期ライフサイクル(sync_catalogs)、フォーマットレベルの要件(catalog_requirements)、コンバージョンイベント整合を持つファーストクラスのプロトコルオブジェクトになりました。
v2 フィールドv3 代替
promoted_offerings(クリエイティブアセット)クリエイティブマニフェストの catalogs フィールド
promoted_offering(メディアバイの文字列)削除 — brand + brief を使用する
promoted_offering(クリエイティブマニフェストの文字列)削除 — catalogs フィールドを使用する

カタログの詳細

変更前後の例、sync_catalogs ワークフロー、catalog_requirements の探索、移行チェックリスト。

ブランドアイデンティティの統一

インラインの brand_manifest オブジェクトがブランド参照(BrandRef)に置き換えられます。タスクスキーマはマニフェストをインラインで渡す代わりに { domain, brand_id } でブランドを参照します。ブランドデータは実行時に brand.json またはレジストリから解決されます。
v2/beta フィールドv3 rc.1 フィールド
brand_manifest(インラインオブジェクト)brand{ domain, brand_id }
影響: get_productscreate_media_buybuild_creative、プロパティリストスキーマ。

ブランドアイデンティティの詳細

BrandRef スキーマ、解決フロー、変更前後の例、移行ステップ。

プロダクトデリバリー予測

estimated_exposuresDeliveryForecast タイプを使った構造化された forecast フィールドに置き換えられます。
v2/beta フィールドv3 rc.1 フィールド
estimated_exposures(整数)forecast(期間、メトリック範囲、方法論を持つ DeliveryForecast)

バイイングモードによるプロポーザルリファインメント

proposal_idget_products リクエストから削除されました。リファインメントは型指定された変更リクエスト配列(型指定されたリファインメント参照)を持つ buying_mode: "refine" を使用します。セッション継続性(MCP では context_id、A2A では contextId)が呼び出し間で会話履歴を引き継ぐ。 proposal_id による create_media_buy でのプロポーザル実行は変更なし。
v2/beta フィールドv3 rc.1 フィールド
get_products リクエストの proposal_id削除 — buying_mode: "refine" を使用する

最適化目標の再設計

optimization_goal(単一オブジェクト)が optimization_goals(配列)に置き換えられます。各目標は kind による識別子付きユニオン:
v2/beta フィールドv3 rc.1 フィールド
optimization_goal(単一オブジェクト)optimization_goals(配列)
暗黙的な単一目標マルチゴール順序付けのための priority フィールド
2つの目標 kind:
  • metriccost_per または threshold_rate ターゲットを持つセラーネイティブのデリバリーメトリック(クリック、視聴、リーチ、エンゲージメントなど)
  • eventevent_sources 配列とオプションの value_field/value_factor を持つコンバージョントラッキング

最適化目標の詳細

目標 kind、リーチ最適化、マルチゴール優先度、プロダクトケイパビリティ、移行ステップ。

シグナル価格の再構造化

シグナルのレガシーの pricing: { cpm } オブジェクトが3つの価格モデルを持つ構造化された pricing_options 配列に置き換えられます。
v2/beta フィールドv3 rc.1 フィールド
pricing.cpm(数値)pricing_options[](価格モデルオブジェクトの配列)
3つのモデル: cpmpercent_of_media(オプションの max_cpm 付き)、flat_fee

シグナルの詳細

価格モデル、deliver_to のフラット化、使用状況レポート、移行ステップ。

シグナル deliver_to のフラット化

get_signals リクエストのネストされた deliver_to オブジェクトが2つのトップレベルフィールドに置き換えられます。
v2/beta フィールドv3 rc.1 フィールド
deliver_to.destinationsdestinations(トップレベル)
deliver_to.countriescountries(トップレベル)

AudienceMember external_id が必須に

external_id が uid-type 列挙値から AudienceMember の必須トップレベルフィールドに昇格します。すべてのメンバーはバイヤーが割り当てた安定した識別子と少なくとも1つのマッチング可能な識別子を持つ必要があります。

オーディエンスの詳細

変更前後の例、uid-type の変更、sync_audiences の使用、移行ステップ。

セラーの承認による型指定されたリファインメント

refineoverall/products/proposals のネストされたオブジェクトからフラットな型指定された配列に再設計されました。各エントリは scope で識別されます:
v2/beta フィールドv3 rc.1 フィールド
refine.overall(文字列){ "scope": "request", "ask": "..." } 配列エントリ
refine.products[].product_id{ "scope": "product", "id": "..." }
refine.products[].notesask フィールド
セラーは refinement_applied で応答する — 位置でマッチする配列で、各エントリが statusappliedpartialunable)とオプションの notes を報告します。

リファインメントの詳細

変更リクエストタイプ、セラーの承認、変更前後の例。

クリエイティブアサインメントの再構造化

SyncCreativesRequest.assignments{ creative_id: package_id[] } マップから明示的なフィールドを持つ型指定された配列に変更されました。
v2/beta フィールドv3 rc.1 フィールド
assignments(オブジェクトマップ)assignments{ creative_id, package_id, weight, placement_ids } の配列)

シグナルのアカウントとフィールドの一貫性

シグナルスキーマへの2つの一貫性変更:
v2/beta フィールドv3 rc.1 フィールド
get_signalsactivate_signalaccount_id(文字列)account(AccountReference オブジェクト)
activate_signaldeploymentsdestinationsget_signals との一貫性のために名前変更)

パッケージカタログを配列に

v2/beta フィールドv3 rc.1 フィールド
パッケージの catalog(単一の Catalog オブジェクト)catalogs(Catalog refs の配列)

ブランドトーンの構造化フォーマット

ブランドの tone はオブジェクト型のみになった — 文字列フォーマットが削除されました。構造化されたトーンには voiceattributesdosdonts フィールドが含まれます。既存の文字列値は { "voice": "<previous-string>" } に移行します。
v2/beta フィールドv3 rc.2 フィールド
tone(文字列またはオブジェクト)tone(オブジェクト: { voice, attributes, dos, donts }

アカウント解決の削除

account_resolution ケイパビリティフィールドが削除されました。require_operator_auth が認証モデルとアカウント参照スタイルの両方を決定する: true は明示的なアカウント(list_accounts で発見し、account_id を渡す)、false は暗黙的なアカウント(sync_accounts で宣言し、自然キーを渡す)を意味します。
v2/beta/rc.1 フィールドv3 rc.2 フィールド
account_resolution ケイパビリティ削除 — require_operator_auth を使用する

プライバシーと同意

AdCP は独自の同意フレームワークを定義しません。プライバシーシグナル(TCF 2.0、GPP、US Privacy String)はブリーフの ext フィールドまたはトランスポートレベルのヘッダーで渡します。同意シグナルを必要とするセラーは、拡張メカニズムを使って get_adcp_capabilities でこれを宣言します。

v3 で削除されたもの

削除されたもの代替
adcp-extension.json エージェントカードget_adcp_capabilities タスク
list_authorized_properties タスクget_adcp_capabilities ポートフォリオセクション
フォーマットの assets_requiredrequired ブールを持つ assets 配列
フォーマットの preview_imageformat_card オブジェクト
パッケージの creative_idscreative_assignments 配列
geo_postal_codesgeo_postal_areas
価格の fixed_ratefixed_price
price_guidance.floorfloor_price(トップレベル)
promoted_offerings アセットタイプクリエイティブマニフェストの catalogs フィールド
メディアバイの promoted_offering削除 — brand + brief を使用する
クリエイティブマニフェストの promoted_offeringcatalogs フィールド
brand_manifest(インラインオブジェクト)brand ref({ domain, brand_id }
プロダクトの estimated_exposuresforecast(DeliveryForecast)
get_products リクエストの proposal_idセッション継続性(context_id / contextId
overall/products/proposals を持つ refine オブジェクト型指定された変更リクエストの refine 配列
build_creative リクエストの creative_briefマニフェスト assets マップの brief アセットタイプ
supports_brief ケイパビリティsupports_compliance
creative-brief-ref.json スキーマ削除 — ブリーフはアセットタイプになった
activate_signaldeploymentsdestinations
シグナルタスクの account_id(文字列)account(AccountReference)
report_usage.kindreport_usage.operator_id削除
パッケージの catalog(単数)catalogs(配列)
account_resolution ケイパビリティrequire_operator_auth がアカウントモデルを決定する
delete_content_standards タスクupdate_content_standards でアーカイブする
get_property_features タスクプロパティリストフィルター + 機能探索のための get_adcp_capabilities
brand.json の文字列としての toneオブジェクトのみ: { voice, attributes, dos, donts }

移行チェックリスト

すべての実装

これらの破壊的変更は AdCP データを読み書きするすべての実装に影響する:
  • チャンネル列挙値を新しいタクソノミーに更新します
  • 価格オプションfixed_rate -> fixed_price に名前変更します
  • price_guidance.floor -> floor_price に移動する(価格の詳細
  • creative_idscreative_assignments に置き換える
  • メトロ/郵便ターゲティングにシステム仕様を追加します
  • geo_postal_codes -> geo_postal_areas に名前変更します
  • 新しい geo_metros_excludegeo_postal_areas_exclude フィールドを処理します
  • assets 配列を使うようにフォーマット解析を更新します
  • preview_image の読み取りを format_card レンダリングに置き換える
  • list_authorized_properties の呼び出しを get_adcp_capabilities ポートフォリオに置き換える
  • promoted_offerings をクリエイティブマニフェストアセットから削除し、catalogs フィールドに置き換える
  • メディアバイとクリエイティブマニフェストオブジェクトから promoted_offering 文字列を削除します
  • optimization_goaloptimization_goals(識別子付きユニオンの配列)に更新します
  • external_id を AudienceMember の必須フィールドとして処理します
  • すべてのタスク呼び出しで brand_manifestbrand ref({ domain, brand_id })に置き換える
  • estimated_exposures の読み取りをプロダクトの forecast(DeliveryForecast)に置き換える
  • get_products リクエストから proposal_id を削除する — リファインメントにはセッション継続性を使用します
  • refine をオブジェクトから scope 識別子を持つ型指定された配列に更新します
  • リトライ/修正ロジックのためにエラーの recovery フィールドを処理します
  • パッケージの catalogcatalogs(配列)に更新します
  • シグナルの account_idaccount(AccountReference)に更新します
  • シグナルの deploymentsdestinations に名前変更します
  • get_productsbuying_mode(現在必須)を渡します
  • creative_brief をマニフェスト assets マップの brief アセットタイプに移動します
  • kindoperator_id フィールドなしの report_usage を処理します
  • SyncCreativesRequest.assignments をオブジェクトマップから型指定された配列に移行します
  • ブランドの tone を文字列からオブジェクトフォーマット({ voice, attributes, dos, donts })に移行します
  • account_resolution の読み取りを削除する — 代わりに require_operator_auth を使用します
  • media_buy.features.sandbox の代わりに account.sandbox からサンドボックスサポートを読む
  • DOOH パラメーターが提供される場合、flat_rate.parameters の中に type: "dooh" を追加します
  • list_creativessync_creatives をクリエイティブプロトコル操作として扱います
  • delete_content_standards の呼び出しを削除する — update_content_standards でアーカイブします
  • get_property_features の呼び出しを削除する — プロパティリストフィルターを使用します
  • すべてのリクエスト/レスポンスを v3 スキーマに対して検証します
すべてのデータ構造を v3 フォーマット(チャンネル、価格、ジオターゲティング)に更新し、新しいケイパビリティを実装します:
  • get_adcp_capabilities タスクを実装する(account ケイパビリティを含む)
  • エージェントカードから adcp-extension.json を削除します
  • アカウントプロビジョニングのために sync_accounts を実装します
  • 該当する場合は get_products からデリバリー予測付きプロポーザルを返す
  • ガバナンスエージェントと統合する場合は get_products でプロパティリストフィルタリングをサポートします
  • 承認ワークフロー付きで sync_catalogs 経由で同期されたカタログを処理します
  • プロダクトで metric_optimization ケイパビリティを宣言します
  • get_adcp_capabilities でディメンションブレークダウンの reporting ケイパビリティを宣言します
  • get_media_buy_deliveryreporting_dimensions パラメーターをサポートします
  • refine リクエストを処理するときに refinement_applied 配列を返す
  • メディアバイで rejected ステータスと rejection_reason を実装します
  • get_productsfields プロジェクションパラメーターをサポートします
  • get_adcp_capabilitiessupported_pricing_models を宣言します
  • get_productstime_budget をサポートし、予算内で完了できない場合は incomplete を返す
  • media_buy.features.sandbox ではなく account.sandbox でサンドボックスサポートを宣言します
  • preferred_delivery_typesexclusivity、オプションの delivery_measurement、パッケージレベルの start_time / end_time をサポートします
すべてのリクエストとレスポンス処理を v3 フォーマットに更新し、新しいケイパビリティを統合する:
  • 購買を行う前に brand.json でブランドを解決します
  • 請求関係を確立するために sync_accounts を呼び出す
  • ランタイム探索のために get_adcp_capabilities を呼び出すように更新します
  • セラーが返したプロポーザルとデリバリー予測を評価します
  • ブランド/プロパティ解決とエージェント探索のためにレジストリ API を使用します
  • ガバナンスエージェントと連携するときはプロパティリストを渡してインベントリをフィルタリングします
  • ユーザーをブランドエージェントに接続するときは SI セッションを呼び出す
  • クリエイティブを送信する前に sync_catalogs でカタログを同期します
  • アトリビューショントラッキングのためにカタログに conversion_events を追加します
  • create_media_buyoptimization_goaloptimization_goals 配列に更新します
  • 価格オプション付きでシグナルをアクティベートするときに pricing_option_id を渡します
  • デリバリーレポーティングでのディメンションブレークダウンのために reporting_dimensions を使用します
  • 型指定されたリファインメントフィードバックのために refinement_applied レスポンスを処理します
  • 自動リトライ/修正のためにエラーの recovery フィールドを使用します
  • 効率的な探索のために get_productsfields プロジェクションを使用します
  • メディアバイの rejected ステータスを処理します
  • キャンペーンクリーンアップのために activate_signalaction: "deactivate" を使用します
  • ライセンスコンテンツキャンペーンのために get_rights / acquire_rights を統合します
  • クリエイティブ生成のために brand.jsonvisual_guidelines を処理します
  • アカウントとサンドボックスフローを選択するときに require_operator_authaccount.sandbox を読む
  • 制限されたレイテンシのプロダクト探索のために time_budget / incomplete を処理します
  • ビルド対ライブラリワークフローをルーティングするためにクリエイティブケイパビリティフラグ(supports_generationsupports_transformationhas_creative_library)を使用します
  • キャンペーンガバナンスが使用中の場合は check_governance でガバナンスエージェントにプランを送信します
スキーマ参照を v2 から v3 に更新します。シグナルプロトコルのコアモデルはメディアチャンネルを使用しません。
  • スキーマ参照を v2 から v3 に更新します
  • get_adcp_capabilitiesmajor_versions: [3] を返すことを確認します
  • get_signals レスポンスで構造化された signal_id オブジェクトを返す
  • シグナルレスポンスに value_type フィールドを含めます
  • ID ベースのルックアップのために get_signals リクエストで signal_ids パラメーターをサポートします
  • レガシーの pricing から構造化された pricing_options 配列に更新します
  • ネストされた deliver_to の代わりにトップレベルの destinations/countries を処理します
  • report_usageidempotency_key サポートを追加します
  • activate_signalaction: "deactivate" をサポートします
  • シグナルエントリに categoriesrange メタデータを含めます
  • account_idaccount(AccountReference)に更新します
  • deploymentsdestinations に名前変更します
adagents.json でシグナルカタログを公開します。データプロバイダーガイドを参照。
  • /.well-known/adagents.json にシグナルカタログを作成します
  • idnamevalue_type、オプションのメタデータでシグナルを定義します
  • グループ化と効率的な認証のために signal_tags を追加します
  • signal_ids または signal_tags 認証タイプを使ってシグナルエージェントを認証します
  • AdAgents.json Builder でカタログを検証します
新しいアセット探索をサポートし、ブランドアイデンティティを統合します。フォーマットの type フィールド(video、display、audio)は IAB クリエイティブ分類であり、メディアチャンネルではありません。
  • required ブールを持つ assets 配列をサポートする(assets_required を置き換え)
  • preview_imageformat_card レンダリングに置き換える
  • ブランドに合ったクリエイティブ生成のために brand.json でブランドアイデンティティを解決します
  • クリエイティブマニフェストで catalog フィールドをサポートする(promoted_offerings アセットを置き換え)
  • カタログアイテムをレンダリングするフォーマットで catalog_requirements を宣言します
  • スキーマ参照を v2 から v3 に更新します
  • クリエイティブマニフェストとアセットで provenance オブジェクトをサポートします
  • assets マップのアセットタイプとして briefcatalog をサポートします
  • クリエイティブブリーフの compliance.required_disclosures を処理します
  • フォーマットの supported_disclosure_positions 互換性を確認します
  • ケイパビリティで supports_compliance を宣言する(supports_brief を置き換え)
  • ブランドに合ったアセット生成のために brand.jsonvisual_guidelines を処理します
  • build_creativeinclude_previewtarget_format_idsqualityitem_limit をサポートします
  • creative_id によるライブラリ取得をサポートし、supports_generationsupports_transformationhas_creative_library を宣言します
  • list_creativessync_creatives をクリエイティブプロトコル操作として実装します
  • preview_creativequality パラメーターをサポートします
  • フォーマットの disclosure_capabilities でディスクロージャー持続性サポートを宣言します
バイサイドアイデンティティを確立します。brand.json 仕様を参照。
  • ドメインに /.well-known/brand.json をホストします
  • ブランドポートフォリオ、プロパティ、認証済みオペレーターを宣言します
  • オプションで brand.json でインラインまたはブランドエージェント経由でブランドデータ(ロゴ、カラー、フォント、トーン)を提供します
  • ジェネラティブクリエイティブシステム向けに brand.jsonvisual_guidelines を追加します
  • コンテンツをライセンスする場合は get_rights / acquire_rights / update_rights を実装します
  • brand.json をホストしていない場合はコミュニティブランドレジストリに登録します
ブランドスーツアビリティケイパビリティを実装します。ガバナンスプロトコルを参照。
  • プロパティリストタスク(create_property_listget_property_list など)を実装します
  • コンテンツスタンダードタスク(create_content_standardscalibrate_content など)を実装します
  • supported_protocolsgovernance を含む get_adcp_capabilities を実装します
  • クリエイティブポリシーで provenance_required 強制を実装します
  • AI 検出サービスからの verification 結果をサポートします
  • クリエイティブ評価のために get_creative_features を実装します
  • get_adcp_capabilitiescreative_features を宣言します
  • プランレベルのガバナンスを提供するときはキャンペーンガバナンスタスク(sync_planscheck_governancereport_plan_outcomeget_plan_audit_logs)を実装します
会話型ブランド体験を実装します。SI チャットプロトコルを参照。
  • SI セッションタスク(si_initiate_sessionsi_send_messagesi_terminate_session)を実装します
  • supported_protocolssponsored_intelligence を含む get_adcp_capabilities を実装します

サポート