Descripción general
Los minoristas con salas limpias o segmentos de audiencia autogestionados pueden sincronizar los datos de clientes y segmentos para ofrecer audiencias personalizadas a los principales anunciantes y al público general. Esta integración implica utilizar su CDP para proporcionar información de clientes y segmentos a Epsilon. Esto puede ser por API o por archivo.
Requisitos de integración
- La integración interna estándar debe incluir el ID de cliente en todos los puntos de contacto pertinentes (cuando esté disponible).
- Fuente de ID de clientes, por API o fuente de archivo.
- Fuente de segmentos por API o fuente de archivo.
Cómo funciona
La plataforma CDP o de audiencia proporciona datos de clientes y segmentos a Epsilon mediante la API o la subida de archivos. Los ID de clientes incluidos en las solicitudes de anuncios se relacionan con los segmentos de audiencia y las campañas asociadas. Esto permite una segmentación precisa basada en definiciones de audiencia personalizadas o generales.
Ejemplos de integración
Ejemplo de solicitud de anuncio: solicitud de anuncio que contiene el ID de cliente:
POST $BASE_URL/v1/ads/generate HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic <API_KEY>
{
"customerId": "wertg5432a",
"sessionId": "ec9-4e07-881d-3e9",
"dtmCookieId": "AAAF8xLBTA968AB6TOthAAAAAAE",
"placement": "search",
"catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b",
"searchTerm": "chocolate",
"options": {
"filterMode": "AndOr"
},
"maxNumberOfAds": 3
}
Su solicitud de anuncio debe contener
customerId, independientemente de si la integración es por archivo o API.
Integración sincronizada de archivos de fuente (recomendada)
Para sincronizar clientes y segmentos por archivo, necesitamos 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 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í.
Archivo de cliente
Su archivo de cliente se utiliza para crear un único cliente y vincularlo a los segmentos, solo tiene que proporcionar customer_id y segment_ids
| customer_id | Segmentos |
|---|---|
| cust_12345 | ["general-segment-3", "general-segment-4"] |
| cust_67890 | ["general-segment-3"] |
Consulte la Guía de referencia de clientes aquí.
Integración de la sincronización de la API
Para sincronizar clientes y segmentos por API, hay tres operaciones que deben completarse.
- Crear segmentos
- Opcional: gestionar el acceso a los segmentos
- Crear clientes
- Gestionar la vinculación de segmento-cliente
Creación de segmentos por API
Lo primero que debe hacer es crear sus segmentos para vincular a los clientes.
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.
Importante: 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í.
Creación de clientes por API
La API de los cliente utiliza la autorización básica que emplea la API de integración.
POST $BASE_URL/v1/customers HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic <API_KEY>
{
"customers": [
{
"id": "cust_12345"
},
{
"id": "cust_67890"
}
}
]
}
Cuando termine, también debe crear segmentos para vincular a los clientes. Puede crear hasta 100 clientes por solicitud.
Consulte la especificación de la API para Crear o actualizar un cliente aquí.
Vincule clientes a segmentos mediante API
Después de crear los segmentos, utilice la API /customers/manage-segments para vincular a los clientes con los segmentos.
POST $BASE_URL/v1/customers/manage-segments HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic <API_KEY>
{
"customerId": "cust_12345",
"teamId":"13c84def-41cb-4f99-a3fc-6788264f79fe",
"segments": {
"segmentIds":[
"general-segment-4","general-segment-3"
]
}
}
teamId en esta solicitud es el ID de su equipo minorista.
Consulte la especificación de la API para Gestionar segmentos y clientes aquí.