ジオターゲティングの移行

AdCP 3.0 は暗黙的な米国中心のジオターゲティングを、グローバル市場をサポートする名前付きシステムに置き換える。メトロと郵便ターゲティングには明示的なシステム仕様が必要になり、コードはシステムでグループ化されます。

変更内容

v2 フィールド	v3 フィールド	変更タイプ
`geo_metros`（文字列配列）	`geo_metros`（system/values オブジェクト）	再構造化
`geo_postal_codes`（文字列配列）	`geo_postal_areas`（system/values オブジェクト）	名前変更と再構造化

変更されていないフィールド: geo_countries、geo_countries_exclude、geo_regions、geo_regions_exclude はすべて ISO コードを使用するシンプルな文字列配列のまま。

メトロターゲティング

v2 — コードのフラット配列、Nielsen DMA と仮定:

{
  "targeting": {
    "geo_metros": ["501", "602"]
  }
}

v3 — システムでグループ化されたコード:

{
  "$schema": "https://adcontextprotocol.org/schemas/v3/core/targeting.json",
  "geo_metros": [
    { "system": "nielsen_dma", "values": ["501", "602"] }
  ]
}

各エントリはシステムとそのシステム内のコードを指定します。複数のシステムが共存できる:

{
  "$schema": "https://adcontextprotocol.org/schemas/v3/core/targeting.json",
  "geo_metros": [
    { "system": "nielsen_dma", "values": ["501", "602"] },
    { "system": "uk_itl2", "values": ["UKC1", "UKD3"] }
  ]
}

メトロシステム

システム	カバレッジ	コード例
`nielsen_dma`	米国の指定市場エリア	`501`（ニューヨーク）、`602`（シカゴ）
`uk_itl1`	英国リージョン	`UKC`（北東）、`UKD`（北西）
`uk_itl2`	英国サブリージョン	`UKC1`（ティーズバレー）、`UKD3`（グレーターマンチェスター）
`eurostat_nuts2`	EU 統計リージョン	`DE11`（シュトゥットガルト）、`FR10`（イル・ド・フランス）
`custom`	パブリッシャー定義エリア	パブリッシャー固有のコード

サポートされるシステムは metro-system.json 列挙で定義: nielsen_dma、uk_itl1、uk_itl2、eurostat_nuts2、custom。

郵便ターゲティング

v2 — コードのフラット配列、米国郵便番号（ZIP コード）と仮定:

{
  "targeting": {
    "geo_postal_codes": ["10001", "90210"]
  }
}

v3 — geo_postal_areas に名前変更、コードはシステムでグループ化:

{
  "$schema": "https://adcontextprotocol.org/schemas/v3/core/targeting.json",
  "geo_postal_areas": [
    { "system": "us_zip", "values": ["10001", "90210"] }
  ]
}

郵便システム

システム	カバレッジ	精度	コード例
`us_zip`	米国	5桁 ZIP	`10001`、`90210`
`us_zip_plus_four`	米国	ZIP+4	`10001-1234`
`gb_outward`	英国	エリアレベル	`SW1`、`EC2`
`gb_full`	英国	完全な郵便番号	`SW1A 1AA`
`ca_fsa`	カナダ	フォワードソーティングエリア	`M5V`、`V6B`
`ca_full`	カナダ	完全な郵便番号	`M5V 2T6`
`de_plz`	ドイツ	Postleitzahl	`10115`、`80331`
`fr_code_postal`	フランス	Code postal	`75001`、`13001`
`au_postcode`	オーストラリア	郵便番号	`2000`、`3000`
`ch_plz`	スイス	Postleitzahl	`8000`、`3000`
`at_plz`	オーストリア	Postleitzahl	`1010`、`6020`

サポートされるシステムは postal-system.json 列挙で定義: us_zip、us_zip_plus_four、gb_outward、gb_full、ca_fsa、ca_full、de_plz、fr_code_postal、au_postcode、ch_plz、at_plz。

除外ターゲティング

v3 はメトロと郵便ターゲティングに _exclude バリアントを追加します:

{
  "$schema": "https://adcontextprotocol.org/schemas/v3/core/targeting.json",
  "geo_countries": ["US"],
  "geo_metros_exclude": [
    { "system": "nielsen_dma", "values": ["501"] }
  ]
}

これはニューヨーク DMA を除く米国全体をターゲットにします。

セラーケイパビリティの発見

ジオターゲティングを送信する前に、バイヤーはセラーがリクエストされたシステムをサポートするか確認する必要があります。get_adcp_capabilities を使用します:

{
  "$schema": "https://adcontextprotocol.org/schemas/v3/protocol/get-adcp-capabilities-response.json",
  "adcp": {
    "major_versions": [3]
  },
  "supported_protocols": ["media_buy"],
  "media_buy": {
    "execution": {
      "targeting": {
        "geo_countries": true,
        "geo_regions": true,
        "geo_metros": {
          "nielsen_dma": true
        },
        "geo_postal_areas": {
          "us_zip": true
        }
      }
    }
  }
}

geo_metros と geo_postal_areas オブジェクトはブールプロパティを使ってどのシステムがサポートされているかを示します。セラーが宣言していないシステムをリクエストすると、バリデーションエラーが発生します。

完全なターゲティング例

ジオ制限を組み合わせた v3 ターゲティングオーバーレイ:

{
  "$schema": "https://adcontextprotocol.org/schemas/v3/core/targeting.json",
  "geo_countries": ["US", "CA"],
  "geo_regions": ["US-NY", "US-CA"],
  "geo_metros": [
    { "system": "nielsen_dma", "values": ["501", "803"] }
  ],
  "geo_postal_areas": [
    { "system": "us_zip", "values": ["10001", "10002", "90210"] }
  ]
}

インクルージョンフィールドは AND ロジックで組み合わされる — 配信はすべての指定された制約に一致しなければなりません。エクスクルージョンフィールド（_exclude バリアント）は AND NOT として機能する — 配信はインクルージョンに一致し、除外に一致してはなりません。

移行ステップ

ジオターゲティングを特定する

geo_metros と geo_postal_codes のすべての使用箇所を見つける。

フィールド名を変更する

geo_postal_codes は geo_postal_areas になります。

値を再構造化する

フラット配列を { "system": "...", "values": [...] } オブジェクトにラップします。

システムを選択する

米国のみのコードには nielsen_dma と us_zip を使用します。国際的なコードには適切なシステムを追加します。

ケイパビリティを確認する

各セラーがサポートするシステムを確認するために get_adcp_capabilities を呼び出す。

除外を追加する

必要に応じて、ネガティブターゲティングのために新しい _exclude バリアントを使用します。

ターゲティング

完全なターゲティングリファレンス: オーディエンス、コンテキスト、地理、デバイスターゲティング。

はじめに

AdCP で構築する

プロトコル

FAQ

トラストとセキュリティ

リファレンス

AAO

認定

ジオターゲティングの移行

ジオターゲティングの移行

変更内容

メトロターゲティング

メトロシステム

郵便ターゲティング

郵便システム

除外ターゲティング

セラーケイパビリティの発見

完全なターゲティング例

移行ステップ

ターゲティング

​ジオターゲティングの移行

​変更内容

​メトロターゲティング

​メトロシステム

​郵便ターゲティング

​郵便システム

​除外ターゲティング

​セラーケイパビリティの発見

​完全なターゲティング例

​移行ステップ

ターゲティング

ジオターゲティングの移行

変更内容

メトロターゲティング

メトロシステム

郵便ターゲティング

郵便システム

除外ターゲティング

セラーケイパビリティの発見

完全なターゲティング例

移行ステップ