A continuación se describen las propiedades posibles en una solicitud estándar y la respuesta si recibe un anuncio.
Artículos solicitados
| Cadena | Descripción | Obligatorio/opcional |
|---|---|---|
catalogId | El identificador de su catálogo de productos 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 que le gustaría que se devolvieran hasta 10. | Obligatorio |
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 |
memoryToken | Used for pagination. Use a token provided in a previous ad request to ensure Epsilon Retail Media only serves new ads to your customers. If provided, Epsilon Retail Media will exclude previously served ads in the ad response. Review Pagination to learn more. | Opcional |
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 |
|---|---|---|
ads.customPayload | Esta carga personalizada debe enrutarse desde el archivo de catálogo hasta la generación de anuncios. El campo debe contener un objeto JSON válido serializado en una matriz de bytes y codificado en Base64. El objeto JSON debe ajustarse a un esquema. | Personalizado por integración |
ads.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 |
ads.id | La ID única del anuncio. Es única para cada solicitud realizada a Epsilon Retail Media y no se puede almacenar en caché. | display_yCaCIy_kKaJnRnzrenBkVSytwr8yNTgxMzM4 |
ads.gtin | El código de producto del anuncio. Este será el código de producto sincronizado en su catálogo de productos. | 25813383 |
ads.discount | El valor anterior se puede ignorar. | { "amount": 0, "minPrice": 0, "maxPerCustomer": 0 } |
ads.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 |
ads.memoryToken | Se utiliza para la paginación y el encadenamiento de solicitudes de anuncios. If provided in your next ad request for the same context, Epsilon Retail Media will exclude previously served ads in the ad response. Review Pagination to learn more. | |
ads.metadata | Object containing the advertiser info required to help advertisers comply with local advertising legislation such as the Digital Services Actin Europe.
| "metadata": { "advertiserInfo": { "advertiser": "Bob's advertising agency", "onBehalfOf": "Brand company inc" } ... |
banners | Comprises of banner objects. View the Banner ad (static) reference to learn more. | "banners": [], |
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" ] |