> 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/fr/brand-pages/brand-page-retailer-integration-guide/validation-troubleshooting.md).
# Validation et dépannage
## Tests et validation
### Liste de contrôle de validation de pré-lancement
**Intégration technique**
* [ ] API :`POST /ads/v3/brand-pages` renvoie 200 avec `contentData`.
* [ ] Rendu : Les modules de contenu s'affichent correctement sur votre site dans le bon ordre.
* [ ] Thème : `theme` les champs sont appliqués correctement ; `null` les valeurs se rabattent sur les valeurs par défaut de la charte graphique du distributeur.
* [ ] Champs optionnels : La logique de rendu et de suivi doit tolérer les champs de module optionnels omis, nuls ou vides, ainsi que les nœuds de suivi omis, sans erreur (validez en utilisant plusieurs modèles actifs, et pas seulement une seule page de marque de démonstration).
* [ ] Style : La page de marque correspond au système de design de votre site.
* [ ] Mobile : La page de marque s'affiche correctement sur les appareils mobiles.
* [ ] Anti-cache : `{TS}` la valeur change à chaque requête.
**Validation du suivi**
* [ ] Pixel d'impression (C2S) : Chaque entrée dans `trackingTemplates.client.impressionPixelUrls` déclenche et renvoie 200 `image/gif`
* [ ] Notification d'impression (S2S) : L'URL d'impression serveur composée ; **GET** ou **POST** direct vers Epsilon l'hôte de suivi renvoie 204 No Content.
* [ ] Suivi des clics (C2S) : Soit l'URL composée `client.clickRedirect` renvoie 302 vers la bonne destination, soit l'URL composée `client.clickEvent` renvoie 204 No Content (selon l'option utilisée par votre flux - pas les deux)
* [ ] Notification de clic (S2S) : **GET** ou **POST** direct vers l'URL serveur composée renvoie 204 No Content
* [ ] Ajout au panier (C2S) : Composé `client.addToCartEvent` déclenché comme balise d'événement renvoie 204 No Content
* [ ] Ajout au panier (S2S) : Composé `server.addToCartEvent` appelé directement vers l'hôte de suivi renvoie 204 No Content
**Infrastructure et confidentialité**
* [ ] Reverse proxy : Requêtes de suivi C2S transmises via votre domaine ; S2S n'est pas envoyé via le proxy
* [ ] En-têtes : `RP-Host`, `X-Forwarded-For`, `X-Forwarded-Request-Path`, `Referer` sont présents sur les requêtes proxyfiées
* [ ] Confidentialité : Aucune PII présente dans un paramètre ou une URL
* [ ] HTTPS : Toutes les requêtes utilisent des connexions sécurisées
* [ ] Pages produits : Les pages s'affichent correctement après la réorientation du clic
### Outils recommandés
* Outils de développement du navigateur : Onglet Réseau pour inspecter les chargements de pixels et les réorientations.
* Fiddler ou Charles Proxy : Inspecter le comportement du reverse proxy et le transfert des en-têtes.
### Dépannage
| Problème | Vérification |
| ------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Échec du chargement des pixels | Vérifiez le DNS/SSL, confirmez la réécriture du chemin du proxy, vérifiez l'accessibilité de Epsilon l'hôte de suivi. |
| Les réorientations ne transmettent pas | S'assurer que `{RURL}` est encodé en URL, vérifier que le proxy conserve la chaîne de requête. |
| L'API ne renvoie aucun contenu | Vérifiez `catalogId` et `urlSlug` correspondent à une campagne de page de marque active. |
| Suivi bloqué par un bloqueur de publicités | Confirmez que le reverse proxy est configuré - le suivi doit acheminer via votre domaine. |
| Ajout au panier non suivi | Assurez-vous de déclencher l'URL d'ajout au panier client ou serveur composée après l'action de panier. |
| La page génère une erreur lors du chargement de certaines pages de marque | Traite probablement les champs doc/example comme étant toujours requis. Journalisez le JSON brut du module, ajoutez des protections pour les clés optionnelles et le suivi manquant, et confirmez que le modèle autorise ou désactive ces champs. |
| Les couleurs du thème ne s'appliquent pas correctement | Vérifiez que `null` les champs de thème se rabattent sur les valeurs par défaut de votre charte graphique, plutôt d'être rendus comme des valeurs nulles littérales ou des chaînes vides. |
## Glossaire
**Termes essentiels pour l'intégration des pages de marque**
| Terme | Définition | Exemple |
| -------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- |
| Clé d'API | Votre identifiant d'authentification pour les Epsilon services | `Basic abc123xyz...` |
| Page de marque | Une expérience de page d'atterrissage aux couleurs de la marque sur votre site | yoursite.com/brands/nike |
| Suivi C2S | Client-to-Server : suivi basé sur le navigateur. Les impressions utilisent des pixels 1x1 ; les clics utilisent une redirection 302 ou une balise d'événement ; l'ajout au panier utilise une balise d'événement. | `
, navigator.sendBeacon(clickEvent)` |
| Suivi S2S | Server-to-Server : suivi backend (GET ou POST vers les URL de suivi composées) | Votre serveur → Epsilon serveur |
| Module de contenu | Blocs de contenu individuels (bannière principale, texte, produits, etc.) | Bannière principale, grille de produits |
| Balises de module | Étiquettes de chaîne facultatives sur un module (par ex., `["header"]`) définies dans le modèle. Utilisées par les distributeurs pour le routage de la mise en page, l'analyse ou l'association à leurs propres composants. Omises de la réponse lorsqu'elles sont vides. | `"tags": ["header"]` |
| Thème | Toujours présent en cas de succès dans la réponse API : imbriqué `colors` (arrière-plan + sept rôles de texte) et `buttons` (`primary` / `secondary` avec `background` et `text`). Tous les champs de couleur de thème sont obligatoires (hex6). Voir [Objet Thème](/retail-media-interface/integration/fr/brand-pages/brand-page-retailer-integration-guide/brand-page-apis.md#theme-object). | "theme": { "colors": { ... }, "buttons": { ... } } |
| Impression | Lorsqu'une page de marque est consultée par un utilisateur | Chargement de la page = 1 impression |
| Clic | Lorsqu'un utilisateur clique sur le contenu d'une page de marque | Clic sur le bouton CTA |
| Conversion | Lorsqu'un utilisateur ajoute un produit au panier depuis la page de marque | Action d'ajout au panier |
| Reverse Proxy | Achemine le suivi via votre domaine pour contourner les bloqueurs de publicite | `yoursite.com/epsilon/` → Epsilon |
| Limace d'URL | L'identifiant de la marque dans le chemin de l'URL | `nike` in `/brands/nike` |
| ID de catalogue | Votre identifiant unique de catalogue de produits | Fourni par Epsilon |
| Macro | Espaces réservés de réponse (`{TS}`, `{RURL}`) in `tracking.params` que vous remplacez lors de l'exécution ; | `{TS} → 1737485823910` |
| IAB TCF | Interactive Advertising Bureau Transparency & Consent Framework | Norme de conformité RGPD |
| DCP | Données à caractère personnel (ne jamais envoyer ceci !) | E-mail, téléphone, nom réel |
| Anti-mise en mémoire cache | Ajout d'horodatages pour empêcher les réponses mises en cache | `?ts=1737485823910` |
### Sigles techniques
| Sigle | Terme complet | Ce que cela signifie |
| ----- | ----------------------------------------------- | -------------------------------------------------- |
| RMN | Retail Media Réseau | Epsilonla plateforme publicitaire de |
| CTA | Bouton d'action | Boutons/liens cliquables |
| JSON | JavaScript Object Notation | Format de données pour les requêtes/réponses d'API |
| HTTPS | HTTP Secure | Protocole web chiffré |
| RGPD | Règlement général sur la protection des données | Loi sur la protection des données de l'UE |
| TLS | Transport Layer Security | Protocole de chiffrement |
| DNS | Domain Name System | Système d'adresses Internet |
| SSL | Secure Sockets Layer | Protocole de chiffrement |
| RFC | Request for Comments | Documents de normes techniques |
---
# 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/fr/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.