> 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/it/data-api/audience-targeting-new/integration-option-3-sync-audiences-only.md).
# Opzione 3: Sincronizzare solo i pubblici
### Panoramica
Per le organizzazioni impossibilitate a condividere gli identificatori dei clienti, l'attivazione del pubblico può essere ottenuta sincronizzando i feed dei segmenti e passando i segment ID nelle richieste di annunci. Questo approccio basato sulla privacy consente il targeting sia del pubblico personalizzato che di quello generale senza esporre i dati a livello di cliente. Le richieste di annunci devono includere gli identificatori di segmento per supportare l'attivazione targettizzata.
### Requisiti di integrazione
* Il feed dei segmenti deve specificare quali segmenti di pubblico sono disponibili per i team di inserzionisti designati.
* Le richieste di annunci devono includere i segment ID pertinenti per ciascun cliente.
### Come funziona
La CDP o la piattaforma di pubblico fornisce Epsilon un feed di segmenti tramite caricamento di file o API. I segment ID inclusi nelle richieste di annunci vengono utilizzati per associare il pubblico alle campagne. La mappatura tra clienti e segmenti viene mantenuta internamente all'interno dei sistemi backend del retailer.
### Esempi di integrazione
**Esempio di richiesta di annuncio**: Richiesta di annuncio contenente segment ID:
```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" %}
Stai sincronizzando segmenti da più origini?
In tal caso, dovrai anche fornire il valore `sourceId` nell'oggetto segment. Questo valore viene concordato tra te e Epsilon per fare riferimento all'origine del segmento. Un esempio potrebbe essere `customer-cdp-1`.
Se stai sincronizzando da una sola origine/CDP, devi inviare solo il valore `segmentIds` nell'array `segment` .
{% endhint %}
### Integrazione con sincronizzazione di file feed (consigliata)
Durante la sincronizzazione dei segmenti, richiediamo un solo file.
#### File dei segmenti
Un file dei segmenti viene utilizzato per fornire un segment ID mostrato nell'interfaccia utente, un nome e una descrizione. Può essere utilizzato anche per specificare eventuali team\_ids specifici che possono visualizzare un segmento, consentendo di curare i segmenti per inserzionisti specifici.
| segment\_id | name | description | team\_ids |
| ----------------- | ---------------------------------- | --------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- |
| general-segment-1 | Acquirenti con spesa elevata | Acquirenti con una spesa media settimanale nel top 15%. | |
| general-segment-2 | Acquirenti attenti al risparmio | Acquirenti che hanno una percentuale di carrello più alta di prodotti orientati al risparmio. | |
| general-segment-3 | Acquirenti ricorrenti | Acquirenti che fanno acquisti in media ogni settimana. | |
| custom-segment-1 | Custom: Acquirenti recenti BrandCo | Clienti che hanno acquistato BrandCo negli ultimi 30 giorni. | \["a5166fc4-f874-4741-a721-c05ffd9941a5","92f4b91f-0089-4102-b13b-6015da8e0174"] |
Visualizza la Guida di riferimento dei segmenti qui
### Integrazione con sincronizzazione API
Durante la sincronizzazione di clienti e segmenti tramite API, ci sono una o due operazioni che devono essere completate.
1. Crea segmenti
2. Opzionale: gestisci l'accesso ai segmenti
#### Creazione di segmenti tramite API
Poiché gestisci la relazione cliente-segmento prima della richiesta di annuncio, devi solo inviare i segmenti.
È necessario fornire un segment ID mostrato nell'interfaccia utente, un nome, una descrizione, nonché il team del retailer.
{% hint style="info" %}
L'API dei segmenti utilizza l'autorizzazione bearer utilizzata dalla Partner API. Dovrai generare un token bearer e utilizzarlo. Per saperne di più: [Richieste di autenticazione](https://help.citrusad.com/retail-media-interface/partner/it/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"
}
}
```
Visualizza il riferimento per l'endpoint Crea un segmento [qui](https://help.citrusad.com/retail-media-interface/partner/it/audience-segment-api/segment/createsegment).
Se si sincronizzano i segmenti tramite API. Questo `sourceId` si allinea alla richiesta di annuncio.
{% hint style="info" %}
Massimo 100 segmenti per richiesta di annuncio.
Se stai sincronizzando più di 100 segmenti, contatta Epsilon. Se superi i 100 segmenti per cliente, le richieste di annunci potrebbero ridurre il pooling dei segmenti e troncare i segmenti nella richiesta.
In caso di troncamenti, vedrai il campo `metadata.warnings`nella risposta dell'annuncio comparire e popolarsi, come mostrato di seguito:
```
"metadata": {
"warnings": [
"Audience Segment IDs exceeded the limit of 100 and were truncated"
]
}
```
{% endhint %}
#### Opzionale: gestisci l'accesso ai segmenti
È possibile utilizzare la funzione manage-access per fornire l'accesso a inserzionisti selezionati per visualizzare il segmento, consentendo di curare i segmenti per inserzionisti specifici.
```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"
]
}
```
Visualizza il riferimento per l'endpoint Gestisci l'accesso a un segmento specifico [qui](https://help.citrusad.com/retail-media-interface/partner/it/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/it/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.