Le tableau ci-dessous décrit les propriétés possibles dans une requête standard, ainsi que la réponse si vous recevez une annonce.
Éléments liés à la requête
| Chaîne | Description | Obligatoire/facultatif |
|---|---|---|
catalogId | L'identifiant de votre catalogue de produits pour votre site Web. | Obligatoire |
customerId | L'identifiant unique du client recevant les annonces. | Facultatif |
filterMode | Méthode facultative vous permettant de définir la structure de votre requête. Consultez la section Filtrer la génération d'annonces pour plus d'informations. | Facultatif, préféré |
maxNumberOfAds | Le nombre maximum d'annonces que vous souhaitez renvoyer, dans la limite de 10. | Obligatoire |
options | Méthode facultative vous permettant de définir la structure de votre requête. Consultez la section Filtrer la génération d'annonces pour plus d'informations. Il s'agit également de l'objet où vous pouvez demander des informations sur les annonceurs afin de vous conformer à la législation locale en matière de publicité, telle que le Règlement sur les services numériques de l'Union européenne. | Facultatif, préféré |
placement | L'emplacement unique lié à votre requête d'annonces. | Obligatoire |
productFilters | Tous les filtres de produits associés à votre requête, comme une catégorie, un emplacement ou une taille. | Obligatoire |
sessionId | L'identifiant unique de la session du client. Il est utilisé à des fins d'attribution dans les intégrations standard. Consultez la section Options de workflow d'intégration pour plus d'informations. | Obligatoire dans le cas d'intégrations standard |
memoryToken | Utilisé pour la pagination. Utilisez un jeton fourni dans une requête d'annonce précédente pour garantir qu'Epsilon Retail Media diffuse uniquement des nouvelles publicités à vos clients. Si c'est le cas, Epsilon Retail Media exclura les annonces précédemment diffusées dans la réponse publicitaire. Consultez Pagination pour en savoir plus. | Facultatif |
dtmCookieId | Cookies créés et stockés par le site Web, utilisés pour suivre le comportement de l’utilisateur sur le même domaine. | Facultatif |
Éléments renvoyés
| Chaîne | Description | Exemple de valeur |
|---|---|---|
customPayload | Cette charge utile personnalisée doit être transférée du fichier catalogue à la génération d'annonces. Le champ doit contenir un objet JSON valide sérialisé dans un tableau d'octets et encodé en Base64. L'objet JSON doit être conforme à un schéma. | Personnalisation par intégration |
sellerId | ID unique du vendeur. S'affichera uniquement si un sellerId est défini pour une équipe. Les sellerId sont généralement utilisés pour l'onboarding des vendeurs Marketplace. | 73nns-32sxr-32ss Personnalisation par intégration |
id | L'identifiant unique de l'annonce. Il est propre à chaque requête adressée à Epsilon Retail Media et ne peut pas être mis en cache. | display_yCaCIy_kKaJnRnzrenBkVSytwr8yNTgxMzM4 |
gtin | Le code produit de l'annonce. Il s'agit du code produit synchronisé dans votre catalogue de produits. | 25813383 |
discount | Obsolète, peut être ignoré. | { "amount": 0, "minPrice": 0, "maxPerCustomer": 0 } |
position | La position de l'annonce dans la réponse d'Epsilon Retail Media. Vous devez respecter cette position dans le cas où des campagnes de location fixe sont utilisées. | 1 |
memoryToken | Utilisé pour la pagination et le chaînage des requêtes d'annonces. S'il est fourni lors de votre prochaine requête d'annonce pour le même contexte, Epsilon Retail Media exclura les annonces précédemment diffusées dans la réponse publicitaire. Consultez Pagination pour en savoir plus. | |
metadata | Objet contenant les informations sur l'annonceur nécessaires pour aider les annonceurs à se conformer à la législation locale en matière de publicité, telle que le Règlement sur les services numériques de l'Union européenne.advertiser est issu du Nom de l'entreprise dans l'équipe de fournisseurs.onBehalfOf est issu du Financeur de l'annonce dans l'équipe de fournisseurs. | "metadata": { "advertiserInfo": { "advertiser": "Bob's advertising agency", "onBehalfOf": "Brand company inc" } ... |