> 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/partner/pt-br/campaign-management-api/bannerxcampaign-1.md). # Campanha de Banner X Banner X oferece anúncios de banner responsivos e multicomponentes que aprimoram a experiência de compra online ao se integrarem perfeitamente aos sites dos varejistas. Epsilon Retail Media fornece os componentes, enquanto o frontend do varejista gerencia a estilização para garantir consistência com o design de e-commerce do site. Essa abordagem ajuda a manter a integridade da marca e, ao mesmo tempo, engaja os clientes de forma eficaz.
## Principais benefícios * **Integração nativa**: Os anúncios se encaixam naturalmente nos carrosséis de produtos, mantendo o estilo do site. * **Personalização**: Entregue anúncios personalizados em tempo real, adaptados aos interesses do usuário. * **Maior engajamento**: Melhore a visibilidade dos produtos, impulsione o engajamento dos clientes e aumente as vendas com CTAs atrativas. ## Banner X componentes Entenda os componentes do banner X para garantir que seu design esteja em conformidade com os padrões do varejista. Cada componente é essencial para manter a consistência visual e a funcionalidade. ### Imagem de fundo principal O fundo principal é um pano de fundo simples que garante a clareza e a consistência do design em todos os dispositivos. Evite incorporar imagens de produtos ou conteúdos muito chamativos para prevenir problemas de corte, especialmente em diferentes dispositivos e larguras de navegador. As seis configurações de fundo principal disponíveis são: * Repetido * Preenchimento * Alinhado no topo * Alinhado na parte inferior * Alinhado à direita * Alinhado à esquerda
### Imagem de fundo secundária Use a imagem de fundo secundária para adicionar decoração ao seu banner. As seis configurações de banner secundário disponíveis são: * Repetido * Preenchimento * Alinhado no topo * Alinhado na parte inferior * Alinhado à direita * Alinhado à esquerda ### Texto do banner Texto do banner é o texto exibido no seu anúncio de banner, com suporte a tags HTML limitadas como `strong` para negrito e `i` para itálico. Você também pode personalizar a cor do texto. Por exemplo,
### Imagem principal (Hero) A imagem principal (Hero) é a imagem promocional principal, normalmente usada para exibir seu produto ou logotipo. As duas configurações disponíveis para a imagem principal são: * Paisagem * Retrato
### Imagem principal (Hero) secundária Use a imagem principal secundária para exibir seu produto ou logotipo. As duas configurações disponíveis são: * Paisagem * Bloco (uma imagem com a mesma largura e altura)
### Chamada para ação (CTA) Uma chamada para ação (CTA) é um texto ou botão clicável que incentiva os usuários a agir, como fazer uma compra ou visitar outra página. As CTAs devem ser claras, orientadas para a ação e visualmente destacadas para aumentar o engajamento. Por exemplo, "Compre agora" incentiva as compras.
## Tipos de posicionamento de anúncios Banner X suporta vários posicionamentos estratégicos [de anúncios](https://developers.citrusad.com/integration/docs/introduction-to-placement-types) em sites de varejo, incluindo: * **Busca**: Exiba anúncios quando os clientes inserirem termos de busca configurados, como chocolate, em sua campanha. Para obter mais informações, consulte [Posicionamentos de busca](https://developers.citrusad.com/integration/docs/introduction-to-placement-types#search). * **Categoria**: Exiba anúncios em páginas de categoria relacionadas ao seu produto. Direcione a categorias específicas fornecendo detalhes de taxonomia relevantes, como `Category:Cupboard/Snacks`. Para obter mais informações, consulte [Posicionamentos de categoria](https://developers.citrusad.com/integration/docs/introduction-to-placement-types#category). * **Categoria e busca**: Exiba anúncios quando os clientes visitarem uma página de categoria relacionada aos seus produtos ou usarem termos de busca configurados em sua campanha. * **Venda cruzada de categoria**: Os posicionamentos de venda cruzada de categoria permitem que os anunciantes direcionem a categorias complementares, além das categorias padrão de seus produtos. Essa abordagem aumenta a visibilidade dos produtos em categorias relacionadas, como exibir produtos de café na seção de laticínios do site de um varejista. Para obter mais informações, consulte [posicionamentos de venda cruzada](https://help.citrusad.com/retail-media-interface/integration/pt-br/feature-integrations/category-cross-sell/difference-between-category-and-category-cross-sell-placements). * **Correspondência ampla**: Mostre anúncios em páginas de alto tráfego não vinculadas a categorias ou termos de busca específicos. Ideal para locais gerais, como páginas iniciais ou páginas de checkout. Para obter mais informações, consulte [Posicionamentos de correspondência ampla](https://help.citrusad.com/retail-media-interface/integration/pt-br/generating-ads/banner-x-responsive/requesting-banner-x-ads#broad-match-placements). ## Formatos de espaço de anúncio suportados Banner X podem ser implantados nos seguintes formatos: * Bloco único * Bloco duplo * Banner completo
## Implementar anúncios de banner X Para configurar anúncios de banner X, siga estas etapas: ### Etapa 1: Revisar os padrões de conteúdo do varejista Os padrões de conteúdo são diretrizes e parâmetros técnicos que ditam como um Banner X anúncio deve ser exibido dentro de um espaço designado em um site ou plataforma digital. Esses padrões podem incluir: * **Dimensões e tamanho**: Especificações sobre a largura e altura exatas do banner. * **Formato de arquivo**: Formatos de arquivo de imagem ou vídeo aceitos, como JPEG, JPG, PNG, SVG ou GIF. * **Limite de tamanho de arquivo**: Tamanho máximo de arquivo permitido para garantir tempos de carregamento rápidos e desempenho ideal na página da web. * **Resolução e qualidade**: Requisitos mínimos de resolução para garantir que o banner pareça nítido e profissional. * **Posicionamento e alinhamento**: Diretrizes sobre como o banner deve ser alinhado dentro do espaço disponível. * **Restrições de conteúdo**: Regras sobre qual conteúdo pode ou não ser incluído no banner (ex.: proibição de conteúdo ofensivo, inclusão de avisos legais obrigatórios). * **Interatividade**: Especificações para elementos interativos, como áreas clicáveis, animações ou eventos acionados pelo usuário, se aplicável. Familiarize-se com as diretrizes de padrões de conteúdo do varejista para iniciar sua campanha. Essas diretrizes incluem URLs de exemplo, posicionamento na página e restrições específicas de conteúdo de arte. Consulte seu Engenheiro de Integração do Cliente (CIE) para obter informações detalhadas sobre os espaços de banner X disponíveis e suas especificações. Aqui está um exemplo:
### Etapa 2: Preparar os ativos criativos Desenvolva seus ativos criativos de acordo com os padrões de conteúdo do varejista. Isso inclui elementos como o fundo principal, fundo secundário, imagem principal (Hero) e imagem principal secundária. Use a [Obter detalhes do padrão de conteúdo do Banner X](/retail-media-interface/partner/pt-br/campaign-management-api/bannerxcontentstandard/getbannerxcontentstandard-1.md) API para recuperar os detalhes do padrão de conteúdo. ### Etapa 3: Identificar o formato do espaço de anúncio Determine o formato do espaço de anúncio para sua implantação, que pode ser um banner completo, bloco único ou bloco duplo. ### Etapa 4: Fazer upload dos ativos criativos Depois de criar seus ativos criativos e identificar o formato do espaço de anúncio, faça o upload deles usando a opção [Fazer upload do ativo criativo](/retail-media-interface/partner/pt-br/team-user-api/user-1/uploadfile-1.md) API. A API retorna o ID do arquivo e a URL da imagem enviada. * **IDs dos arquivos**: Os IDs dos arquivos são obrigatórios ao criar uma campanha de banner X. Você deve fornecer um ID de arquivo específico para cada tipo de recurso, como o plano de fundo principal, o plano de fundo secundário, a imagem principal e a imagem principal secundária. * **URL**: A URL é usada principalmente para visualizar a imagem enviada. ### (Opcional) Etapa 5: Recuperar a URL pública da imagem Use a [API de recuperação da URL do arquivo](/retail-media-interface/partner/pt-br/campaign-management-api/creativeassets/getcampaignfileurl.md) para obter a URL pública da imagem. Você pode usar essa URL para verificar ou compartilhar a imagem com as partes interessadas. ### Etapa 6: Criar uma campanha de banner X Crie uma campanha de banner X usando a [Criar uma campanha de banner X](/retail-media-interface/partner/pt-br/campaign-management-api/bannerxcampaign-1/createbannerxcampaign-1.md) API. Certifique-se de ter o `backgroundImageId`, `secondaryBackgroundImageId`, `heroImageId`, e `secondaryHeroImageId`que são os IDs de arquivos retornados pela [Fazer upload do ativo criativo](/retail-media-interface/partner/pt-br/team-user-api/user-1/uploadfile-1.md) API. --- # 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/partner/pt-br/campaign-management-api/bannerxcampaign-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.