Opción 2: Clientes y audiencias sincronizadas

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
}

📘

Your ad request must contain customerId, regardless of if you are integrating via file or 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.

View the Segment Reference Guide here.

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.

View the Customer Reference Guide here.

📘

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 podrían reducir la agrupación de segmentos y truncar los segmentos de la solicitud.

Integración de la sincronización de la API

Para 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 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.

📘

Important: The segments API uses bearer authorisation used by the Partner API. You will need to generate a bearer token and use it. Learn more: Authentication requests.

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"
  }
}

View the reference for the Create a segment endpoint here.

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"
        ]
}

View the reference for the Manage access to a specific segment endpoint here.

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.

View the specification for the API to Create or update a customer here.

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.

View the specification for the API to manage segments and customers here.