> 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/sk/feature-integrations/location-targeting.md).
# Cielenie na polohu
Cielenie na polohu umožňuje inzerentom alebo maloobchodníkom cieliť v ich kampaniach na špecifické polohy (ako sú predajne alebo štáty). To sa dá použiť pri širších umiestneniach na zúženie publika na určitú polohu.
{% hint style="success" %}
Témo vylepšenie odporúčame pri širokých umiestneniach Display
Naším najlepším postupom je integrovať to na kategóriových umiestneniach alebo širokých umiestneniach Display, keďže tie sú viac založené na prehliadaní. Neodporúčame to pri vyhľadávacích umiestneniach, pretože kampane sú už zacielené na zámer a toto môže znížiť vybrateľné publikum inzerenta.
{% endhint %}
## Prehľad na vysokej úrovni
Naša schopnosť cielenia na polohu umožňuje inzerentom vybrať polohy v sprievodcovi kampaňou. Toto je možné povoliť na úrovni jednotlivých umiestnení pre vyhľadávacie, kategóriové a široké umiestnenia Display. Príklad rozhrania je uvedený nižšie:
Táto funkčnosť funguje podobne ako naša funkčnosť cielenia na kategórie a umožňuje inzerentom vybrať polohy, ktoré sú synchronizované na ich vybraných produktoch. Po výbere polôh ich možno vidieť na obrazovkách kontroly a správcu kampaní.
## Prehľad integrácie
V rámci tejto integrácie budete musieť vykonať nasledujúce kroky
1. Synchronizovať filtre na úrovni polohy na vašich produktoch
2. Synchronizovať používateľsky prívetivé názvy polôh alebo mapovať polohy spoločne cez [filterMapping](/retail-media-interface/integration/sk/citrus-filter-mapping-api/filtermapping.md) API (podmienené integráciou)
1\.
1. Toto platí len vtedy, ak ste integrovaní s ID polôh namiesto názvov, alebo ak chcete mapovať polohy spoločne (napríklad synchronizovať predajne a chcieť ich namapovať na štáty).
3. Vylepšiť vašu žiadosť o reklamu na vyžiadanie filtrov polohy
### Synchronizácia filtrov na úrovni polohy na vašich produktoch
Na zobrazenie polôh v UI je potrebné relevantné dáta (dostupnosť) synchronizovať na každom produkte. V závislosti od vašej integrácie už možno tieto informácie synchronizujete na zlepšenie miery vyplnenia reklám.
#### Synchronizácia cez API
Ak [synchronizujete produkty cez API](/retail-media-interface/integration/sk/data-api/catalog-products-2/syncing-products-via-api.md), budete musieť aktualizovať každý produkt s príslušnými polohami v `filters` objekte. Príklad je podrobne popísaný v [synchronizácii informácií o polohe](/retail-media-interface/integration/sk/data-api/catalog-products-2/syncing-products-via-api.md#syncing-location-information) sekcii stránky Synchronizácia produktov cez API.
#### Synchronizácia cez súbor
Ak [synchronizujete katalóg a produkty cez súbor](/retail-media-interface/integration/sk/data-api/catalog-products-2/syncing-catalog-products-via-file.md), je pravdepodobné, že stačí pridať do súboru ďalší stĺpec, ktorý špecifikuje príslušnú polohu (polohy), v ktorej je každý produkt na sklade. Pôjde jednoducho o ďalší stĺpec s názvom `location`.
{% hint style="info" %}
Formát filtra polohy
Dôrazne odporúčame, aby formát vašich filtrov polohy bol `location:`. Tento formát sa správne zobrazí v reportingovom API. Ide o rovnaký formát, aký bude musieť žiadosť o reklamu využívať na zobrazovanie reklám.
Ak synchronizujete cez súbor, váš Client Integration Engineer to môže pre vás správne namapovať.
{% endhint %}
### Synchronizácia názvov polôh cez filterMapping API
API na mapovanie filtrov možno použiť na namapovanie vašich ID polôh na hodnoty čitateľné pre ľudí. Toto je potrebné, ak synchronizujete ID polôh, keďže UI zobrazuje hodnoty vašim používateľom. Ak synchronizujete jednohladinové filtre (ako je štát), UI zobrazí každý výber ako je znázornené nižšie:
Ak mapujete predajne na štáty alebo podobný agregát, každý výber zobrazí počet filtrov polohy, ktoré predstavuje:
{% hint style="info" %}
Ak synchronizujete ľudsky čitateľné štáty ako polohy vo vašom katalógu produktov s Epsilon Retail Media, tento krok nebude potrebný.
{% endhint %}
#### Vylepšenie vašej žiadosti o reklamu
V závislosti od vašej integrácie už možno tieto informácie synchronizujete na zlepšenie miery vyplnenia reklám. To zahŕňa vylepšenie vašej žiadosti tak, aby špecifikovala polohu používateľa v `productFilters` objekte.
Formát vašej žiadosti by mal zodpovedať žiadosti o reklamu, ako je uvedené nižšie:
* [Produktová reklama - filtrovanie podľa polohy](/retail-media-interface/integration/sk/generating-ads/product-ads/requesting-product-ads-1.md#filtering-by-location)
* [Bannerová reklama - filtrovanie podľa polohy](/retail-media-interface/integration/sk/generating-ads/banner-ads-static/requesting-banner-ads.md#filtering-by-location)
* [Banner X - filtrovanie podľa polohy](/retail-media-interface/integration/sk/generating-ads/banner-x-responsive/requesting-banner-x-ads.md#filtering-by-location)
{% hint style="warning" %}
Pridanie cielenia na polohu len pre vybrané umiestnenie?
Možno budete chcieť implementovať toto vylepšenie naprieč všetkými vašimi umiestneniami. Tým sa štandardizuje vaša implementácia naprieč všetkými umiestneniami, aj keď povolíte cielenie len na vybraných umiestneniach.
{% endhint %}
## Známé obmedzenia funkčnosti
Pred začatím vývoja odporúčame porozumieť nižšie uvedeným obmedzeniam tejto funkčnosti
* Táto funkčnosť využíva filtre synchronizované na produktoch; odporúčame zabezpečiť, aby ste synchronizáciou dostupnosti produktov v polohách zostali v rámci podporovaného SLA [Dohoda o úrovni služieb](https://citrusad.service-now.com/csm/en/service-support-agreement-service-offerings?id=kb_article_view\&sys_kb_id=c508eee097438d100c0fb18fe153af42)
* Táto funkčnosť nie je kompatibilná s kategóriovým kros-selom ani s legacy produktovými kros-selovými umiestneniami.
* V UI nie je k dispozícii reporting podľa polohy (polôh) vybranej v kampani
* Tieto informácie sa zobrazujú v reportingových dátových sadách na úrovni faktov pre maloobchodníkov, ktorí využívajú reportingové API. Reporting na úrovni polohy je pre maloobchodníkov k dispozícii na agregáciu reportov, ak je to potrebné v externých systémoch.
* Rezervácie typu Fixné umiestnenie vám umožňujú vybrať polohy v kampani, ale rezervácie nie je možné vykonať na úrovni jednotlivej kampane
* Rezervácie sa vykonávajú na úrovni kategórie, vyhľadávacieho výrazu alebo umiestnenia (pre široké umiestnenia Display)
---
# 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/sk/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.