​

プレリリースアップグレードノート

​

rc.3 → 3.0

​

rc.3 採用者にとって破壊的

​

Media buy status migration

1. ステータスフィルター — get_media_buys と get_media_buy_delivery の status_filter 配列で、pending_activation を pending_creatives と pending_start の両方に置き換え。
2. ステータス比較 — 任意の if (status === 'pending_activation') は、チェックしている条件で分岐する必要がある。「まだ配信していない」が欲しいなら pending_creatives と pending_start の両方をチェック。「準備完了だがフライト日待ち」が欲しいなら pending_start のみをチェック。
3. ステートマシン遷移 — rejected は今や pending_creatives と pending_start の両方から有効（以前は pending_activation からのみ）。pending_creatives → pending_start は、クリエイティブが sync_creatives 経由で割り当てられたときに起こる。
4. レガシーエイリアス — pending は配信レスポンスステータスフィルターで pending_start のエイリアスとして受け入れられ続ける。

​

Capabilities model simplification

{
  "features": {
    "content_standards": true,
    "audience_targeting": true
  },
  "trusted_match": {
    "supported": true,
    "uid_types": ["email_sha256"]
  }
}

{
  "content_standards": { ... },
  "audience_targeting": { ... },
  "trusted_match": {
    "uid_types": ["email_sha256"]
  }
}

​

preview_creative schema flattening

{
  "creative_manifest": { "format_id": { ... }, "assets": { ... } }
}

{
  "request_type": "single",
  "creative_manifest": { "format_id": { ... }, "assets": { ... } }
}

​

Governance lifecycle migration

{
  "media_buy_id": "mb_456",
  "planned_delivery": { ... }
}

{
  "governance_context": "campaign_2024_q4_nova",
  "purchase_type": "media_buy",
  "planned_delivery": { ... }
}

​

context and ext fields

​

Additive changes in 3.0

• RFC 9421 リクエスト署名プロファイル（3.0 では任意、AdCP Verified の下では必須） — 正準化されたカバードコンポーネントリストを持つ Ed25519 HTTP Message Signatures。公開されたテストベクターは static/compliance/source/test-vectors/request-signing/。ビット同一の正準入力のため sf-binary エンコーディングと URL 正準化がピン留め。keyid cap-before-crypto を持つ 15 ステップの検証チェックリスト。
• RFC 9421 に統一された Webhook 署名 — webhook を発するセラーにベースライン必須。セラーは jwks_uri の JWKS に署名 JWK を公開。新しい署名者は webhook 配信に adcp_use: "request-signing" を使う一方、非推奨の webhook-signing キーは互換性ウィンドウ中受け入れられたまま。webhook 専用の鍵素材が欲しい場合は異なる kid を使う。Security ガイド の 14 ステップの webhook 検証者チェックリスト。HMAC-SHA256 は 3.x を通じてレガシーフォールバックのまま（authentication オブジェクト全体は 4.0 で削除）。
• すべての webhook ペイロードで必須の idempotency_key — 5 つすべての webhook ペイロードスキーマにわたる送信者生成の UUID v4。脆弱な (task_id, status, timestamp) 重複排除を置き換え。プロトコル全体の一貫性のため revocation-notification.notification_id を idempotency_key にリネーム。
• すべての spend-commit での check_governance — ガバナンス呼び出しは、プラン承認時だけでなくコミット時に必須。部分的な支出がガバナンスをスキップできる抜け穴を閉じる。
• 実験的ステータスメカニズム — 本番使用中だがまだ完全な安定性保証下にないフィールドとタスクのための status: experimental マーカー。シグナルの custom 価格モデルエスケープハッチ。
• create_media_buy の submitted ブランチ — セラーは処理のためにペイロードを受け入れたがまだオーダーを確認していない。pending_creatives と pending_start とは別。
• 時間セマンティクス + activate_signal 冪等性 — プロトコルをまたいで時間フィールドセマンティクスを統一。activate_signal を必須冪等性テーブルに追加。
• 既知の制限 + プライバシー考慮事項のリファレンスページ — 新しい /docs/reference/known-limitations と /docs/reference/privacy-considerations。プラットフォーム非依存リントがベンダー固有の言語が仕様に忍び込むのを防ぐ。
• 署名付き JWS governance_context — ガバナンス決定は今や暗号学的に検証可能。セラーは sync_governance 経由でガバナンスエージェントの JWKS を解決し、決定を尊重する前に sub / aud / phase / exp を検証する。
• ユニバーサルセキュリティストーリーボード — すべてのエージェントが /compliance/{version}/universal/security.yaml を実行（未認証拒否、API キー、OAuth/RFC 9728、オーディエンスバインド）。署名を宣言するエージェントは signed_requests ハーネスも実行。
• クロスインスタンス状態永続性 — アーキテクチャ仕様が、水平スケールされたインスタンスをまたいだ永続状態（タスク、メディアバイ、プラン、署名付きアーティファクト、冪等性キー）を要求。
• セキュリティ実装ガイド — 新しい docs/building/by-layer/L1/security.mdx が脅威モデル、3 プリンシパルモデル（brand / operator / agent）、検証パスを文書化。曖昧な「principal」用語を廃止。
• スキーマ不変条件としての GDPR 第 22 条 / EU AI Act Annex III — 新しいレジストリポリシー eu_ai_act_annex_iii。ポリシーとカテゴリーの requires_human_review。規制されたバーティカルの human_review_required: true のスキーマレベル強制。
• エージェントの運用ガイド — エンジニアリングチームを持たないパブリッシャーのための新しいドキュメント — 3 つのパス: パートナー、セルフホスト、ビルド。
• リリースケイデンスポリシー — 名前付きケイデンス: パッチ月次、マイナー四半期、必要ならメジャー年次。v2 EOL 2026 年 8 月 1 日。
• CHARTER.md — 正式なガバナンス憲章を公開。
• コレクションリスト — クロスパブリッシャーマッチングに配信識別子（IMDb、Gracenote、EIDR）を使うプログラムレベルのブランドセーフティ。新しいターゲティングオーバーレイフィールド（collection_list、collection_list_exclude）。新しいジャンルタクソノミー enum。
• 放送 TV サポート — Ad-ID 識別子、放送スポットフォーマット（:15、:30、:60）、Agency Estimate Number、測定ウィンドウ（Live、C3、C7）、配信データの完全性（is_final、measurement_window）。
• オフラインレポート配信 — ケイパビリティの reporting_delivery_methods、アカウントの reporting_bucket、プロダクト reporting_capabilities の supports_offline_delivery。Avro と ORC をファイルフォーマットオプションとして追加。
• TMPX エクスポージャートラッキング — Trusted Match Protocol 実行層のための国分割アイデンティティとマクロ接続。
• TMP プロバイダー登録 — provider-registration.json スキーマ、GET /health エンドポイント、デュアルディスカバリーモデル（静的設定と動的 API）、プロバイダーごとのレイテンシー予算セマンティクス。
• TMP マルチアイデンティティ Identity Match — identity-match-request が単一の user_token + uid_type を identities 配列（minItems 1、maxItems 3）に置き換え。ルーターはプロバイダーごとにフィルターし RFC 8785 JCS 正準化で再署名。キャッシュキーは consent_hash を追加。uid-type enum に rampid_derived を追加。以前のプレリリース TMP ドラフトに対してのみ破壊的。TMP は 3.0 でプレリリースのままで 3.1.0 で安定化。
• GOVERNANCE_DENIED エラー — ガバナンス拒否された操作のための新しい correctable エラーコード。
• context/ext フィールド — ガバナンス、コレクション、プロパティ、SI、コンテンツ標準プロトコルにわたるすべてのリクエスト/レスポンススキーマで任意の context と ext。
• コンプライアンステストケイパビリティ — エージェントは、サポートする comply_test_controller シナリオを宣言する compliance_testing: { scenarios: [...] } ブロックを get_adcp_capabilities に含める。ブロックの存在がシグナル — コンプライアンステストは supported_protocols の値では ない。ストーリーボードランナーは、決定的テストステップが検証できるかを判断するためにこのブロックを使う。
• 専門分野 + コンプライアンスカタログ — ストーリーボードは /compliance/{version}/（universal + protocols + specialisms + test-kits）でプロトコルに出荷。6 プロトコルにわたる 19 値の新しい specialisms フィールドを get_adcp_capabilities に追加。/protocol/{version}.tgz のバージョンごとのプロトコル tarball。Compliance Catalog を参照。
• 構造化された測定条件 — 課金ベンダー、IVT しきい値、ビューアビリティフロアの交渉のためのプロダクトとメディアバイの measurement_terms。保証プロダクトの cancellation_policy。viewability-standard enum。TERMS_REJECTED エラーコード。
• 統一されたベンダー価格 — list_creatives、build_creative、get_creative_features、property-list の pricing_options[]。共有の vendor-pricing-option.json スキーマ。
• リクエストごとのバージョン宣言 — すべての v3 リクエストスキーマの adcp_major_version。VERSION_UNSUPPORTED エラーコード。v2 クライアントをサポートするマルチバージョンセラーは、このフィールドではなく構造的な手がかりで v2 ペイロードを検出しなければならない（v2 スキーマにはそれがない）。
• 放送予測スキーマ — DeliveryForecast の measurement_source、packages、guaranteed_impressions。新しい forecast-range-unit と forecastable-metric enum。
• 放送局識別子 — station_id と facility_id 識別子タイプ。linear_tv プロパティタイプ。
• ブランドスキーマ拡張 — brand.json の汎用 agents 配列。ビジュアルトークン（border_radius、elevation、spacing、拡張カラーロール）。構造化フォント定義。
• アイテムごとのエラースキーマ — sync_creatives、sync_catalogs、sync_event_sources のレスポンスエラーは今や error.json ref を使う。
• プロパティ関係フィールド — adagents.json 委譲タイプとの双方向検証のための brand.json プロパティ定義の relationship（owned、direct、delegated、ad_network）。
• sales エージェントタイプの復活 — sales が brand-agent-type enum に復活。セールスエージェント（SSP、パブリッシャー）は購買エージェント（DSP、バイヤープラットフォーム）とは別。
• 必須タスクリファレンス — エージェントロールごとにすべての AdCP プロトコルにわたる必須、条件付き、任意タスクを統合する新しいリファレンスページ。
• ストーリーボード検証の修正 — 11 のストーリーボードファイルにわたる 20 以上の検証バグを修正: フィールドパスを訂正（creatives[0].action、media_buy_deliveries、renders[0].preview_url）、field_value チェックに欠けていた value: を追加、ストーリーボード検証スキーマに value プロパティを追加。

​

rc.1 → rc.2

​

rc.1 採用者にとって潜在的に破壊的

​

Additive changes in rc.2

• クリエイティブ生成とプレビュー — build_creative が include_preview、preview_inputs、preview_quality、preview_output_format、quality、item_limit、マルチフォーマット target_format_ids を追加。バイヤーは今やインラインでプレビューし、ドラフト対本番生成を選び、1 回の呼び出しで複数の出力フォーマットをリクエストできる。
• クリエイティブライブラリ取得 — build_creative は creative_id、任意の concept_id、media_buy_id、package_id、macro_values を使ったライブラリ取得もサポートし、アドサーバーとクリエイティブプラットフォームが保存されたクリエイティブを配信可能なマニフェストに解決できる。
• クリエイティブケイパビリティディスカバリー — クリエイティブエージェントは supports_generation、supports_transformation、has_creative_library を宣言できる。list_creatives は今や include_snapshot、has_served、items のようなライブラリ指向のフィールドを使う。
• プロダクトディスカバリーとプランニング — get_products が exclusivity、preferred_delivery_types、time_budget を追加、レスポンスに incomplete。プロダクトは delivery_measurement を省略でき、パッケージは今やパッケージごとの start_time / end_time を運べる。
• コンプライアンスとガバナンス — クリエイティブ開示が永続性セマンティクスを追加、キャンペーンガバナンスが sync_plans、check_governance、report_plan_outcome、get_plan_audit_logs を導入。
• アカウントとサンドボックスの人間工学 — sync_accounts が payment_terms を追加、サンドボックスが今やバイヤー宣言アカウント参照の自然アカウントキーに参加。

​

ヘルプが必要ですか？

• コミュニティ: Slack — 他の実装者への手早い質問に最適
• Issues: GitHub Issues — バグ、仕様の質問、移行のエッジケース
• 完全な v2 → v3 移行: 移行ガイド