Las cookies de origen son pequeños fragmentos de datos almacenados por el sitio web (o dominio) que el usuario está visitando en ese momento. Estas cookies las crea y almacena directamente el propio sitio web y solo ese sitio web puede acceder a ellas.

Cuando un usuario visita un sitio web, se establece una cookie de origen en su navegador que puede contener varios datos, como un identificador de usuario único o datos sobre las interacciones del usuario en el sitio. Esta cookie persiste durante varias sesiones y visitas, lo que permite al sitio web reconocer a los usuarios que regresan y atribuir sus acciones a lo largo del tiempo. Estas identificaciones están disponibles en el sistema durante aproximadamente 13 meses.

Epsilon aprovecha esta cookie para facilitar la elaboración de informes y atribuciones omnicanal más profundos.

Requisitos

Para implementar correctamente la atribución basada en cookies propias (FPC, por sus siglas en inglés) en sus sitios, asegúrese de tener los siguientes datos antes de integrar las actividades de su sitio con la cookie de origen de Epsilon:

Preparar los datos requeridos

Asegúrese de tener listos los datos de los clientes, los datos de conversión y las etiquetas del sitio de Epsilon.

• Datos de conversión: Los datos de conversión ayudan a realizar una atribución precisa, mejoran la segmentación, optimizan el rendimiento, garantizan la coherencia de los datos y brindan información completa sobre los clientes.
  • Datos de conversiones de la campaña: incluya datos de conversiones de todos los canales de compra, como en la tienda, en línea y por catálogo.
  • Todas las conversiones: Incluya todas las conversiones de clientes conocidos y desconocidos.
  • Solo ventas brutas: Proporcione únicamente las ventas brutas, excluyendo las actualizaciones o cancelaciones de pedidos.
  • ID de pedido coherentes: asegúrese de que los ID de pedido incluidos en el archivo de conversión coincidan con los ID de pedido incluidos en las etiquetas del sitio web.
• Etiquetas del sitio de Epsilon: El etiquetado del sitio implica incrustar código de seguimiento en sus páginas web para establecer y leer cookies de origen. Este proceso es esencial para capturar las interacciones de los usuarios y atribuir acciones con precisión a lo largo del tiempo.

  📘

  Para garantizar una integración perfecta, tendrá que colaborar con sus equipos de ingeniería de integración de clientes (CIE) y gestión de programas de integración (IPM). Estos le guiarán a través de los pasos necesarios, que incluyen los siguientes:

  • Estrategia de etiquetado: desarrolle una estrategia para captar todas las interacciones relevantes de los usuarios.
  • Implementación: incruste el código de seguimiento correctamente en sus páginas web.
  • Pruebas: lleve a cabo pruebas exhaustivas para asegurarse de que las cookies se establecen y leen correctamente.

Proporcionar atributos coincidentes

El cliente debe proporcionar atributos coincidentes en los siguientes puntos de datos.

Implementar cookies propias

Esta sección describe los pasos secuenciales necesarios para integrar con éxito la cookie propia (FPC) de Epsilon con las actividades de su sitio, lo que garantiza un seguimiento y una atribución precisos.

Paso 1: Identificar y capturar la cookie propia

1. Determine cuándo se establece la FPC en el navegador del cliente.

2. Localice e identifique el valor dtm_token_sc dentro de los datos de la cookie.

   

📘

Cuando un nuevo usuario visite su sitio por primera vez, la FPC no se habrá establecido. La primera vez que el usuario navegue por su sitio, aparecerá el valor de la cookie propia. Podrá comenzar a usar dtm_token_sc cuando esté disponible.

Paso 2: Pasar el dtm_token_sc en las llamadas a la API de solicitud de anuncios en el sitio

1. Incluir el valor dtm_token_sc en el campo dtmCookieId al realizar llamadas a la API de solicitud de anuncios en el sitio. Esto permite realizar un seguimiento y atribución precisos de las interacciones de los usuarios.

2. Además, pase el campo CustomerId en el campo CustomerId para asociar la cookie a un cliente específico, lo que mejora la precisión del seguimiento. El valor CustomerId estará disponible cuando el cliente se conecte al sitio del minorista.

   Solicitud de ejemplo

   HTTP

   {
     "sessionid": "{SESSION_ID}", // Set to value advised by your CIE.
     "customerid": "{CUSTOMER_ID}", // Set to CustomerId value when available.
     "dtmCookieId": "{DTM_TOKEN_SC_VALUE}" // Set to dtm_token_sc value.
   }
   
   

   Ejemplo de respuesta

   HTTP

   {
     "sessionid": "SESSION_1", // Set to value advised by your CIE.
     "customerid": "CUSTOMER_1", // Set to CustomerId value when available.
     "dtmCookieId": "AAAF8xLBTA968AB6TOthAAAAAAE" // Set to dtm_token_sc value.
   }
   
   

Para obtener más información sobre las llamadas a la API de solicitud de anuncios, consulte Generar anuncios de productos.

📘

Si su sistema utiliza el almacenamiento en caché para mejorar el rendimiento mediante el almacenamiento temporal de datos o contenido, es fundamental incluir el valor dtm_token_sc en todas las llamadas a eventos de impresión y clic. Esto garantiza que las interacciones de los usuarios se rastreen correctamente, incluso cuando los datos se sirven desde la caché.

Paso 2a: Manejar la implementación del almacenamiento en caché

Si tiene una función de almacenamiento en caché integrada, asegúrese de enviar el valor dtm_token_sc en sus impresiones y llamadas a eventos de clic.

Ejemplo de evento de impresión

GET {integration}.citrusad.com/v1/resource/first-i/display_xc0O_S0kqwqS93k972ikrrUDagUKCAoGOTI0NTcxEgIIARoMCI7ew6AGENTCytEDIgIIAQ==?sessionId=SESSION_1&customerId=CUSTOMER_1&dtmCookieId=AAAF8xLBTA968AB6TOthAAAAAAE&event_ts=20230314200515

Ejemplo de evento de clic

GET {integration}.citrusad.com/v1/resource/second-c/display_xc0O_S0kqwqS93k972ikrrUDagUKCAoGOTI0NTcxEgIIARoMCI7ew6AGENTCytEDIgIIAQ==?sessionId=SESSION_1&customerId=CUSTOMER_1&dtmCookieId=AAAF8xLBTA968AB6TOthAAAAAAE&event_ts=20230314200515

Paso 3: Pasar el dtm_token_sc en llamadas a la API de pedidos en el sitio

1. Incluir el valor dtm_token_sc en el campo dtmCookieId al realizar llamadas a la API de pedidos en el sitio. Esto ayuda a atribuir con precisión los pedidos y las acciones de conversión al usuario específico.
2. Además, pase el campo CustomerId en el campo CustomerId para vincular los datos del pedido con el perfil del cliente, lo que facilita la elaboración de informes y análisis más detallados. El valor de CustomerId estará disponible cuando el cliente inicie sesión en el sitio del minorista.

Ejemplo de respuesta

{
    "orders": [
       {
        "customerId": "npc-s243-ir",
        "teamId": "9f48572c-0a5b-4997-9a0e-ed74f4d32dc6",
        "sessionId": "5cat7-9964-4f",
        "dtmCookieId": " AAAF8xLBTA968AB6TOthAAAAAAE"
        "orderDate": "2021-12-02T15:00:00Z",
        "id": "3h30e938-c158-4d78-a0af-b48bbwfrcss4",
        "orderItems": [
            {
                  "gtin": "9891998566P",  
                  "quantity": 3, 
                  "regularUnitPrice": 1.00,
                  "totalOrderItemPriceAfterDiscounts": 3.00,
                  "catalogId": "6adb93d0-7he4-4d4e-9b47-e5d3714c976a",
                  "citrusDiscountAmount": 0.0,
                  "substitutedFor": null,
                  "sellerId": "seller_id_601_64"
                }
              ]
            }
    ]
}

Para obtener más información sobre las llamadas a la API de solicitud de anuncios, consulte Sincronización de datos de pedidos a través de API.