> 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/ko/feature-integrations/location-targeting.md).
# 위치 타겟팅
위치 타겟팅을 사용하면 광고주나 리테일러가 캠페인에서 특정 위치(예: 매장 또는 주)를 타겟팅할 수 있습니다. 이는 더 광범위한 게재 위치에서 타겟 대상을 특정 위치로 축소하는 데 사용할 수 있습니다.
{% hint style="success" %}
권장 사항: 광범위한 디스플레이 게재 위치에 이 기능 추가
카테고리 또는 광범위한 디스플레이 게재 위치는 탐색 기반이므로 이 향상 기능을 해당 게재 위치에 통합하는 것이 모범 사례입니다. 검색 게재 위치는 캠페인이 이미 의도 타겟팅되어 있어 광고주가 선택할 수 있는 타겟 대상을 줄일 수 있으므로 권장하지 않습니다.
{% endhint %}
## 개요
당사의 위치 타겟팅 기능을 통해 광고주는 캠페인 마법사에서 위치를 선택할 수 있습니다. 이는 검색, 카테고리 및 광범위한 디스플레이 게재 위치에 대해 게재 위치별로 활성화할 수 있습니다. 인터페이스 예시는 다음과 같습니다.
이 기능은 카테고리 타겟팅 기능과 유사하게 작동하여 광고주가 선택한 상품에 동기화된 위치를 선택할 수 있도록 합니다. 위치가 선택되면 검토 및 캠페인 관리자 화면에서 확인할 수 있습니다.
## 통합 개요
이 통합의 일환으로 아래 작업을 수행해야 합니다.
1. 상품의 위치 수준 필터 동기화
2. 다음 항목을 통해 UI 친화적인 위치 이름 또는 지도 위치를 함께 동기화합니다. [filterMapping](/retail-media-interface/integration/ko/citrus-filter-mapping-api/filtermapping.md) API (통합 조건부)
1\.
1. 이는 이름 대신 위치 ID와 통합되었거나 위치를 함께 매핑하려는 경우(예: 매장을 동기화하고 이를 주로 매핑하려는 경우)에만 적용됩니다.
3. 광고 요청을 향상시켜 위치 필터 요청
### 상품의 위치 수준 필터 동기화
UI에 위치를 표시하려면 각 상품에 관련 데이터(재고 유무)를 동기화해야 합니다. 통합 방식에 따라 광고 충전율을 높이기 위해 이미 이 정보를 동기화하고 있을 수도 있습니다.
#### API를 통한 동기화
다음 방식을 사용하는 경우 [API를 통한 상품 동기화](/retail-media-interface/integration/ko/data-api/catalog-products-2/syncing-products-via-api.md), 각 상품을 다음의 관련 위치로 업데이트해야 합니다. `filters` 객체. 예시는 다음의 [위치 정보 동기화](/retail-media-interface/integration/ko/data-api/catalog-products-2/syncing-products-via-api.md#syncing-location-information) 섹션(API를 통한 상품 동기화 페이지)에 자세히 설명되어 있습니다.
#### 파일을 통한 동기화
다음 방식을 사용하는 경우 [파일을 통한 카탈로그 및 상품 동기화](/retail-media-interface/integration/ko/data-api/catalog-products-2/syncing-catalog-products-via-file.md), 각 상품이 재고로 보유된 관련 위치를 지정하는 추가 열을 파일에 추가하기만 하면 될 가능성이 높습니다. 이는 단순히 다음과 같은 이름의 다른 열이 됩니다. `location`.
{% hint style="info" %}
위치 필터 형식
위치 필터 형식을 다음으로 설정할 것을 강력히 권장합니다. `location:`. 이 형식은 보고 API에 올바르게 표시됩니다. 이는 광고를 게재하기 위해 광고 요청이 활용해야 하는 것과 동일한 형식입니다.
파일을 통해 동기화하는 경우 Client Integration Engineer가 이를 올바르게 매핑해 드릴 수 있습니다.
{% endhint %}
### filterMapping API를 통한 위치 이름 동기화
filter mapping API를 사용하여 위치 ID를 사람이 읽을 수 있는 값으로 매핑할 수 있습니다. UI에 사용자에게 값이 표시되므로 위치 ID를 동기화하는 경우 이 작업이 필요합니다. 단일 수준 필터(예: 주)를 동기화하는 경우 UI에 각 선택 사항이 아래와 같이 표시됩니다.
매장을 주로 매핑하거나 이와 유사한 집계를 수행하는 경우 각 선택 사항에 해당 필터가 나타내는 위치 필터 수가 표시됩니다.
{% hint style="info" %}
상품 카탈로그에서 사람이 읽을 수 있는 주를 위치로 동기화하는 경우 Epsilon Retail Media, 이 단계는 필요하지 않습니다.
{% endhint %}
#### 광고 요청 향상
통합 방식에 따라 광고 충전율을 높이기 위해 이미 이 정보를 동기화하고 있을 수도 있습니다. 이를 위해서는 광고 요청을 향상시켜 다음 항목에서 사용자의 위치를 지정해야 합니다. `productFilters` 객체.
요청 형식은 아래 나열된 광고 요청과 일치해야 합니다.
* [상품 광고 - 위치별 필터링](/retail-media-interface/integration/ko/generating-ads/product-ads/requesting-product-ads-1.md#filtering-by-location)
* [배너 광고 - 위치별 필터링](/retail-media-interface/integration/ko/generating-ads/banner-ads-static/requesting-banner-ads.md#filtering-by-location)
* [배너 X - 위치별 필터링](/retail-media-interface/integration/ko/generating-ads/banner-x-responsive/requesting-banner-x-ads.md#filtering-by-location)
{% hint style="warning" %}
선택한 게재 위치에만 위치 타겟팅을 추가하시겠습니까?
모든 게재 위치에 걸쳐 이 향상 기능을 구현하고자 할 수 있습니다. 이렇게 하면 선택한 게재 위치에서 타겟팅을 활성화하더라도 모든 게재 위치에 걸쳐 구현이 표준화됩니다.
{% endhint %}
## 알려진 기능 제한 사항
개발을 시작하기 전에 이 기능의 아래 제한 사항을 이해하는 것이 좋습니다.
* 이 기능은 상품에 동기화된 필터를 활용하므로 상품-위치 재고 유무를 동기화하여 지원되는 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/ko/feature-integrations/location-targeting.md?ask=&goal=
```
`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.