> 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/product-ad-reference-1.md). # Referencia de anuncios de producto A continuación se describen las propiedades posibles en una solicitud estándar y la respuesta si recibe un anuncio. ## Artículos solicitados | String | Descripción | Obligatorio/opcional | | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------- | | `catalogId` | El identificador de su catálogo de productos para su sitio web. | Obligatorio | | `customerId` | El identificador único del cliente al que se le muestran los anuncios. | Opcional | | `filterMode` | Forma opcional de definir la estructura de su solicitud. Consulte Filtrado de generación de anuncios para obtener más información. | Opcional, preferido | | `maxNumberOfAds` | El número máximo de anuncios que desea que se devuelvan, hasta 10. | Obligatorio | | `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 en el que 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 Opciones de flujo de trabajo de integración para obtener más información. | Obligatorio en integraciones estándar | | `memoryToken` |

Utilizado para la paginación. Utilice un token proporcionado en una solicitud de anuncio anterior para garantizar que Epsilon Retail Media solo muestre anuncios nuevos a sus clientes.

Si se proporciona, Epsilon Retail Media excluirá los anuncios mostrados anteriormente en la respuesta del anuncio. Revise Paginación para obtener más información.

| Opcional | | `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 | ## Artículos devueltos | String | Descripción | Valor de ejemplo | | ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | | `ads.customPayload` |

Esta carga útil personalizada que debe conectarse desde el archivo del catálogo a 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 adherirse a un esquema.

| Personalizado por integración | | `ads.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 del marketplace. | `73nns-32sxr-32ss` Personalizado por integración | | `ads.id` |

El id único del anuncio.
Esto es único 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` | Heredado, se puede ignorar. | `{
"amount": 0,
"minPrice": 0,
"maxPerCustomer": 0
}` | | `ads.position` | La posición del anuncio en la Epsilon Retail Media respuesta. Debe respetar esta posición en caso de que se utilicen campañas de Ubicación fija. | 1 | | `ads.memoryToken` |

Utilizado para la paginación y la vinculación de solicitudes de anuncios.

Si se proporciona en su próxima solicitud de anuncio para el mismo contexto, Epsilon Retail Media excluirá los anuncios mostrados anteriormente en la respuesta del anuncio. Revise Paginación para obtener más información.

| | | `ads.metadata` |

Objeto que contiene la información del anunciante requerida para ayudar a los anunciantes a cumplir con la legislación publicitaria local como la Ley de Servicios Digitalesen Europa.

advertiser se toma del Nombre de la empresa en el equipo del proveedor.

onBehalfOf se toma del Financiador del anuncio en el equipo del proveedor.

| `"metadata": {
"advertiserInfo": {
"advertiser": "Bob's advertising agency",
"onBehalfOf": "Brand company inc"
}
...` | | `banners` | Se compone de objetos de banner. Ver el [Referencia de anuncio de banner (estático)](/retail-media-interface/integration/es/references/banner-ad-static-reference.md) para obtener más información. | `"banners": [],` | | `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/product-ad-reference-1.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.