​

移行: v1 名前付きフォーマット → 正準フォーマット

命名ノート: このページ全体で使われる v1↔v2 用語は、2 つのフォーマット作成モデル — format_ids（レガシー、v1）対 format_options（正準フォーマット、v2）— を記述します。AdCP プロトコル自体のバージョン（現在 3.x）を指すものでは ありません。「v2」パスは正準フォーマットパスとも呼ばれます。両方の言い回しは同じことを意味します。

​

何が変わらないか

• すべてのアセットプリミティブスキーマ（image-asset.json、video-asset.json、audio-asset.json、vast-asset.json、daast-asset.json） — 変わらず
• カタログとオファリングスキーマ — 変わらず
• マニフェストエンベロープ形状（assets マップでキーされた creative-manifest.json） — 変わらず
• レスポンスエンベロープ、エラースキーマ、共通タイプ — 変わらず
• v1 名前付きフォーマット（複合 format_id を持つ format.json） — 依然として 4.x を通じてサポート
• v1 list_creative_formats ツール — 非推奨だが 4.x を通じて機能。5.0 で削除
• すべての既存プロデューサーと消費者 — 変更なしで動作し続ける

​

並列比較: v1 名前付きフォーマット → v2 製品フォーマット宣言

​

v1 — 製品が参照する別のフォーマットファイル

// formats/meta_reels.json
{
  "format_id": { "agent_url": "https://creative.adcontextprotocol.org", "id": "meta_reels" },
  "name": "Meta Reels",
  "type": "video",
  "assets": [
    {
      "asset_id": "video_file",
      "asset_type": "video",
      "asset_role": "hero_video",
      "item_type": "individual",
      "required": true,
      "requirements": {
        "min_duration_ms": 3000,
        "max_duration_ms": 90000,
        "aspect_ratio": "9:16",
        "min_width": 1080,
        "min_height": 1920,
        "containers": ["mp4"],
        "codecs": ["h264"]
      }
    }
  ]
}

// products/meta_reels_us.json
{
  "product_id": "meta_reels_us",
  "name": "Meta Reels — United States",
  "format_ids": [
    { "agent_url": "https://creative.adcontextprotocol.org", "id": "meta_reels" }
  ],
  // ... pricing, targeting, etc.
}

​

v2 — 製品上のインラインフォーマット宣言

{
  "product_id": "meta_reels_us",
  "name": "Meta Reels — United States",
  "format_options": [
    {
      "format_kind": "video_hosted",
      "params": {
        "orientation": "vertical",
        "aspect_ratio": "9:16",
        "duration_ms_range": [3000, 90000],
        "min_width": 1080,
        "min_height": 1920,
        "video_codecs": ["h264"],
        "containers": ["mp4"],
        "headline_max_chars": 25,
        "primary_text_max_chars": 72,
        "cta_values": ["LEARN_MORE", "SHOP_NOW", "DOWNLOAD", "SIGN_UP"],
        "composition_model": "deterministic",
        "platform_extensions": [
          { "uri": "https://creative.adcontextprotocol.org/translated/meta/extensions/meta_pixel", "digest": "sha256:..." }
        ]
      }
    }
  ],
  // ... pricing, targeting, etc.
}

​

v1 → v2 正準マッピング

​

正準マッピングレジストリ

• format_id_glob — v1 format_id.id に対する完全 / glob マッチ。IAB 慣習サイズ（iab/mrec_300x250 → image 300×250）、名前付きプラットフォームフォーマット、一般的なパブリッシャー慣習をカバー。
• structural — フォーマットのスロット形状、アセットタイプ、バージョン制約に対するマッチ。異なる名前の下で構造的に標準フォーマットであるカスタム v1 フォーマットを捕捉（セラーの acme_homepage_300x250 は構造的に IAB MREC）。

​

v1 フォーマット宣言の canonical フィールド（カスタム / 未登録フォーマット）

{
  "format_id": "acme/sponsored_recipe_card",
  "name": "Sponsored Recipe Card",
  "canonical": { "kind": "sponsored_placement" },
  "canonical_parameters": {
    "format_kind": "sponsored_placement",
    "params": {
      "supported_catalog_types": ["product"],
      "supported_id_types": ["sku"],
      "fanout_mode": "per_item",
      "item_production_model": "buyer_uploaded"
    }
  },
  "assets": [
    { "asset_id": "headline", "asset_type": "text", "asset_group_id": "headline", "required": true },
    { "asset_id": "recipe_image", "asset_type": "image", "asset_group_id": "image_main", "required": true }
  ]
}

​

規範的 SDK 投影ルール

1. v1 フォーマット宣言が canonical を運ぶ場合、それを使う（セラー宣言、最高優先度）。canonical_parameters も存在するとき、それを投影された ProductFormatDeclaration としてそのまま使う。
2. そうでなければ、/schemas/registries/v1-canonical-mapping.json の format_id_glob エントリーで format_id をルックアップ。
3. そうでなければ、レジストリの structural エントリーに対して構造マッチを試みる。
4. そうでなければ、フェイルクローズ: SDK はこのフォーマットを運ぶ製品に format_options を発行してはならない（MUST NOT）。セラーが明示的な canonical フィールドを追加するかレジストリエントリーを提出することを提案する検証警告を表示。バイヤーはこれらの製品に format_ids のみを見る。

​

スロット名マッピング（v1 → 正準）

// v1 format with author-invented slot name
{
  "asset_id": "click_url",
  "asset_type": "url",
  "item_type": "individual",
  "required": true
}

// Same v1 format with canonical pointer (additive — backwards-compatible)
{
  "asset_id": "click_url",
  "asset_type": "url",
  "asset_group_id": "landing_page_url",
  "item_type": "individual",
  "required": true
}

​

ディスカバリー表面移行

​

生成フォーマット — *_generated_* ファイルが溶ける

• フォーマット宣言の slots 配列は、マニフェストの assets マップでバイヤーが出荷するすべてを列挙します — 各エントリーは asset_type とペアになった正準 asset_group_id。一部のスロットはそのままレンダーされます（画像 / 動画 / オーディオ）。一部は生成のため消費されます（テキストスクリプト → ホストリードオーディオ。ブリーフ → 合成画像。video_brief → 生成動画）。セラーはスロットごとにディスパッチします。
• セラーの内部生成が生成 AI、ホスト録音、トランスコーディング、アセットレンダリングのいずれかは バイヤーに不可視 です。
• 単一の正準フォーマット（例: audio_hosted）はバイヤーアップロードオーディオとエージェント生成オーディオの両方を処理します。フォーマットの asset_source と buyer_asset_acceptance パラメーターがどのフローが受け入れられるかを記述します。

// v1: separate generated format file
{
  "format_id": { "agent_url": "...", "id": "audiostack_audio_30s_generated" },
  "name": "AudioStack 30s Audio (Generated)",
  "assets": [
    {
      "asset_id": "creative_brief",
      "asset_type": "brief",
      "required": true
    },
    {
      "asset_id": "audio_output",
      "asset_type": "audio",
      "required": false
    }
  ]
}

// v2: same canonical (audio_hosted), buyer-shipped assets declared as slots
{
  "format_kind": "audio_hosted",
  "params": {
    "duration_ms_exact": 30000,
    "audio_codecs": ["mp3"],
    "loudness_lufs": -16,
    "asset_source": "agent_synthesized",
    "buyer_asset_acceptance": "rejected",
    "slots": [
      { "asset_group_id": "creative_brief", "required": true, "asset_type": "brief", "max_chars": 1000 },
      { "asset_group_id": "voice_id", "required": false, "asset_type": "text" }
    ],
    "production_window_business_days": 0
  }
}

​

ブランドアイデンティティ — スロットが消える

{
  "format_id": { "agent_url": "...", "id": "..." },
  "assets": { ... },
  "brand": {
    "domain": "acme.example",
    "brand_kit_override": {
      "logo": { "asset_type": "image", "url": "https://cdn.acme.example/logo-2026.png", "width": 200, "height": 100 },
      "colors": { "primary": "#0066CC", "accent": "#FF6600" },
      "tagline": "Spring savings, all season"
    }
  }
}

​

ツール — 何が新しいか対変わらないか

​

アダプター移行パス

​

セールスエージェント（DSP、SSP、リテールメディアネットワーク、ウォールドガーデン）

1. 在庫: 既存の v1 名前付きフォーマットを列挙。各々が 12 の v2 正準の 1 つまたはカスタム形状（下の「カスタムフォーマットの出荷」を参照）にマップすることを確認。合成/協調/スポンサーシップ形状（マルチプレースメントテイクオーバー、ロードブロック、ブランデッドコンテンツ、クロススクリーンスポンサーシップ、スポンサーシップロックアップ、ニュースレター、AR レンズ、プレイアブル、ライブイベントスポンサーシップ）は、format_shape レジストリ分類子と format_schema URI+ダイジェスト参照付き format_kind: "custom" として出荷。
2. 翻訳: 各名前付きフォーマットについて、プラットフォームのパラメーターで正準を絞る v2 ProductFormatDeclaration を書く。カスタム形状には、フォーマットの params と slots を記述する JSON Schema を作成し、サブドメインの安定した URI（またはウォールドガーデンセラーには AAO ミラー経由）でホストし、format_schema から参照。
3. ランタイム準備状況に正直に: ランタイムパスがまだ完全に配線されていない各宣言に experimental: true を設定。懸念が「仕様がまだ落ち着いている」（正準レベル）か「私のランタイムが移行途中」（宣言レベル）かにかかわらず同じフラグ。バイヤーはデフォルトビューから experimental: true をフィルターすべき（SHOULD）。フラグを落とすまで v1 フォールバック（宣言の v1_format_ref または親製品の format_ids 経由）を優先すべき（SHOULD）。ランタイムが追いついたらフラグを落とす。
4. テスト: 翻訳された宣言を /schemas/core/product.json に対して検証（npm run test:canonical-fixtures パターンを使う）。
5. デュアル公開: v1 名前付きフォーマットと list_creative_formats を 4.x を通じて動作させ続ける。それを持つ製品に v2 format_options フィールドを追加。
6. フラット化ラッパー: v2 製品宣言から v1 list_creative_formats 形状を導出するサーバー側ラッパーを実装。v1 時代のダッシュボードとツールが動作し続けられる。
7. 非推奨タイミング: 5.0 で、製品の v1 format_ids 参照を削除。それまでは両パスが共存。

​

サーバー側実装の考慮事項

• provenance_required: true のときの sync_creatives プロベナンス検証。 v2 製品のフォーマット宣言が provenance_required: true を運ぶ（そしてバイヤーのマニフェストが合成アセット — 通常生成プラットフォームからの動画/画像 — を含む）とき、sync_creatives は C2PA 互換プロベナンスマニフェストが添付されていることを検証し、署名されていない合成アセットを拒否しなければなりません（MUST）。これは Creative の既存の AI プロベナンストラッキング（EU AI Act Article 50 作業）の自然な拡張です — 新しい部分は提出をゲートする検証フックです。既存のプロベナンス配管を持たないセラーは、フラグが設定された v2 製品を出荷するまでこれを必要としません。それまでは no-op です。
• get_products レスポンスが拡張定義を集める。 製品が v2 format.params.platform_extensions 参照を運ぶとき、レスポンスは <uri>@sha256:<digest> でキーされた extensions マップに参照された拡張定義を含むべきです（SHOULD）。実装はレスポンス内の任意の製品が参照する拡張を集め、ダイジェストで重複排除し、発行します。バイヤーは URI@digest でキャッシュします。後続のレスポンスはバイヤーが既にキャッシュした定義を省略してもよい（MAY）。製品が v2 宣言を使わないとき自明。テナントがオプトインするときのみ発動。
• ホストリード / エージェント生成製品の production_window_business_days。 今日ほとんどのサーバー実装は Products での生成ターンアラウンドをモデル化しません — フィールドは v2 の追加です。テナントが v2 ホストリードまたは生成動画製品（asset_source: 'publisher_host_recorded' の audio_hosted、または synthesis_nondeterministic: true の任意の製品）を出荷するときのみ重要。今日これらのフローの多くは手動トラフィックされたスポンサーシップを通じてルーティングされ、プロトコル上でターンアラウンドを表示しません。v2 はそれを宣言可能にします。

​

カスタムフォーマットの出荷

1. 語彙レジストリ から format_shape を選ぶ。あなたの形状がそこにない場合、語彙 PR を提出 — エントリー追加はガバナンスライトで、メジャーバージョンバンプを要求せず、ワーキンググループが形状ごとの採用速度を追跡するのを助ける。
2. フォーマットの params と slots を記述する JSON Schema を作成。スキーマの仕事は、バイヤーエージェントにマニフェストを検証しあなたが受け入れるアセット、どうトラックするか、インプレッションコントラクトが何かを推論する十分な構造を与えることです。v1 名前付きフォーマットファイルを作成するように扱ってください — 同じレベルの厳密さ、ただ AdCP の屋根の下ではなくあなたの URI でホストされる。業界共有スキーマ（例: 複数のパブリッシャーが収束する共有 multi_placement_takeover_v1 スキーマ）は奨励され正準昇格を加速します。
3. Cache-Control: public, max-age=31536000, immutable とダイジェストで 安定した URI にスキーマをホスト。オープンエコシステムパブリッシャーは自身のサブドメイン（https://yourpub.example/schemas/formats/your_shape_v1）でホスト。ウォールドガーデンセラーは https://creative.adcontextprotocol.org/translated/<vendor>/<shape> の AAO ミラーを通じてルーティング（AAO は翻訳提出を受け入れる。同じホスティング / 不変性コントラクト）。ProductFormatDeclaration の format_schema: { uri, digest } からスキーマを参照。

​

クリエイティブエージェント（Flashtalking、AudioStack、生成プラットフォーム、AI レンダリングサービス）

​

v2 でクリエイティブエージェントに何が変わるか

​

具体例: Flashtalking 形状のクリエイティブエージェント

// GET https://flashtalking.example/.well-known/agent.json
// → get_adcp_capabilities response (excerpt)
{
  "creative": {
    "supports_generation": true,
    "supports_transformation": true,
    "has_creative_library": true,
    "supported_formats": [
      {
        "capability_id": "flashtalking_image_iab_standard",
        "format": {
          "format_kind": "image",
          "params": {
            "image_formats": ["jpg", "png", "gif"],
            "max_file_size_kb": 200,
            "ssl_required": true,
            "asset_source": "buyer_uploaded",
            "platform_extensions": [
              { "uri": "https://flashtalking.example/extensions/flashtalking_pixel_v2", "digest": "sha256:..." }
            ]
          }
        }
      },
      {
        "capability_id": "flashtalking_video_vast_42",
        "format": {
          "format_kind": "video_vast",
          "params": {
            "vast_version": "4.2",
            "duration_ms_range": [6000, 60000],
            "linear_required": true,
            "ssl_required": true,
            "platform_extensions": [
              { "uri": "https://flashtalking.example/extensions/flashtalking_vpaid_2_0", "digest": "sha256:..." }
            ]
          }
        }
      },
      {
        "capability_id": "flashtalking_html5_iab_standard",
        "format": {
          "format_kind": "html5",
          "params": {
            "max_initial_load_kb": 200,
            "om_sdk_required": true,
            "backup_image_required": true,
            "ssl_required": true
          }
        }
      }
    ]
  }
}

​

具体例: AudioStack 形状の変換エージェント

// GET https://audiostack.example/.well-known/agent.json
{
  "creative": {
    "supports_generation": true,
    "supports_transformation": true,
    "supported_formats": [
      {
        "capability_id": "audiostack_audio_brief_to_30s",
        "format": {
          "format_kind": "audio_hosted",
          "params": {
            "duration_ms_exact": 30000,
            "audio_codecs": ["mp3", "aac"],
            "audio_sample_rates": [44100, 48000],
            "audio_channels": ["stereo"],
            "loudness_lufs": -16,
            "asset_source": "seller_pre_rendered_from_brief",
            "buyer_asset_acceptance": "rejected",
            "production_window_business_days": 1,
            "slots": [
              { "asset_group_id": "creative_brief", "asset_type": "brief", "required": true, "max_chars": 500 },
              { "asset_group_id": "voice_id", "asset_type": "text", "required": false },
              { "asset_group_id": "landing_page_url", "asset_type": "url", "required": false }
            ]
          }
        }
      },
      {
        "capability_id": "audiostack_audio_script_to_30s",
        "format": {
          "format_kind": "audio_hosted",
          "params": {
            "duration_ms_exact": 30000,
            "audio_codecs": ["mp3"],
            "asset_source": "agent_synthesized",
            "buyer_asset_acceptance": "rejected",
            "synthesis_nondeterministic": false,
            "production_window_business_days": 0,
            "slots": [
              { "asset_group_id": "script", "asset_type": "text", "required": true, "max_chars": 800 },
              { "asset_group_id": "voice_id", "asset_type": "text", "required": true }
            ]
          }
        }
      }
    ]
  }
}

​

クリエイティブエージェントのサーバー側フック

• creative.supported_formats はあなたの公開コントラクトです。 バイヤーとセールスエージェントは、あなたが何を生成するかを知るためそれを読みます。リリース全体で capability_id 値を安定に保つ — バイヤーは build_creative 呼び出しでそれらを参照します。
• synthesis_nondeterministic: true は QA ループ義務を含意します。 それを宣言するとき、あなたは以下にコミットします: 各合成試行をフォーマットのパラメーター制約に対して検証。スペック内出力を生成するため最大 N 回再シード。ループが尽きた場合 synthesis_failed 理由で task_failed を返す。孤立したスペック外アーティファクトのプロトコル状態はありません — バイヤーは部分的結果を決して見ません。
• provenance_required: true は C2PA 証明を要求します。 セールスエージェントの製品が provenance_required: true を運びバイヤーがあなたの生成アセットを出荷しているとき、あなたが返すマニフェストは、合成をあなたのエージェント（バイヤーでもセラーでもない）に帰属させる C2PA 互換プロベナンスマニフェストを含まなければなりません（MUST）。EU AI Act Article 50 アライメント。

​

クリエイティブエージェントの移行タイミング

​

バイヤー / DSP

1. 製品の format_ids（v1）または format（v2 インライン）のいずれかを読むようクライアントを更新。
2. レンダーにコミットする前に安価なドライラン検証のため validate_input を使う。
3. マニフェストを構築するとき正準 asset_group_id 語彙 を使う。レジストリの aliases フィールドが v1 時代のスロット名を正準同等物にマップ。
4. 以前通り sync_creatives 経由でクリエイティブを提出。スロットが生成コンテンツを受け入れる製品（ホストリードポッドキャストは script テキストアセットを出荷。生成動画は creative_brief と video_brief を出荷）には、クリエイティブエージェントの build_creative 経由で事前生成してレンダーされたアセット付きマニフェストを取り戻すか、生成コンテンツアセットを直接提出しセラーに内部で生成させる — 両方のフローが有効。

​

パブリッシャーダイレクト（GAM/prebid パス）

1. zip アセットタイプ（asset-vocabulary Phase 1）が HTML5 バナーバンドルをきれいに処理。URL 配信の HTML/JS は適切な url_type で url-asset.json を通してルーティング。
2. タグベース配信（VAST、サードパーティディスプレイタグ）が display_tag、video_vast、audio_daast 正準フォーマットにマップ。
3. ネイティブ正準フォーマットは TemplateCreative + OpenRTB Native 1.2 監査の後 3.2 に延期。それまでネイティブフォーマットは v1 パスに留まる。

​

アダプタータイプ別の現実的タイムライン

​

v1 format_ids はいつ削除されるか?

• フロア（最小 end-of-life）: v1 format_ids は採用シグナルにかかわらず少なくとも 2027-Q4 を通じてサポート。組織の現実（レガシー広告サーバー統合、ウォールドガーデン翻訳ギャップ、遅い調達サイクル）が即座の移行を妨げるアダプターは、3.1 GA から無条件の 18 か月のランウェイを得る。
• シーリング（最大 end-of-life）: v1 format_ids は採用シグナルにかかわらず 2029-Q1 より遅くない時に削除。SDK 作者と検証者メンテナーのロングテール負債を上限とする。3.0 の v2-sunset-policy パターンに一致。
• 採用トリガー（フロア / シーリングウィンドウ内）: AAO はキャッシュされた get_products ケイパビリティレスポンスから format_options を宣言するセールスエージェント（対 format_ids）の比率を計算。トリガーは分母 = supported_protocols に creative を宣言するセールスエージェント。分子 = 最新の get_products レスポンスがすべての製品に format_options を運ぶもの。比率が 80% を超えフロア/シーリングウィンドウ内で 30 連続日そこに留まる とき、5.0 カットシーケンスが開く（非推奨警告がエスカレート。次のメジャーが format_ids を落とす）。そのシグナルがトリップするまで両方の形状が有効なまま。

​

v1 ↔ v2 全体の creative_id 安定性

​

product_card と product_card_detailed はインラインで型付け

"product_card": {
  "image": { "asset_type": "image", "url": "https://...", "width": 300, "height": 400 },
  "title": "Meta Reels — United States",
  "description": "9:16 vertical short-form video on Meta Reels.",
  "price_label": "From $5.50 CPM",
  "cta_label": "View details"
}

"product_card_detailed": {
  "hero_image": { "asset_type": "image", "url": "...", "width": 1200, "height": 600 },
  "carousel_images": [ { "asset_type": "image", "url": "...", ... }, ... ],
  "title": "Meta Reels — United States",
  "description": "Full markdown-friendly product description...",
  "specifications": [
    { "label": "Aspect ratio", "value": "9:16" },
    { "label": "Duration", "value": "3-90s" }
  ],
  "price_label": "From $5.50 CPM",
  "cta_label": "Get proposal"
}

​

OpenRTB が与えないものを v2 が与えるもの

• バイヤーはセラーの絞り込みではなく正準に対して検証する。 OpenRTB には正準層がありません。各 SSP が自身のネイティブアセットスペックを作成（Native 1.2 はプレースメント固有アセットを「実装を見よ」に残した）。各動画プレイヤーが自身の VAST 拡張を作成。各リテールメディアネットワークが自身のカタログフィールド形状を公開。バイヤーはランタイムにセラーごとのスペックを発見し検証しなければならない。v2 の canonical-as-contract は、バイヤー検証をセラーごとのスキーマディスカバリーから分離 — バイヤーは正準 image を満たすマニフェストを出荷し、どのセラーがオークションに勝つかを知る前に、その正準を話す任意のセラーに対して構造的に有効であることを知る。
• ディスカバリーは暗黙ではなく運用的。 OpenRTB Display 1.x と Native 1.2 は、アダプターが仕様を読み、バージョンごとのハンドラーを書き、各セラーが要求するかもしれないもののサポートを事前焼き込みすることを期待。v2 は製品（get_products の format_options[i]）とクリエイティブエージェント（get_adcp_capabilities の creative.supported_formats）にフォーマット宣言をインラインで運ぶ。バイヤーはランタイムに受け入れられるものをフェッチ。SDK コード生成が正準の型付きハンドラーを生成。新しいセラーはバイヤー側コード変更を要求しない。
• 生成ソースはファーストクラス。 OpenRTB には「バイヤーがブリーフを出荷。セラーがレンダー」の概念がない。最も近い表現は提出後の OpenRTB Native の nobid_reason。v2 は生成ソースを宣言されたパラメーター（*_source enum）にするため、生成 DSP とホストリード製品が拒否後だけでなくディスカバリー時に可視。
• トラッキングモデルは正準定義。 OpenRTB トラッキング（インプレッション NURL、クリック NURL、サードパーティトラッカー）は VAST には一貫だがネイティブとディスプレイには断片化。v2 はトラッキングモデルを各正準に焼き込む（image のインプレッションピクセル、html5 の MRAID + OM-SDK、video_vast の VAST イベント、image_carousel のカードごとピクセル） — バイヤーは正準だけからどのトラッキング形状が適用されるかを知る。

​

移行の検証

npm run test:canonical-fixtures

​

関連

• 正準フォーマット概要
• RFC #3305 — アーキテクチャ決定と根拠
• アセットグループ語彙
• BrandRef スキーマ
• ユニバーサルマクロ — 正準トラッキングから参照される置換パターン