Validation & Troubleshooting

Tests et validation

Liste de contrôle de validation avant lancement

Intégration technique

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.

Validation du suivi

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

Infrastructure et confidentialité

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
Confidentialité : aucun paramètre ou aucune URL ne contient d'informations personnelles.
HTTPS : toutes les requêtes utilisent des connexions sécurisées
Pages produits : les pages s'affichent correctement après redirection par clic

Outils recommandés

Outils de développement du navigateur : onglet Réseau pour inspecter les chargements de pixels et les redirections.
Fiddler ou Charles Proxy : inspectez le comportement du proxy inversé et le transfert des en-têtes.

Résolution des problèmes

Problème	Vérifiez
Les pixels ne se chargent pas	Verify DNS/SSL, confirm proxy path rewrite, check reachability to the Epsilon tracking host.
Les redirections ne sont pas transférées	Ensure `{RURL}` is URL-encoded, verify proxy preserves query string.
L’API ne renvoie aucun contenu	Verify `catalogId` and `urlSlug` match an active brand page campaign.
Suivi bloqué par le bloqueur de publicités	Confirm reverse proxy is configured - tracking should route through your domain.
L'ajout au panier n'est pas suivi	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.

Glossaire

Termes essentiels pour l'intégration des pages de marque

Durée de validité	Définition	Exemple
Clé API	Votre identifiant d'authentification pour les services Epsilon	`Basic abc123xyz...`
Page de marque	Une page de renvoi de marque sur votre site	yoursite.com/brands/nike
Suivi 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)`
Suivi S2S	Serveur-serveur : suivi du backend (GET ou POST vers les URL de suivi composées)	Votre serveur → serveur Epsilon
Module de contenu	Blocs de contenu individuels (hero, texte, produits, etc.)	Bannière principale, grille de produits
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": { ... }}
Impression	Lorsqu'une page de marque est consultée par un utilisateur	Chargement de la page = 1 impression
Cliquez sur	Lorsqu'un utilisateur clique sur le contenu de la page de marque	Clic sur le bouton CTA
Conversion	Lorsqu’un utilisateur ajoute un produit au panier depuis la page de la marque	Action Ajouter au panier
Proxy inversé	Achemine le suivi via votre domaine pour éviter les bloqueurs de publicités	`yoursite.com/epsilon/` → Epsilon
Slug de l'URL	L'identifiant de la marque dans le chemin URL	`nike` dans `/brands/nike`
ID du catalogue	L'identifiant unique de votre catalogue de produits	Fourni par Epsilon
Macro	Response placeholders (`{TS}`, `{RURL}`) in `tracking.params` that you replace at runtime;	`{TS} → 1737485823910`
IAB TCF	Cadre de transparence et de consentement du Bureau de la publicité interactive	Norme de conformité au RGPD
PII	Informations personnelles identifiables (ne les communiquez en aucun cas !)	E-mail, téléphone, vrai nom
Cache-busting	Ajoutez des horodatages pour empêcher la mise en cache des réponses	`?ts=1737485823910`

Acronymes techniques

Acronyme	Période complète	Ce que cela signifie
RMN	Réseau de médias de vente au détail	La plateforme publicitaire d’Epsilon
Appel à l'action	Appel à l'action	Boutons/liens cliquables
JSON	Notation d'objets JavaScript	Format de données pour les requêtes/réponses d'API
HTTPS	HTTP sécurisé	Protocole Web chiffré
RGPD	Règlement général sur la protection des données	Droit européen de la vie privée
TLS	Sécurité de la couche de transport	Protocole de chiffrement
DNS	Système de noms de domaine	Système d'adresses Internet
SSL	Couche de sockets sécurisés	Protocole de chiffrement
RFC	Request for Comments	Technical standards documents