API partenaire
Ressources API

Ciblage par emplacement

Le ciblage par emplacement permet aux annonceurs ou aux détaillants de cibler des lieux spécifiques (tels que des magasins ou des régions) dans leurs campagnes. Cette fonctionnalité peut être utilisée pour des emplacements plus larges afin de restreindre l’audience à un endroit précis.

👍

Nous recommandons cette amélioration pour les emplacements d’affichage larges

Nous vous recommandons de l’intégrer dans les catégories ou les emplacements d’affichage larges, car ils sont davantage basés sur la navigation. Nous ne le recommandons pas pour les emplacements de recherche, car les campagnes sont déjà ciblées par intention et cela peut réduire l’audience sélectionnable de l’annonceur.

Aperçu de haut niveau

Notre fonctionnalité de ciblage par emplacement permet aux annonceurs de sélectionner des lieux dans l’assistant de création de campagne. Cette option peut être activée au niveau de chaque emplacement pour les recherches, catégories et affichages larges. Voici un exemple de l’interface :

Elle fonctionne de la même manière que notre fonction de ciblage par catégorie. Elle permet aux annonceurs de sélectionner des emplacements synchronisés avec les produits qu’ils ont choisis. Une fois les emplacements sélectionnés, ils apparaissent dans les écrans de révision et de gestion de campagne.

Vue d’ensemble de l’intégration

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

  1. Synchroniser les filtres d’emplacement de vos produits
  2. Synchroniser des noms d’emplacements adaptés à l’interface utilisateur ou des emplacements de mappage via l’API FilterMapping (sous réserve d’intégration)
      1. Cela s’applique uniquement si vous intégrez des identifiants d’emplacements au lieu de noms, ou si vous souhaitez mapper des emplacements (par exemple, synchroniser des magasins et les mapper à des régions).
  3. Améliorer votre requête d’annonces pour demander des filtres d’emplacement

Synchroniser les filtres d’emplacement de vos produits

Pour afficher des emplacements dans l’interface utilisateur, les données pertinentes (disponibilité) doivent être synchronisées sur chaque produit. En fonction de votre intégration, vous pouvez déjà synchroniser ces informations pour améliorer le taux de remplissage des annonces.

Synchroniser via l’API

Si vous synchronisez des produits via une API, vous devrez mettre à jour chaque produit avec les emplacements correspondants dans filters l’objet. Vous trouverez un exemple dans la section Synchroniser les informations d’emplacement sur la page Synchroniser les produits via une API.

Synchroniser par fichier

Si vous synchronisez le catalogue et les produits via un fichier, vous aurez probablement simplement besoin d’ajouter une colonne à votre fichier pour indiquer l'emplacement/les emplacements pertinent(s) dans le(s)quel(s) chaque produit est stocké. Ce sera simplement une autre colonne intitulée location.

📘

Format du filtre d’emplacement

Nous recommandons vivement d'utiliser le format suivant pour vos filtres d’emplacement : location:<value>Il apparaîtra correctement dans l’API de reporting. Il est identique à celui utilisé par la requête d’annonces pour diffuser des publicités.

Si vous synchronisez les données via un fichier, votre système d’intégration client peut le mapper correctement pour vous.

Synchroniser des noms d’emplacements via l’API FilterMapping

L’API de mappage de filtres peut être utilisée pour mapper vos ID d’emplacements en valeurs lisibles par l’homme. Cette fonctionnalité est nécessaire si vous synchronisez les ID d’emplacements car les valeurs seront affichées dans l’interface utilisateur. Si vous synchronisez des filtres à un seul niveau (comme la région), l’interface utilisateur affichera chaque sélection comme suit :

Si vous mappez des magasins à des régions, ou un agrégat similaire, chaque sélection indiquera le nombre de filtres d’emplacements qu’elle représente :


📘

Si vous synchronisez des états lisibles par l’homme en tant qu’emplacements dans votre catalogue de produits avec Epsilon Retail Media, cette étape ne sera pas nécessaire.

Améliorer votre requête d’annonces

En fonction de votre intégration, vous pouvez déjà synchroniser ces informations pour améliorer le taux de remplissage des annonces. Il s’agit d’améliorer votre demande afin de préciser l’emplacement de l’utilisateur dans productFilters l'objet.

Le format de votre requête doit correspondre à celui de la requête d’annonces, comme indiqué ci-dessous :

🚧

Souhaitez-vous ajouter le ciblage par emplacement à un emplacement sélectionné uniquement ?

Vous souhaiterez peut-être mettre en œuvre cette amélioration sur tous vos emplacements. Cela permettra de les uniformiser, même si vous activez le ciblage sur les emplacements sélectionnés.

Limitations connues de la fonctionnalité

Avant de commencer le développement, nous vous recommandons de comprendre les limitations de cette fonctionnalité, exposées ci-dessous.

  • Cette fonctionnalité exploite les filtres synchronisés sur les produits. Nous vous recommandons de vous assurer qu’en synchronisant la disponibilité des produits et des emplacements, vous restez dans les limites de l’accord de niveau de service (SLA) pris en charge.
  • Cette fonctionnalité n’est pas compatible avec la catégorie ventes croisées ou les emplacements de ventes croisées des produits existants.
  • Il n’existe pas de rapports dans l’interface utilisateur par emplacement sélectionné dans une campagne.
    • Ces informations apparaissent dans les ensembles de données de reporting au niveau des informations pour les détaillants qui utilisent l’API de reporting. Ces derniers peuvent générer des rapports au niveau de l’emplacement pour les intégrer dans des systèmes externes, si besoin.
  • Les réservations de location fixe vous permettent de sélectionner des emplacements sur une campagne, mais elles ne peuvent pas être effectuées au niveau de chaque campagne.
    • Les réservations se font par catégorie, par terme de recherche ou par niveau d’emplacement (pour les emplacements d’affichage larges)