> 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/cs/feature-integrations/location-targeting.md).
# Cílení na polohu
Cílení na polohu umožňuje inzerentům nebo prodejcům cílit ve svých kampaních na konkrétní místa (například prodejny nebo státy). To lze použít u širších umístění k zúžení publika na určitou polohu.
{% hint style="success" %}
Toto vylepšení doporučujeme u širších umístění display na webu
Naším osvědčeným postupem je integrovat tuto funkci do kategorií nebo širších umístění display na webu, protože ta jsou více založena na procházení. Nedoporučujeme to u vyhledávacích umístění, protože kampaně jsou již cíleny podle záměru a toto může zmenšit volitelné publikum inzerenta.
{% endhint %}
## Přehled na vysoké úrovni
Naše funkce cílení na polohu umožňuje inzerentům vybrat polohy v průvodci kampaní. To lze povolit na úrovni jednotlivých umístění pro vyhledávání, kategorie a širší umístění display na webu. Příklad rozhraní je uveden níže:
Tato funkce funguje podobně jako naše funkce cílení na kategorie a umožňuje inzerentům vybrat polohy, které jsou synchronizovány u jejich vybraných produktů. Jakmile jsou polohy vybrány, lze je zobrazit na obrazovkách kontroly a správce kampaní.
## Přehled integrace
V rámci této integrace budete muset provést následující krok
1. Synchronizovat filtry na úrovni polohy u vašich produktů
2. Synchronizovat uživatelsky přívětivé názvy poloh nebo mapovat polohy společně prostřednictvím [filterMapping](/retail-media-interface/integration/cs/citrus-filter-mapping-api/filtermapping.md) API (podmíněno integrací)
1\.
1. Toto platí pouze v případě, že jste integrováni s ID poloh namísto názvů, nebo chcete mapovat polohy společně (například synchronizovat prodejny a chtít je mapovat na státy).
3. Vylepšit váš požadavek na reklamu o požadavek na filtry polohy
### Synchronizace filtrů na úrovni polohy u vašich produktů
Pro zobrazení poloh v UI je třeba synchronizovat příslušná data (dostupnost) u každého produktu. V závislosti na vaší integraci již možná tyto informace synchronizujete pro zlepšení míry vyplnění reklam.
#### Synchronizace přes API
Pokud [Synchronizujete produkty přes API](/retail-media-interface/integration/cs/data-api/catalog-products-2/syncing-products-via-api.md), budete muset aktualizovat každý produkt o příslušné polohy v `filters` objektu. Příklad je podrobně popsán v sekci [Synchronizace informací o poloze](/retail-media-interface/integration/cs/data-api/catalog-products-2/syncing-products-via-api.md#syncing-location-information) na stránce Synchronizace produktů přes API.
#### Synchronizace pomocí souboru
Pokud [Synchronizujete katalog a produkty pomocí souboru](/retail-media-interface/integration/cs/data-api/catalog-products-2/syncing-catalog-products-via-file.md), pravděpodobně stačí do souboru přidat další sloupec, který určuje příslušnou polohu (polohy), ve kterých je každý produkt skladem. Bude to jednoduše další sloupec s názvem `location`.
{% hint style="info" %}
Formát filtru polohy
Důrazně doporučujeme, aby formát vašich filtrů polohy byl `location:`. Tento formát se správně zobrazí v API pro výkazy. Jedná se o stejný formát, který bude muset požadavek na reklamu využívat pro zobrazování reklam.
Pokud synchronizujete pomocí souboru, váš Client Integration Engineer to pro vás může správně namapovat.
{% endhint %}
### Synchronizace názvů poloh přes filterMapping API
API pro mapování filtrů lze použít k namapování vašich ID poloh na hodnoty čitelné pro člověka. To je vyžadováno, pokud synchronizujete ID poloh, protože UI zobrazuje tyto hodnoty vašim uživatelům. Pokud synchronizujete jednonástrojové filtry (například stát), UI zobrazí každý výběr jako níže:
Pokud mapujete prodejny na státy nebo podobný agregát, každý výběr zobrazí počet filtrů polohy, které představuje:
{% hint style="info" %}
Pokud synchronizujete lidsky čitelné státy jako polohy ve svém katalogu produktů s Epsilon Retail Media, tento krok nebude vyžadován.
{% endhint %}
#### Vylepšení vašeho požadavku na reklamu
V závislosti na vaší integraci již možná tyto informace synchronizujete pro zlepšení míry vyplnění reklam. To obnáší vylepšení vašeho požadavku tak, aby specifikoval polohu uživatele v `productFilters` objektu.
Formát vašeho požadavku by měl odpovídat požadavku na reklamu, jak je uvedeno níže:
* [Produktová reklama - filtrování podle polohy](/retail-media-interface/integration/cs/generating-ads/product-ads/requesting-product-ads-1.md#filtering-by-location)
* [Bannerová reklama - filtrování podle polohy](/retail-media-interface/integration/cs/generating-ads/banner-ads-static/requesting-banner-ads.md#filtering-by-location)
* [Banner X - filtrování podle polohy](/retail-media-interface/integration/cs/generating-ads/banner-x-responsive/requesting-banner-x-ads.md#filtering-by-location)
{% hint style="warning" %}
Přidání cílení na polohu pouze do vybraného umístění?
Možná budete chtít toto vylepšení implementovat napříč všemi vašimi umístěními. Tím se standardizuje vaše implementace napříč všemi umístěními, i když cílení povolíte pouze u vybraných umístění.
{% endhint %}
## Známá omezení funkcionality
Než začnete s vývojem, doporučujeme porozumět níže uvedeným omezením této funkcionality
* Tato funkce využívá filtry synchronizované na produktech; doporučujeme zajistit, aby synchronizace dostupnosti produktů podle polohy zůstala v rámci podporované SLA [Dohoda o úrovni služeb (SLA)](https://citrusad.service-now.com/csm/en/service-support-agreement-service-offerings?id=kb_article_view\&sys_kb_id=c508eee097438d100c0fb18fe153af42)
* Tato funkce není kompatibilní s cross-sell umístěními v kategoriích nebo se staršími produktovými cross-sell umístěními.
* V UI nejsou k dispozici žádné přehledy podle polohy (poloh) vybraných v kampani
* Tyto informace se zobrazují v datových sadách přehledů na úrovni faktů pro prodejce, kteří využívají reportingové API. Přehledy na úrovni polohy jsou k dispozici pro prodejce k agregaci výkazů v případě potřeby v externích systémech.
* Rezervace typu Fixní umístění vám umožňují vybrat polohy v kampani, ale rezervace nelze provádět na úrovni jednotlivých kampaní
* Rezervace se provádějí na úrovni kategorie, vyhledávaného výrazu nebo umístění (pro širší umístění display na webu)
---
# 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/cs/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.