> For the complete documentation index, see [llms.txt](https://help.citrusad.com/retail-media-interface/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.citrusad.com/retail-media-interface/integration/es/references/banner-ad-static-reference.md).
# Referencia de anuncios de banner (estáticos)
A continuación se describen las propiedades posibles en una solicitud estándar según se describe en [Solicitud de anuncios de banner](/retail-media-interface/integration/es/generating-ads/banner-ads-static/requesting-banner-ads.md) para su solicitud y la respuesta si recibe un anuncio.
{% hint style="info" %}
Los anuncios de banner se solicitan en el mismo `/generate` endpoint que los anuncios de producto. Se puede utilizar una sola solicitud para recuperar ambos tipos de anuncios.
{% endhint %}
## Elementos solicitados
| String | Descripción | Obligatorio/opcional |
| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| `bannerSlots` | Un array de espacios de banner para los que desea recibir anuncios de banner. Al especificar un maxNumberOfAds para los espacios de banner, puede recuperar más de un banner para el espacio. Un caso de uso para esto sería las ubicaciones de carrusel. | Obligatorio |
| `bannerSlotIds` | Un array de espacios de banner para los que desea recibir anuncios de banner | Obligatorio, sustituido 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 al que se le muestran anuncios. | Opcional |
| `filterMode` | Forma opcional de definir la estructura de su solicitud. Consulte [Filtrado de generación de anuncios](/retail-media-interface/integration/es/data-api/api-overview/ad-generation-filtering-1.md) para obtener más información. | Opcional, preferido |
| `maxNumberOfAds` | El número máximo de anuncios de producto que desea que se devuelvan, hasta 15. | Obligatorio, permite que se sirvan anuncios de producto en la misma solicitud. Si no se desean anuncios de producto, ajústelo a `0` |
| `options` | Forma opcional de definir la estructura de su solicitud. Consulte Filtrado de generación de anuncios para obtener más información.
Este es también el objeto donde puede solicitar información del anunciante para cumplir con la legislación publicitaria local como la de Europa Ley de Servicios Digitales .
| Opcional, preferido |
| `placement` | La ubicación única para la que está solicitando anuncios. | Obligatorio |
| `productFilters` | Cualquier filtro de producto relevante para su solicitud. Como una categoría, ubicación o tamaño. | Obligatorio |
| `sessionId` | El identificador único de la sesión del cliente. Se utiliza para la atribución en integraciones estándar. Revise las opciones de flujo de trabajo de integración para obtener más información. | Obligatorio en integraciones estándar |
| `dtmCookieId` | Cookies creadas y almacenadas por el sitio web, utilizadas para rastrear el comportamiento del usuario en el mismo dominio. | Opcional |
| `audience` | Especifica segmentos de audiencia específicos a los que pertenece el comprador. Solo es relevante si se utiliza [Opción 3 de segmentación de audiencia](/retail-media-interface/integration/es/data-api/audience-targeting-new/integration-option-3-sync-audiences-only.md) | Opcional |
## Elementos devueltos
| String | 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 momento en el que se puede informar de un clic a Epsilon Retail Media | `2021-06-01T23:48:16.573967987Z` |
| `banners.id` | El id único del anuncio.
Esto es único 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. | `[]\() |
| `banners.gtins` | Un array 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 banner. | ` |
| `banners.slotId` | El id del espacio específico para el banner que ha solicitado. | `Category_Top` |
| `banners.tags` | Este campo devuelve cualquier etiqueta de terceros introducida por el anunciante en su campaña. | `{
"dv": "<script src=\"" type=\"text/javascript\"></script>"
}` |
| `banners.text` | Utilizado en integraciones a medida 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 el caso de que se utilicen campañas de Ubicación fija. | 1 |
| `banners.sellerId` | El Id único del vendedor. Solo se completará si se establece un sellerId en un equipo. Los sellerIds se utilizan normalmente al incorporar vendedores de marketplace. | `73nns-32sxr-32ss` Personalizado por integración |
| `banners.metadata` | Objeto que contiene la información del anunciante necesaria para ayudar a los anunciantes a cumplir con la legislación publicitaria local, como la Ley de Servicios Digitales en Europa.
advertiser se obtiene a partir del nombre de la Empresa en el equipo del proveedor.
onBehalfOf se obtiene a partir del Financiador del anuncio en el equipo del proveedor.
| `"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 advierte si se supera el número máximo de segmentos. | `"metadata": {
"warnings": [
"Audience Segment IDs exceeded the limit of 100 and were truncated"
]
}` |
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://help.citrusad.com/retail-media-interface/integration/es/references/banner-ad-static-reference.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.