> 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-3-sync-audiences-only.md).
# Možnosť 3: Synchronizácia iba publika
### Prehľad
Pre organizácie, ktoré nemôžu zdieľať identifikátory zákazníkov, je možné aktiváciu publika dosiahnuť synchronizáciou kanálov segmentov a odovzdávaním ID segmentov v požiadavkách na reklamu. Tento prístup zameraný na súkromie umožňuje cieľové zacielenie na vlastné aj všeobecné publikum bez odhalenia údajov na úrovni zákazníka. Požiadavky na reklamu musia obsahovať identifikátory segmentov na podporu cielenej aktivácie.
### Požiadavky na integráciu
* Kanál segmentov musí určovať, ktoré segmenty publika sú k dispozícii určeným tímom inzerentov.
* Požiadavky na reklamu musia obsahovať príslušné ID segmentu (segmentov) pre každého zákazníka.
### Ako to funguje
CDP alebo platforma publika poskytuje Epsilon kanál segmentov prostredníctvom odovzdania súboru alebo API. ID segmentov obsiahnuté v požiadavkách na reklamu sa používajú na priradenie publiká k kampaniam. Mapovanie medzi zákazníkmi a segmentmi sa spravuje interne v backendových systémoch predajcu.
### Príklady integrácie
**Príklad požiadavky na reklamu**: Požiadavka na reklamu obsahujúca ID segmentov:
```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" %}
Synchronizujete segmenty z viacerých zdrojov?
Ak áno, budete musieť zadať aj `sourceId` v objekte segment. Táto hodnota je dohodnutá medzi vami a Epsilon na odkazovanie na zdroj segmentu. Príkladom môže byť `customer-cdp-1`.
Ak synchronizujete iba z jedného zdroja/CDP, musíte poslať iba `segmentIds` v `segment` poli.
{% endhint %}
### Integrácia synchronizácie súboru kanála (Odporúčané)
Pri synchronizácii segmentov vyžadujeme iba jeden súbor.
#### 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žňuje 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 výhodných produktov v košíku. | |
| general-segment-3 | Pravidelní zákazníci | Zákazníci, ktorí nakupujú v priemere každý týždeň. | |
| custom-segment-1 | Vlastné: Nedávno nakupujúci BrandCo | Zákazníci, ktorí nakúpili BrandCo za posledných 30 dní. | \["a5166fc4-f874-4741-a721-c05ffd9941a5","92f4b91f-0089-4102-b13b-6015da8e0174"] |
Zobrazte si príručku pre segmenty tu
### Integrácia synchronizácie cez API
Pri synchronizácii zákazníkov a segmentov cez API je potrebné dokončiť jednu alebo dve operácie.
1. Vytvoriť segmenty
2. Voliteľné: správa prístupu k segmentom
#### Vytváranie segmentov cez API
Keďže vzťah medzi zákazníkom a segmentom spravujete pred požiadavkou na reklamu, musíte odosielať iba segmenty.
Musíte poskytnúť ID segmentu, ktoré sa zobrazuje v používateľskom rozhraní, názov, popis, ako aj váš tím predajcu.
{% hint style="info" %}
API segmentov používa autorizáciu typu bearer, ktorú používa Partner API. Budete musieť vygenerovať bearer token a použiť ho. Zistite viac: [Požiadavky na 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
{
"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"
}
}
```
Zobrazte si dokumentáciu pre koncový bod Vytvorenie segmentu [tu](https://help.citrusad.com/retail-media-interface/partner/sk/audience-segment-api/segment/createsegment).
Ak synchronizujete segmenty cez API. Toto `sourceId` sa zhoduje s požiadavkou na reklamu.
{% hint style="info" %}
Maximum 100 segmentov na požiadavku na reklamu.
Ak synchronizujete viac ako 100 segmentov, kontaktujte Epsilon. Ak prekročíte 100 segmentov na zákazníka, požiadavky na reklamu môžu mať znížené spájanie segmentov a skrátiť segmenty v požiadavke.
V prípade skrátenia uvidíte, `metadata.warnings`pole v odpovedi na reklamu sa zobrazí a naplní, ako je znázornené nižšie:
```
"metadata": {
"warnings": [
"Audience Segment IDs exceeded the limit of 100 and were truncated"
]
}
```
{% endhint %}
#### Voliteľné: správa prístupu k segmentom
Funkciu manage-access môžete použiť 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
{
"accessTeamIds":[
"90d5f138-2090-412b-a397-1f59ea6a31b3","1439f6f2-8c43-4ec5-b511-fc153f7d8119"
]
}
```
Zobrazte si dokumentáciu pre koncový bod Správa prístupu ku konkrétnemu segmentu [tu](https://help.citrusad.com/retail-media-interface/partner/sk/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/sk/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.