> 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-3-sync-audiences-only.md).
# Opción 3: Sincronizar solo audiencias
### Descripción general
Para las organizaciones que no puedan compartir identificadores de clientes, la activación de audiencias se puede lograr sincronizando fuentes de segmentos y pasando los ID de segmento en las solicitudes de anuncios. Este enfoque que prioriza la privacidad permite la segmentación de audiencias tanto personalizadas como generales sin exponer datos a nivel de cliente. Las solicitudes de anuncios deben incluir identificadores de segmento para admitir la activación segmentada.
### Requisitos de integración
* La fuente de segmentos debe especificar qué segmentos de audiencia están disponibles para los equipos de anunciantes designados.
* Las solicitudes de anuncios deben incluir los ID de segmento correspondientes para cada cliente.
### Cómo funciona
La CDP o plataforma de audiencia proporciona a Epsilon una fuente de segmentos mediante la carga de archivos o una API. Los ID de segmento incluidos en las solicitudes de anuncios se utilizan para hacer coincidir las audiencias con las campañas. La asignación entre clientes y segmentos se mantiene internamente dentro de los sistemas backend del minorista.
### Ejemplos de integración
**Ejemplo de solicitud de anuncio**: Solicitud de anuncio que contiene ID de segmento:
```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" %}
¿Está sincronizando segmentos desde múltiples fuentes?
Si es así, también deberá proporcionar el `sourceId` en el objeto segment. Este valor se acuerda entre usted y Epsilon para hacer referencia a la fuente del segmento. Un ejemplo podría ser `customer-cdp-1`.
Si solo está sincronizando desde una fuente/CDP, solo necesita enviar el `segmentIds` en el array `segment` .
{% endhint %}
### Integración de sincronización mediante archivo de fuente (Recomendado)
Al sincronizar segmentos, solo necesitamos un archivo.
#### Archivo de segmentos
Un archivo de segmentos se utiliza para proporcionar un ID de segmento que se muestra en la IU, 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 estructurar 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 enfocados en el valor | Compradores que tienen un mayor porcentaje de productos económicos en la cesta. | |
| general-segment-3 | Compradores recurrentes | Compradores que compran todas las semanas en promedio. | |
| custom-segment-1 | Personalizado: MarcaCo con alta frecuencia de compra | Clientes que han comprado MarcaCo en los últimos 30 días. | \["a5166fc4-f874-4741-a721-c05ffd9941a5","92f4b91f-0089-4102-b13b-6015da8e0174"] |
Consulte la Guía de referencia de segmentos aquí
### Integración de sincronización por API
Al sincronizar clientes y segmentos por API, hay una o dos operaciones que deben completarse.
1. Crear segmentos
2. Opcional: gestionar el acceso al segmento
#### Creación de segmentos mediante la API
Dado que gestiona la relación cliente-segmento antes de la solicitud de anuncio, solo necesita enviar segmentos.
Debe proporcionar un ID de segmento que se muestra en la IU, un nombre, una descripción, así como el equipo de su minorista.
{% hint style="info" %}
La API de segmentos utiliza la autorización bearer utilizada por la Partner API. Deberá generar un token bearer y utilizarlo. Obtenga 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"
}
}
```
Consulte la referencia para el extremo Crear un segmento [aquí](https://help.citrusad.com/retail-media-interface/partner/es/audience-segment-api/segment/createsegment).
Si se sincronizan segmentos mediante la API. Este `sourceId` se alinea con la solicitud de anuncio.
{% hint style="info" %}
Máximo de 100 segmentos por solicitud de anuncio.
Si está sincronizando más de 100 segmentos, póngase en contacto con Epsilon. Si supera los 100 segmentos por cliente, es posible que las solicitudes de anuncios tengan una agrupación reducida de segmentos y los trunquen en la solicitud.
En caso de truncamiento, verá que el campo `metadata.warnings`en la respuesta del anuncio aparece y se completa, como a continuación:
```
"metadata": {
"warnings": [
"Audience Segment IDs exceeded the limit of 100 and were truncated"
]
}
```
{% endhint %}
#### Opcional: gestionar el acceso al segmento
Puede utilizar la función manage-access para proporcionar acceso a anunciantes seleccionados para que vean el segmento, lo que le permite estructurar 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"
]
}
```
Consulte la referencia para el extremo Gestionar acceso a un segmento específico [aquí](https://help.citrusad.com/retail-media-interface/partner/es/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/es/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.