Descripción general de alto nivel

Como parte de esta integración, tendrá que hacer lo siguiente

1. Aplicar una solicitud de anuncio adicional para la ubicación por categorías de venta cruzada.
   1. Esto incluye el trabajo de posicionar y mostrar anuncios en su sitio, así como el informe de clics e impresiones
   2. Los pedidos deben proporcionarse a Epsilon Retail Media como parte de la integración estándar.
2. If you synchronise category IDs with Epsilon Retail Media, you will need to use the filterMapping API to provide human readable values for the UI category selection
   1. Esto solo se aplica si está integrado con ID de categoría en lugar de nombres. (como cuando solicita anuncios, sus filtros son category:123j-dsef-er en lugar de category:Milk
3. (Recomendado): sincronice las asignaciones de categorías de venta cruzada para automatizar la aprobación y reducir la carga de gestión de campañas.

Solicitud de anuncios e integración del sitio

Solicitud de anuncio

Como la venta cruzada por categorías requiere una ubicación independiente, deberá integrar una solicitud de anuncio adicional por tipo de anuncio para el que esté integrando la venta cruzada por categorías.

El formato de su solicitud debe coincidir con la solicitud de anuncio de categoría de venta cruzada, como se indica a continuación

• Anuncio de producto: solicitud de anuncios de venta cruzada por categorías
• Anuncio de banner: solicitud de anuncios de venta cruzada por categorías
• Banner X: solicitud de anuncios de venta cruzada por categorías

Informes de impresiones y clics

Once you have integrated your ad request, you will also need to ensure you are reporting clicks and impressions correctly for each ad shown. Ensure you read Reporting impressions & clicks.

Información de pedidos

Generally, most integrations report all order information to Epsilon Retail Media as per a standard integration. You need to ensure you are reporting all orders correctly to Epsilon Retail Media as per Order data.

Asignaciones de filtros

El endpoint de asignación de filtros se puede utilizar para asignar sus ID de categoría a valores legibles por humanos. Esto es necesario si sincroniza ID de categoría, ya que la IU muestra los valores a sus usuarios.

📘

Si sincroniza categorías legibles por humanos de su catálogo de productos con Epsilon Retail Media, este paso no será necesario.

Los usuarios no entenderán qué es category:12345-abcde. La API filterMapping se puede usar para asignar el valor al nombre de categoría relevante en su sitio, como category:Pantry.

There is no file based method to synchronise this information, it must be done via the filterMapping API.

🚧

A medida que cree categorías adicionales en su sitio, deberá asegurarse de que la API filterMapping se usa para actualizar las categorías.

Asignaciones de venta cruzada por categorías (recomendado)

Al integrar este tipo de ubicación, se recomienda encarecidamente proporcionar una asignación de las categorías que pueden segmentarse entre sí. Esto puede agilizar sus operaciones tras los trabajos de integración iniciales. La experiencia del anunciante está optimizada para permitir solo seleccionar las categorías que ya están permitidas.

Además, también es posible configurar la aprobación automática para campañas de categorías de venta cruzada cuando se proporcionan asignaciones de venta cruzada.

Métodos de integración

• You are able to use the crossSellCategory API to create and manage mappings as you require.
• Como alternativa, puede proporcionar un archivo TSV a un depósito de GCS alojado por Epsilon Retail Media con el formato que se indica a continuación.

Integración de API

All required information can be seen in the crossSellCategory API reference.

Integración de archivos

Si se integra por archivos, Epsilon Retail Media requerirá un archivo por catálogo, cuyas categorías pueden segmentarse entre sí.

Cada fila del archivo representa una única asignación de una categoría y la categoría a la que puede segmentarse. Cada asignación es unidireccional (si sincroniza chocolate -> leche, los productos de chocolate pueden aparecer en la categoría de lácteos. Si es necesario que los productos lácteos aparezcan en chocolate, se requiere una fila adicional).

Se necesita una fuente de datos en formato TSV que cumpla con las siguientes especificaciones:

A continuación se detallan las especificaciones adicionales de los archivos:

• Solo son compatibles los archivos TSV
• El TSV debe estar en LF, no en CRLF
• El TSV debe estar codificado en UTF-8; cualquier otro código hará que falle el feed
• Se requiere convención de nomenclatura: ^cross_sell_category.*.tsv$

A modo de ejemplo, el aspecto del snippet será el siguiente:

Este snippet anterior permite que la categoría de galletas realice ventas cruzadas en las categorías de leche y chocolate. La categoría leche puede realizar ventas cruzadas en la categoría galletas. La categoría chocolate se puede segmentar, pero no puede segmentarse a ninguna otra categoría.

❗️

Cada fila es una combinación de asignación única

Debe sincronizar filas únicas para cada asignación de categorías de venta cruzada única. Al intentar sincronizar varios cross_category_id en una sola fila, la ingestión de archivos fallará.

🚧

Orden de columnas

Asegúrese de que su archivo tiene la columna category como primera columna. Si sincroniza cross_category_id como primera columna, la incorporación fallará.

Proceso de activación de funciones

Cuando lo tenga todo listo para empezar a sincronizar el feed de términos de búsqueda sugeridos, Epsilon Retail Media le configurará un depósito de GCS en el que colocar sus archivos.

Esta capacidad solo es compatible con depósitos GCS. No se admiten depósitos externos como AWS/Azure/otros.

Su gestor técnico de cuentas podrá guiarle a través de la activación de esta función. En caso de que el equipo de operaciones de la plataforma de Epsilon Retail Media deba realizar una configuración, tenga en cuenta que hay un plazo adicional para la activación.