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.
Los anuncios de banner se solicitan en el mismo endpoint
/generateque los anuncios de producto. Se puede usar una única solicitud para recuperar ambos tipos de anuncios.
Artículos solicitados
| Cadena | Descripción | Obligatorio/opcional |
|---|---|---|
bannerSlots | Una matriz de posiciones de banner para las que desea recibir anuncios publicitarios. Al especificar un MaxNumberOfAds para las posiciones de banner, puede recuperar más de un banner para la posición. Tal caso de uso sería para ubicaciones de carrusel. | Obligatorio |
bannerSlotIds | Una matriz de posiciones de banner para las que desea recibir anuncios publicitarios | Obligatorio, reemplazado por bannerSlots |
catalogId | El identificador de su catálogo de productos para su sitio web. | Obligatorio |
contentStandardId | El identificador estándar de contenido para su sitio web. | Obligatorio |
customerId | El identificador único para el cliente que recibe anuncios. | Opcional |
filterMode | Optional way of defining the structure of your request. See Ad generation filtering for more information. | Opcional, preferente |
maxNumberOfAds | El número máximo de anuncios de producto que le gustaría que se devolvieran hasta 15. | Obligatorio, permite que los anuncios de productos se muestren en la misma solicitud. Si no se desean anuncios de productos, fijar en 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 . | Opcional, preferente |
placement | La ubicación única para la que solicita anuncios. | Obligatorio |
productFilters | Cualquier filtro de producto relevante para su solicitud, como categoría, ubicación o tamaño. | Obligatorio |
sessionId | The unique identifier of the customer's session. Used for attribution in standard integrations. Review Integration workflow options for more information. | Obligatorio en integraciones estándar |
dtmCookieId | Cookies creadas y almacenadas por el sitio web, utilizadas para rastrear el comportamiento de los usuarios en el mismo dominio. | Opcional |
audience | Specifies specific audience segments that the shopper belongs to. Only relevant is using Audience Targeting Option 3 | Opcional |
Artículos devueltos
| Cadena | Descripción | Valor de ejemplo |
|---|---|---|
banners.altText | Texto alternativo para la imagen principal en el raro caso de que no se muestre. | Advertisement for <BRAND>. Art of the Burger. Create your delicious masterpiece. Shop Now. |
banners.contentStandardId | El identificador estándar de contenido para su sitio web. | `4ffb80ba-b9a9-4567-8069-79b2eca93473 |
banners.expiry | El vencimiento del anuncio. Este es el último punto en el que se puede informar de un clic a Epsilon Retail Media. | 2021-06-01T23:48:16.573967987Z |
banners.id | La ID única del anuncio. Es única para cada solicitud realizada a Epsilon Retail Media y no se puede almacenar en caché. | banner_j2vfi9pN2BiQZk4X9sC55PgNu5k3ODIzOTlfMDAwODc2ODQwMDEwNzM= |
banners.imageUrl | El enlace de la imagen del banner. | [<https://cdn.[server].io/s/9b93e7f9-d747-4c8b-bcba-2357b280a3b3>](https://cdn.[server].io/s/9b93e7f9-d747-4c8b-bcba-2357b280a3b3`) |
banners.gtins | Una serie de hasta 20 códigos de producto seleccionados de los productos anunciados de la campaña. | [ "7714107", "7163379", "7733636", "7733657", "7733628" ], |
banners.linkUrl | La URL reenviada desde el banner cuando el cliente hace clic en el mismo. | <https://www.retailer.com/groceries/en-GB/search?query=double-fudge> |
banners.slotId | La ID de la posición específica para el banner que ha solicitado. | Category_Top |
banners.tags | Este campo devuelve las etiquetas de terceros introducidas por el anunciante en su campaña. | { "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 | Se usa en integraciones personalizadas como un campo de texto adicional. | |
banners.position | La posición del anuncio en la respuesta de Epsilon Retail Media. Debe respetar esta posición en caso de que se utilicen campañas de posición fija. | 1 |
banners.sellerId | El identificador único del vendedor. Solo se completará si se establece un sellerId en un equipo. Los SellerIds suelen usarse al incorporar vendedores del mercado. | 73nns-32sxr-32ss Personalizado por integración |
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 | Objeto que contiene información de advertencia sobre la solicitud de anuncio. Actualmente solo avisa si se supera el número máximo de segmentos. | "metadata": { "warnings": [ "Audience Segment IDs exceeded the limit of 100 and were truncated" ] } |