> 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-3-sync-audiences-only.md).
# Možnost 3: Pouze synchronizace publik
### Přehled
Pro organizace, které nemohou sdílet identifikátory zákazníků, lze aktivaci publika dosáhnout synchronizací kanálů segmentů a předáváním ID segmentů v požadavcích na reklamu. Tento přístup zaměřený na ochranu soukromí umožňuje cílení na vlastní i obecná publika bez odhalení dat na úrovni zákazníků. Požadavky na reklamu musí obsahovat identifikátory segmentů pro podporu cílené aktivace.
### Požadavky na integraci
* Kanál segmentů musí specifikovat, které segmenty publika jsou k dispozici určeným týmům inzerentů.
* Požadavky na reklamu musí obsahovat příslušná ID segmentů pro každého zákazníka.
### Jak to funguje
CDP nebo platforma publika poskytuje Epsilon kanál segmentů prostřednictvím nahrání souboru nebo API. ID segmentů obsažená v požadavcích na reklamu se používají k párování publik s kampaněmi. Mapování mezi zákazníky a segmenty je udržováno interně v backendových systémech maloobchodníka.
### Příklady integrace
**Příklad požadavku na reklamu**: Požadavek na reklamu obsahující ID segmentů:
```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 více zdrojů?
Pokud ano, budete muset také poskytnout `sourceId` v objektu segment. Tato hodnota je dohodnuta mezi vámi a Epsilon pro odkazování na zdroj segmentu. Příkladem může být `customer-cdp-1`.
Pokud synchronizujete pouze z jednoho zdroje/CDP, musíte poslat pouze `segmentIds` v poli `segment` .
{% endhint %}
### Integrace synchronizace souboru kanálu (doporučeno)
Při synchronizaci segmentů požadujeme pouze jeden soubor.
#### Soubor segmentů
Soubor segmentů se používá k poskytnutí ID segmentu, které se zobrazuje v uživatelském rozhraní, názvu a popisu. Lze jej také použít ke specifikaci konkrétních team\_ids, které mohou segment zobrazit, což vám umožní spravovat 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 v horních 15 %. | |
| general-segment-2 | Výhodně nakupující | Nakupující, kteří mají vyšší % košíku tvořené cenově výhodnými produkty. | |
| general-segment-3 | Pravidelně nakupující | Nakupující, kteří nakupují v průměru každý týden. | |
| custom-segment-1 | Vlastní: Značka BrandCo – nedávný nákup | 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
### Integrace synchronizace přes API
Při synchronizaci zákazníků a segmentů pomocí API je třeba dokončit jednu nebo dvě operace.
1. Vytvořit segmenty
2. Volitelné: správa přístupu k segmentům
#### Vytváření segmentů přes API
Vzhledem k tomu, že vztah mezi zákazníkem a segmentem spravujete před požadavkem na reklamu, musíte odesílat pouze segmenty.
Musíte poskytnout ID segmentu, které se zobrazuje v uživatelském rozhraní, název, popis a také váš tým maloobchodníka.
{% hint style="info" %}
API pro segmenty používá autorizaci bearer používanou API pro partnery. 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 Vytvoření segmentu [zde](https://help.citrusad.com/retail-media-interface/partner/cs/audience-segment-api/segment/createsegment).
Pokud synchronizujete segmenty přes API. Toto `sourceId` se odpovídá požadavku na reklamu.
{% hint style="info" %}
Maximálně 100 segmentů na požadavek na reklamu.
Pokud 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.
V případě zkrácení se v odpovědi na reklamu zobrazí a vyplní pole `metadata.warnings`, jako níže:
```
"metadata": {
"warnings": [
"Audience Segment IDs exceeded the limit of 100 and were truncated"
]
}
```
{% endhint %}
#### Volitelné: správa přístupu k segmentům
Funkci manage-access můžete použít k poskytnutí přístupu vybraným inzerentům k zobrazení segmentu, což vám umožní spravovat 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 Správa přístupu ke konkrétnímu segmentu [zde](https://help.citrusad.com/retail-media-interface/partner/cs/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/cs/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.