​

v2 から v3 への移行

このページは、AdCP 2.x から 3.0 にアップグレードする際のすべての破壊的変更を、工数見積もりと詳細な移行ページへのリンクとともにカバーします。新機能については What’s new in v3 を、リリース候補の差分については プレリリースアップグレードノート を、3.0 をサポートする SDK バージョンについては Schemas and SDKs を参照。

​

移行チェックリスト

各行は破壊的変更です。工数は典型的な作業を示します。

• Rename — フィールド名が変わったが、セマンティクスは同じ。検索置換。
• Restructure — 形状が変わった（例: string → object、single → array）。コード変更が必要。
• Remove — v2 に存在したが v3 で削除。検索削除。
• New requirement — v2 に存在しなかった。新しい実装が必要。

​

v3 の新機能 — 必須対オプション

これらの機能は v3 で新しいものです。いずれも v2 に存在しなかったため移行するものはありません — しかしどれがインテグレーションに影響するかを知っておくべきです。

​

v2 と v3 を並行稼働させる

デュアルサポートは一時的な移行ツールであり、長期的な姿勢ではありません。2026 年 8 月 1 日以降、v3 のみが必須の構成です — v2 サンセットページ を参照。 移行中、セラーは v2 と v3 の両方のトラフィックを受け入れることができ、バイヤーは各セラーに正しいバージョンでルーティングできます。

1. セラーの機能を確認 — 各セラーで get_adcp_capabilities を呼び出します。成功したレスポンスはセラーが v3 をサポートすることを意味します。バイヤーは adcp_major_version でバージョンを宣言し、セラーは major_versions で受け入れるバージョンをアドバタイズします。完全なフローについては バージョンネゴシエーション を参照。get_adcp_capabilities に応答しないセラーは v2 のみです。
2. セラーごとに分岐 — v3 対応のセラーを v3 インテグレーション経由で、v2 のみのセラーを既存の v2 コード経由でルーティングします。
3. 段階的に移行 — リネーム変更（価格フィールド、チャネル更新）から始め、次に構造変更（クリエイティブ割り当て、最適化目標）に取り組み、次に必要に応じて新機能（アカウント、ガバナンス）を採用します。

​

破壊的移行（v2 → v3.0）

​

3.1 バッジ準備ガイド

互換性を壊さずに 3.0 に留まれます。3.1 バッジを取得するには、この短い準備チェックリストを完了します。