> 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/es/campaign-management-api/bannerxcampaign-1.md).
# Campaña de banner X
Banner X ofrece anuncios de banner adaptables y multicomponente que mejoran la experiencia de compra en línea al integrarse perfectamente en los sitios web de los minoristas. Epsilon Retail Media proporciona los componentes, mientras que el frontend del minorista gestiona el estilo para garantizar la coherencia con el diseño de comercio electrónico del sitio. Este enfoque ayuda a mantener la integridad de la marca al tiempo que capta la atención de los clientes de manera eficaz.
## Beneficios clave
* **Integración nativa**: Los anuncios se adaptan de forma natural dentro de los carruseles de productos, manteniendo el estilo del sitio.
* **Personalización**: Entregue anuncios personalizados en tiempo real, adaptados a los intereses del usuario.
* **Mayor interacción**: Mejore la visibilidad del producto, impulse la interacción con el cliente y aumente las ventas con llamadas a la acción (CTA) atractivas.
## Banner X componentes
Comprenda los componentes del banner X para asegurarse de que su diseño cumpla con las normas del minorista. Cada componente es esencial para mantener la coherencia visual y la funcionalidad.
### Imagen de fondo primaria
El fondo primario es un telón de fondo simple que garantiza la claridad del diseño y la coherencia entre dispositivos. Evite incluir imágenes de productos o contenido excesivo para evitar problemas de recorte, especialmente en diferentes dispositivos y anchos de navegador. Las seis configuraciones de fondo primario disponibles son:
* Mosaico
* Relleno
* Alineado arriba
* Alineado abajo
* Alineado a la derecha
* Alineado a la izquierda
### Imagen de fondo secundaria
Utilice la imagen de fondo secundaria para añadir decoración a su banner. Las seis configuraciones de banner secundario disponibles son:
* Mosaico
* Relleno
* Alineado arriba
* Alineado abajo
* Alineado a la derecha
* Alineado a la izquierda
### Texto del banner
El texto del banner es el texto que se muestra en su anuncio de banner, compatible con etiquetas HTML limitadas como `strong` para negrita y `i` para cursiva. También puede personalizar el color del texto. Por ejemplo,
### Imagen principal
La imagen principal es la imagen promocional clave, utilizada normalmente para mostrar su producto o logotipo. Las dos configuraciones disponibles para la imagen principal son:
* Horizontal
* Vertical
### Imagen principal secundaria
Utilice la imagen principal secundaria para mostrar su producto o logotipo. Las dos configuraciones disponibles son:
* Horizontal
* Bloque (una imagen con el mismo ancho y alto)
### Llamada a la acción
Una llamada a la acción (CTA) es un texto o botón interactivo que incita a los usuarios a actuar, como realizar una compra o visitar otra página. Las CTA deben ser claras, orientadas a la acción y visualmente destacadas para aumentar la interacción. Por ejemplo, "Comprar ahora" fomenta las compras.
## Tipos de ubicación de anuncios
Banner X admite varias ubicaciones estratégicas [ubicaciones de anuncios](https://developers.citrusad.com/integration/docs/introduction-to-placement-types) en sitios web minoristas, que incluyen:
* **Búsqueda**: Muestre anuncios cuando los clientes introduzcan términos de búsqueda configurados, como chocolate, en su campaña. Para obtener más información, consulte [Ubicaciones de búsqueda](https://developers.citrusad.com/integration/docs/introduction-to-placement-types#search).
* **Categoría**: Muestre anuncios en páginas de categoría relacionadas con su producto. Diríjase a categorías específicas proporcionando detalles de taxonomía relevantes, como `Category:Cupboard/Snacks`. Para obtener más información, consulte [Ubicaciones de categoría](https://developers.citrusad.com/integration/docs/introduction-to-placement-types#category).
* **Categoría y búsqueda**: Muestre anuncios cuando los clientes visiten una página de categoría relacionada con sus productos o utilicen términos de búsqueda configurados en su campaña.
* **Venta cruzada por categoría**: Las ubicaciones de venta cruzada por categoría permiten a los anunciantes dirigirse a categorías complementarias además de las categorías predeterminadas de sus productos. Este enfoque mejora la visibilidad de los productos en categorías relacionadas, como mostrar productos de café en la sección de lácteos del sitio de un minorista. Para obtener más información, consulte [ubicaciones de venta cruzada](https://help.citrusad.com/retail-media-interface/integration/es/feature-integrations/category-cross-sell/difference-between-category-and-category-cross-sell-placements).
* **Coincidencia amplia**: Muestre anuncios en páginas de alto tráfico no vinculadas a categorías o términos de búsqueda específicos. Ideal para ubicaciones generales como páginas de inicio o páginas de pago. Para obtener más información, consulte [Ubicaciones de concordancia amplia](https://help.citrusad.com/retail-media-interface/integration/es/generating-ads/banner-x-responsive/requesting-banner-x-ads#broad-match-placements).
## Formatos de espacio publicitario admitidos
Banner X se puede desplegar en los siguientes formatos:
* Ficha única
* Ficha doble
* Banner completo
## Implementar anuncios de banner X
Para configurar anuncios de banner X, siga estos pasos:
### Paso 1: Revisar las normas de contenido del minorista
Las normas de contenido son directrices y parámetros técnicos que determinan cómo se debe mostrar un anuncio de Banner X dentro de un espacio designado en un sitio web o plataforma digital. Estas normas pueden incluir:
* **Dimensiones y tamaño**: Especificaciones sobre el ancho y el alto exactos del banner.
* **Formato de archivo**: Formatos de archivo de imagen o vídeo aceptados, como JPEG, JPG, PNG, SVG o GIF.
* **Límite de tamaño de archivo**: Tamaño máximo de archivo permitido para garantizar tiempos de carga rápidos y un rendimiento óptimo en la página web.
* **Resolución y calidad**: Requisitos mínimos de resolución para garantizar que el banner se vea nítido y profesional.
* **Posicionamiento y alineación**: Directrices sobre cómo se debe alinear el banner dentro del espacio disponible.
* **Restricciones de contenido**: Reglas sobre qué contenido se puede o no incluir dentro del banner (p. ej., sin contenido ofensivo, inclusión de avisos legales obligatorios).
* **Interactividad**: Especificaciones para elementos interactivos, como áreas con clic, animaciones o eventos activados por el usuario, si corresponde.
Familiarícese con las directrices de normas de contenido del minorista para comenzar su campaña. Estas directrices incluyen URL de ejemplo, posicionamiento en la página y restricciones específicas sobre el contenido del arte final. Consulte con su Customer Integration Engineer (CIE) para obtener información detallada sobre los espacios de banner X disponibles y sus especificaciones. Aquí tiene un ejemplo:
### Paso 2: Preparar los recursos creativos
Desarrolle sus recursos creativos de acuerdo con las normas de contenido del minorista. Esto incluye elementos como el fondo primario, el fondo secundario, la imagen principal y la imagen principal secundaria. Utilice la API [Obtener detalles del estándar de contenido de Banner X](/retail-media-interface/partner/es/campaign-management-api/bannerxcontentstandard/getbannerxcontentstandard-1.md) para recuperar los detalles de la norma de contenido.
### Paso 3: Identificar el formato del espacio publicitario
Determine el formato del espacio publicitario para su despliegue, que podría ser un banner completo, una ficha única o una ficha doble.
### Paso 4: Cargar los recursos creativos
Después de crear sus recursos creativos e identificar el formato del espacio publicitario, cárguelos utilizando la API [Cargar el recurso de la Creatividad](/retail-media-interface/partner/es/team-user-api/user-1/uploadfile-1.md) . La API devuelve el ID de archivo y la URL de la imagen cargada.
* **ID de archivo**: Los ID de archivo son necesarios al crear una campaña de banner X. Debe proporcionar un ID de archivo específico para cada tipo de recurso, como el fondo primario, el fondo secundario, la imagen principal y la imagen principal secundaria.
* **URL**: La URL se utiliza principalmente para previsualizar la imagen cargada.
### (Opcional) Paso 5: Recuperar la URL pública de la imagen
Utilice el [API para recuperar la URL del archivo](/retail-media-interface/partner/es/campaign-management-api/creativeassets/getcampaignfileurl.md) para obtener la URL pública de la imagen. Puede utilizar esta URL para verificar o compartir la imagen con las partes interesadas.
### Paso 6: Crear una campaña de banner X
Cree una campaña de banner X utilizando la API [Crear una campaña de Banner X](/retail-media-interface/partner/es/campaign-management-api/bannerxcampaign-1/createbannerxcampaign-1.md) . Asegúrese de tener el `backgroundImageId`, `secondaryBackgroundImageId`, `heroImageId`, y `secondaryHeroImageId`que son los ID de archivo devueltos por la [Cargar el recurso de la Creatividad](/retail-media-interface/partner/es/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/es/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.