Opción 3: Solo audiencias sincronizadas

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

📘
¿Está sincronizando segmentos de varias fuentes?
Si es así, también deberá proporcionar el sourceId en el objeto de segmento. 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 sincroniza desde una fuente/CDP, solo necesita enviar lossegmentIds en la matriz del segment.

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

View the Segment Reference Guide here

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.

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

Si se sincronizan segmentos a través de la API, este sourceId se alinea con la solicitud de anuncio.

📘
Máximo de 100 segmentos por solicitud de anuncio.
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.
En caso de truncamientos, verá que el campo metadata.warnings en la respuesta al anuncio aparece y se completa, tal y como se indica a continuación:
  "metadata": {
    "warnings": [
      "Audience Segment IDs exceeded the limit of 100 and were truncated"
     ]
  }

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.