Validation & Troubleshooting

Pruebas y validación

Lista de verificación de validación previa al lanzamiento

Integración técnica

API :POST /ads/v3/brand-pages returns 200 with contentData.
Rendering : Content modules render correctly on your site in the correct order.
Theme: theme fields are applied correctly; null values fall back to retailer style guide defaults.
Optional fields: Renderer and tracking logic must tolerate omitted, null, or empty optional module fields, as well as omitted tracking nodes, without errors (validate using multiple live templates, not just a single demo brand page).
Styling : Brand page matches your site's design system.
Mobile : Brand page displays correctly on mobile devices.
Cache-busting : {TS} value changes on every request.

Validación de seguimiento

Impression pixel (C2S) : Every entry in trackingTemplates.client.impressionPixelUrls fires and returns 200 image/gif
Impression notification (S2S) : Composed server impression URL; GET or POST direct to Epsilon tracking host returns 204 No Content.
Click tracking (C2S) : Either the composed client.clickRedirect URL returns 302 to the correct destination, or the composed client.clickEvent returns 204 No Content (whichever option your flow uses - not both)
Click notification (S2S) : GET or POST direct to the composed server URL returns 204 No Content
Add-to-cart (C2S) : Composed client.addToCartEvent fired as event beacon returns 204 No Content
Add-to-cart (S2S) : Composed server.addToCartEvent called direct to tracking host returns 204 No Content

Infraestructura y privacidad

Reverse proxy : C2S tracking requests forwarded through your domain; S2S is not sent through the proxy
Headers : RP-Host, X-Forwarded-For, X-Forwarded-Request-Path, Referer are present on proxied requests
Privacidad: No existe información de identificación personal en ningún parámetro o URL
HTTPS: todas las solicitudes utilizan conexiones seguras
Páginas de producto: Las páginas se renderizan correctamente tras la redirección por clic

Herramientas recomendadas

Herramientas para desarrolladores del navegador: pestaña de red para inspeccionar cargas de píxel y redirecciones.
Fiddler o Charles Proxy: inspeccione el comportamiento del proxy inverso y el reenvío de encabezados.

Resolución de problemas

Problema	Verificación
No se han podido cargar los píxeles.	Verify DNS/SSL, confirm proxy path rewrite, check reachability to the Epsilon tracking host.
Las redirecciones no se reenvían	Ensure `{RURL}` is URL-encoded, verify proxy preserves query string.
La API no devuelve contenido	Verify `catalogId` and `urlSlug` match an active brand page campaign.
Seguimiento bloqueado por el bloqueador de anuncios	Confirm reverse proxy is configured - tracking should route through your domain.
No se realiza el seguimiento de añadir al carrito	Ensure you fire the composed client or server add-to-cart URL after the cart action.
Page throws when loading some brand pages	Likely treating doc/example fields as always required. Log raw module JSON, add guards for optional keys and missing tracking, and confirm the template allows or disables those fields.
Theme colors not applying correctly	Check that `null` theme fields fall back to your style guide defaults, rather than being rendered as literal null values or empty strings.

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 los servicios Epsilon	`Basic abc123xyz...`
Página de la marca	Una experiencia de página de destino de marca en su sitio	yoursite.com/brands/nike
Seguimiento C2S	Client-to-Server: Browser-based tracking. Impressions use 1x1 pixels; clicks use a 302 redirect or an event beacon; add-to-cart uses an event beacon.	`<img src="impression-pixel">, navigator.sendBeacon(clickEvent)`
Seguimiento S2S	De servidor a servidor: seguimiento en backend (GET o POST a las URL de seguimiento compuestas)	Su servidor → servidor Epsilon
Módulo de contenido	Bloques individuales de contenido (principal, texto, productos, etcétera).	Banner principal, cuadrícula de productos
Module Tags	Optional string labels on a module (e.g., `["header"]`) set in the template. Used by retailers for layout routing, analytics, or mapping to their own components. Omitted from the response when empty.	`"tags": ["header"]`
Theme	Always present on success in the API response: nested `colors` (background + seven text roles) and `buttons` (`primary` / `secondary` with `background` and `text`). All theme color fields are required (hex6). See Theme Object.	"theme": {"colors": { ... }, "buttons": { ... }}
Impresión	Cuando un usuario ve una página de marca	Carga de página = 1 impresión
Haga clic en	Cuando un usuario hace clic en el contenido de una página de marca	Clic en botón de CTA
Conversión	Cuando un usuario añade un producto al carrito desde la página de la marca	Acción de añadir al carrito
Proxy inverso	Seguimiento de rutas a través de su dominio para evitar los bloqueadores de anuncios.	`yoursite.com/epsilon/` → Epsilon
Slug de la URL	El identificador de marca en la ruta URL	`nike` en `/brands/nike`
ID del catálogo	Su identificador único del catálogo de productos	Proporcionado por Epsilon
Macro	Response placeholders (`{TS}`, `{RURL}`) in `tracking.params` that you replace at runtime;	`{TS} → 1737485823910`
IAB TCF	Marco de Transparencia y Consentimiento del Interactive Advertising Bureau	Norma de cumplimiento del RGPD
Información de identificación personal	Información de identificación personal (¡no debe enviarse nunca!)	Correo electrónico, teléfono, nombre real
Evitar el almacenamiento en caché	Añadir marcas de tiempo para evitar que las respuestas se almacenen en caché	`?ts=1737485823910`

Acrónimos técnicos

Acrónimo	Término completo	Significado
RMN	Retail Media Network	La plataforma de publicidad de Epsilon
CTA	Llamada a la acción	Botones/enlaces en los que se puede hacer clic
JSON	JavaScript Object Notation	Formato de los datos para las solicitudes/respuestas de la API
HTTPS	HTTP seguro	Protocolo web cifrado
GDPR	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 (SSL)	Protocolo de cifrado
RFC	Request for Comments	Technical standards documents