> 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/hu/feature-integrations/location-targeting.md).
# Helyszerinti célzás
A hely szerinti célzás lehetővé teszi a hirdetők vagy kiskereskedők számára, hogy konkrét helyeket (például üzleteket vagy államokat) célozzanak meg a kampányaikban. Ez szélesebb körű elhelyezéseknél használható a célközönség szűkítésére egy adott helyre.
{% hint style="success" %}
Ezt a fejlesztést széles körű display elhelyezéseknél javasoljuk
Bevált gyakorlatunk szerint ezt kategória- vagy széles körű display elhelyezéseken érdemes integrálni, mivel ezek inkább böngészésalapúak. Nem javasoljuk ezt keresési elhelyezéseken, mivel a kampányok már amúgy is szándékalapúan célzottak, és ez csökkentheti a hirdető által választható célközönséget.
{% endhint %}
## Magas szintű áttekintés
A hely szerinti célzási lehetőségünk lehetővé teszi a hirdetők számára, hogy helyeket válasszanak ki a kampányvarázslóban. Ez elhelyezésenként engedélyezhető keresési, kategória- és széles körű display elhelyezések esetén. A felületre alább látható egy példa:
A funkció a kategóriacélzási lehetőségünkhöz hasonlóan működik, lehetővé téve a hirdetők számára, hogy olyan helyeket válasszanak ki, amelyek szinkronizálva vannak a kiválasztott termékeiken. A helyek kiválasztása után azok megtekinthetők az ellenőrzési és a kampánykezelő képernyőkön.
## Integrációs áttekintés
Ennek az integrációnak a részeként az alábbiakat kell elvégeznie
1. Helyszintű szűrők szinkronizálása a termékein
2. A felületen megjeleníthető helynevek vagy térképes helyek szinkronizálása egymással a következőkön keresztül: [filterMapping](/retail-media-interface/integration/hu/citrus-filter-mapping-api/filtermapping.md) API (Az integrációtól függően)
1\.
1. Ez csak akkor érvényes, ha nevek helyett helyazonosítókkal (ID) van integrálva, vagy ha a helyeket össze szeretné képezni (például üzleteket szinkronizál, és azokat államokhoz szeretné képezni).
3. A hirdetési kérés kibővítése helyszűrők kéréséhez
### Helyszintű szűrők szinkronizálása a termékein
A helyek felületen való megjelenítéséhez a vonatkozó adatokat (elérhetőséget) szinkronizálni kell az egyes termékeken. Az integrációtól függően előfordulhat, hogy már szinkronizálja ezt az információt a hirdetéskitöltési arány javítása érdekében.
#### Szinkronizálás API-n keresztül
Ha Ön [Termékek szinkronizálása API-n keresztül](/retail-media-interface/integration/hu/data-api/catalog-products-2/syncing-products-via-api.md)módon jár el, frissítenie kell az egyes termékeket a megfelelő helyekkel a következőkben: `filters` objektum. Egy példát részletesen a következők tartalmaznak: [Helyadatok szinkronizálása](/retail-media-interface/integration/hu/data-api/catalog-products-2/syncing-products-via-api.md#syncing-location-information) szakasz a Termékek szinkronizálása API-n keresztül oldalon.
#### Szinkronizálás fájlon keresztül
Ha Ön [Katalógus és termékek szinkronizálása fájlon keresztül](/retail-media-interface/integration/hu/data-api/catalog-products-2/syncing-catalog-products-via-file.md)módon jár el, valószínűleg csak egy további oszlopot kell hozzáadnia a fájljához, amely meghatározza azokat a megfelelő helye(ke)t, ahol az egyes termékeket készleten tartják. Ez egyszerűen egy másik oszlop lesz, amelynek a neve `location`.
{% hint style="info" %}
Helyszűrő formátuma
Kifejezetten javasoljuk, hogy a helyszűrők formátuma a következő legyen: `location:`. Ez a formátum helyesen fog megjelenni a jelentési API-ban. Ugyanezt a formátumot kell használnia a hirdetési kérésnek is a hirdetések kiszolgálásához.
Ha fájlon keresztül szinkronizál, az Ön ügyfélintegrációs mérnöke megfelelően feltérképezheti ezt Önnek.
{% endhint %}
### Helynevek szinkronizálása a filterMapping API-n keresztül
A filter mapping API segítségével a helyazonosítók ember által olvasható értékekhez képezhetők le. Ez akkor szükséges, ha helyazonosítókat szinkronizál, mivel a felhasználói felület az értékeket jeleníti meg a felhasználóknak. Ha egyszintű szűrőket (például államot) szinkronizál, a felület az egyes kijelöléseket az alábbiak szerint jeleníti meg:
Ha az üzleteket államokhoz vagy hasonló aggregátumhoz képezi le, minden egyes kijelölés megmutatja az általa képviselt helyszűrők számát:
{% hint style="info" %}
Ha ember által olvasható államokat szinkronizál helyekként a termékkatalógusában a következőkkel: Epsilon Retail Media, erre a lépésre nem lesz szükség.
{% endhint %}
#### A hirdetési kérés kibővítése
Az integrációjától függően előfordulhat, hogy már szinkronizálja ezt az információt a hirdetéskitöltési arány javítása érdekében. Ez magában foglalja a kérés kibővítését a felhasználó helyének megadásával a következőkben: `productFilters` objektum.
A kérés formátumának meg kell felelnie az alább felsorolt hirdetési kérésnek:
* [Termékhirdetés – szűrés hely szerint](/retail-media-interface/integration/hu/generating-ads/product-ads/requesting-product-ads-1.md#filtering-by-location)
* [Bannerhirdetés – szűrés hely szerint](/retail-media-interface/integration/hu/generating-ads/banner-ads-static/requesting-banner-ads.md#filtering-by-location)
* [Banner X – szűrés hely szerint](/retail-media-interface/integration/hu/generating-ads/banner-x-responsive/requesting-banner-x-ads.md#filtering-by-location)
{% hint style="warning" %}
Hely szerinti célzás hozzáadása csak egy kiválasztott elhelyezéshez?
Lehet, hogy ezt a fejlesztést az összes elhelyezésén végre szeretné hajtani. Ez szabványosítja a megvalósítást az összes elhelyezésen, még akkor is, ha a célzást csak a kiválasztott elhelyezéseken engedélyezi.
{% endhint %}
## A funkció ismert korlátai
Mielőtt elkezdené a fejlesztést, javasoljuk, hogy ismerje meg a funkció alábbi korlátait
* Ez a funkció a termékeken szinkronizált szűrőket használja, javasoljuk, hogy a termék-hely elérhetőség szinkronizálásával biztosítsa a támogatott SLA-n belül maradást [Service Level Agreement](https://citrusad.service-now.com/csm/en/service-support-agreement-service-offerings?id=kb_article_view\&sys_kb_id=c508eee097438d100c0fb18fe153af42)
* Ez a funkció nem kompatibilis a kategóriás keresztértékesítési vagy a korábbi termék keresztértékesítési elhelyezésekkel.
* A kampányban kiválasztott hely(ek) szerint nincs felületen belüli jelentéskészítés
* Ez az információ megjelenik a tényalapú jelentési adatsettben azon kiskereskedők számára, akik a jelentési API-t használják. A helyszintű jelentéskészítés elérhető a kiskereskedők számára a jelentések göngyölítéséhez, ha külső rendszerekben szükséges.
* A Fix elhelyezés foglalások lehetővé teszik a helyek kiválasztását egy kampányban, de a foglalásokat nem lehet kampányonkénti szinten megtenni
* A foglalások kategória, keresési kifejezés vagy elhelyezés szintjén történnek (széles körű display elhelyezések esetén)
---
# 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/hu/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.