Aperçu de haut niveau

Dans le cadre de cette intégration, vous devrez effectuer les opérations suivantes

1. Implémenter une demande d'annonce supplémentaire pour l'emplacement des ventes croisées par catégorie.
   1. Cela comprend le travail de positionnement et de rendu des publicités sur votre site, ainsi que l'établissement de rapports sur les clics et les impressions
   2. Les commandes doivent être fournies à Epsilon Retail Media dans le cadre de votre intégration standard
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. Cela ne s'applique que si vous êtes intégré(e) aux ID de catégorie au lieu de noms. (par exemple, lorsque vous demandez des annonces, vos filtres sont category:123j-dsef-er au lieu de category:Milk
3. (Conseillé) - Synchronisez les mappages de ventes croisées par catégorie pour automatiser l'approbation et réduire le chargement de la gestion des campagnes.

Requête d'annonce et intégration du site

Demande d'annonce

Comme la vente croisée par catégorie nécessite un emplacement autonome, vous devrez intégrer une requête d'annonce supplémentaire par type d'annonce pour lequel vous intégrez la vente croisée par catégorie.

Le format de votre requête doit correspondre à celui de la requête d'annonces de ventes croisées, comme indiqué ci-dessous

• Annonce de produit - requête d'annonces de vente croisée par catégorie
• Bannière publicitaire - requête d'annonces de vente croisée par catégorie
• Bannière X - requête d'annonces de vente croisée par catégorie

Comptabiliser les impressions et les 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.

Comptabiliser les commandes

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.

Mappages des filtres

Le point de terminaison de mappage de filtre peut être utilisé pour mapper vos ID de catégorie en valeurs lisibles par l'homme. Ceci est nécessaire si vous synchronisez les ID de catégorie car l'interface utilisateur affiche les valeurs à vos utilisateurs.

📘

Si vous synchronisez les catégories lisibles par l'homme de votre catalogue de produits avec Epsilon Retail Media, cette étape ne sera pas nécessaire.

Les utilisateurs ne comprendront pas ce qu'est category:12345-abcde. L'API filterMapping peut être utilisée pour faire correspondre la valeur au nom de la catégorie correspondante sur votre site, par exemple category:Pantry.

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

🚧

Au fur et à mesure que vous créez des catégories supplémentaires sur votre site, vous devez vous assurer que l'API filterMapping est utilisée pour mettre à jour les catégories.

Mappages de ventes croisées par catégorie (conseillé)

Lors de l'intégration de ce type d'emplacement, il est vivement conseillé de fournir un mappage des catégories autorisées à se cibler mutuellement. Cela permet de rationaliser vos opérations après les premiers travaux d'intégration. L'expérience des annonceurs est rationalisée pour ne permettre que la sélection des catégories déjà autorisées.

En outre, il est également possible de configurer l'approbation automatique pour les campagnes de ventes croisées par catégorie, lorsque des mappages de vente croisée sont fournis.

Méthodes d'intégration

• You are able to use the crossSellCategory API to create and manage mappings as you require.
• Vous avez également la possibilité de fournir un fichier TSV à un bucket GCS hébergé par Epsilon Retail Media dans le format indiqué ci-dessous.

Intégration d'API

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

Intégration de fichiers

Si vous intégrez par fichier, Epsilon Retail Media exige un fichier par catalogue, dont les catégories peuvent se cibler mutuellement.

Chaque ligne du fichier représente un mappage unique d'une catégorie et la catégorie qu'elle peut cibler. Chaque mappage est unidirectionnel (si vous synchronisez chocolat > lait, les produits chocolatés peuvent apparaître dans la catégorie lait. Si les produits laitiers doivent apparaître sur le chocolat (et qu'une ligne supplémentaire est requise).

Nous avons besoin d'un flux de données au format TSV correspondant aux spécifications ci-dessous :

Les spécifications supplémentaires des fichiers sont les suivantes :

• Seuls les fichiers TSV sont pris en charge
• Le TSV doit être en LF et non CRLF
• Le TSV doit être encodé en UTF-8, tout type entraînera l'échec du flux
• Convention de dénomination requise : ^cross_sell_category.*.tsv$

Voici un exemple d'extrait de code :

Cet extrait ci-dessus permet à la catégorie cookies de réaliser des ventes croisées dans les catégories lait et chocolat. La catégorie lait peut effectuer des ventes croisées dans la catégorie cookies. La catégorie chocolat peut être ciblée, mais ne peut pas cibler d'autres catégories.

❗️

Chaque ligne est une combinaison de mappage unique

Vous devez synchroniser des lignes uniques pour chaque mappage unique de ventes croisées par catégorie. Si vous tentez de synchroniser plusieurs cross_category_id sur une seule ligne, l'ingestion du fichier échouera.

🚧

Ordre des colonnes

Veuillez vous assurer que la colonne category est la première colonne de votre fichier. Si vous synchronisez cross_category_id en tant que première colonne, l’ingestion échouera.

Processus d'activation des fonctionnalités

Une fois que vous êtes prêt(e) à synchroniser votre flux de termes de recherche suggérés, Epsilon Retail Media configure pour vous un compartiment GCS dans lequel déposer vos fichiers.

Cette fonctionnalité n'est prise en charge que sur les compartiments GCS. Les compartiments externes comme AWS/Azure/other ne sont pas pris en charge.

Votre responsable de compte technique pourra vous guider dans l'activation de cette fonctionnalité. L'équipe d’exploitation de la plateforme d’Epsilon Retail Media devant effectuer une configuration, veuillez noter qu’il y a un délai d’exécution supplémentaire pour l’activation.