> ## Documentation Index
> Fetch the complete documentation index at: https://adcp-docs-ja.pier1.co.jp/llms.txt
> Use this file to discover all available pages before exploring further.

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

> AdCP ジオターゲティングを v2 から v3 に移行します。暗黙的な米国中心のターゲティングを、グローバル市場サポートのための名前付きシステム（Nielsen DMA、郵便番号）に置き換える。

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

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 と仮定:

```json theme={null}
{
  "targeting": {
    "geo_metros": ["501", "602"]
  }
}
```

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

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

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

```json theme={null}
{
  "$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 コード）と仮定:

```json theme={null}
{
  "targeting": {
    "geo_postal_codes": ["10001", "90210"]
  }
}
```

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

```json theme={null}
{
  "$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` バリアントを追加します:

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

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

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

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

```json theme={null}
{
  "$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 ターゲティングオーバーレイ:

```json theme={null}
{
  "$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 として機能する — 配信はインクルージョンに一致し、除外に一致してはなりません。

## 移行ステップ

<Steps>
  <Step title="ジオターゲティングを特定する">
    `geo_metros` と `geo_postal_codes` のすべての使用箇所を見つける。
  </Step>

  <Step title="フィールド名を変更する">
    `geo_postal_codes` は `geo_postal_areas` になります。
  </Step>

  <Step title="値を再構造化する">
    フラット配列を `{ "system": "...", "values": [...] }` オブジェクトにラップします。
  </Step>

  <Step title="システムを選択する">
    米国のみのコードには `nielsen_dma` と `us_zip` を使用します。国際的なコードには適切なシステムを追加します。
  </Step>

  <Step title="ケイパビリティを確認する">
    各セラーがサポートするシステムを確認するために `get_adcp_capabilities` を呼び出す。
  </Step>

  <Step title="除外を追加する">
    必要に応じて、ネガティブターゲティングのために新しい `_exclude` バリアントを使用します。
  </Step>
</Steps>

<Card title="ターゲティング" icon="arrow-right" href="/docs/media-buy/advanced-topics/targeting">
  完全なターゲティングリファレンス: オーディエンス、コンテキスト、地理、デバイスターゲティング。
</Card>

***

**関連:** [チャンネル](/docs/reference/migration/channels) | [価格](/docs/reference/migration/pricing) | [クリエイティブ](/docs/reference/migration/creatives) | [カタログ](/docs/reference/migration/catalogs) | [アトリビューション](/docs/reference/migration/attribution) | [AdCP 3.0 概要](/docs/reference/whats-new-in-v3)