> 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/es/data-api/audience-targeting-new/integration-option-2-sync-customers-audience.md).
# Opción 2: Sincronizar clientes y audiencia
### Descripción general
Los minoristas con clean rooms o segmentos de audiencia autogestionados pueden sincronizar datos de clientes y segmentos para permitir la entrega de audiencias personalizadas para los principales anunciantes y audiencias generales. Esta integración implica usar su CDP para suministrar información de clientes/segmentos a Epsilon. Ya sea por API o por archivo.
### Requisitos de integración
* La integración estándar en el sitio debe incluir el ID de cliente en todos los puntos de contacto relevantes (cuando esté disponible).
* Feed de ID de cliente de clientes, por API o feed de archivos.
* Feed de segmentos por API o feed de archivos.
### Cómo funciona
La CDP o plataforma de audiencia proporciona datos de clientes y segmentos a Epsilon mediante la carga de archivos o API. Los ID de cliente incluidos en las solicitudes de anuncios se comparan con los segmentos de audiencia y las campañas asociadas. Esto permite una segmentación precisa basada en definiciones de audiencia generales o personalizadas.
### Ejemplos de integración
**Ejemplo de solicitud de anuncio**: Solicitud de anuncio que contiene el ID de 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" %}
Su solicitud de anuncio debe contener `customerId`, independientemente de si se integra mediante archivo o API.
{% endhint %}
### Integración de sincronización de archivos de feed (recomendado)
Al sincronizar clientes y segmentos por archivo, requerimos dos archivos:
* Archivo de segmento
* Archivo de cliente
#### Archivo de segmento
Un archivo de segmento se utiliza para proporcionar un ID de segmento que se muestra en la interfaz de usuario, un nombre y una descripción. También se puede utilizar para especificar cualquier team\_ids específico que pueda ver un segmento, lo que le permite curar segmentos para anunciantes específicos.
| segment\_id | name | description | team\_ids |
| ----------------- | ---------------------------------------------- | ------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- |
| general-segment-1 | Compradores de alto gasto | Compradores con una compra semanal promedio en el 15% superior. | |
| general-segment-2 | Compradores orientados al valor | Compradores que tienen un mayor % en la cesta de productos orientados al valor. | |
| general-segment-3 | Compradores recurrentes | Compradores que compran todas las semanas en promedio. | |
| custom-segment-1 | Personalizado: Alta reciente de compra BrandCo | Clientes que han comprado BrandCo en los últimos 30 días. | \["a5166fc4-f874-4741-a721-c05ffd9941a5","92f4b91f-0089-4102-b13b-6015da8e0174"] |
Ver la Guía de referencia de segmentos [aquí](/retail-media-interface/integration/es/references/audience-targeting-reference.md#segment-feed-required-when-syncing-your-own-segments).
#### Archivo de cliente
Su archivo de cliente se utiliza para crear un solo cliente y vincularlo a segmentos, solo necesita proporcionar `customer_id` y `segment_ids`
| customer\_id | segments |
| ------------ | ------------------------------------------- |
| cust\_12345 | \["general-segment-3", "general-segment-4"] |
| cust\_67890 | \["general-segment-3"] |
Ver la Guía de referencia de clientes [aquí](/retail-media-interface/integration/es/references/audience-targeting-reference.md#customer-feed-required-when-syncing-your-own-segments-and-customers).
{% hint style="info" %}
Máximo de 100 segmentos por cliente.
Si está sincronizando más de 100 segmentos para un cliente, póngase en contacto con Epsilon. Si supera los 100 segmentos por cliente, las solicitudes de anuncios pueden tener una agrupación de segmentos reducida y truncar los segmentos en la solicitud.
{% endhint %}
### Integración de sincronización por API
Al sincronizar clientes y segmentos por API, hay tres operaciones que deben completarse.
1. Crear segmentos
2. Opcional: gestionar el acceso a los segmentos
3. Crear clientes
4. Gestionar la vinculación entre cliente y segmento
#### Creación de segmentos mediante la API
Lo primero que debe hacer es crear sus segmentos a los que vinculará a los clientes.
Debe proporcionar un ID de segmento que se muestra en la interfaz de usuario, un nombre, una descripción y su equipo de minorista.
{% hint style="info" %}
Importante: La API de segmentos utiliza la autorización bearer empleada por la API de socios (Partner API). Necesitará generar un token bearer y utilizarlo. Más información: [Solicitudes de autenticación](https://help.citrusad.com/retail-media-interface/partner/es/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"
}
}
```
Ver la referencia del extremo Crear un segmento [aquí](https://help.citrusad.com/retail-media-interface/partner/es/audience-segment-api/segment/createsegment).
#### Opcional: gestionar el acceso a los segmentos
Puede utilizar la función manage-access para proporcionar acceso a anunciantes seleccionados para que vean el segmento, lo que le permite curar segmentos para anunciantes específicos.
```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"
]
}
```
Ver la referencia del extremo Gestionar el acceso a un segmento específico [aquí](https://help.citrusad.com/retail-media-interface/partner/es/audience-segment-api/segment/manageaccess).
#### Creación de clientes mediante la API
{% hint style="info" %}
La API de clientes utiliza la autorización básica empleada por la API de integración.
{% 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 vez completado, también debe crear segmentos a los que vincular a los clientes. Puede crear hasta 100 clientes por solicitud.
Ver la especificación de la API para crear o actualizar un cliente [aquí](/retail-media-interface/integration/es/integration/create-or-update-a-customer.md).
#### Vincular clientes a segmentos mediante la API
Después de crear los segmentos, utilice la API /customers/manage-segments para vincular clientes a segmentos
```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 en esta solicitud es su ID de equipo de minorista.
{% endhint %}
Consulta la especificación de la API para gestionar segmentos y clientes aquí.
---
# 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/es/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.