En este documento se explica cómo actualizar los archivos TSV y enviar archivos de datos a Epsilon Retail Media, lo que es esencial para ejecutar campañas y permitir que Epsilon Retail Media publique anuncios personalizados.

Requisitos previos para la entrega del archivo de detalles del producto

Formato de archivo: Se recomienda que todos los archivos estén delimitados por tabulaciones (TSV) y que estas sean coherentes en todos los archivos.
TSV sin comillas: los archivos de TSV no pueden estar entre comillas. Asegúrese de sincronizar los archivos sin comillas.
Fila de encabezado: incluya una fila de encabezado en cada archivo de datos para identificar las columnas.
Compresión gzip: Se recomienda que los archivos TSV se entreguen mediante compresión gzip.
Convención de nomenclatura de archivos: utilice el siguiente formato para dar nombre a los archivos: <clientname>_ONLINE_PRODUCT_CATALOG_YYYYMMDD.gz
- <nombrecliente>: sustitúyalo por el nombre de cliente correspondiente.
- AAAAMMDD: la fecha en que se entrega el archivo en formato Año-Mes-Día. Se recomienda incorporar el catálogo de productos a diario para ofrecer los mejores anuncios. Cada incorporación es una actualización completa, lo que significa que el catálogo del día anterior se borra por completo y el nuevo catálogo se carga y se utiliza. Por lo tanto, la fecha en el nombre del archivo es crucial.

Campos obligatorios para campos de catálogo de productos

Debe compartir el archivo TSV que contiene los siguientes detalles:

Nombre del campo	Descripción
product_code o product_id (obligatorio)	Un código para identificar el producto en su sistema, normalmente el GTIN del producto. Este es el mismo ID de producto que se utiliza en la integración de su sitio con Epsilon/CitrusAd. Debe ser un ID de nivel de producto, no un ID de nivel de SKU (es decir, no debe contener información sobre el tamaño o el color).
product_name (obligatorio)	El nombre o título del producto tal y como aparece en su página web.
product_description (obligatorio)	La descripción del producto tal y como aparece en su sitio.
URL (obligatorio)	La URL de la página que contiene este producto en su sitio.
image_url (opcional)	Un hipervínculo a la imagen de un producto. Debe ser una URL válida.
Inventario o disponibilidad (obligatorio)	Indique «Y» si el producto está actualmente disponible para su compra en línea; de lo contrario, indique «N». También puede proporcionarse como un valor de inventario numérico, donde 0 significa «N» y 1 significa «Y». Si el valor es 0, no se distribuirán anuncios de productos para este producto.
precio (Opcional)	El precio de este producto en moneda local, incluyendo el importe exacto en dólares y centavos. No incluya el símbolo de la moneda.
sale_price (opcional)	El precio de venta de este producto en moneda local, incluyendo el importe exacto en dólares y centavos. No incluya el símbolo de la moneda.
tipo (opcional)	La categoría o clasificación del producto. Este campo suele ser específico del minorista y, a menudo, puede ser NULL. Es posible que se requiera información o pautas adicionales para completar este campo con precisión.
UPC (obligatorio)	El código universal de producto (UPC) del producto.
PARENT_SKU_NUMBER (opcional)	Número de SKU principal: el cliente debe verificar la indisponibilidad de un número de SKU principal y confirmar si se debe usar el UPC o el ID de producto como alternativa.
CATEGORY_HIERARCHY_IDS (opcional)	Jerarquía delimitada de ID de categoría para el producto. Por ejemplo, 1234>2345>3456
CATEGORY_HIERARCHY_NAMES (opcional)	Jerarquía delimitada de nombres de categoría para el producto. Por ejemplo, Hombres>Partes de arriba>Camisas
PRODUCT_BRAND (obligatorio)	La marca a la que se asocia este producto.
FILTROS (obligatorio)	Una matriz JSON de filtros de productos.
FILTER:KEY (obligatorio)	Esto es necesario para las ubicaciones de categoría y de visualización amplia. Para añadir filtros como categorías al sistema de manera efectiva, recomendamos que los minoristas compartan su lista de categorías (retailer_taxonomy). Las categorías deben añadirse en el formato «categoría:», como «Categoría:Libros». Si se utiliza este tipo de columna, los minoristas deben proporcionar un valor para . Se pueden incluir varias columnas con esta sintaxis en un archivo TSV.
subClassName (obligatorio solo para ubicaciones de venta cruzada en el sitio)	El nombre de la subclase o categoría a la que pertenece el producto correspondiente. Por ejemplo, un producto de manteca puede pertenecer a la subclase «pan« pero no a la de «vendajes». Esta clasificación permite una mejor segmentación de los productos.
subSellSubClassName (obligatorio solo para ubicaciones de venta cruzada en el sitio)	Los nombres de las subclases/categorías a las que el producto en cuestión puede dirigirse.
custom_payload (opcional: solo in situ para integraciones en las que el minorista recibe metadatos personalizados adicionales para renderizar un producto).	Este campo contiene una carga personalizada que debe enrutarse a través de la generación de anuncios. El valor de esta columna debe ser un objeto JSON válido serializado en una matriz de bytes y codificado en Base64.
PRODUCT_REVIEW_COUNT (opcional)	Recuento actual de reseñas en línea para este producto.
PRODUCT_RATING_COUNT (opcional)	Recuento actual de valoraciones en línea para este producto.
PRODUCT_RATING_AVERAGE (opcional)	Valoración media actual de este producto.
COLLECTION_ID (opcional)	El identificador de la colección a la que pertenece el producto (por ejemplo, Outfit, Series, etc.). Todos los productos de la misma colección deben compartir el mismo ID de colección.
COLLECTION_TYPE (opcional)	El tipo de colección al que pertenece el producto (por ejemplo, Outfit, Series, etc.). Todos los productos de la misma colección deben compartir el mismo ID de colección.
COLLECTION_IMAGE_URL (opcional)	La dirección URL de una imagen que muestra esta colección.
COLLECTION_URL (opcional)	La dirección URL de la página del sitio que contiene esta colección.
GÉNERO (opcional)	El género (hombres, mujeres, niños, niñas, desconocido) con el que está asociado este producto.
TAMAÑO	El tamaño de este producto.
N.º DE PRODUCT_ATTRIBUTE PERSONALIZADO	Campos personalizados que contienen información específica de su negocio. Trabaje con su ingeniero de integración de clientes para determinar el contenido de este campo o si se necesitan campos adicionales.

Compartir su archivo TSV

Después de actualizar su archivo TSV con todos los campos obligatorios, compártalo con su ingeniero de integración de clientes (CIE) de Epsilon. Además, proporcione los siguientes datos junto con el archivo:

Dirección de correo electrónico de contacto para datos
Registro de encabezado para cada uno de los archivos
Notifique al equipo de Epsilon que se han enviado los archivos e incluya el recuento de filas de cada archivo