Ce document explique comment mettre à jour vos fichiers TSV et envoyer des fichiers de données à Epsilon Retail Media afin d’exécuter des campagnes et de permettre à Epsilon Retail Media de diffuser des annonces personnalisées.

Conditions préalables à la livraison du fichier d’informations du produit

Format du fichier : Il est recommandé que tous les fichiers soient délimités par des tabulations (TSV). Ce format doit être cohérent dans tous les fichiers.
TSV sans guillemets : les fichiers TSV ne peuvent pas contenir de guillemets. Assurez-vous de synchroniser les fichiers sans guillemets.
Ligne d’en-tête: pensez à inclure une ligne d’en-tête dans chaque fichier de données pour identifier les colonnes.
Compression Gzip : Il est recommandé de livrer les fichiers TSV avec une compression gzip.
Convention de dénomination des fichiers : utilisez le format suivant pour nommer les fichiers : <clientname>_ONLINE_PRODUCT_CATALOG_YYYYMMDD.gz
- <clientname> : remplacez ce champ par le nom du client.
- YYYMMDD : la date de livraison du fichier au format jour-mois-année. Il est recommandé d’ingérer le catalogue de produits tous les jours pour diffuser les meilleures annonces. Chaque ingestion est une actualisation complète, ce qui signifie que le catalogue de la veille est complètement effacé et que le nouveau catalogue est chargé et utilisé. Par conséquent, la date dans le nom du fichier est déterminante.

Champs obligatoires pour le catalogue de produits

Vous devez partager le fichier TSV contenant les informations suivantes :

Nom du champ	Description
product_code ou product_id (obligatoire)	Code permettant d’identifier le produit dans votre système, généralement le GTIN du produit. Il s’agit du même identifiant de produit que celui utilisé dans le cadre de l’intégration de votre site avec Epsilon/CitrusAd. Il doit s’agir d’un identifiant de niveau produit et non d’un identifiant de niveau SKU (c’est-à-dire qu’il ne doit pas contenir d’informations sur la taille ou la couleur).
product_name (obligatoire)	Nom ou titre du produit tel qu’il apparaît sur votre site.
product_description (obligatoire)	Description du produit telle qu’elle apparaît sur votre site.
URL (obligatoire)	URL de la page contenant ce produit sur votre site.
image_url (facultatif)	Un hyperlien vers l'image d'un produit. L'URL doit être valide.
stock ou disponibilité (obligatoire)	Indiquez « O » si le produit est actuellement disponible à l’achat en ligne, sinon, indiquez « N ». Il est également possible de fournir une valeur de stock numérique où 0 représente « N » et 1 représente « O ». Si la valeur est de 0, aucune annonce de produit ne sera diffusée pour ce produit.
prix (facultatif)	Prix du produit dans la devise locale, y compris le montant exact en dollars et en centimes. N’incluez pas le symbole de la devise.
sale_price (facultatif)	Prix de vente du produit dans la devise locale, y compris le montant exact en dollars et en centimes. N’incluez pas le symbole de la devise.
type (facultatif)	Catégorie ou classification du produit. Ce champ est généralement spécifique au détaillant et peut souvent être NULL. Des informations ou des directives supplémentaires peuvent être nécessaires pour le remplir correctement.
UPC (obligatoire)	Code universel du produit (UPC).
PARENT_SKU_NUMBER (facultatif)	Numéro SKU parent : le client doit vérifier si un numéro SKU parent n’est pas disponible et confirmer si l’UPC ou l’identifiant du produit doit être utilisé à la place.
CATEGORY_HIERARCHY_IDS (facultatif)	Hiérarchie délimitée d’identifiants de catégories pour le produit. Par exemple, 1234>2345>3456
CATEGORY_HIERARCHY_NAMES (facultatif)	Hiérarchie délimitée de noms de catégories pour le produit. Par exemple, Hommes>Hauts>Chemises
PRODUCT_BRAND (obligatoire)	Marque à laquelle ce produit est associé.
FILTERS (obligatoire)	Un tableau json de filtres de produits.
FILTER:KEY (obligatoire)	Cette information est obligatoire pour les emplacements de catégories et d’affichages larges. Pour optimiser l’ajout de filtres tels que les catégories dans le système, nous recommandons aux détaillants de partager leur liste de catégories (retailer_taxonomy). Ces dernières doivent être ajoutées au format « catégorie : », comme « catégorie :Livres ». Si ce type de colonne est utilisé, les détaillants doivent fournir une valeur pour . Plusieurs colonnes avec cette syntaxe peuvent être incluses dans un fichier TSV.
SubclassName (obligatoire pour les ventes croisées sur les emplacements sur site uniquement)	Nom de la sous-classe ou de la catégorie à laquelle appartient le produit concerné. Par exemple, un produit à base de beurre peut appartenir à la sous-classe « pain » mais pas à celle des « pansements ». Cette classification permet de mieux cibler les produits.
xSellSubClassName (obligatoire pour les ventes croisées sur les emplacements sur site uniquement)	Les noms des sous-classes/catégories dans lesquelles le produit pertinent peut cibler des produits.
custom_payload (facultatif : sur site uniquement pour les intégrations où le détaillant reçoit des métadonnées personnalisées supplémentaires pour le rendu d’un produit).	Ce champ contient une charge utile personnalisée qui doit être transmise à la génération d’annonces. La valeur de cette colonne doit être un objet JSON valide sérialisé dans un tableau d’octets et encodé en Base64.
PRODUCT_REVIEW_COUNT (facultatif)	Nombre d’avis en ligne pour ce produit.
PRODUCT_RATING_COUNT (facultatif)	Nombre d’évaluations en ligne pour ce produit.
PRODUCT_RATING_AVERAGE (facultatif)	Note moyenne pour ce produit.
COLLECTION_ID (facultatif)	Identifiant de la collection à laquelle appartient le produit (par exemple, « Vêtements », « Séries », etc.). Tous les produits d’une même collection doivent avoir le même identifiant de collection.
COLLECTION_TYPE (facultatif)	Type de collection à laquelle appartient le produit (par exemple, « Vêtements », « Séries », etc.). Tous les produits d’une même collection doivent avoir le même identifiant de collection.
URL_IMAGE_COLLECTION (facultatif)	URL d’une image affichant cette collection.
COLLECTION_URL (facultatif)	URL de la page de votre site contenant cette collection.
GENDER (facultatif)	Sexe (homme, femme, garçon, fille, inconnu) auquel ce produit est associé.
SIZE	Dimensions du produit.
CUSTOMPRODUCT_ATTRIBUTE#	Champs personnalisés contenant des informations propres à votre entreprise. Collaborez avec votre Client Integration Engineer pour déterminer le contenu de ce champ ou si des champs supplémentaires sont nécessaires.

Partager votre fichier TSV

Après avoir mis à jour votre fichier TSV avec tous les champs obligatoires, partagez-le avec votre Client Integration Engineer (CIE) d’Epsilon. Fournissez également les informations suivantes avec le fichier :

adresse e-mail de contact pour les données ;
enregistrement d’en-tête pour chacun des fichiers ;
informez l’équipe Epsilon que les fichiers ont été envoyés et incluez le nombre de lignes pour chaque fichier.