> ## 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.

# Release Notes

> 累積的な変更詳細、移行ガイダンス、バージョンごとの採用ノートを備えた、AdCP の権威あるバージョンごとのリリース記録。

AdCP の権威あるバージョンごとのリリース記録。累積的な変更詳細、移行ガイダンス、バージョンごとの採用ノート付き。3.1 マイナーリリースの厳選された採用者向け概要については [What's New in AdCP 3.1](/docs/reference/whats-new-in-3-1) を参照。焦点を絞ったアップグレードチェックリストについては [Migrating from 3.0 to 3.1](/docs/reference/migration/3-0-to-3-1) を参照。公開されたすべてのバージョンの一覧ステータスについては [Versions & Compatibility](/docs/reference/versions) を参照。ソースレベルの変更履歴については [CHANGELOG.md](https://github.com/adcontextprotocol/adcp/blob/main/CHANGELOG.md) を参照。バージョン安定性、スキーマ変更スコープ、3.x 保証については [Versioning & Governance](/docs/reference/versioning) を参照。v2 の EOL については [v2 サンセットページ](/docs/reference/v2-sunset) を参照。

***

## Version 3.1.0

**Status:** 一般提供 — マイナーリリース。安定したワイヤーネゴシエーション値は `"3.1"`。公開された 3.0.x ラインは既存のインテグレーションに対してサポートされ続けます。新しい 3.1 インテグレーションは `"3.1"` にピン留めし、3.1 専用フィールドを送信する前に `supported_versions` を読むべきです。

完全な変更リストの前の採用指向のフレーミングについては [What's New in AdCP 3.1](/docs/reference/whats-new-in-3-1) から始めてください。役割ベースのアップグレードチェックリストには [Migrating from 3.0 to 3.1](/docs/reference/migration/3-0-to-3-1) を使ってください。

**ヘッドライン: 実際のエージェント運用のための本番強化。** 3.1 は、分散 `brand.json`、リリース精度のバージョンネゴシエーション、指定ブランドレスポンス署名、正準クリエイティブフォーマット、ベンダー証明の最適化、ホールセールフィードのミラーリング、依存性影響の可観測性、プロポーザルライフサイクルの精度、バージョンごとの検証バッジを追加します。ブランドは今や、コーポレートハウスがポートフォリオポインター経由で所有権を宣言する一方で、自身のドメインで**自身の**正準ドキュメントを公開できます。階層は 1 レベルの深さのままで — ハウスのみが所有権を宣言 — リーフとハウス間の信頼は相互アサーション（両側が相互応答）で解決します。アイデンティティ属性（logos、colors、tone、tagline）はリーフの TLS のみで信頼されます。関係信頼（ガバナンス伝播、課金可能な包含）は相互エントリでゲートされます。

3.0 に対して追加的 — 既存のすべての brand.json パブリッシャーは変更なしに検証され続けます。

3.1 の詳細な変更リストは [CHANGELOG.md](https://github.com/adcontextprotocol/adcp/blob/main/CHANGELOG.md) と [What's New in AdCP 3.1](/docs/reference/whats-new-in-3-1) を参照。焦点を絞ったアップグレードチェックリストには [Migrating from 3.0 to 3.1](/docs/reference/migration/3-0-to-3-1) を使ってください。3.1 は、分散 `brand.json` と `brand_refs[]`、リリース精度のバージョンネゴシエーション、ブランド指定タスクレスポンス署名、正準フォーマット、ベンダー証明の最適化目標（`kind: "vendor_metric"`）、ホールセールシグナルフィードのミラーリング、`reach_window` と `viewability.viewed_seconds` の配信メトリクス、ワイヤー適合性の明確化（すべてのタスクでの冪等性、フラットな MCP エンベロープ許容、前方互換のエラーコードデコード）、片側の hosted audio/video 継続時間範囲を追加します。完全な採用者向けの概要と各機能の詳細なアダプターアクションについては、上記の [What's New in AdCP 3.1](/docs/reference/whats-new-in-3-1) を参照。

***

## Version 3.0.6

**Status:** パッチリリース — 3.0 準拠エージェントに対して安定サーフェスの no-op

**3.0.6 は `GOVERNANCE_DENIED` のワイヤー配置ルールをエラーコード自体から発見可能にし**、`ctx_metadata` キーワードをアダプター内部のラウンドトリップキーとして予約し、呼び出しエージェント側での `issues[]` 回復に関する SKILL.md ガイダンスを拡張し、仕様準拠のアダプターを拒否していた 2 つのストーリーボードフィクスチャバグを修正します。任意の 3.0 エージェントのワイヤー形式は変更されません。詳細は [CHANGELOG.md § 3.0.6](https://github.com/adcontextprotocol/adcp/blob/main/CHANGELOG.md) を参照。

***

## Version 3.0.5

**Status:** パッチリリース — 3.0 準拠エージェントに対して安定サーフェスの no-op

**3.0.5 は 3.0 での `brand_json_url` 採用をアンブロックし**、任意のストーリーボードオーサリングのアフォーダンスを出荷し、仕様準拠のエージェントを拒否していたブランド権利ストーリーボードのキャプチャパスを修正します。新しい任意サーフェスを主張しない任意の 3.0 エージェントのワイヤー形式は変更されません。主な変更: `get_adcp_capabilities` の `identity` ブロックが `additionalProperties: true` になり（`brand_json_url` の 3.0 採用をアンブロック）、任意の `default_agent` ストーリーボードフィールドが追加されます。詳細は [CHANGELOG.md § 3.0.5](https://github.com/adcontextprotocol/adcp/blob/main/CHANGELOG.md#305) を参照。

***

## Version 3.0.4

**Status:** パッチリリース — 3.0 準拠エージェントに対して安定サーフェスの no-op

**3.0.4 は 3 つ目の 3.0.x パッチです。** main からの 3 つの追加的なチェリーピック、すべてメンテナンスライン用に手作業で適応: `manifest.json` + 構造化 `enumMetadata` アーティファクト（SDK が仕様を手作業で書き写すのを止める）、`core/error.json` の規範的な `issues[]` 配列、`AUTH_REQUIRED` のリトライストームリスクを指摘する文章のみの強化。ワイヤー形式は変更されません。`AUTH_REQUIRED` は 3.0.x では単一コードのままですが（3.1 で `AUTH_MISSING` / `AUTH_INVALID` に分割）、拒否された認証情報での自動リトライを抑制する文章が追加されました。詳細は [CHANGELOG.md § 3.0.4](https://github.com/adcontextprotocol/adcp/blob/main/CHANGELOG.md#304) を参照。

***

## Version 3.0.3

**Status:** パッチリリース — 追加的なストーリーボードスキーマフィールド、3.0 準拠エージェントに対して安定サーフェスの no-op

**3.0.3 は `provides_state_for` ストーリーボードフィールドを出荷し**、同じフェーズに 2 つの交換可能なステートフルステップがあるときに適合性スイートがカスケードスキップを救済できるようにします。加えて、公開されたスキーマがすでに除外していた値を発するチャネルドキュメントの `url_type` enum のドキュメントのみの修正（`tracker` → `tracker_pixel`）。ワイヤー形式は変更されません。詳細は [CHANGELOG.md § 3.0.3](https://github.com/adcontextprotocol/adcp/blob/main/CHANGELOG.md#303) を参照。

***

## Version 3.0.2

**Status:** パッチリリース — 追加的なストーリーボードチェック種別 + 正準アセットユニオンスキーマ

**3.0.2 は新しいストーリーボードチェック種別を出荷し**、`@adcp/sdk` のドリフト検証者の静的解析ギャップを閉じます。加えて、共有アセットバリアント `oneOf` ユニオンを独自のスキーマファイル（`core/assets/asset-union.json`）に抽出し、コード生成ツール（特に `json-schema-to-typescript`）が番号付き重複型を発するのを止めます。ワイヤー形式は no-op です。詳細は [CHANGELOG.md § 3.0.2](https://github.com/adcontextprotocol/adcp/blob/main/CHANGELOG.md#302) を参照。

***

## Version 3.0.1

**Status:** パッチリリース — 3.0 準拠エージェントに対して安定サーフェスの no-op

**3.0.1 はメンテナンスリリースです。** 正準 tarball を通じてプロトコルスキルバンドルを出荷し、3.0.0 で未指定だったいくつかの規範的条項を形式化し、実験的サーフェス（ガバナンス、TMP）と適合性ハーネスに小さな追加フィールドを追加します。安定したワイヤーサーフェスは変更されません。主な変更: 正準 skills tarball（3.0.0 tarball の cosign 署名後に skills/ がプロトコルルートに移動したため再カット）、`acquire_rights` リクエスト検証、`get_signals` ページネーション優先順位、URL 正規化、v3 エンベロープ整合性、ガバナンス `mode` フィールド、TMP `seller_agent`。詳細は [CHANGELOG.md § 3.0.1](https://github.com/adcontextprotocol/adcp/blob/main/CHANGELOG.md#301) を参照。

***

## Version 3.0.0

**Status:** 一般提供 | [AdCP 3.0 overview](/docs/reference/whats-new-in-v3)

**AdCP 3.0 はエージェント間の広告購入をリトライ安全かつ監査可能にし、AdCP Verified エージェント向けに任意のエンドツーエンドリクエスト署名を備えます。** 4 つの信頼プリミティブが変更トラフィックを運びます — 3 つは 3.0 でベースライン必須（リクエスト側の冪等性、Webhook 上の RFC 9421 プロファイル、署名付き JWS ガバナンス）で、RFC 9421 リクエスト署名はエージェントが AdCP Verified を主張しない限り任意です。コンプライアンスランナーがエージェントがそれぞれを正しく行うことを証明します。ストーリーボードがバーとして `/compliance/{version}/` のプロトコルに移動します。AdCP Verified は、エージェントが合格したランナー出力を公開したという自己証明のスタンプです。3.0 はまた、放送 TV を一級のチャネルとして持ち込み、ガバナンスを任意の購入タイプに一般化し、オブジェクトの存在が数十のブールフラグを置き換えるよう機能モデルを簡素化します。

3.0 の完全な What's New 一覧、破壊的変更、移行ノートについては [AdCP 3.0 概要](/docs/reference/whats-new-in-v3) と [CHANGELOG.md § 3.0.0](https://github.com/adcontextprotocol/adcp/blob/main/CHANGELOG.md#300) を参照。ハイライト: 4 つの暗号プリミティブ（リクエスト/Webhook 冪等性、RFC 9421 署名、署名付き JWS ガバナンス）、専門分野とコンプライアンスストーリーボードと AdCP Verified、放送 TV サポート、ガバナンスの一般化と規制不変条件（GDPR 22条 / EU AI Act 附属書 III）、機能モデルの簡素化、コレクションリスト、構造化測定条件、統合ベンダー価格、リクエストごとのバージョン宣言、オフラインレポート配信、エラーコードのクリーンアップ（`REFERENCE_NOT_FOUND` への統合）。

### 次のステップ

* **v2 からアップグレード？** [移行ガイド](/docs/reference/migration) から始めてください。
* **プレリリースからアップグレード？** [プレリリースアップグレードノート](/docs/reference/migration/prerelease-upgrades) へ。
* **AdCP は初めて？** [3.0 概要](/docs/reference/whats-new-in-v3) を読んでから [始める](/docs/quickstart)。

***

## Version 3.0.0-rc.3

**Status:** リリース候補（3.0.0 に置き換えられました） | [AdCP 3.0 overview](/docs/reference/whats-new-in-v3)

### 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

| Change                     | rc.2                                            | rc.3                                                              |
| -------------------------- | ----------------------------------------------- | ----------------------------------------------------------------- |
| バイヤー参照                     | `buyer_ref`、`buyer_campaign_ref`、`campaign_ref` | 削除 — セラー割り当ての `media_buy_id` と `package_id` が正準                   |
| 冪等性                        | 暗黙の重複排除キーとしての `buyer_ref`                       | すべての変更リクエストで明示的な `idempotency_key`                                |
| ガバナンスコンテキスト                | 構造化 `governance-context.json` スキーマ              | 署名付き JWS `governance_context` 文字列                                 |
| `check_governance` binding | リクエストの `binding` フィールド                          | 削除 — 判別フィールドから推論                                                  |
| `sync_plans` mode          | `mode` フィールド                                    | 削除 — ガバナンスエージェント設定                                                |
| `check_governance` status  | `escalated`                                     | 削除 — 非同期タスクライフサイクルを使う                                             |
| `get_media_buy_artifacts`  | リクエストの `sampling` パラメーター                        | 削除 — 作成時に設定                                                       |
| FormatCategory             | `format-category.json` enum、Format の `type`     | 削除 — `assets` 配列または `asset_types` フィルターを使う                        |
| 番組/エピソード                   | `show`、`episode`、`show_id`、`episode_id`         | `collection`、`installment`、`collection_id`、`installment_id` にリネーム |

***

## Version 3.0.0-rc.2

**Status:** リリース候補 | [AdCP 3.0 overview](/docs/reference/whats-new-in-v3)

### 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

| Change                     | rc.1                                                    | rc.2                                             |
| -------------------------- | ------------------------------------------------------- | ------------------------------------------------ |
| アカウント解決                    | `account_resolution` 機能                                 | 削除 — `require_operator_auth` がアカウントモデルを決定        |
| クリエイティブライブラリ操作             | Media Buy 下に文書化                                         | クリエイティブプロトコルに存在                                  |
| サンドボックス機能                  | `media_buy.features.sandbox`                            | `account.sandbox`                                |
| DOOH フラットレートパラメーター         | 判別子なしの `flat_rate.parameters`                           | パラメーター存在時 `flat_rate.parameters.type: "dooh"` 必須 |
| delete\_content\_standards | 文書化タスク                                                  | 削除 — `update_content_standards` でアーカイブ           |
| get\_property\_features    | スタンドアロンタスク                                              | 削除 — プロパティリストフィルターと `get_adcp_capabilities` を使う  |
| ガバナンスエージェント同期              | `sync_accounts` / `list_accounts` の `governance_agents` | 専用 `sync_governance` タスクに移動                      |

***

## Version 3.0.0-rc.1

**Status:** リリース候補 | [AdCP 3.0 overview](/docs/reference/whats-new-in-v3)

### What's New

rc.1 は 3.0 に向けた大規模なプレリリースで、30 の主要な新機能領域を導入します: キーワードターゲティング、最適化目標の再設計（`optimization_goal` → `optimization_goals` 配列、判別共用体）、リーチ最適化、拡張フリークエンシーキャップ、シグナル価格モデル、次元ブレークダウン、デバイスタイプターゲティング、deliver-to のフラット化、メトリクス最適化機能、ブランドアイデンティティの統合（`brand-manifest.json` 削除、BrandRef 参照）、プロダクトの配信フォーキャスト、バイイングモードによるプロポーザル絞り込み、一級カタログ（`sync_catalogs`、13 カタログタイプ）、新タスク（`get_media_buys`、`get_creative_features`、`sync_audiences`）、バイイングモード、サンドボックスモード、クリエイティブブリーフ型、ジオ近接ターゲティング、セラーの承認を伴う型指定された絞り込み、AI プロベナンスと開示、クリエイティブコンプライアンス、マニフェスト統合、構造化エラー回復（18 標準エラーコード）、シグナルの非アクティベーション、メディアバイの拒否、冪等性。

### Breaking Changes

| Change                  | beta.3                              | rc.1                                                       |
| ----------------------- | ----------------------------------- | ---------------------------------------------------------- |
| ブランドアイデンティティ            | インライン `brand_manifest` オブジェクト       | `brand`（BrandRef: `{ domain, brand_id }`）— 実行時に解決          |
| プロダクトエクスポージャー推定         | `estimated_exposures`（整数）           | `forecast`（DeliveryForecast オブジェクト）                        |
| プロポーザル絞り込み              | `get_products` の `proposal_id`      | 削除 — 型付き `refine` 配列を伴う `buying_mode: "refine"` を使う        |
| 最適化目標                   | `optimization_goal`（単一）             | `optimization_goals`（判別共用体の配列）                             |
| AudienceMember アイデンティティ | uid-type enum の `external_id`       | `external_id` が必須のトップレベルフィールド、enum から削除                    |
| シグナル deliver\_to        | ネストされた `deliver_to`                 | トップレベル `destinations` と `countries`                        |
| シグナル価格                  | `pricing: { cpm }`                  | 構造化 `pricing_options[]`                                    |
| クリエイティブアサインメント          | `{ creative_id: package_id[] }` マップ | `creative_id`、`package_id`、`weight`、`placement_ids` の型付き配列 |
| パッケージカタログ               | `catalog`（単一オブジェクト）                 | `catalogs`（配列）                                             |
| buying\_mode            | なし                                  | 必須 — 3 モード: `brief`、`wholesale`、`refine`                   |

***

## Version 3.0.0-beta.3

**Status:** Beta | [AdCP 3.0 overview](/docs/reference/whats-new-in-v3)

### 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

| Change        | beta.2             | beta.3                       |
| ------------- | ------------------ | ---------------------------- |
| ページネーション      | `limit`/`offset`   | カーソルベースの `pagination` オブジェクト |
| ブランドマニフェストトーン | `string \| object` | 構造化フィールドを持つオブジェクトのみ          |

***

## Version 3.0.0-beta.2

**Status:** Beta | [Full Changelog](https://github.com/adcontextprotocol/adcp/blob/main/CHANGELOG.md#300-beta2) | [AdCP 3.0 overview](/docs/reference/whats-new-in-v3)

beta.1 の上に構築し、このリリースはアカウントレベルの課金、プロパティターゲティング制御、CTV 技術仕様、Sponsored Intelligence のエージェント駆動 UI レンダリングを追加します。

### 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

| Removed                          | Replacement                               |
| -------------------------------- | ----------------------------------------- |
| `list_property_features` タスク     | `get_adcp_capabilities`                   |
| `list_authorized_properties` タスク | `get_adcp_capabilities` portfolio section |
| `adcp-extension.json` スキーマ       | `get_adcp_capabilities` タスク               |
| `assets_required` フォーマットフィールド    | `required` ブール付きの `assets` 配列             |
| `preview_image` フォーマットフィールド      | `format_card` オブジェクト                      |

***

## Version 3.0.0-beta.1

**ステータス:** Beta | [Full Changelog](https://github.com/adcontextprotocol/adcp/blob/main/CHANGELOG.md#300-beta1) | [Migration Guide](/docs/reference/migration)

<Warning>
  **このリリースはベータ版です。** API はテストに耐える状態ですが、正式版 3.0.0 までに破壊的変更が入る可能性があります。早期利用者からのテストとフィードバックを歓迎します。
</Warning>

### 変更概要

Version 3.0.0 はメディアバイを超え、ガバナンス、ブランドセーフティ、会話型コマースへ領域を拡張する **メジャーリリース** です。詳細な移行手順は [Migration Guide](/docs/reference/migration) を参照してください。

**🎯 主なテーマ:**

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

### 破壊的変更の概要

| Change              | v2.x                     | v3.x                               |
| ------------------- | ------------------------ | ---------------------------------- |
| Channels            | 5 values                 | 19 planning-oriented values        |
| Creative assignment | `creative_ids: [...]`    | `creative_assignments: [{...}]`    |
| Metro targeting     | `geo_metros: ["501"]`    | `geo_metros: [{ system, code }]`   |
| Postal targeting    | `geo_postal_codes`       | `geo_postal_areas` with system     |
| Asset discovery     | `assets_required: [...]` | `assets: [{ asset_id, required }]` |

詳細な before/after と移行手順は [Migration Guide](/docs/reference/migration) を参照してください。

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

#### ガバナンスプロトコル

ブランドセーフティと在庫キュレーション:

* **プロパティリスト** - `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 へ途切れなくハンドオフ

詳細は [Sponsored Intelligence Overview](/docs/sponsored-intelligence/overview)。

### 新機能

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

### v3 で削除された項目

| Removed                           | Replacement                               |
| --------------------------------- | ----------------------------------------- |
| `adcp-extension.json` agent card  | `get_adcp_capabilities` task              |
| `list_authorized_properties` task | `get_adcp_capabilities` portfolio section |
| `assets_required` in formats      | `assets` array with `required` boolean    |
| `preview_image` in formats        | `format_card` object                      |
| `creative_ids` in packages        | `creative_assignments` array              |
| `geo_postal_codes`                | `geo_postal_areas`                        |
| `fixed_rate` in pricing           | `fixed_price`                             |
| `price_guidance.floor`            | `floor_price` (top-level)                 |

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

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

**[完全な移行ガイドを見る →](/docs/reference/migration)**

***

## Version 2.5.0

**リリース日:** 2025 年 11 月 | [Full Changelog](https://github.com/adcontextprotocol/adcp/blob/main/CHANGELOG.md#250)

### 変更概要

Version 2.5.0 は **開発体験と API の磨き込み** を目的としたリリースで、型安全性、スキーマ基盤、クリエイティブワークフロー性能を大幅に改善しました。TypeScript/Python のコード生成、厳密なバリデーションセマンティクス、柔軟なスキーマバージョニングにより、本番規模の導入に備えています。

**🎯 主なテーマ:**

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）

多くのスキーマで判別子フィールドが必須になりました。コードを更新してください。

**Signal Destinations:**

```json theme={null}
// Before
{
  "platform_id": "ttd"
}

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

**Property Selectors:**

```json theme={null}
// Before
{
  "publisher_domain": "cnn.com",
  "property_ids": ["cnn_ctv_app"]
}

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

**Pricing Options:**

```json theme={null}
// Before
{
  "pricing_model": "cpm",
  "rate": 12.50
}

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

#### Webhook ペイロード構造（Breaking）

Webhook ペイロードがトップレベルでプロトコルエンベロープを使用するようになりました。

**Before:**

```json theme={null}
{
  "task_id": "task_123",
  "status": "completed",
  "media_buy_id": "mb_456",
  "packages": [...]
}
```

**After:**

```json theme={null}
{
  "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）

`activate_signal` のレスポンスが単一キーから deployments 配列へ変更されました。

**Before:**

```json theme={null}
{
  "activation_key": "segment_123"
}
```

**After:**

```json theme={null}
{
  "deployments": [
    {
      "destination": {"type": "platform", "platform_id": "ttd"},
      "activation_key": "segment_123",
      "status": "active"
    }
  ]
}
```

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

フォーマットがパラメーターを受け取り、動的サイズに対応できるようになりました。

**テンプレートフォーマット定義:**

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

`parameters_from_format_id: true` は、使用時の format\_id から寸法を取得することを示します。

**利用例（パラメータ化された format\_id）:**

```json theme={null}
{
  "format_id": {
    "agent_url": "https://creative.adcontextprotocol.org",
    "id": "display_static",
    "width": 300,
    "height": 250
  }
}
```

これは display\_static テンプレートの 300x250 版を生成します。

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

`get_products` に構造化フィルタが追加されました。

```json theme={null}
{
  "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

**リリース日:** 2025 年 10 月 | [Full Changelog](https://github.com/adcontextprotocol/adcp/blob/main/CHANGELOG.md#230)

### 変更概要

**パブリッシャー所有のプロパティ定義** - プロパティをパブリッシャーが所有し、エージェントが参照するモデルへ変更（IAB Tech Lab sellers.json に倣う）。重複をなくし、プロパティ情報の単一のソース・オブ・トゥルースを提供。

**プレースメントターゲティング** - 商品が複数のプレースメント（ホームページバナー、記事サイドバーなど）を定義でき、バイヤーは商品購入内でプレースメントごとに異なるクリエイティブを割り当て可能。

**シンプルな予算指定** - 予算をパッケージ単位のみに限定し、混在通貨キャンペーンを可能にするとともに、メディアバイレベルでの冗長な集約を排除。

### 移行ガイド

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

**Before:**

```json theme={null}
{
  "properties": [{
    "publisher_domain": "cnn.com",
    "property_name": "CNN CTV App",
    "property_tags": ["ctv", "premium"]
  }]
}
```

**After:**

```json theme={null}
{
  "publisher_properties": [
    {
      "publisher_domain": "cnn.com",
      "property_tags": ["ctv"]
    }
  ]
}
```

バイヤーは `https://cnn.com/.well-known/adagents.json` からプロパティ定義を取得します。

#### メディアバイ予算の削除

**Before:**

```json theme={null}
{
  "budget": 50000,
  "packages": [...]
}
```

**After:**

```json theme={null}
{
  "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

**リリース日:** 2025 年 10 月 | [Full Changelog](https://github.com/adcontextprotocol/adcp/blob/main/CHANGELOG.md#220)

### 変更概要

**Build Creative の整合性** - `build_creative` タスクが明確な「manifest-in → manifest-out」の変換モデルに準拠し、パラメーター名を統一。

### 移行ガイド

**Before:**

```json theme={null}
{
  "source_manifest": {...},
  "promoted_offerings": [...]
}
```

**After:**

```json theme={null}
{
  "creative_manifest": {
    "format_id": {...},
    "assets": {
      "promoted_offerings": [...]
    }
  }
}
```

### 破壊的変更

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

***

## Version 2.1.0

**リリース日:** 2025 年 1 月 | [Full Changelog](https://github.com/adcontextprotocol/adcp/blob/main/CHANGELOG.md#210)

### 変更概要

**シンプルなアセットスキーマ** - アセットのペイロードスキーマとフォーマット要件スキーマを分離し、冗長性を排除。アセットタイプはマニフェストの宣言ではなくフォーマット仕様で決定。

### 移行ガイド

**Before:**

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

**After:**

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

### 破壊的変更

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