Skip to main content

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

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_nuts2EU 統計リージョン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桁 ZIP10001、90210
us_zip_plus_four米国ZIP+410001-1234
gb_outward英国エリアレベルSW1、EC2
gb_full英国完全な郵便番号SW1A 1AA
ca_fsaカナダフォワードソーティングエリアM5V、V6B
ca_fullカナダ完全な郵便番号M5V 2T6
de_plzドイツPostleitzahl10115、80331
fr_code_postalフランスCode postal75001、13001
au_postcodeオーストラリア郵便番号2000、3000
ch_plzスイスPostleitzahl8000、3000
at_plzオーストリアPostleitzahl1010、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 として機能する — 配信はインクルージョンに一致し、除外に一致してはなりません。

​
移行ステップ

1

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

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

フィールド名を変更する

geo_postal_codes は geo_postal_areas になります。
3

値を再構造化する

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

システムを選択する

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

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

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

除外を追加する

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

ターゲティング

完全なターゲティングリファレンス: オーディエンス、コンテキスト、地理、デバイスターゲティング。
関連: チャンネル | 価格 | クリエイティブ | カタログ | アトリビューション | AdCP 3.0 概要