¡Desarrollo previsto!
Esta es una vista previa de la capacidad que tenemos prevista. Aunque el patrón general se mantendrá, tenga en cuenta que las especificaciones exactas pueden cambiar a medida que finalice el desarrollo.
Descripción general
Para las organizaciones que no pueden compartir identificadores de clientes, la activación de la audiencia puede lograrse sincronizando los feeds del segmento e incluyendo los ID de segmentos en las solicitudes de anuncios. Este enfoque que prioriza la privacidad permite la segmentación de audiencias personalizadas y generales sin exponer datos a nivel de cliente. Las solicitudes de anuncios deben incluir identificadores de segmentos para permitir 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 a cada cliente.
Cómo funciona
La plataforma CDP o de audiencia proporciona a Epsilon un feed del segmento mediante la API o la subida de archivos. Los ID de segmentos incluidos en las solicitudes de anuncios se utilizan para relacionar las audiencias con las campañas. La correspondencia 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 segmentos:
POST $BASE_URL/v1/ads/generate HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic <API_KEY>
{
"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
}
Integración sincronizada de archivos de fuente (recomendada)
Para sincronizar segmentos, solo necesitamos un archivo.
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 seleccionar segmentos para anunciantes específicos.
| segment_id | Nombre | Descripción | team_ids |
|---|---|---|---|
| general-segment-1 | Compradores con un gasto elevado | Compradores con una compra semanal media del 15 % superior. | |
| general-segment-2 | Compradores de valor | Compradores que tienen un mayor porcentaje de cesta de productos orientados al valor. | |
| general-segment-3 | Compradores recurrentes | Compradores que compran de media cada semana. | |
| custom-segment-1 | Personalizado: Elevada recencia de compra BrandCo | Clientes que han comprado BrandCo 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 la sincronización de la API
Para sincronizar clientes y segmentos a través de la API, se deben completar una o dos operaciones.
- Crear segmentos
- Opcional: gestionar el acceso a los segmentos
Creación de segmentos por API
Como usted ya gestiona la relación cliente-segmento antes de la solicitud de anuncio, solo necesita enviar segmentos.
Debe proporcionar un ID de segmento que se muestre en la interfaz de usuario, un nombre, una descripción y el equipo de su minorista.
La API de segmentos utiliza la autorización de portador que emplea la API para socios. Tendrá que generar un token de portador y usarlo. Más información: Solicitudes de autenticación.
POST $BASE_URL/v1/segments HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Bearer <API_KEY>
{
"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 endpoint Crear un segmento aquí.
Opcional: gestionar el acceso al segmento
Puede utilizar la función de gestión de acceso para otorgar acceso a los anunciantes seleccionados para que vean el segmento, lo que le permite seleccionar segmentos para anunciantes específicos.
POST $BASE_URL/v1/segments/{id}:manage-access HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Bearer <API_KEY>
{
"accessTeamIds":[
"90d5f138-2090-412b-a397-1f59ea6a31b3","1439f6f2-8c43-4ec5-b511-fc153f7d8119"
]
}
Consulte la referencia para el endpoint Gestionar el acceso para un segmento específico aquí.