> 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/data-api/audience-targeting-new/integration-option-3-sync-audiences-only.md). # 3. opció: Csak célközönségek szinkronizálása ### Áttekintés A ügyfélazonosítókat megosztani nem tudó szervezetek esetében a célközönségek aktiválása a szegmensfeadek szinkronizálásával és a szegmens azonosítók hirdetési kérésekben történő átadásával érhető el. Ez az adatvédelmet előtérbe helyező megközelítés lehetővé teszi mind az egyéni, mind az általános célközönség-célzást ügyfélszintű adatok felfedése nélkül. A hirdetési kéréseknek tartalmazniuk kell a szegmensazonosítókat a célzott aktiválás támogatásához. ### Integrációs követelmények * A szegmensfeadnek meg kell határoznia, hogy mely célközönség-szegmensek érhetők el a kijelölt hirdetői csapatok számára. * A hirdetési kéréseknek tartalmazniuk kell a vonatkozó szegmens azonosító(ka)t minden ügyfélhez. ### Hogyan működik A CDP vagy célközönség-platform biztosítja a következőt: Epsilon egy szegmensfeaddel fájlfeltöltésen vagy API-n keresztül. A hirdetési kérésekben szereplő szegmens ID-k a célközönségek kampányokhoz való illesztésére szolgálnak. Az ügyfelek és szegmensek közötti hozzárendelést belsőleg, a kiskereskedő háttérrendszereiben tartják karban.
### Integrációs példák **Hirdetési kérés példa**: Szegmens ID-kat tartalmazó hirdetési kérés: ```http POST $BASE_URL/v1/ads/generate HTTP/1.1 accept: application/json content-type: application/json Authorization: Basic { "audience": { "segments": [ { "segmentIds": [ "segment-1" ] }, { "sourceId": "RETAILER_SOURCE_2", "segmentIds": [ "general-segment-4","general-segment-3" ] } ] }, "sessionId": "ec9-4e07-881d-3e9", "dtmCookieId": "AAAF8xLBTA968AB6TOthAAAAAAE", "placement": "search", "catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b", "searchTerm": "chocolate", "options": { "filterMode": "AndOr" }, "maxNumberOfAds": 3 } ``` {% hint style="info" %} Több forrásból szinkronizál szegmenseket? Ha igen, meg kell adnia a következőt is: `sourceId` a szegmens objektumban. Ezt az értéket Ön és a(z) Epsilon egyezteti a szegmens forrására való hivatkozáshoz. Egy példa lehet a következő: `customer-cdp-1`. Ha csak egy forrásból/CDP-ből szinkronizál, csak a következőt kell elküldenie: `segmentIds` a következőkben: `segment` tömb. {% endhint %} ### Fead fájl szinkronizációs integráció (Ajánlott) A szegmensek szinkronizálásakor csak egy fájlra van szükségünk. #### Szegmens fájl A szegmens fájl egy olyan szegmens ID megadására szolgál, amely megjelenik a felületen, valamint egy név és egy leírás megadására. Arra is használható, hogy meghatározza azokat a konkrét team\_ids értékeket, amelyek megtekinthetik a szegmenst, lehetővé téve a szegmensek testreszabását konkrét hirdetők számára. | segment\_id | name | description | team\_ids | | ----------------- | ----------------------------------------- | --------------------------------------------------------------------- | -------------------------------------------------------------------------------- | | general-segment-1 | Sokat költő vásárlók | Vásárlók, akiknek az átlagos heti vásárlása a felső 15%-ba tartozik. | | | general-segment-2 | Kedvező árat kereső vásárlók | Vásárlók, akiknek a kosarában magasabb a kedvező árú termékek aránya. | | | general-segment-3 | Visszatérő vásárlók | Vásárlók, akik átlagosan minden héten vásárolnak. | | | custom-segment-1 | Egyéni: Legutóbb vásárló BrandCo ügyfelek | Ügyfelek, akik az elmúlt 30 napban BrandCo terméket vásároltak. | \["a5166fc4-f874-4741-a721-c05ffd9941a5","92f4b91f-0089-4102-b13b-6015da8e0174"] | Tekintse meg a Szegmens referenciagyűjteményt itt ### API-szinkronizációs integráció Amikor ügyfeleket és szegmenseket szinkronizál API-n keresztül, egy vagy két műveletet kell elvégezni. 1. Szegmensek létrehozása 2. Opcionális: szegmens hozzáférés kezelése #### Szegmensek létrehozása API-n keresztül Mivel az ügyfél-szegmens kapcsolatot a hirdetési kérés előtt kezeli, csak a szegmenseket kell elküldenie. Meg kell adnia egy szegmens ID-t, amely megjelenik a felületen, egy nevet, egy leírást, valamint a kiskereskedői csapatát. {% hint style="info" %} A szegmensek API a Partner API által használt Bearer engedélyezést használja. Létre kell hoznia egy Bearer tokent, és azt kell használnia. Tudjon meg többet: [Hitelesítési kérések](https://help.citrusad.com/retail-media-interface/partner/hu/partner-api-authentication/authenticating-requests). {% endhint %} ```http POST $BASE_URL/v1/segments HTTP/1.1 accept: application/json content-type: application/json Authorization: Bearer { "segment":{ "segmentId": "general-segment-4", "sourceId": "DEFAULT_SOURCE_ID", "name": "Value Shoppers", "description": "Shoppers that have a higher basket % of value driven products.", "retailerTeamId": "13c84def-41cb-4f99-a3fc-6788264f79fe" } } ``` Tekintse meg a Szegmens létrehozása végponthoz tartozó referenciát [itt](https://help.citrusad.com/retail-media-interface/partner/hu/audience-segment-api/segment/createsegment). Ha szegmenseket szinkronizál API-n keresztül. Ez `sourceId` igazodik a hirdetési kéréshez. {% hint style="info" %} Legfeljebb 100 szegmens hirdetési kérésenként. Ha 100-nál több szegmenst szinkronizál, lépjen kapcsolatba a következőkkel: Epsilon. Ha ügyfelenként meghaladja a 100 szegmenst, a hirdetési kérésekben csökkenhet a szegmensösszevonás, és a kérésben lévő szegmensek csonkolódhatnak. Csonkolás esetén a következőt fogja látni: `metadata.warnings`mező megjelenik és feltöltődik a hirdetési válaszban, az alábbiak szerint: ``` "metadata": { "warnings": [ "Audience Segment IDs exceeded the limit of 100 and were truncated" ] } ``` {% endhint %} #### Opcionális: szegmens hozzáférés kezelése A manage-access funkcióval hozzáférést biztosíthat a kiválasztott hirdetőknek a szegmens megtekintéséhez, lehetővé téve a szegmensek testreszabását konkrét hirdetők számára. ```http POST $BASE_URL/v1/segments/{id}:manage-access HTTP/1.1 accept: application/json content-type: application/json Authorization: Bearer { "accessTeamIds":[ "90d5f138-2090-412b-a397-1f59ea6a31b3","1439f6f2-8c43-4ec5-b511-fc153f7d8119" ] } ``` Tekintse meg a Hozzáférés kezelése egy adott szegmenshez végponthoz tartozó referenciát [itt](https://help.citrusad.com/retail-media-interface/partner/hu/audience-segment-api/segment/manageaccess). --- # 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/data-api/audience-targeting-new/integration-option-3-sync-audiences-only.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.