> 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/data-api/audience-targeting-new/integration-option-2-sync-customers-audience.md).

# Možnosť 2: Synchronizácia zákazníkov a publika

### Prehľad

Predajcovia s clean roomami alebo vlastnými segmentmi publika môžu synchronizovať údaje o zákazníkoch a segmentoch, aby umožnili doručovanie zákazníckemu publiku pre top inzerentov a všeobecné publikum. Táto integrácia zahŕňa použitie vašej CDP na poskytovanie informácií o zákazníkoch/segmentoch pre Epsilon. Buď prostredníctvom API, alebo súboru.

### Požiadavky na integráciu

* Štandardná integrácia na webe musí zahŕňať ID zákazníka vo všetkých relevantných kontaktných bodoch (ak je k dispozícii).
* Zdroj ID zákazníkov prostredníctvom API alebo súborového zdroja.
* Zdroj segmentov prostredníctvom API alebo súborového zdroja.

### Ako to funguje

CDP alebo platforma publika poskytuje údaje o zákazníkoch a segmentoch pre Epsilon pomocou odovzdania súboru alebo API. ID zákazníkov zahrnuté v žiadostiach o reklamu sa priradzujú k segmentom publika a spojeným kampaniam. To umožňuje presné cielenie na základe definícií vlastného alebo všeobecného publika.

<figure><img src="/files/ZaleS5Nc5XuByTpVqzZY" alt="" width="100%"><figcaption></figcaption></figure>

### Príklady integrácie

**Príklad žiadosti o reklamu**: Žiadosť o reklamu obsahujúca ID zákazníka:

```http
POST $BASE_URL/v1/ads/generate HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic <API_KEY>
{
    "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" %}
Vaša žiadosť o reklamu musí obsahovať `customerId`, bez ohľadu na to, či integrujete cez súbor alebo API.
{% endhint %}

### Integrácia synchronizácie pomocou súboru zdroja (odporúčané)

Pri synchronizácii zákazníkov a segmentov pomocou súboru požadujeme dva súbory:

* Súbor segmentov
* Súbor zákazníkov

#### Súbor segmentov

Súbor segmentov sa používa na poskytnutie ID segmentu, ktoré sa zobrazuje v používateľskom rozhraní, názvu a popisu. Môže sa použiť aj na určenie konkrétnych team\_ids, ktoré môžu zobraziť segment, čo vám umožní pripraviť segmenty pre konkrétnych inzerentov.

| segment\_id       | name                                     | description                                                               | team\_ids                                                                        |
| ----------------- | ---------------------------------------- | ------------------------------------------------------------------------- | -------------------------------------------------------------------------------- |
| general-segment-1 | Zákazníci s vysokými výdavkami           | Zákazníci s priemerným týždenným nákupom v horných 15 %.                  |                                                                                  |
| general-segment-2 | Cenovo orientovaní zákazníci             | Zákazníci, ktorí majú vyšší % podiel cenovo výhodných produktov v košíku. |                                                                                  |
| general-segment-3 | Vracajúci sa zákazníci                   | Zákazníci, ktorí nakupujú v priemere každý týždeň.                        |                                                                                  |
| custom-segment-1  | Vlastné: Vysoká nedávnosť nákupu BrandCo | Zákazníci, ktorí si zakúpili BrandCo za posledných 30 dní.                | \["a5166fc4-f874-4741-a721-c05ffd9941a5","92f4b91f-0089-4102-b13b-6015da8e0174"] |

Pozrite si referenčnú príručku pre segmenty [tu](/retail-media-interface/integration/sk/references/audience-targeting-reference.md#segment-feed-required-when-syncing-your-own-segments).

#### Súbor zákazníkov

Váš súbor zákazníkov sa používa na vytvorenie jediného zákazníka a jeho prepojenie so segmentmi, musíte poskytnúť iba `customer_id` a `segment_ids`

| customer\_id | segments                                    |
| ------------ | ------------------------------------------- |
| cust\_12345  | \["general-segment-3", "general-segment-4"] |
| cust\_67890  | \["general-segment-3"]                      |

Pozrite si referenčnú príručku pre zákazníkov [tu](/retail-media-interface/integration/sk/references/audience-targeting-reference.md#customer-feed-required-when-syncing-your-own-segments-and-customers).

{% hint style="info" %}
Maximálne 100 segmentov na zákazníka.

Ak synchronizujete viac ako 100 segmentov pre zákazníka, kontaktujte prosím Epsilon. Ak prekročíte 100 segmentov na zákazníka, žiadosti o reklamu môžu mať znížené zhlukovanie segmentov a skrátené segmenty v žiadosti.
{% endhint %}

### API integrácia synchronizácie

Pri synchronizácii zákazníkov a segmentov prostredníctvom API je potrebné dokončiť tri operácie.

1. Vytvoriť segmenty
2. Voliteľné: spravovať prístup k segmentom
3. Vytvoriť zákazníkov
4. Spravovať prepojenie zákazníkov a segmentov

#### Vytváranie segmentov cez API

Prvá vec, ktorú musíte urobiť, je vytvoriť segmenty, ku ktorým prepojíte zákazníkov.

Musíte poskytnúť ID segmentu, ktoré sa zobrazuje v používateľskom rozhraní, názov, popis, ako aj tím vášho predajcu.

{% hint style="info" %}
Dôležité: API pre segmenty používa autorizáciu bearer používanú v Partner API. Budete musieť vygenerovať token bearer a použiť ho. Dozviete sa viac: [Žiadosti o autentifikáciu](https://help.citrusad.com/retail-media-interface/partner/sk/partner-api-authentication/authenticating-requests).
{% endhint %}

```http
POST $BASE_URL/v1/segments HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Bearer <API_KEY>
{
  "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"
  }
}
```

Pozrite si referenciu pre koncový bod Vytvorenie segmentu [tu](https://help.citrusad.com/retail-media-interface/partner/sk/audience-segment-api/segment/createsegment).

#### Voliteľné: spravovať prístup k segmentom

Môžete použiť funkciu manage-access na poskytnutie prístupu vybraným inzerentom na zobrazenie segmentu, čo vám umožní pripraviť segmenty pre konkrétnych inzerentov.

```http
POST $BASE_URL/v1/segments/{id}:manage-access HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Bearer <API_KEY>
{
  "accessTeamIds":[
        "90d5f138-2090-412b-a397-1f59ea6a31b3","1439f6f2-8c43-4ec5-b511-fc153f7d8119"
        ]
}
```

Pozrite si referenciu pre koncový bod Spravovanie prístupu ku konkrétnemu segmentu [tu](https://help.citrusad.com/retail-media-interface/partner/sk/audience-segment-api/segment/manageaccess).

#### Vytváranie zákazníkov cez API

{% hint style="info" %}
API pre zákazníkov používa základnú autorizáciu používanú v Integration API.
{% endhint %}

```http
POST $BASE_URL/v1/customers HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic <API_KEY>
{
    "customers": [
        {
            "id": "cust_12345"
        },
        {
            "id": "cust_67890"
        }
        }
    ]
}
```

Po dokončení musíte tiež vytvoriť segmenty, ku ktorým prepojíte zákazníkov. V jednej žiadosti môžete vytvoriť až 100 zákazníkov.

Pozrite si špecifikáciu pre API na vytvorenie alebo aktualizáciu zákazníka [tu](/retail-media-interface/integration/sk/integration/create-or-update-a-customer.md).

#### Prepojte zákazníkov so segmentmi cez API

Po vytvorení segmentov použite API /customers/manage-segments na prepojenie zákazníkov so segmentmi

```http
POST $BASE_URL/v1/customers/manage-segments HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic <API_KEY>
{
    "customerId": "cust_12345",
    "teamId":"13c84def-41cb-4f99-a3fc-6788264f79fe",
    "segments": {
        "segmentIds":[
        "general-segment-4","general-segment-3"
        ]
    }
}
```

{% hint style="info" %}
teamId v tejto požiadavke je vaše ID tímu predajcu.
{% endhint %}

Zobrazte si špecifikáciu pre API na spravovanie segmentov a zákazníkov tu.


---

# 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/data-api/audience-targeting-new/integration-option-2-sync-customers-audience.md?ask=<question>&goal=<endgoal>
```

`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.