> 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/validation-troubleshooting.md).
# Validación y solución de problemas
## Pruebas y validación
### Lista de verificación de validación previa al lanzamiento
**Integración técnica**
* [ ] API:`POST /ads/v3/brand-pages` devuelve 200 con `contentData`.
* [ ] Renderización: los módulos de contenido se renderizan correctamente en su sitio en el orden correcto.
* [ ] Tema: `theme` los campos se aplican correctamente; `null` los valores recurren a las opciones predeterminadas de la guía de estilo del comerciante.
* [ ] Campos opcionales: la lógica de renderizador y seguimiento debe tolerar campos de módulos opcionales omitidos, nulos o vacíos, así como nodos de seguimiento omitidos, sin errores (valide utilizando múltiples plantillas activas, no solo una única página de marca de demostración).
* [ ] Estilo: la página de marca coincide con el sistema de diseño de su sitio.
* [ ] Móvil: la página de marca se muestra correctamente en dispositivos móviles.
* [ ] Cache-busting: `{TS}` el valor cambia en cada solicitud.
**Validación de seguimiento**
* [ ] Píxel de impresión (C2S): cada entrada en `trackingTemplates.client.impressionPixelUrls` se dispara y devuelve 200 `image/gif`
* [ ] Notificación de impresión (S2S): la URL de impresión del servidor compuesta; **GET** o **POST** directo al Epsilon host de seguimiento devuelve 204 No Content.
* [ ] Seguimiento de clics (C2S): o bien la URL compuesta de `client.clickRedirect` devuelve 302 al destino correcto, o bien la compuesta `client.clickEvent` devuelve 204 No Content (cualquiera de las opciones que use su flujo, no ambas)
* [ ] Notificación de clic (S2S): **GET** o **POST** directo a la URL de servidor compuesta devuelve 204 No Content
* [ ] Añadir al carrito (C2S): la URL compuesta de `client.addToCartEvent` activada como señal de evento devuelve 204 No Content
* [ ] Añadir al carrito (S2S): la URL compuesta de `server.addToCartEvent` llamada directamente al host de seguimiento devuelve 204 No Content
**Infraestructura y privacidad**
* [ ] Proxy inverso: las solicitudes de seguimiento C2S se reenvían a través de su dominio; S2S no se envía a través del proxy
* [ ] Encabezados: `RP-Host`, `X-Forwarded-For`, `X-Forwarded-Request-Path`, `Referer` están presentes en las solicitudes con proxy
* [ ] Privacidad: no hay PII presente en ningún parámetro o URL
* [ ] HTTPS: todas las solicitudes utilizan conexiones seguras
* [ ] Páginas de productos: las páginas se renderizan correctamente después de la redirección de clic
### Herramientas recomendadas
* Herramientas para desarrolladores del navegador: pestaña Red para inspeccionar cargas de píxeles y redirecciones.
* Fiddler o Charles Proxy: inspeccione el comportamiento del proxy inverso y el reenvío de encabezados.
### Solución de problemas
| Problema | Comprobación |
| ------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Los píxeles no se cargan | Verifique DNS/SSL, confirme la reescritura de la ruta del proxy, compruebe la accesibilidad al Epsilon host de seguimiento. |
| Las redirecciones no se reenvían | Asegúrese de que `{RURL}` esté codificado en URL, verifique que el proxy conserve la cadena de consulta. |
| La API no devuelve contenido | Verifique que `catalogId` y `urlSlug` coincidan con una campaña activa de la página de marca. |
| El seguimiento está bloqueado por el bloqueador de anuncios | Confirme que el proxy inverso esté configurado; el seguimiento debe enrutarse a través de su dominio. |
| Añadir al carrito no se rastrea | Asegúrese de disparar la URL del cliente o servidor compuesta para añadir al carrito después de la acción del carrito. |
| La página arroja un error al cargar algunas páginas de marca | Probablemente esté tratando los campos doc/example como siempre obligatorios. Registre el JSON sin procesar del módulo, añada protecciones para claves opcionales y seguimiento faltante, y confirme que la plantilla permita o deshabilite esos campos. |
| Los colores del tema no se aplican correctamente | Compruebe que `null` los campos de tema recurran a las opciones predeterminadas de su guía de estilo, en lugar de renderizarse como valores nulos literales o cadenas vacías. |
## Glosario
**Términos esenciales para la integración de páginas de marca**
| Término | Definición | Ejemplo |
| ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- |
| Clave API | Su credencial de autenticación para Epsilon servicios | `Basic abc123xyz...` |
| Página de marca | Una experiencia de página de destino de marca en su sitio | tusitio.com/brands/nike |
| Rastreo C2S | Cliente a servidor: rastreo basado en navegador. Las impresiones usan píxeles de 1x1; los clics usan una redirección 302 o una señal de evento; la acción de añadir al carrito usa una señal de evento. | `
, navigator.sendBeacon(clickEvent)` |
| Rastreo S2S | Servidor a servidor: rastreo en el backend (GET o POST a las URL de rastreo compuestas) | Su servidor → Epsilon servidor |
| Módulo de contenido | Bloques de contenido individuales (principal, texto, productos, etc.) | Banner principal, cuadrícula de productos |
| Etiquetas de módulo | Etiquetas de cadena opcionales en un módulo (p. ej., `["header"]`) configuradas en la plantilla. Utilizadas por los minoristas para el enrutamiento del diseño, la analítica o el mapeo de sus propios componentes. Se omiten de la respuesta cuando están vacías. | `"tags": ["header"]` |
| Tema | Siempre presente en caso de éxito en la respuesta de la API: anidado `colors` (fondo + siete roles de texto) y `buttons` (`primary` / `secondary` con `background` y `text`). Todos los campos de color del tema son obligatorios (hex6). Consulte [Objeto de tema](/retail-media-interface/integration/es/brand-pages/brand-page-retailer-integration-guide/brand-page-apis.md#theme-object). | "theme": { "colors": { ... }, "buttons": { ... } } |
| Impresión | Cuando un usuario ve una página de marca | Carga de página = 1 impresión |
| Clic | Cuando un usuario hace clic en el contenido de la página de marca | Clic en el botón de CTA |
| Conversión | Cuando un usuario añade un producto al carrito desde la página de marca | Acción de añadir al carrito |
| Proxy inverso | Enruta el rastreo a través de su dominio para evitar los bloqueadores de anuncios | `yoursite.com/epsilon/` → Epsilon |
| Slug de URL | El identificador de marca en la ruta de la URL | `nike` in `/brands/nike` |
| ID de catálogo | Su identificador único de catálogo de productos | Proporcionado por Epsilon |
| Macro | Marcadores de posición en la respuesta (`{TS}`, `{RURL}`) in `tracking.params` que usted reemplaza en tiempo de ejecución; | `{TS} → 1737485823910` |
| IAB TCF | Interactive Advertising Bureau Transparency & Consent Framework | Estándar de cumplimiento del GDPR |
| PII | Información de identificación personal (¡nunca envíe esto!) | Correo electrónico, teléfono, nombre real |
| Evitar el uso de caché | Añadir marcas de tiempo para evitar respuestas almacenadas en caché | `?ts=1737485823910` |
### Acrónimos técnicos
| Acrónimo | Término completo | Qué significa |
| -------- | ----------------------------------------- | --------------------------------------------------- |
| RMN | Retail Media Red | Epsilonplataforma publicitaria de |
| CTA | Llamada a la acción | Botones/enlaces con opción de clic |
| JSON | Notación de Objetos JavaScript | Formato de datos para solicitudes/respuestas de API |
| HTTPS | HTTP Seguro | Protocolo web cifrado |
| RGPD | Reglamento General de Protección de Datos | Ley de privacidad de la UE |
| TLS | Seguridad de la Capa de Transporte | Protocolo de cifrado |
| DNS | Sistema de Nombres de Dominio | Sistema de direcciones de Internet |
| SSL | Capa de Sockets Seguros | Protocolo de cifrado |
| RFC | Petición de comentarios | Documentos de estándares técnicos |
---
# 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/validation-troubleshooting.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.