The below outlines the properties possible in a standard request as outlined in Requesting banner ads for your request, and the response if you receive an ad.
Les requêtes des bannières publicitaires sont effectuées sur le même point de terminaison
/generateque les annonces de produits. Une seule requête peut être utilisée pour récupérer les deux types d'annonces.
Éléments liés à la requête
| Chaîne | Description | Obligatoire/facultatif |
|---|---|---|
bannerSlots | Un ensemble d'espaces de bannière pour lesquels vous souhaitez recevoir des bannières publicitaires. En précisant un MaxNumberOfAds pour les espaces de bannière, vous pouvez récupérer plusieurs bannières pour chaque espace. Ce cas concerne notamment les carrousels (diaporamas). | Obligatoire |
bannerSlotIds | Un ensemble d'espaces de bannière pour lesquels vous souhaitez recevoir des bannières publicitaires | Obligatoire, supplanté par bannerSlots |
catalogId | L'identifiant de votre catalogue de produits pour votre site Web. | Obligatoire |
contentStandardId | L'identifiant standard du contenu de votre site Web. | Obligatoire |
customerId | L'identifiant unique du client recevant les annonces. | Facultatif |
filterMode | Optional way of defining the structure of your request. See Ad generation filtering for more information. | Facultatif, préféré |
maxNumberOfAds | Le nombre maximum d'annonces de produits que vous souhaitez renvoyer, dans la limite de 15. | Obligatoire, permet de diffuser des annonces de produits dans la même requête. Si vous ne souhaitez pas diffuser d'annonce de produit, définissez le paramètre sur 0 |
options | Optional way of defining the structure of your request. See Ad generation filtering for more information. This is also the object where you can request advertiser information in order to comply with local advertising legislation like Europe’s Digital Services Act . | 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 | The unique identifier of the customer's session. Used for attribution in standard integrations. Review Integration workflow options for more information. | Obligatoire dans le cas d'intégrations standard |
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 |
audience | Specifies specific audience segments that the shopper belongs to. Only relevant is using Audience Targeting Option 3 | Facultatif |
Éléments renvoyés
| Chaîne | Description | Exemple de valeur |
|---|---|---|
banners.altText | Le texte alternatif pour l'image Hero dans les rares cas où elle ne s'afficherait pas. | Advertisement for <BRAND>. Art of the Burger. Create your delicious masterpiece. Shop Now. |
banners.contentStandardId | L'identifiant standard du contenu de votre site Web. | `4ffb80ba-b9a9-4567-8069-79b2eca93473 |
banners.expiry | Le délai d'expiration de l'annonce. C'est le dernier moment où un clic peut être signalé à Epsilon Retail Media | 2021-06-01T23:48:16.573967987Z |
banners.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. | banner_j2vfi9pN2BiQZk4X9sC55PgNu5k3ODIzOTlfMDAwODc2ODQwMDEwNzM= |
banners.imageUrl | Le lien de l'image de la bannière. | [<https://cdn.[server].io/s/9b93e7f9-d747-4c8b-bcba-2357b280a3b3>](https://cdn.[server].io/s/9b93e7f9-d747-4c8b-bcba-2357b280a3b3`) |
banners.gtins | Un tableau contenant un maximum de 20 codes produit sélectionnés parmi les produits présentés dans une campagne. | [ "7714107", "7163379", "7733636", "7733657", "7733628" ], |
banners.linkUrl | L'URL transférée depuis la bannière lorsque le client clique sur cette dernière. | <https://www.retailer.com/groceries/en-GB/search?query=double-fudge> |
banners.slotId | L'ID de l'espace spécifique de la bannière associé à votre requête. | Category_Top |
banners.tags | Ce champ renvoie toutes les balises tierces saisies par l'annonceur dans sa campagne. | { "dv": "<script src=\"<https://cdn.doubleverify.com/dvtp_src.js?ctx=111111&cmp=11111111&sid=111111&plc=111111&adsrv=111&btreg=&btadsrv=&crt=&tagtype=&dvtagver=6.1.src>" type=\"text/javascript\"></script>" } |
banners.text | Utilisé dans le cadre d'intégrations sur mesure, comme un champ de texte supplémentaire. | |
banners.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 |
banners.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 |
banners.metadata | Object containing the advertiser info required to help advertisers comply with local advertising legislation such as the Digital Services Act in Europe.
| "metadata": { "advertiserInfo": { "advertiser": "Bob's advertising agency", "onBehalfOf": "Brand company inc" } ... |
metadata.warnings | Objet contenant des informations d'avertissement relatives à la demande d'annonce. Actuellement, avertit uniquement si le nombre maximal de segments est dépassé. | "metadata": { "warnings": [ "Audience Segment IDs exceeded the limit of 100 and were truncated" ] } |