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)	A code to identify the product in your system, typically the GTIN of the product. This is the same product ID used within your site's integration with Epsilon/CitrusAd. It should be a product-level ID, not a SKU-level ID (i.e., it should not contain size or color information).
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)	Indicate "Y" if the product is currently available for purchase online; otherwise, indicate "N". Alternatively, this can be provided as a numeric inventory value, where 0 represents "N" and 1 represents "Y". If the value is 0, product ads will not be served for the product.
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)	This is required for the category and broad display placements. To add filters like categories into the system effectively, we recommend that retailers share their list of categories (retailer_taxonomy). Categories should be added in the format "category:<value>", such as "category:Books". Si ce type de colonne est utilisé, les détaillants doivent fournir une valeur pour
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).	This field contains a custom payload that should be threaded through to ad generation. The value for this column must be a valid JSON object serialized into a byte array and Base64 encoded.
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.
CUSTOM_PRODUCTATTRIBUTE#	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.