> 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-2-sync-customers-audience.md). # 2. opció: Ügyfelek és célközönség szinkronizálása ### Áttekintés A tiszta szobákkal (clean room) vagy saját kezelésű célközönség-szegmensekkel rendelkező kiskereskedők szinkronizálhatják az ügyfél- és szegmensadatokat, hogy lehetővé tegyék az egyéni célközönségek elérését a kiemelt hirdetők és az általános célközönségek számára. Ez az integráció magában foglalja a CDP használatát az ügyfél-/szegmensinformációk átadására a következő felé: Epsilon. Akár API-n, akár fájlon keresztül. ### Integrációs követelmények * A standard Webhelyen integrációnak tartalmaznia kell az ügyfél-ID-t minden vonatkozó kapcsolódási ponton (ahol elérhető). * Ügyfelek ügyfél-ID feedje, API vagy fájlfeed alapján. * Szegmensfeed API vagy fájlfeed alapján. ### Hogyan működik A CDP vagy célközönség-platform ügyfél- és szegmensadatokat biztosít a következőknek: Epsilon fájlfeltöltés vagy API használatával. A hirdetési kérésekben szereplő ügyfél-ID-k párosításra kerülnek a célközönség-szegmensekkel és a kapcsolódó kampányokkal. Ez lehetővé teszi a pontos célzást az egyéni vagy általános célközönség-definíciók alapján.
### Integrációs példák **Hirdetési kérés példa**: Ügyfél-ID-t 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 { "customerId": "wertg5432a", "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" %} A hirdetési kérésnek tartalmaznia kell a következőt: `customerId`, függetlenül attól, hogy fájlon vagy API-n keresztül integrálja. {% endhint %} ### Feedfájl-szinkronizálási integráció (Ajánlott) Amikor ügyfeleket és szegmenseket szinkronizál fájl alapján, két fájlra van szükségünk: * Szegmensfájl * Ügyfélfájl #### Szegmensfájl A szegmensfájl a felületen megjelenő szegmens-ID, a név és a leírás megadására szolgál. Használható továbbá bármely olyan konkrét team\_ids megadására is, amely megtekintheti a szegmenst, lehetővé téve a szegmensek testreszabását az egyes hirdetők számára. | segment\_id | name | description | team\_ids | | ----------------- | ------------------------------------------- | --------------------------------------------------------------------- | -------------------------------------------------------------------------------- | | general-segment-1 | Sokat költő vásárlók | Az átlagos heti vásárlások alapján a felső 15%-ba tartozó vásárlók. | | | general-segment-2 | Költségtudatos 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: Magas vásárlási gyakoriságú BrandCo | A BrandCo termékeket az elmúlt 30 napban megvásárló ügyfelek. | \["a5166fc4-f874-4741-a721-c05ffd9941a5","92f4b91f-0089-4102-b13b-6015da8e0174"] | Tekintse meg a Szegmens referencia-útmutatót [itt](/retail-media-interface/integration/hu/references/audience-targeting-reference.md#segment-feed-required-when-syncing-your-own-segments). #### Ügyfélfájl Az ügyfélfájl egyetlen ügyfél létrehozására és szegmensekhez való összekapcsolására szolgál, csak a következőket kell megadnia: `customer_id` és `segment_ids` | customer\_id | segments | | ------------ | ------------------------------------------- | | cust\_12345 | \["general-segment-3", "general-segment-4"] | | cust\_67890 | \["general-segment-3"] | Tekintse meg az Ügyfél referencia-útmutatót [itt](/retail-media-interface/integration/hu/references/audience-targeting-reference.md#customer-feed-required-when-syncing-your-own-segments-and-customers). {% hint style="info" %} Ügyfélkönyvenként legfeljebb 100 szegmens. Ha ügyfelenként több mint 100 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 szegmensek összevonása, és a kérésben szereplő szegmensek csonkolódhatnak. {% endhint %} ### API-szinkronizálási integráció Amikor API-n keresztül szinkronizálja az ügyfeleket és a szegmenseket, három műveletet kell elvégezni. 1. Szegmensek létrehozása 2. Opcionális: szegmens-hozzáférés kezelése 3. Ügyfelek létrehozása 4. Ügyfél-szegmens összekapcsolás kezelése #### Szegmensek létrehozása API-n keresztül Az első dolog, amit tennie kell, a szegmensek létrehozása, amelyekhez az ügyfeleket kapcsolni fogja. Meg kell adnia a felületen megjelenő szegmens-ID-t, egy nevet, leírást, valamint a kiskereskedelmi csapatát. {% hint style="info" %} Fontos: A szegmensek API-ja a Partner API által használt bearer autorizációt 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égpont referenciáját [itt](https://help.citrusad.com/retail-media-interface/partner/hu/audience-segment-api/segment/createsegment). #### Opcionális: szegmens-hozzáférés kezelése A manage-access funkció segítségével 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 az egyes 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 az Adott szegmenshez való hozzáférés kezelése végpont referenciáját [itt](https://help.citrusad.com/retail-media-interface/partner/hu/audience-segment-api/segment/manageaccess). #### Ügyfelek létrehozása API-n keresztül {% hint style="info" %} Az ügyfelek API az Integration API által használt basic autorizációt használja. {% endhint %} ```http POST $BASE_URL/v1/customers HTTP/1.1 accept: application/json content-type: application/json Authorization: Basic { "customers": [ { "id": "cust_12345" }, { "id": "cust_67890" } } ] } ``` Ha kész, szegmenseket is létre kell hoznia, amelyekhez az ügyfeleket kapcsolhatja. Kérésenként legfeljebb 100 ügyfelet hozhat létre. Tekintse meg az Ügyfél létrehozása vagy frissítése API specifikációját [itt](/retail-media-interface/integration/hu/integration/create-or-update-a-customer.md). #### Ügyfelek összekapcsolása szegmensekkel API-n keresztül A szegmensek létrehozása után használja a /customers/manage-segments API-t az ügyfelek szegmensekhez való kapcsolásához ```http POST $BASE_URL/v1/customers/manage-segments HTTP/1.1 accept: application/json content-type: application/json Authorization: Basic { "customerId": "cust_12345", "teamId":"13c84def-41cb-4f99-a3fc-6788264f79fe", "segments": { "segmentIds":[ "general-segment-4","general-segment-3" ] } } ``` {% hint style="info" %} Ebben a kérésben a teamId az Ön kiskereskedői csapatának az azonosítója (retailer team ID). {% endhint %} Tekintse meg a szegmensek és ügyfelek kezelésére szolgáló API specifikációját itt. --- # 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-2-sync-customers-audience.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.