> 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/data-api/audience-targeting-new/integration-option-2-sync-customers-audience.md). # Možnost 2: Synchronizace zákazníků a publika ### Přehled Maloobchodníci s clean roomy nebo samostatně spravovanými segmenty publik mohou synchronizovat data o zákaznících a segmentech a nechat doručovat vlastní publika pro top inzerenty i obecná publika. Tato integrace zahrnuje použití vaší CDP k poskytování informací o zákaznících/segmentech do Epsilon. Buď prostřednictvím API, nebo souboru. ### Požadavky na integraci * Standardní integrace na webu musí zahrnovat ID zákazníka ve všech relevantních kontaktních bodech (kde je k dispozici). * Zdroj ID zákazníků, prostřednictvím API nebo souborového zdroje. * Zdroj segmentů prostřednictvím API nebo souborového zdroje. ### Jak to funguje CDP nebo platforma publik poskytuje data o zákaznících a segmentech do Epsilon pomocí nahrání souboru nebo API. ID zákazníků obsažená v požadavcích na reklamu se spárují se segmenty publik a souvisejícími kampaněmi. To umožňuje přesné cílení na základě definic vlastních nebo obecných publik.
### Příklady integrace **Příklad požadavku na reklamu**: Požadavek na reklamu obsahující ID zákazníka: ```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" %} Váš požadavek na reklamu musí obsahovat `customerId`, bez ohledu na to, zda integrujete přes soubor nebo API. {% endhint %} ### Integrace synchronizace pomocí souborového zdroje (doporučeno) Při synchronizaci zákazníků a segmentů pomocí souboru vyžadujeme dva soubory: * Soubor segmentů * Soubor zákazníků #### Soubor segmentů Soubor segmentů se používá k poskytnutí segment ID, které se zobrazuje v uživatelském rozhraní, názvu a popisu. Lze jej také použít k určení konkrétních team\_ids, které mohou segment zobrazit, což vám umožní připravit segmenty pro konkrétní inzerenty. | segment\_id | name | description | team\_ids | | ----------------- | ---------------------------------------- | ------------------------------------------------------------- | -------------------------------------------------------------------------------- | | general-segment-1 | Nakupující s vysokými útratami | Nakupující s průměrným týdenním nákupem mezi 15 % nejvyšších. | | | general-segment-2 | Výhodně nakupující | Nakupující, kteří mají vyšší % výhodných produktů v košíku. | | | general-segment-3 | Opakovaně nakupující | Nakupující, kteří nakupují v průměru každý týden. | | | custom-segment-1 | Vlastní: Vysoká nedávnost nákupu BrandCo | Zákazníci, kteří nakoupili BrandCo v posledních 30 dnech. | \["a5166fc4-f874-4741-a721-c05ffd9941a5","92f4b91f-0089-4102-b13b-6015da8e0174"] | Zobrazit referenční příručku k segmentům [zde](/retail-media-interface/integration/cs/references/audience-targeting-reference.md#segment-feed-required-when-syncing-your-own-segments). #### Soubor zákazníků Váš soubor zákazníků se používá k vytvoření jednoho zákazníka a jeho propojení se segmenty, stačí zadat pouze `customer_id` a `segment_ids` | customer\_id | segments | | ------------ | ------------------------------------------- | | cust\_12345 | \["general-segment-3", "general-segment-4"] | | cust\_67890 | \["general-segment-3"] | Zobrazit referenční příručku k zákazníkům [zde](/retail-media-interface/integration/cs/references/audience-targeting-reference.md#customer-feed-required-when-syncing-your-own-segments-and-customers). {% hint style="info" %} Maximálně 100 segmentů na zákazníka. Pokud pro zákazníka synchronizujete více než 100 segmentů, kontaktujte prosím Epsilon. Pokud překročíte 100 segmentů na zákazníka, požadavky na reklamu mohou mít omezené sdružování segmentů a zkrátit segmenty v požadavku. {% endhint %} ### Integrace synchronizace přes API Při synchronizaci zákazníků a segmentů přes API je třeba dokončit tři operace. 1. Vytvořit segmenty 2. Volitelné: spravovat přístup k segmentu 3. Vytvořit zákazníky 4. Spravovat propojení zákazníků a segmentů #### Vytváření segmentů přes API První věc, kterou musíte udělat, je vytvořit segmenty, ke kterým připojíte zákazníky. Musíte zadat segment ID, které se zobrazuje v uživatelském rozhraní, název, popis a také váš tým maloobchodníka. {% hint style="info" %} Důležité: API pro segmenty používá autorizaci typu bearer používanou v Partner API. Budete muset vygenerovat token bearer a použít jej. Další informace: [Požadavky na autentizaci](https://help.citrusad.com/retail-media-interface/partner/cs/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" } } ``` Zobrazit dokumentaci pro koncový bod Create a segment [zde](https://help.citrusad.com/retail-media-interface/partner/cs/audience-segment-api/segment/createsegment). #### Volitelné: spravovat přístup k segmentu Funkci manage-access můžete použít k poskytnutí přístupu vybraným inzerentům k zobrazení segmentu, což vám umožní připravit segmenty pro konkrétní inzerenty. ```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" ] } ``` Zobrazit dokumentaci pro koncový bod Manage access to a specific segment [zde](https://help.citrusad.com/retail-media-interface/partner/cs/audience-segment-api/segment/manageaccess). #### Vytváření zákazníků přes API {% hint style="info" %} API pro zákazníky používá základní autorizaci používanou v Integration API. {% 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" } } ] } ``` Po dokončení musíte také vytvořit segmenty, ke kterým zákazníky připojíte. V jedno požadavku můžete vytvořit až 100 zákazníků. Zobrazit specifikaci pro API Create or update a customer [zde](/retail-media-interface/integration/cs/integration/create-or-update-a-customer.md). #### Propojení zákazníků se segmenty pomocí API Po vytvoření segmentů použijte API /customers/manage-segments k propojení zákazníků se segmenty ```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" %} teamId v tomto požadavku je vaše ID maloobchodního týmu. {% endhint %} Zde si můžete prohlédnout specifikaci API pro správu segmentů a zákazníků. --- # 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/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.