​

AdCP v3 への移行

​

v3 に移行する理由

• Media Channel Taxonomy — 予算配分の実態に沿った 19 の計画指向チャンネル
• Proposals — 会話的に調整し、そのまま実行できる構造化メディアプラン
• Capability Discovery — 購入前に販売側のターゲティング対応（地理システムなど）を検証
• Governance Protocol — エンタープライズ向けブランドセーフティのためのプロパティリストとコンテンツ基準
• Sponsored Intelligence — AI アシスタントでの会話型ブランド体験

​

v3 の主な違い

​

主要テーマ

1. メディアプランとの整合 - 新チャンネル分類は、技術的なレンダリングだけでなく実際の予算配分を反映。
2. ガバナンスとブランドセーフティ - ガバナンスプロトコルでプロパティリストとコンテンツ基準を扱い、エンタープライズの安全性ワークフローを支援。
3. 会話型コマース - Sponsored Intelligence プロトコルがブランドエージェントの呼び出し方を定義し、リッチな会話体験を提供。
4. グローバルターゲティング - 名前付きジオシステムで米国中心の前提を排除し、国際市場をサポート。
5. 実行時ディスカバリ - 静的なカード拡張を get_adcp_capabilities に置き換え、動的に機能を取得。

​

役割別の移行ポイント

• 非互換: データ構造を v3 形式に更新（チャンネル、価格、ジオターゲティング）
• 新規実装: 実行時ディスカバリ用に get_adcp_capabilities を実装
• 新規連携: ガバナンスエージェントと連携する場合、get_products でプロパティリストフィルターをサポート

• 非互換: すべてのリクエスト/レスポンス処理を v3 形式に更新
• 新しい利用: get_adcp_capabilities で販売側の能力を実行時に取得
• 新規連携: プロパティリストで在庫を絞り込み、会話型ブランド体験のために SI セッションを呼び出す

• 非互換: スキーマ参照を v2 から v3 に更新
• チャンネル変更なし: Signals プロトコルはコアモデルでメディアチャンネルを使用しません

• 非互換: required ブールを持つ assets 配列をサポートし、フルなアセットディスカバリに対応
• チャンネル変更なし: フォーマットの type（video/display/audio）は IAB のクリエイティブ分類でありメディアチャンネルではありません

• 新プロトコル: プロパティリストとコンテンツ基準タスクを実装
• 実装は Governance Protocol を参照

• 新プロトコル: 会話型ブランド体験のために SI セッションタスクを実装
• 詳細は Sponsored Intelligence を参照

​

非互換の変更

​

Media Channel Taxonomy

["display", "video", "audio", "native", "retail"]

[
  "display", "olv", "social", "search", "ctv", "linear_tv",
  "radio", "streaming_audio", "podcast", "dooh", "ooh",
  "print", "cinema", "email", "gaming", "retail_media",
  "influencer", "affiliate", "product_placement"
]

​

チャンネル対応表

​

移行手順

1. チャンネル使用箇所を棚卸し - コード中でチャンネル値を読み書きする箇所をすべて特定
2. 旧→新のマッピング - 上記テーブルに従い値を変換
3. フィルターを更新 - チャンネルでフィルターする場合は新しい値に置き換え
4. 十分にテスト - チャンネル不一致は検証エラーの原因に

​

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

{
  "pricing_option_id": "cpm_usd_auction",
  "pricing_model": "cpm",
  "currency": "USD",
  "price_guidance": {
    "floor": 10.00,
    "p50": 15.00,
    "p75": 18.00
  }
}

{
  "pricing_option_id": "cpm_usd_auction",
  "pricing_model": "cpm",
  "currency": "USD",
  "floor_price": 10.00,
  "price_guidance": {
    "p50": 15.00,
    "p75": 18.00
  }
}

​

フィールド変更

​

意味の違い

• ハード制約 (fixed_price, floor_price) - 違反すると入札拒否される出版社の強制価格
• ソフトな目安 (price_guidance.p25/.p50/.p75/.p90) - 過去分布を示し入札調整に利用

​

移行手順

1. すべての価格オプションで fixed_rate を fixed_price にリネーム
2. price_guidance 内の floor をトップレベルの floor_price へ移動
3. リーダー側で新フィールドを読むよう更新
4. オークション入札が適切にフロアを尊重するかテスト

const price = option.fixed_price ?? option.fixed_rate;
const floor = option.floor_price ?? option.price_guidance?.floor;

​

重み付きのクリエイティブ割り当て

{
  "creative_ids": ["creative_1", "creative_2"]
}

{
  "creative_assignments": [
    { "creative_id": "creative_1", "weight": 60 },
    { "creative_id": "creative_2", "weight": 40 }
  ]
}

​

移行手順

1. すべての creative_ids 配列を creative_assignments に置換
2. 旧 JSON を受け入れる場合は、creative_ids を重み均等な creative_assignments にマッピング
3. プレースメント単位のターゲティングがある場合は placement_ids を組み合わせる（該当する場合）

​

地理ターゲティングの命名されたシステム

​

例: v2 から v3 への変換

{
  "geo": {
    "states": ["CA", "NY"]
  }
}

{
  "geo": {
    "systems": [
      {
        "name": "us_states_iso",
        "codes": ["US-CA", "US-NY"]
      }
    ]
  }
}

​

推奨システム名

• us_states_iso — ISO 3166-2 コード
• ca_provinces_iso — カナダ州/準州 (ISO 3166-2)
• countries_iso — 国コード (ISO 3166-1 alpha-2)
• dma_nielsen — Nielsen DMA コード

​

移行手順

1. 既存のジオフィールドを確認し、暗黙のシステムを特定
2. 適切なシステム名を選び、コードを変換（例: CA → US-CA）
3. バリデーションを更新し、未知のシステム名を拒否
4. 国際キャンペーンで複数システムが混在しないか確認

​

クリエイティブアセットディスカバリ

{
  "assets": [
    { "item_type": "individual", "asset_id": "video_file", "asset_type": "video" }
  ]
}

{
  "assets": [
    {
      "item_type": "individual",
      "asset_id": "video_file",
      "asset_type": "video",
      "required": true,
      "requirements": {
        "duration": "30s",
        "format": ["MP4"],
        "resolution": ["1920x1080", "1280x720"]
      }
    },
    {
      "item_type": "individual",
      "asset_id": "companion_banner",
      "asset_type": "image",
      "required": false,
      "requirements": {
        "dimensions": "300x250",
        "format": ["PNG", "JPG", "GIF"]
      }
    }
  ]
}

​

移行手順

1. すべてのフォーマット定義に required を追加し、任意アセットを明確化
2. requirements を充実させ、検証/プレビュー/生成が可能なようにします
3. クライアントサイドロジックを更新し、必須/任意の扱いを区別

​

移行チェックリスト

1. スキーマ参照を更新 - v2 スキーマ URL を v3 に差し替え
2. チャンネル更新 - 新しい 19 チャンネルに統一
3. 価格オプション更新 - fixed_price と floor_price を使用
4. クリエイティブ割り当て - creative_assignments と重み、必要ならプレースメント指定を使用
5. ジオターゲティング - 名前付きジオシステムを明示
6. アセット要件 - required 付き assets 配列を実装
7. Runtime Discovery - get_adcp_capabilities を実装/呼び出し
8. プロパティリスト - ガバナンスが関与する場合に対応
9. SI セッション - 会話型ブランド体験が必要な場合は SI プロトコルを実装
10. テスト - チャンネル、価格、ジオ、クリエイティブ割り当てのケースを網羅

​

よくある質問

​

まとめ