Ce document fournit un guide complet sur la manière de générer des annonces de produits sur la base de critères de recherche spécifiques. Chaque requête API doit inclure des détails sur le contexte, tels que :

• customerId
• sessionId
• Emplacement
• ID du catalogue
• productFilters
• Nombre maximum d’annonces à afficher

Conditions préalables

Vous devez effectuer les étapes suivantes avant de commencer à demander des annonces de produits pour les emplacements de recherche.

Ajouter des catalogues de produits

Assurez-vous que vos produits ont été ajoutés à vos catalogues et synchronisés avec la plateforme Epsilon Retail Media.

Créer une campagne et configurer les catégories

Assurez-vous d'avoir créé une campagne et configuré des catégories. Pour obtenir de plus amples informations, veuillez consulter l’étape 4 : Configurer les critères cibles.

Récupérer les clés API et l’URL de base

1. Vous devez disposer d’une clé API valide. Procédez comme suit :

   1. Connectez-vous au compte de votre équipe Retail Media d’Epsilon.

   2. Allez en haut à droite de la page et cliquez sur le menu déroulant.

   3. Sélectionnez Paramètres d’intégration dans le menu déroulant.

      

   4. Cliquez sur l’onglet Clé API. Votre clé API secrète est initialement masquée. Pour l’afficher, cliquez sur le bouton Afficher. Une fois visible, copiez-la. Utilisez-la pour effectuer des appels API.

2. Vous devez avoir l’URL de base pour le point de terminaison d’API. Par exemple, https://staging-test.citrusad.com/v1/ads/generate HTTP/1.1. Vérifiez-la auprès de votre responsable de compte technique.

Générez des annonces pour les emplacements de catégories

Procédez comme suit pour générer des annonces de produits.

Requête HTTP

Point de terminaison : /v1/ads/generate

Méthode : POST

En-têtes :

• accepter : application/json
• content-type : application/json
• Autorisation : Basic <API_KEY>

Paramètres de la requête

Le corps de la requête doit être un objet JSON contenant les champs suivants. Pour préciser les emplacements de catégories, l'option productFilters doit être incluse dans le corps de la demande.

Exemple de requête

La requête JSON permet de spécifier un emplacement par catégorie pour les annonces liées à la catégorie « Placard/Snacks ». Elle inclut l'identifiant client, l'identifiant de session, l'identifiant du catalogue, les options de filtrage et définit le nombre maximum d'annonces à 3.

POST $BASE_URL/v1/ads/generate HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic <API_KEY>
{
    "customerId": "wertg5432a",
    "sessionId": "ec9-4e07-881d-3e9",
    "dtmCookieId": "AAAF8xLBTA968AB6TOthAAAAAAE",
    "placement": "category",
    "catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b",
    "productFilters": [
     	 ["category:Cupboard/Snacks"]
    ],
    "options": {
   							 "filterMode": "AndOr"
 							 },
    "maxNumberOfAds": 3
}

Générer des annonces pour les emplacements de catégories de ventes croisées

Les emplacements par catégories de ventes croisées sont similaires aux emplacements par catégories habituels, mais ils sont spécifiquement utilisés pour cibler les annonces relatives à des produits de vente croisée. Dans un scénario de vente croisée, vous visez à recommander des produits complémentaires en fonction de la catégorie actuelle que l’utilisateur parcourt.

Vous devez préciser la catégorie exacte pour laquelle vous souhaitez générer des annonces. Cette catégorie est généralement celle qui est affichée sur la page que l'utilisateur est en train de parcourir.

Exemple de requête

POST $BASE_URL/v1/ads/generate HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic <API_KEY>
{
    "customerId": "wertg5432a",
    "sessionId": "ec9-4e07-881d-3e9", 
    "placement": "category-cross-sell",
    "dtmCookieId": "AAAF8xLBTA968AB6TOthAAAAAAE",
    "catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b",
    "productFilters": [
     	 ["category:Cupboard/Snacks"]
    ],
    "options": {
   							 "filterMode": "AndOr"
 							 },
    "maxNumberOfAds": 3
}

Fusionner le ciblage des catégories organiques et des ventes croisées

Si vous souhaitez combiner des annonces organiques (annonces relatives à la catégorie consultée) et des annonces de vente croisée (annonces relatives à des catégories ou produits connexes) dans un seul emplacement publicitaire, vous devrez gérer cette intégration vous-même. Il faut développer la fonctionnalité permettant de combiner et d'afficher les deux types d'annonces simultanément.

Recommandations :

• Annonces organiques en premier : Affichez en premier les annonces correspondant à la catégorie actuelle (annonces organiques).
• Annonces de vente croisée en deuxième : Ensuite, affichez des annonces pour des catégories ou des produits associés (annonces de vente croisée) après les annonces organiques.

Les recommandations en matière de ciblage publicitaire par catégorie

Lorsque les utilisateurs naviguent dans différentes catégories, il est essentiel de mettre à jour votre appel API pour refléter la catégorie en cours de consultation. Cela permet de s'assurer que les annonces affichées restent pertinentes par rapport au contexte de navigation de l'utilisateur.

Il est recommandé d'envoyer la catégorie la plus spécifique (niveau le plus bas) dans votre demande d'annonce à la plateforme Epsilon Retail Media. En ciblant le niveau de catégorie le plus profond, on peut proposer des annonces plus pertinentes et plus précisément ciblées pour l'utilisateur.

Exemple de scénario

Un utilisateur commence à naviguer dans une catégorie générale, puis se dirige vers une sous-catégorie plus spécifique.

Appel API initial

Lorsque l'utilisateur accède à la sous-catégorie « Maison » :

POST $BASE_URL/v1/ads/generate HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic <API_KEY>
{
    "customerId": "wertg5432a",
    "sessionId": "ec9-4e07-881d-3e9",
    "dtmCookieId": "AAAF8xLBTA968AB6TOthAAAAAAE",
    "placement": "category",
    "catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b",
    "productFilters": [
     	 ["category:Home"]
    ],
    "options": {
   							 "filterMode": "AndOr"
 							 },
    "maxNumberOfAds": 3
}

Appel API mis à jour

Lorsque l'utilisateur accède à la sous-catégorie « Maison > Meubles » :

POST $BASE_URL/v1/ads/generate HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic <API_KEY>
{
    "customerId": "wertg5432a",
    "sessionId": "ec9-4e07-881d-3e9",
    "dtmCookieId": "AAAF8xLBTA968AB6TOthAAAAAAE",
    "placement": "category",
    "catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b",
    "productFilters": [
     	 ["category:Home/Furniture"]
    ],
    "options": {
   							 "filterMode": "AndOr"
 							 },
    "maxNumberOfAds": 3
}

Dernier appel API

Lorsque l'utilisateur accède à la sous-catégorie « Maison > Meubles > Chaises » :

POST $BASE_URL/v1/ads/generate HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic <API_KEY>
{
    "customerId": "wertg5432a",
    "sessionId": "ec9-4e07-881d-3e9",
    "dtmCookieId": "AAAF8xLBTA968AB6TOthAAAAAAE",
    "placement": "category",
    "catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b",
    "productFilters": [
     	 ["category:Home/Furniture/Chairs"]
    ],
    "options": {
   							 "filterMode": "AndOr"
 							 },
    "maxNumberOfAds": 3
}

En mettant à jour l'appel API pour refléter la catégorie la plus spécifique dans laquelle l'utilisateur navigue, vous vous assurez que les annonces diffusées sont très pertinentes. Au lieu de préciser une requête en chaîne sur plusieurs niveaux de catégorie (L1 + L2 + L3), il est recommandé de préciser le niveau de catégorie le plus profond (L3).

Prochaines étapes

• Générez des annonces de produits à l'aide de l'emplacement dans les résultats de recherche
• Optimiser le ciblage publicitaire