> 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/pt-br/references/banner-ad-static-reference.md). # Referência de anúncio de banner (estático) Abaixo descrevem-se as propriedades possíveis em uma solicitação padrão, conforme descrito em [Solicitação de anúncios em banner](/retail-media-interface/integration/pt-br/generating-ads/banner-ads-static/requesting-banner-ads.md) para sua solicitação, e a resposta se você receber um anúncio. {% hint style="info" %} Anúncios em banner são solicitados no mesmo `/generate` endpoint que anúncios de produtos. Uma única solicitação pode ser usada para recuperar ambos os tipos de anúncio. {% endhint %} ## Itens solicitados | String | Descrição | Obrigatório/opcional | | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------- | | `bannerSlots` | Uma matriz de espaços de banner para os quais você deseja receber anúncios em banner. Ao especificar um maxNumberOfAds para os espaços de banner, você pode recuperar mais de um banner para o espaço. Esse caso de uso seria para posicionamentos em carrossel. | Obrigatório | | `bannerSlotIds` | Uma matriz de espaços de banner para os quais você deseja receber anúncios em banner | Obrigatório, substituído por bannerSlots | | `catalogId` | Seu identificador de catálogo de produtos para seu site. | Obrigatório | | `contentStandardId` | O identificador de padrão de conteúdo para seu site. | Obrigatório | | `customerId` | O identificador exclusivo do cliente para o qual os anúncios estão sendo exibidos. | Opcional | | `filterMode` | Forma opcional de definir a estrutura de sua solicitação. Veja [Filtragem de geração de anúncios](/retail-media-interface/integration/pt-br/data-api/api-overview/ad-generation-filtering-1.md) para mais informações. | Opcional, preferencial | | `maxNumberOfAds` | O número máximo de anúncios de produtos que você gostaria que fossem retornados, até 15. | Obrigatório, permite que anúncios de produtos sejam exibidos na mesma solicitação. Se nenhum anúncio de produto for desejado, defina para `0` | | `options` |

Forma opcional de definir a estrutura de sua solicitação. Veja Filtragem de geração de anúncios para mais informações.

Este também é o objeto em que você pode solicitar informações do anunciante para cumprir a legislação local de publicidade, como a da Europa Lei de Serviços Digitais .

| Opcional, preferencial | | `placement` | O posicionamento exclusivo para o qual você está solicitando anúncios. | Obrigatório | | `productFilters` | Quaisquer filtros de produtos relevantes para sua solicitação. Como categoria, localização ou tamanho. | Obrigatório | | `sessionId` | O identificador exclusivo da sessão do cliente. Usado para atribuição em integrações padrão. Analise as opções de fluxo de trabalho de integração para obter mais informações. | Obrigatório em integrações padrão | | `dtmCookieId` | Cookies criados e armazenados pelo site, usados para rastrear o comportamento do usuário no mesmo domínio. | Opcional | | `audience` | Especifica segmentos de público específicos aos quais o comprador pertence. Relevante apenas se estiver usando [Opção de direcionamento de público 3](/retail-media-interface/integration/pt-br/data-api/audience-targeting-new/integration-option-3-sync-audiences-only.md) | Opcional | ## Itens retornados | String | Descrição | Valor de exemplo | | --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `banners.altText` | Texto alternativo para a imagem principal no raro evento de ela não ser exibida. | `Advertisement for <BRAND>. Art of the Burger. Create your delicious masterpiece. Shop Now.` | | `banners.contentStandardId` | O identificador de padrão de conteúdo para seu site. | \`4ffb80ba-b9a9-4567-8069-79b2eca93473 | | `banners.expiry` | A expiração do anúncio. Este é o último momento em que um clique pode ser informado para Epsilon Retail Media | `2021-06-01T23:48:16.573967987Z` | | `banners.id` |

O ID exclusivo do anúncio.
Isso é exclusivo para cada solicitação feita para Epsilon Retail Media e não pode ser armazenado em cache.

| `banner_j2vfi9pN2BiQZk4X9sC55PgNu5k3ODIzOTlfMDAwODc2ODQwMDEwNzM=` | | `banners.imageUrl` | O link da imagem do banner. | `[]\() | | `banners.gtins` | Uma matriz de até 20 códigos de produtos selecionados dos produtos anunciados da campanha. | `[
"7714107",
"7163379",
"7733636",
"7733657",
"7733628"
],` | | `banners.linkUrl` | A URL encaminhada a partir do banner quando o cliente clica no banner. | ` | | `banners.slotId` | O ID do espaço específico para o banner que você solicitou. | `Category_Top` | | `banners.tags` | Este campo retorna quaisquer tags de terceiros inseridas pelo anunciante em sua campanha. | `{
"dv": "<script src=\"" type=\"text/javascript\"></script>"
}` | | `banners.text` | Usado em integrações personalizadas como um campo de texto adicional. | | | `banners.position` | A posição do anúncio na Epsilon Retail Media resposta. Você deve respeitar esta posição no caso de campanhas de posicionamento fixo serem utilizadas. | 1 | | `banners.sellerId` | O ID exclusivo do vendedor. Só será preenchido se um sellerId estiver configurado em uma equipe. Os sellerIds são normalmente usados no processo de integração de vendedores de marketplace. | `73nns-32sxr-32ss` Personalizado por integração | | `banners.metadata` |

Objeto contendo as informações do anunciante necessárias para ajudar os anunciantes a cumprirem a legislação local de publicidade, como a Lei de Serviços Digitais na Europa.

advertiser é transportado do Nome da empresa na equipe do fornecedor.

onBehalfOf é transportado do Financiador do anúncio na equipe do fornecedor.

| `"metadata": {
"advertiserInfo": {
"advertiser": "Bob's advertising agency",
"onBehalfOf": "Brand company inc"
}
...` | | `metadata.warnings` | Objeto contendo informações de aviso sobre a solicitação de anúncio. Atualmente, só avisa se o número máximo de segmentos for excedido. | `"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/pt-br/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.