Release Notes

​

Version 3.1.0

​

Version 3.0.6

​

Version 3.0.5

​

Version 3.0.4

​

Version 3.0.3

​

Version 3.0.2

​

Version 3.0.1

​

Version 3.0.0

​

次のステップ

• v2 からアップグレード？ 移行ガイド から始めてください。
• プレリリースからアップグレード？ プレリリースアップグレードノート へ。
• AdCP は初めて？ 3.0 概要 を読んでから 始める。

​

Version 3.0.0-rc.3

​

What’s New

1. Trusted Match Protocol (TMP) — AdCP のリアルタイム実行層。9 スキーマ、12 ドキュメントページ、プロダクトでのプロバイダー探索、コンテンツ解決の型付きアーティファクト、軽量なコンテキストマッチング。AXE を非推奨に。
2. オーダーライフサイクル管理 — オーダー作成時の confirmed_at、canceled_by 帰属付きのメディアバイとパッケージレベルでのキャンセル、パッケージごとの creative_deadline、状態認識エージェント向けの valid_actions、楽観的並行制御の revision、リビジョン監査証跡の include_history。7 つの新エラーコード。
3. ガバナンスの簡素化 — check_governance から binding フィールドを削除（判別フィールドから推論）、sync_plans から mode を削除、escalated ステータスを削除。3 つの終端ステータス: approved、denied、conditions。
4. セラー割り当て ID — buyer_ref、buyer_campaign_ref、campaign_ref を削除。セラー割り当ての media_buy_id と package_id が正準。すべての変更リクエストで idempotency_key。不透明な governance_context 文字列が構造化スキーマを置き換える。
5. プロポーザルライフサイクル — draft/committed プロポーザルステータス、refine アクションによる確定、インサーションオーダー署名、create_media_buy での有効期限強制。
6. オーディエンスバイアスガバナンス — 公平性検証のための構造化オーディエンスデータ。オーディエンスセレクター、制約、ポリシーカテゴリ、制限属性（GDPR 第9条）の新スキーマ。
7. ストリーミングとオーディオの配信メトリクス — completed_views（video_completions からリネーム）、reach、reach_unit、frequency。
8. 可用性フォーキャスト — ForecastPoint の budget が任意に。新しい availability フォーキャストレンジユニット。
9. 広告主業種タクソノミー — ブランドマニフェストと create_media_buy の 2 レベルドット記法カテゴリ。
10. コンテンツ標準 — 購入前の可視性のための get_adcp_capabilities の content_standards。get_media_buy_artifacts から sampling を削除。
11. イベントソースのヘルス — イベントソースの任意の health、プロダクトの measurement_readiness。
12. コレクション/インストールメント拡張 — special と limited_series フィールド、インストールメント期限、印刷対応クリエイティブフォーマット。
13. スコープされた adagents.json 認可 — 委任タイプ、プレースメントガバナンス、署名鍵、authorized_agents の国と時間ウィンドウ制約。

​

Breaking Changes

​

Version 3.0.0-rc.2

​

What’s New

1. ブランドプロトコル権利ライフサイクル — ブランドライセンスのための get_rights、acquire_rights、update_rights タスク。生成資格情報、クリエイティブ承認 Webhook、取り消し通知、利用レポート。
2. ブランドマニフェストのビジュアルガイドライン — brand.json の構造化 visual_guidelines フィールド: 写真、グラフィックスタイル、シェイプ、アイコノグラフィー、コンポジション、モーション、ロゴ配置、カラーウェイ、タイプスケール、アセットライブラリ、制限。
3. コレクションとインストールメント — 永続的なプログラム（ポッドキャスト、TV シリーズ、YouTube チャンネル）を表すプロダクトのコンテンツ次元。
4. Sponsored Intelligence チャネル — AI プラットフォーム広告のためにメディアチャネルタクソノミーに sponsored_intelligence を追加。
5. プロパティガバナンス統合 — ガバナンス評価されたプロパティリストでプロダクトをフィルタリングする get_products の任意 property_list パラメーター。
6. キャンペーンガバナンスとポリシーレジストリ — プランレベルのガバナンスのための sync_plans、check_governance、report_plan_outcome、get_plan_audit_logs。
7. アカウントモデルの簡素化 — account_resolution 機能を削除。require_operator_auth が認証モデルとアカウント参照スタイルの両方を決定。
8. クリエイティブワークフローのアップグレード — build_creative が include_preview によるインラインプレビュー、target_format_ids によるマルチフォーマット出力、品質階層をサポート。
9. クリエイティブライブラリプロトコルの統合 — list_creatives と sync_creatives がクリエイティブプロトコルに存在するように。
10. 開示の永続性 — 規制開示要件が position と duration に加えて persistence（continuous、initial、flexible）を指定できるように。
11. プロダクト探索とプランニングのエルゴノミクス — プロダクト探索に exclusivity と preferred_delivery_types を追加。
12. アカウントとサンドボックスの改良 — sync_accounts に payment_terms を追加、サンドボックス機能がアカウント機能ブロックに移動。
13. ガバナンスエージェント同期 — ガバナンスエージェントエンドポイントを特定のアカウントに同期する sync_governance タスク。

​

Breaking Changes

​

Version 3.0.0-rc.1

​

What’s New

​

Breaking Changes

​

Version 3.0.0-beta.3

​

What’s New

1. 配信フォーキャスト — 予算コミット前にキャンペーンパフォーマンスを予測。予算曲線、フォーキャスト方法、デイパートターゲティングウィンドウ、GRP デモグラフィック記法を持つ新しい DeliveryForecast 型。
2. ブランドプロトコル — brand.json によるブランド探索とアイデンティティ解決。4 つのマニフェストバリアント。
3. アカウント管理 — エージェントがブランドポートフォリオをセラーに宣言する sync_accounts タスク（upsert セマンティクス）。2 つの課金モデル。
4. コマースメディア — カタログ駆動のプロダクト探索、カタログ駆動パッケージ、カタログアイテムごとの配信レポート、店舗商圏ターゲティング。
5. クリエイティブ配信レポート — 配信レスポンスの by_package 内のクリエイティブごとのメトリクス内訳。新しい get_creative_delivery タスク。
6. CPA & TIME 価格モデル — 2 つの新価格モデル。成果ベースキャンペーンの CPA、スポンサーシップベース広告の TIME。
7. コンバージョントラッキング — sync_event_sources と log_event タスクを持つ新しいイベントプロトコル。
8. 公開シグナル定義 — データプロバイダーが、シグナル定義、カテゴリ、ターゲティングスキーマ、値タイプを持つ一級メンバーに。
9. カーソルベースのページネーション — すべてのリスト操作がカーソルベースのページネーションに標準化。
10. クリエイティブフォーマットのアクセシビリティ — 2 層アクセシビリティモデル。フォーマットレベルの wcag_level。
11. ターゲティング制限とジオ除外 — 年齢、デバイスプラットフォーム、言語ローカライゼーションの機能的制限オーバーレイ。地理的除外フィールド。
12. 型付きアセット要件 — asset_type を判別子とする 12 のすべてのアセットタイプの判別共用体スキーマ。
13. ユニバーサルマクロ — 54 のすべての標準アドサービングマクロを定義する universal-macro.json enum。
14. ブランドマニフェストの改良 — voice、attributes、dos、donts フィールドを持つ構造化トーンオブジェクト。

​

Breaking Changes

​

Version 3.0.0-beta.2

​

What’s New

1. アカウントとエージェント — AdCP は Brand（プロダクトが広告される主体）、Account（課金される主体）、Agent（購入を行う主体）を区別するように。メディアバイ、プロダクトクエリ、クリエイティブ操作の新しい account_id フィールド。
2. プロパティターゲティング — プロダクトが property_targeting_allowed を宣言してバイヤーがパブリッシャープロパティのサブセットをターゲットできるように。
3. Sponsored Intelligence の A2UI — Sponsored Intelligence セッションが MCP Apps によるエージェント駆動 UI レンダリングをサポート。
4. CTV & ストリーミング制約 — 動画フォーマットがフレームレート、HDR、GOP 構造、moov アトム位置の技術制約フィールドを得る。
5. クリエイティブプロトコル探索 — get_adcp_capabilities が supported_protocols に "creative" を含むように。

​

Removed

​

Version 3.0.0-beta.1

​

変更概要

1. メディアチャネル分類 - 5 つのフォーマット起点チャネルから、バイヤーの予算配分を反映した 19 のプランニング指向チャネルへ全面刷新。詳しくは Media Channel Taxonomy。
2. ガバナンスプロトコル - プロパティリスト、コンテンツスタンダード、ブランドセーフティ評価を、協調的なキャリブレーションワークフローと共に定義。
3. Sponsored Intelligence プロトコル - AI アシスタント内でのブランド会話体験。ブランドエージェントエンドポイントを途切れなく呼び出す方法を定義。詳細は Sponsored Intelligence。
4. プロトコルレベルの能力ディスカバリー - get_adcp_capabilities タスクがエージェントカード拡張を置き換え、実行時に機能、サポートプロトコル、ジオターゲティングシステムを公開。
5. クリエイティブ割り当ての重み付け - 単純な creative ID 配列を、トラフィック配分とプレースメントターゲティングに対応する重み付き割り当てへ置換。
6. グローバルなジオターゲティング - 名前付きシステム（Nielsen DMA、UK ITL、Eurostat NUTS2 など）による構造化ターゲティングで国際市場に対応。

​

破壊的変更の概要

​

新しいプロトコルドメイン

​

ガバナンスプロトコル

• プロパティリスト - create_property_list、get_property_list、update_property_list、delete_property_list、list_property_lists
• コンテンツスタンダード - create_content_standards、get_content_standards、update_content_standards、calibrate_content、validate_content_delivery
• 商品フィルタリング - ガバナンスリストを get_products に渡し、コンプライアンス済み在庫を探索

​

Sponsored Intelligence プロトコル

• セッション管理 - si_check_availability、si_initiate_session、si_send_message、si_terminate_session
• 機能ネゴシエーション - ブランドがモダリティ（音声・動画・アバター）を宣言し、ホストが対応機能を返す
• コマース連携 - 取引を ACP へ途切れなくハンドオフ

​

新機能

• get_adcp_capabilities タスク - エージェントカード拡張に代わる実行時の能力ディスカバリー
• 統一されたアセットディスカバリー - required ブール値付きの assets 配列で完全なアセット可視化
• プロパティリストフィルタリング - ガバナンスリストを get_products に渡し、ブランドセーフな在庫を抽出

​

v3 で削除された項目

​

クイック移行チェックリスト

• チャネル enum を更新（taxonomy guide）
• creative_ids を creative_assignments に置き換える
• メトロ/郵便ターゲティングに system 指定を追加
• get_adcp_capabilities タスクを実装
• フォーマット解析を assets 配列に対応させる

​

Version 2.5.0

​

変更概要

1. 型安全性とコード生成 - プロトコル全体に判別子フィールドを追加し、TypeScript/Python の型推論を向上、曖昧な共用体を排除。
2. クリエイティブ一括プレビュー - 最大 50 件のクリエイティブを 1 回の API 呼び出しで生成し、直接 HTML 埋め込みも可能。プレビュー時間を 5〜10 倍短縮。
3. スキーマ基盤 - セマンティックパス（/schemas/2.5.0/, /schemas/v2/, /schemas/v2.5/）でビルド時バージョン管理を実現し、バージョン固定と自動マイナートラッキングを提供。
4. API 一貫性 - 原子的なレスポンスセマンティクス（success XOR error）と標準化された Webhook ペイロードで曖昧さを排除し、信頼性を向上。
5. シグナルプロトコルの改善 - 認可に基づくデプロイメント別のアクティベーションキーを返却し、マルチプラットフォームでの適切なシグナル活性化を実現。
6. テンプレートフォーマット - accepts_parameters により、実行時寸法や尺などを受け付ける動的フォーマットをサポート。
7. 商品ディスカバリーの強化 - 日付範囲、予算制約、国ターゲティング、チャネルフィルタを持つ構造化フィルタで検索精度を向上。

​

主な改善点

​

型安全性とコード生成

• 判別子フィールド を判別共用体全体（配信先、価格、プロパティセレクター、プレビューのリクエスト/レスポンス）に追加
• 原子的レスポンスセマンティクス - すべてのタスクレスポンスで厳密な success XOR error パターン（oneOf 判別子）を採用
• すべての const フィールドに 明示的な型宣言 を付与し、正確な TypeScript リテラル型を生成
• 31 個の新しい enum スキーマ をインライン定義から抽出し再利用性を向上

​

スキーマ基盤

• ビルド時バージョニング - セマンティックなパス（/schemas/2.5.0/）、メジャーエイリアス（/schemas/v2/）、マイナーエイリアス（/schemas/v2.5/）をサポート
• 一貫したメディアバイレスポンス - create_media_buy と update_media_buy が共に完全な Package オブジェクトを返す
• 標準化された Webhook ペイロード - プロトコルエンベロープをトップレベルに、タスクデータを result フィールドに配置

​

商品ディスカバリー

• 構造化フィルタ - フィルタオブジェクトを個別スキーマ（product-filters.json、creative-filters.json、signal-filters.json）に分離
• 強化されたフィルタ - 日付範囲（start_date、end_date）、通貨付き予算範囲、国ターゲティング、チャネルフィルタを追加
• 完全な enum 対応 - フィルタで全 enum 値を制限なく受け付け

​

シグナルプロトコル

• アクティベーションキー - activate_signal が認証権限に基づきデプロイメント別のアクティベーションキー（セグメント ID、キー/バリュー）を返却
• 用語の統一 - リクエストとレスポンス全体で「deployments」に統一

​

クリエイティブプロトコル

• バッチプレビュー対応 - preview_creative が 1〜50 件のプレビューを 1 リクエストでサポート
• 直接 HTML 埋め込み - iframe なしで表示できる生 HTML をレスポンスに含められます
• シンプルな brand manifest - 必須フィールドを name のみにし、重複した型生成を排除
• テンプレートフォーマット - accepts_parameters により display_[width]x[height]、video_[duration]s のような動的フォーマットを実現
• インラインクリエイティブ更新 - sync_creatives タスクが既存キャンペーンへの upsert セマンティクスを提供

​

ドキュメントとテスト

• テスト可能なドキュメント - すべてのコード例をライブスキーマで検証可能
• クライアントライブラリの明示 - イントロに NPM バッジとインストール手順を掲載
• 50 ファイルで 389 件のリンク切れを修正

​

移行ガイド

​

判別子フィールド（Breaking）

// Before
{
  "platform_id": "ttd"
}

// After
{
  "type": "platform",
  "platform_id": "ttd"
}

// Before
{
  "publisher_domain": "cnn.com",
  "property_ids": ["cnn_ctv_app"]
}

// After
{
  "publisher_domain": "cnn.com",
  "selection_type": "by_id",
  "property_ids": ["cnn_ctv_app"]
}

// Before
{
  "pricing_model": "cpm",
  "rate": 12.50
}

// After
{
  "pricing_model": "cpm",
  "is_fixed": true,
  "rate": 12.50
}

​

Webhook ペイロード構造（Breaking）

{
  "task_id": "task_123",
  "status": "completed",
  "media_buy_id": "mb_456",
  "packages": [...]
}

{
  "task_id": "task_123",
  "task_type": "create_media_buy",
  "status": "completed",
  "timestamp": "2025-11-21T10:30:00Z",
  "result": {
    "media_buy_id": "mb_456",
    "packages": [...]
  }
}

​

Signal Activation レスポンス（Breaking）

{
  "activation_key": "segment_123"
}

{
  "deployments": [
    {
      "destination": {"type": "platform", "platform_id": "ttd"},
      "activation_key": "segment_123",
      "status": "active"
    }
  ]
}

​

テンプレートフォーマット

{
  "format_id": {"agent_url": "https://creative.adcontextprotocol.org", "id": "display_static"},
  "accepts_parameters": ["dimensions"],
  "renders": [{
    "role": "primary",
    "parameters_from_format_id": true
  }]
}

{
  "format_id": {
    "agent_url": "https://creative.adcontextprotocol.org",
    "id": "display_static",
    "width": 300,
    "height": 250
  }
}

​

商品フィルタリングの強化

{
  "filters": {
    "start_date": "2026-01-01",
    "end_date": "2026-03-31",
    "budget_range": {
      "min": 10000,
      "max": 50000,
      "currency": "USD"
    },
    "countries": ["US", "CA"],
    "channels": ["display", "video"]
  }
}

​

スキーマバージョニング

• /schemas/2.5.0/ - 正確なバージョン（本番利用に推奨）
• /schemas/v2.5/ - 最新の 2.5.x パッチ（パッチリリースで自動更新）
• /schemas/v2/ - 最新の 2.x リリース（マイナー/パッチで自動更新）
• /schemas/v1/ - 後方互換エイリアス（v2 と同一）

​

破壊的変更

• 配信先、プロパティセレクター、価格オプション、プレビューリクエストで 判別子フィールドが必須
• Webhook ペイロード構造 - タスクデータが result フィールド下へ移動し、domain は不要に
• シグナルアクティベーションレスポンス - activation_key 文字列から deployments 配列へ変更
• レガシークリエイティブフィールドの削除 - list_creatives レスポンスから media_url、click_url、duration を削除

​

非破壊的な追加

• すべてのタスクリクエストで任意の Application context オブジェクト
• ビジュアル UI 向けの任意フィールド product_card と format_card
• 後方互換の preview_creative バッチプレビューモード
• 配信レポートでのパッケージ価格フィールド（既存ドキュメントをスキーマで強制）
• マイナーバージョンのシンボリックリンク (/schemas/v2.5/)

​

Version 2.3.0

​

変更概要

​

移行ガイド

​

パブリッシャー所有のプロパティ

{
  "properties": [{
    "publisher_domain": "cnn.com",
    "property_name": "CNN CTV App",
    "property_tags": ["ctv", "premium"]
  }]
}

{
  "publisher_properties": [
    {
      "publisher_domain": "cnn.com",
      "property_tags": ["ctv"]
    }
  ]
}

​

メディアバイ予算の削除

{
  "budget": 50000,
  "packages": [...]
}

{
  "packages": [
    {"package_id": "p1", "budget": 30000},
    {"package_id": "p2", "budget": 20000}
  ]
}

​

破壊的変更

• 商品の properties フィールド → publisher_properties
• list_authorized_properties は publisher_domains 配列を返却
• create_media_buy/update_media_buy リクエストから budget を削除

​

Version 2.2.0

​

変更概要

​

移行ガイド

{
  "source_manifest": {...},
  "promoted_offerings": [...]
}

{
  "creative_manifest": {
    "format_id": {...},
    "assets": {
      "promoted_offerings": [...]
    }
  }
}

​

破壊的変更

• build_creative パラメーターを source_manifest から creative_manifest に改名
• トップレベルの promoted_offerings を削除（マニフェストの assets に移動）

​

Version 2.1.0

​

変更概要

​

移行ガイド

{
  "assets": {
    "banner_image": {
      "asset_type": "image",
      "url": "https://cdn.example.com/banner.jpg",
      "width": 300,
      "height": 250
    }
  }
}

{
  "assets": {
    "banner_image": {
      "url": "https://cdn.example.com/banner.jpg",
      "width": 300,
      "height": 250
    }
  }
}

​

破壊的変更

• クリエイティブマニフェストから asset_type フィールドを削除
• スキーマパスを /creative/asset-types/*.json から /core/assets/*-asset.json に変更
• 制約フィールドをアセットペイロードからフォーマット仕様へ移動