ブランドアイデンティティの移行

AdCP 3.0 rc.1 はインラインの brand_manifest オブジェクトを軽量なブランド参照（BrandRef）に置き換える。ブランドデータは実行時に /.well-known/brand.json またはコミュニティブランドレジストリから解決されます。

変更内容

beta.3	rc.1	注記
`brand_manifest`（インラインオブジェクト）	`brand`（`BrandRef`）	参照は実行時に解決される
ブランドデータをすべてのリクエストで渡す	ブランドデータを `brand.json` から一度取得	キャッシュ推奨（24時間 TTL）
標準的なアイデンティティフォーマットなし	`/.well-known/brand.json` 仕様	4つのバリアント: House Portfolio、Brand Agent、House Redirect、Authoritative Location

BrandRef スキーマ

ブランド参照はドメインとオプションの brand_id でブランドを識別する:

{
  "$schema": "https://adcontextprotocol.org/schemas/latest/core/brand-ref.json",
  "domain": "nova-brands.com",
  "brand_id": "spark"
}

domain（必須）— /.well-known/brand.json がホストされているドメイン、またはブランドの運営ドメイン
brand_id（オプション）— ハウスポートフォリオ内のブランド識別子。シングルブランドドメインの場合は省略します。

シングルブランドドメインの場合:

{
  "domain": "acme-corp.com"
}

brand が使われる場所

タスク	必須?	目的
`create_media_buy`	はい	キャンペーンアイデンティティ — 一度設定したら変更不可
`get_products`	いいえ	探索コンテキスト。`catalog` が指定された場合は必須
`build_creative`	いいえ	クリエイティブ生成のためのカラー、ロゴ、トーンを解決する

brand は update_media_buy（作成時から不変）、sync_creatives（アカウントにスコープ）、sync_catalogs（アカウントにスコープ）には使われない。

変更前後

beta.3 — create_media_buy でのインライン brand_manifest:

test=false

{
  "brand_manifest": {
    "name": "Spark",
    "domain": "spark.nova-brands.com",
    "logo_url": "https://spark.nova-brands.com/logo.png",
    "industries": ["consumer_electronics"]
  },
  "account": { "account_id": "acct_nova" },
  "start_time": "2025-04-01T00:00:00Z",
  "end_time": "2025-04-30T23:59:59Z"
}

rc.1 — ブランド参照:

test=false

{
  "brand": {
    "domain": "nova-brands.com",
    "brand_id": "spark"
  },
  "account": { "account_id": "acct_nova" },
  "start_time": "2025-04-01T00:00:00Z",
  "end_time": "2025-04-30T23:59:59Z"
}

セラーはブランドプロトコルを介して nova-brands.com + spark を完全なブランドアイデンティティ（ロゴ、カラー、トーン、プロパティ）に解決します。

解決フロー

BrandRef が与えられた場合、解決の手順は次のとおり:

https://{domain}/.well-known/brand.json を取得します
House Redirect（house フィールドを持つ）の場合、ハウスドメインに従う（最大3リダイレクト）
House Portfolio の場合、brands 配列で brand_id によりブランドを検索します
Brand Agent の場合、動的なブランドデータを取得するために MCP エージェントを呼び出す
Authoritative Location の場合、location URL に従う

セラーは解決されたブランドデータをキャッシュする（検証済みファイルの場合は24時間 TTL 推奨、失敗した検索の場合は1時間）。

移行ステップ

brand_manifest を brand に置き換える

すべてのタスクリクエスト（create_media_buy、get_products、build_creative）で、brand_manifest オブジェクトを brand BrandRef: { "domain": "...", "brand_id": "..." } に置き換える。

brand.json をホストする

ブランドのドメインに /.well-known/brand.json を公開します。バリアントを選択する: マルチブランド企業には House Portfolio、動的データには Brand Agent、シンプルなケースにはシングルブランド。

ブランドレジストリに登録する

ブランドドメインが brand.json をホストしていない場合、セラーが解決できるようにコミュニティブランドレジストリに登録します。

セラーの解決を更新する

セラーエージェントは実行時に BrandRef を完全なブランドデータに解決する必要があります。キャッシュを実装し、4つの brand.json バリアントすべてを処理します。

インラインブランドデータを削除する

brand_manifest オブジェクトを構築または解析するコードを削除します。ブランドデータはインラインで渡されなくなります。

スキーマに対して検証する

リクエストを brand-ref.json スキーマに対して実行します。domain フィールドには有効な小文字のドメインパターンが必要です。