> For the complete documentation index, see [llms.txt](https://help.citrusad.com/retail-media-interface/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.citrusad.com/retail-media-interface/integration/ja/feature-integrations/location-targeting.md).

# 地域ターゲティング

地域ターゲティングを使用すると、広告主や小売業者はキャンペーンで特定の地域（店舗や州など）をターゲットに設定できます。これは、オーディエンスを特定の地域に絞り込むために、より広範な掲載枠で使用できます。

{% hint style="success" %}
幅広いディスプレイ掲載枠でのこの機能強化を推奨します

カテゴリまたは広範なディスプレイ掲載枠は閲覧ベースであることが多いため、これらに統合することがベストプラクティスです。検索掲載枠では、キャンペーンがすでに意図でターゲティングされており、広告主が選択できるオーディエンスが減少する可能性があるため、推奨されません。
{% endhint %}

## ハイレベルな概要

弊社の地域ターゲティング機能により、広告主はキャンペーンウィザードで地域を選択できるようになります。これは、検索、カテゴリ、および広範なディスプレイ掲載枠の掲載枠レベルごとに有効にできます。インターフェースの例は以下の通りです：

<figure><img src="/files/6VcKeW5sWVZkMZ03ocAq" alt="" width="100%"><figcaption></figcaption></figure>

この機能はカテゴリターゲティング機能と同様に動作し、選択した商品に同期されている地域を広告主が選択できるようにします。地域が選択されると、確認画面およびキャンペーンマネージャー画面で確認できます。

<figure><img src="/files/4uXxVUL5d1ZEJpqKMN41" alt="" width="100%"><figcaption></figcaption></figure>

## 統合の概要

この統合の一環として、以下を行う必要があります

1. 商品で地域レベルのフィルターを同期する
2. UIフレンドリーな地域名またはマップの地域を以下経由で相互に同期する [filterMapping](/retail-media-interface/integration/ja/citrus-filter-mapping-api/filtermapping.md) API（統合に対する条件付き）
   1\.
   1. これは、名前ではなく地域IDで統合している場合、または地域を相互にマッピングしたい場合（店舗を同期してそれらを州にマッピングしたい場合など）にのみ適用されます。
3. 広告リクエストを強化して地域フィルターをリクエストする

### 商品での地域レベルフィルターの同期

UIに地域を表示するには、関連データ（在庫状況）を各商品で同期する必要があります。統合方法によっては、広告のフィルレートを向上させるために、この情報をすでに同期している場合があります。

#### API経由での同期

もし [API経由での商品同期](/retail-media-interface/integration/ja/data-api/catalog-products-2/syncing-products-via-api.md)の場合、各商品を関連する地域で更新する必要があります `filters` オブジェクト。例は以下の詳細に記載されています [場所情報の同期](/retail-media-interface/integration/ja/data-api/catalog-products-2/syncing-products-via-api.md#syncing-location-information) API経由での商品同期ページのセクション。

#### ファイル経由での同期

もし [ファイル経由でのカタログと商品の同期](/retail-media-interface/integration/ja/data-api/catalog-products-2/syncing-catalog-products-via-file.md)の場合、各商品が在庫されている関連地域を指定する列をファイルに1つ追加するだけで済む可能性が高いです。これは単純にという名前の別の列になります `location`.

{% hint style="info" %}
地域フィルターの形式

地域フィルターの形式は以下にすることを強く推奨します `location:<value>`。この形式はレポートAPIに正確に表示されます。これは、広告を配信するために広告リクエストが利用する必要がある形式と同じです。

ファイル経由で同期している場合、Client Integration Engineerがこれを正確にマッピングします。
{% endhint %}

### filterMapping API経由での地域名の同期

filter mapping APIを使用すると、地域IDを人間が読み取り可能な値にマッピングできます。UIはユーザーに値を表示するため、地域IDを同期する場合はこれが必要です。単一レベルのフィルター（州など）を同期している場合、UIには以下のように各選択肢が表示されます：

<figure><img src="/files/6VcKeW5sWVZkMZ03ocAq" alt="" width="100%"><figcaption></figcaption></figure>

店舗を州または同様の集計にマッピングしている場合、各選択肢にはそれが表す地域フィルターの数が表示されます：

<figure><img src="/files/FCKuDntfA367kyHl11wV" alt="" width="100%"><figcaption></figcaption></figure>

<br>

{% hint style="info" %}
商品カタログ内で人間が読み取り可能な州を地域として以下で同期している場合 Epsilon Retail Media、このステップは必要ありません。
{% endhint %}

#### 広告リクエストの強化

統合方法によっては、広告のフィルレートを向上させるために、この情報をすでに同期している場合があります。これには、ユーザーの地域を以下で指定するようにリクエストを強化することが含まれます `productFilters` オブジェクト。

リクエストの形式は、以下に記載されている広告リクエストと一致する必要があります：

* [商品広告 - 場所によるフィルタリング](/retail-media-interface/integration/ja/generating-ads/product-ads/requesting-product-ads-1.md#filtering-by-location)
* [バナー広告 - 場所によるフィルタリング](/retail-media-interface/integration/ja/generating-ads/banner-ads-static/requesting-banner-ads.md#filtering-by-location)
* [バナー X - 場所によるフィルタリング](/retail-media-interface/integration/ja/generating-ads/banner-x-responsive/requesting-banner-x-ads.md#filtering-by-location)

{% hint style="warning" %}
選択した掲載枠にのみ地域ターゲティングを追加しますか？

この機能強化をすべての掲載枠に実装したい場合もあります。これにより、選択した掲載枠でターゲティングを有効にしている場合でも、すべての掲載枠にわたって実装が標準化されます。
{% endhint %}

## 機能の既知の制限事項

開発を開始する前に、この機能に関する以下の制限事項を理解しておくことを推奨します

* この機能は商品で同期されたフィルターを活用します。商品と地域の在庫状況を同期することで、サポートされているSLAの範囲内に収まるようにすることをお勧めします [サービスレベル合意書 (SLA)](https://citrusad.service-now.com/csm/en/service-support-agreement-service-offerings?id=kb_article_view\&sys_kb_id=c508eee097438d100c0fb18fe153af42)
* この機能は、カテゴリクロスセル、またはレガシー商品クロスセル掲載枠と互換性がありません。
* キャンペーンで選択された地域ごとのUI内レポートはありません
  * この情報は、レポートAPIを利用する小売業者向けのファクトレベルのレポートデータセットに表示されます。外部システムで必要な場合、小売業者は地域レベルのレポートを利用してレポートをロールアップできます。
* 固定掲載の予約ではキャンペーンで地域を選択できますが、予約はキャンペーンレベルでは行えません
  * 予約はカテゴリ、検索用語、または掲載枠レベル（広範なディスプレイ掲載枠の場合）で行われます


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.citrusad.com/retail-media-interface/integration/ja/feature-integrations/location-targeting.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.