> 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-2-sync-customers-audience.md).
# Opzione 2: Sincronizzare clienti e pubblico
### Panoramica
I retailer con clean room o segmenti di pubblico gestiti in autonomia possono sincronizzare i dati sui clienti e sui segmenti per consentire l'erogazione di pubblico personalizzato per i principali inserzionisti e per il pubblico generale. Questa integrazione prevede l'utilizzo della propria CDP per fornire informazioni sui clienti/segmenti a Epsilon. Sia tramite API che tramite file.
### Requisiti di integrazione
* L'integrazione onsite standard deve includere l'ID cliente su tutti i touchpoint pertinenti (ove disponibile).
* Feed di ID cliente dei clienti, tramite API o feed di file.
* Feed di segmenti tramite API o feed di file.
### Come funziona
La CDP o la piattaforma di pubblico fornisce dati sui clienti e sui segmenti a Epsilon tramite caricamento di file o API. Gli ID cliente inclusi nelle richieste di annunci vengono associati ai segmenti di pubblico e alle campagne correlate. Ciò consente un targeting preciso basato su definizioni di pubblico personalizzate o generali.
### Esempi di integrazione
**Esempio di richiesta di annuncio**: Richiesta di annuncio contenente l'ID cliente:
```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" %}
La richiesta di annuncio deve contenere `customerId`indipendentemente dal fatto che l'integrazione avvenga tramite file o API.
{% endhint %}
### Integrazione per la sincronizzazione tramite file di feed (consigliata)
Quando si sincronizzano clienti e segmenti tramite file, sono necessari due file:
* File dei segmenti
* File dei clienti
#### File dei segmenti
Un file dei segmenti viene utilizzato per fornire un ID segmento mostrato nell'interfaccia utente, un nome e una descrizione. Può essere utilizzato anche per specificare eventuali team\_id specifici che possono visualizzare un segmento, consentendo di curare 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 valore | Acquirenti con una percentuale di carrello più alta di prodotti orientati al valore. | |
| general-segment-3 | Acquirenti ricorrenti | Acquirenti che acquistano in media ogni settimana. | |
| custom-segment-1 | Personalizzato: Recenza d'acquisto elevata 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](/retail-media-interface/integration/it/references/audience-targeting-reference.md#segment-feed-required-when-syncing-your-own-segments).
#### File dei clienti
Il file dei clienti viene utilizzato per creare un singolo cliente e collegarlo ai segmenti, è sufficiente fornire `customer_id` e `segment_ids`
| customer\_id | segments |
| ------------ | ------------------------------------------- |
| cust\_12345 | \["general-segment-3", "general-segment-4"] |
| cust\_67890 | \["general-segment-3"] |
Visualizza la Guida di riferimento dei clienti [qui](/retail-media-interface/integration/it/references/audience-targeting-reference.md#customer-feed-required-when-syncing-your-own-segments-and-customers).
{% hint style="info" %}
Massimo 100 segmenti per cliente.
Se si sincronizzano più di 100 segmenti per un cliente, contattare Epsilon. Se si superano i 100 segmenti per cliente, le richieste di annunci potrebbero ridurre il pooling dei segmenti e troncare i segmenti nella richiesta.
{% endhint %}
### Integrazione per la sincronizzazione tramite API
Quando si sincronizzano clienti e segmenti tramite API, è necessario completare tre operazioni.
1. Crea segmenti
2. Opzionale: gestisci l'accesso ai segmenti
3. Crea clienti
4. Gestisci il collegamento cliente-segmento
#### Creazione di segmenti tramite API
La prima cosa da fare è creare i segmenti a cui collegare i clienti.
È necessario fornire un ID segmento mostrato nell'interfaccia utente, un nome, una descrizione e il team del retailer.
{% hint style="info" %}
Importante: l'API dei segmenti utilizza l'autorizzazione bearer utilizzata dall'API Partner. È necessario 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).
#### Opzionale: gestisci l'accesso ai segmenti
È possibile utilizzare la funzione manage-access per fornire l'accesso ad 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).
#### Creazione di clienti tramite API
{% hint style="info" %}
L'API dei clienti utilizza l'autorizzazione di base usata dall'API di integrazione.
{% 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"
}
}
]
}
```
Una volta completato, è necessario creare anche i segmenti a cui collegare i clienti. È possibile creare fino a 100 clienti per richiesta.
Visualizza le specifiche per l'API per creare o aggiornare un cliente [qui](/retail-media-interface/integration/it/integration/create-or-update-a-customer.md).
#### Collega i clienti ai segmenti tramite API
Dopo aver creato i segmenti, utilizza l'API /customers/manage-segments per collegare i clienti ai segmenti
```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 in questa richiesta è l'ID del team del tuo retailer.
{% endhint %}
Visualizza qui le specifiche dell'API per gestire segmenti e clienti.
---
# 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-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.