> 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/brand-pages/brand-page-retailer-integration-guide/overview-1.md). # Descripción general ## ¿Qué son las Brand Pages? Las Brand Pages son experiencias de páginas de destino personalizadas que residen en su sitio web y muestran contenido de marca específico. Se alojan en su dominio y se representan mediante los componentes de su interfaz de usuario. Las Brand Pages se gestionan por separado de las campañas publicitarias estándar en la Epsilon plataforma.\ Aunque utilizan un flujo de trabajo de creación y revisión similar, representan experiencias de páginas de destino de marca en el sitio de un minorista, no anuncios tradicionales. **Ejemplo:** Un usuario visita `yoursite.com/brands/nike` y ve una página de la marca Nike con productos Nike, pero tiene el mismo aspecto y sensación que el resto de su sitio web. ## Lo que construirá Como ingeniero del minorista, usted deberá: * Añadir una ruta para las URL de Brand Pages (por ejemplo, `/brands/{slug}`). {% hint style="info" %} Los minoristas no están obligados a aprovisionar una URL para cada Brand Page. La plataforma gestiona automáticamente las URL. Sin embargo, la URL base de la Brand Page (incluido el prefijo) debe configurarse durante la incorporación (por ejemplo, en la Guía de estilo del minorista). Si no se proporciona la URL completa o el prefijo, la URL de la Brand Page no se completará en la página de configuración. {% endhint %} * Llamar a la API de Brand Pages utilizando el slug extraído. * Representar los módulos de contenido devueltos. * Implementar el seguimiento de impresiones, clics y adición al carrito. * Configurar un proxy inverso para el seguimiento de primera parte. {% hint style="info" %} Este paso solo es necesario para el seguimiento en el lado del cliente. {% endhint %} ### Sus responsabilidades frente a Epsilon's | Usted gestiona | Epsilon Proporciona | | ------------------------------------------- | --------------------------------------- | | ✅ Integración de API para obtener contenido | ✅ Plantillas y contenido de Brand Pages | | ✅ Representación del contenido en su sitio | ✅ Infraestructura de seguimiento | | ✅ Configuración del proxy inverso | ✅ Analítica e informes | | ✅ Suministro de su guía de estilo | ✅ Herramientas de gestión de campañas | | ✅ Pruebas y validación | ✅ Soporte técnico | ## Cómo funcionan las Brand Pages ### Flujo de extremo a extremo {% hint style="info" %} El contenido de la Brand Page se configura y se previsualiza en la Epsilon interfaz de usuario. Los minoristas integran las Brand Pages exclusivamente a través de API y son responsables de representar la experiencia final en sus sitios. {% endhint %} Durante el proceso de revisión, los minoristas pueden previsualizar el contenido de la Brand Page configurado antes de su aprobación. ### Plantillas y módulos Durante la incorporación, Epsilon trabaja con su equipo para crear plantillas que definen: * Los módulos de contenido disponibles (como hero, cuadrícula de productos, texto e imágenes), con nombres de módulos configurables en la interfaz de usuario para alinearse con la taxonomía del minorista. * Las restricciones para cada módulo (límites de caracteres, dimensiones de imagen, etc.). * El estilo que se alinea con las directrices de su marca. Las marcas seleccionan una plantilla al crear su campaña y, a continuación, rellenan el contenido dentro de esas restricciones. {% hint style="info" %} La API de Brand Pages devuelve módulos de contenido y URL de seguimiento. Los minoristas son responsables de aplicar el estilo utilizando sus propios componentes de interfaz de usuario y sistema de diseño. {% endhint %} **Ejemplos** Los siguientes ejemplos ilustran cómo las marcas pueden rellenar módulos de contenido comunes al crear una Brand Page. Estos son solo ejemplos de entradas y se pueden ajustar en función de la plantilla seleccionada y los objetivos de la campaña. **Módulo HERO** * **Encabezado:** Descubra la última colección de verano * **Subencabezado:** Estilos frescos para cada ocasión * **CTA:** Comprar ahora **Módulo TEXT** Explore nuestras novedades diseñadas para ofrecer comodidad, estilo y rendimiento: perfectas para el día a día. **Módulo IMAGE** * Leyenda:\*\* Novedades ya disponibles * **Texto alternativo:** Modelo con la colección de verano * URL: **PRODUCT\_GRID module** Utilice una cuadrícula de productos para mostrar los productos más vendidos o de temporada e impulsar la interacción y las conversiones. #### Configuración del módulo: | Módulo | Descripción | Elementos configurables (resumen) | | -------------- | ----------------------------------------------------------- | --------------------------------------------------------------------- | | HERO | Banner de ancho completo con imagen, encabezado y CTA | Encabezado, subencabezado, CTA, imagen, superposición | | PRODUCT\_GRID | Cuadrícula o carrusel de productos | Productos, título de sección, descripción, CTA | | TEXT | Bloque de contenido de texto (encabezado, cuerpo del texto) | Campos de texto, CTA | | IMAGE | Imagen única con enlace opcional | Imagen, leyenda, texto alternativo, enlace opcional | | IMAGE\_GALLERY | Varias imágenes en diseño de cuadrícula | Imágenes, leyendas, texto alternativo, título de sección, descripción | | FILTER\_MENU | Pestañas de filtro horizontal para cuadrículas de productos | Etiquetas de filtro y ordenación | | SPLIT\_LAYOUT | Diseño multicolumna con módulos anidados | Estructura de diseño y módulos anidados | {% hint style="info" %} Cada elemento configurable se puede establecer como obligatorio, opcional (permitido) o deshabilitado, según los requisitos del módulo y del minorista. Algunos campos también pueden aplicar límites máximos de caracteres cuando se marcan como obligatorios o permitidos. {% endhint %} ### Etiquetas de módulo Las plantillas pueden incluir un campo opcional `tags` en cada módulo: una lista de etiquetas de texto cortas (por ejemplo, `["header"]`) que su integración puede utilizar para decisiones de diseño, analítica o para mapear módulos a sus propios componentes. #### Cómo funcionan las etiquetas en la respuesta de la API * Cuando un módulo tiene etiquetas, aparecen como un array `tags` en el elemento correspondiente en `contentData`. * Cuando un módulo no tiene etiquetas, la propiedad `tags` se omite por completo de la respuesta; no aparecerá como `"tags": []`. * Trate la ausencia del campo `tags` de la misma manera que "sin etiquetas": no devuelva un error si no está presente. * Las etiquetas también se admiten en módulos anidados dentro de `SPLIT_LAYOUT` , no solo en el módulo dividido raíz. {% hint style="info" %} Importante Las etiquetas son etiquetas opacas acordadas entre el minorista y su equipo de integración. No están relacionadas con las etiquetas de seguimiento de anuncios ni con ningún otro sistema; refiérase siempre a ellas como *"etiquetas de módulo"* o *"etiquetas de módulo de página de marca"* para evitar confusiones. {% endhint %} Ejemplo de módulo de respuesta con una etiqueta ```json { "id": "image-1", "contentType": "IMAGE", "order": 1, "tags": ["header"], "imageUrl": "https://example.com/images/banner.jpg" } ``` **Ejemplo de módulo de respuesta sin etiqueta (propiedad de etiquetas omitida):** ```json { "id": "image-2", "contentType": "IMAGE", "order": 2, "imageUrl": "https://example.com/images/promo.jpg" } ``` #### Lo que esto significa para la respuesta de la API La respuesta `POST /ads/v3/brand-pages` refleja estas mismas reglas: un tipo de módulo solo aparece en `contentData` cuando forma parte de la plantilla activa y la página de la marca ha configurado contenido para ese módulo. Es posible que falten campos dentro de un módulo en el JSON, `null`, o que estén vacíos cuando la plantilla los marca como opcionales o deshabilitados, o cuando la marca los deja sin configurar; esto es lo esperado y no indica una carga útil defectuosa. Implemente la representación con tipos opcionales y accesores seguros; por ejemplo, solo represente un bloque de CTA cuando `ctaText` y un destino de navegación estén presentes; oculte el elemento multimedia principal cuando `mediaUrl`esté ausente. `trackers`a nivel de página o en un nodo se pueden omitir cuando no hay una interacción rastreable. Componga URL solo cuando tenga tanto una clave de plantilla aplicable de `trackingTypes` como el correspondiente `trackers.`\`.params`, cuando lo proporcione la 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/integration/es/brand-pages/brand-page-retailer-integration-guide/overview-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.