> 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/it/brand-pages/brand-page-retailer-integration-guide/validation-troubleshooting.md).
# Validazione e risoluzione problemi
## Test e validazione
### Checklist di validazione pre-lancio
**Integrazione tecnica**
* [ ] API:`POST /ads/v3/brand-pages` restituisce 200 con `contentData`.
* [ ] Rendering: I moduli di contenuto vengono visualizzati correttamente sul tuo sito nell'ordine corretto.
* [ ] Tema: `theme` i campi vengono applicati correttamente; `null` i valori ripiegano sui valori predefiniti della guida di stile del retailer.
* [ ] Campi opzionali: La logica del renderer e di tracciamento deve tollerare campi modulo opzionali omessi, null o vuoti, nonché nodi di tracciamento omessi, senza errori (convalidare utilizzando più template attivi, non solo una singola pagina del brand demo).
* [ ] Stile: La pagina del brand corrisponde al design system del tuo sito.
* [ ] Mobile: La pagina del brand viene visualizzata correttamente sui dispositivi mobili.
* [ ] Cache-busting: `{TS}` il valore cambia a ogni richiesta.
**Validazione del tracciamento**
* [ ] Pixel di impressione (C2S): Ogni voce in `trackingTemplates.client.impressionPixelUrls` scatta e restituisce 200 `image/gif`
* [ ] Notifica di impressione (S2S): L'URL di impressione del server composto; **GET** o **POST** diretto a Epsilon l'host di tracciamento restituisce 204 No Content.
* [ ] Tracciamento dei clic (C2S): O l'URL composto `client.clickRedirect` restituisce 302 alla destinazione corretta, oppure il composto `client.clickEvent` restituisce 204 No Content (a seconda dell'opzione utilizzata dal tuo flusso - non entrambe)
* [ ] Notifica di clic (S2S): **GET** o **POST** diretto all'URL del server composto restituisce 204 No Content
* [ ] Aggiunta al carrello (C2S): Il composto `client.addToCartEvent` inviato come beacon di evento restituisce 204 No Content
* [ ] Aggiunta al carrello (S2S): Il composto `server.addToCartEvent` chiamato direttamente all'host di tracciamento restituisce 204 No Content
**Infrastruttura e privacy**
* [ ] Reverse proxy: Le richieste di tracciamento C2S vengono inoltrate tramite il tuo dominio; S2S non viene inviato tramite il proxy
* [ ] Intestazioni: `RP-Host`, `X-Forwarded-For`, `X-Forwarded-Request-Path`, `Referer` sono presenti sulle richieste inviate tramite proxy
* [ ] Privacy: Nessuna PII presente in qualsiasi parametro o URL
* [ ] HTTPS: Tutte le richieste utilizzano connessioni sicure
* [ ] Pagine di dettaglio prodotto: Le pagine vengono visualizzate correttamente dopo il reindirizzamento dal clic
### Strumenti consigliati
* Strumenti per sviluppatori del browser: Scheda Rete per ispezionare i caricamenti dei pixel e i reindirizzamenti.
* Fiddler o Charles Proxy: Ispeziona il comportamento del reverse proxy e l'inoltro delle intestazioni.
### Risoluzione dei problemi
| Problema | Verifica |
| ---------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Mancato caricamento dei pixel | Verifica DNS/SSL, conferma la riscrittura del percorso del proxy, controlla la raggiungibilità a Epsilon l'host di tracciamento. |
| I reindirizzamenti non inoltrano | Assicurati che `{RURL}` sia codificato in formato URL, verifica che il proxy conservi la stringa di query. |
| L'API non restituisce alcun contenuto | Verifica che `catalogId` e `urlSlug` corrispondano a una campagna della pagina del brand attiva. |
| Tracciamento bloccato dall'ad blocker | Conferma che il reverse proxy sia configurato: il tracciamento deve essere instradato tramite il tuo dominio. |
| Aggiunta al carrello non tracciata | Assicurati di attivare l'URL di aggiunta al carrello composto client o server dopo l'azione sul carrello. |
| La pagina genera un errore durante il caricamento di alcune pagine del brand | È probabile che i campi doc/example vengano trattati come sempre obbligatori. Registra il JSON del modulo grezzo, aggiungi controlli di sicurezza per le chiavi opzionali e il tracciamento mancante e conferma che il template consenta o disabiliti tali campi. |
| I colori del tema non vengono applicati correttamente | Verifica che `null` i campi del tema ripieghino sui valori predefiniti della tua guida di stile, anziché essere visualizzati come valori null letterali o stringhe vuote. |
## Glossario
**Termini essenziali per l'integrazione delle pagine del brand**
| Termine | Definizione | Esempio |
| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- |
| Chiave API | La tua credenziale di autenticazione per Epsilon servizi | `Basic abc123xyz...` |
| Pagina del brand | Un'esperienza di pagina di destinazione personalizzata con il brand sul tuo sito | yoursite.com/brands/nike |
| Tracciamento C2S | Client-to-Server: tracciamento basato su browser. Le impression utilizzano pixel 1x1; i clic utilizzano un reindirizzamento 302 o un beacon di evento; l'aggiunta al carrello utilizza un beacon di evento. | `
, navigator.sendBeacon(clickEvent)` |
| Tracciamento S2S | Server-to-Server: tracciamento backend (GET o POST verso gli URL di tracciamento composti) | Il tuo server → Epsilon server |
| Modulo di contenuto | Singoli blocchi di contenuto (hero, testo, prodotti, ecc.) | Banner hero, griglia di prodotti |
| Tag del modulo | Etichette di testo opzionali su un modulo (ad es., `["header"]`impostate nel modello. Utilizzate dai retailer per l'instradamento del layout, l'analisi o la mappatura sui propri componenti. Omesse dalla risposta quando vuote. | `"tags": ["header"]` |
| Tema | Sempre presente in caso di successo nella risposta API: annidato `colors` (sfondo + sette ruoli di testo) e `buttons` (`primary` / `secondary` con `background` e `text`). Tutti i campi colore del tema sono obbligatori (hex6). Vedere [Oggetto Theme](/retail-media-interface/integration/it/brand-pages/brand-page-retailer-integration-guide/brand-page-apis.md#theme-object). | "theme": { "colors": { ... }, "buttons": { ... } } |
| Impression | Quando una pagina del brand viene visualizzata da un utente | Caricamento pagina = 1 impression |
| Clic | Quando un utente fa clic sul contenuto della pagina del brand | Clic sul pulsante CTA |
| Conversione | Quando un utente aggiunge un prodotto al carrello dalla pagina del brand | Azione aggiungi al carrello |
| Reverse Proxy | Instrada il tracciamento attraverso il tuo dominio per evitare gli ad blocker | `yoursite.com/epsilon/` → Epsilon |
| Slug URL | L'identificatore del brand nel percorso dell'URL | `nike` in `/brands/nike` |
| ID catalogo | Il tuo identificatore univoco del catalogo prodotti | Fornito da Epsilon |
| Macro | Segnaposto nella risposta (`{TS}`, `{RURL}`) in `tracking.params` che sostituisci in fase di esecuzione; | `{TS} → 1737485823910` |
| IAB TCF | Interactive Advertising Bureau Transparency & Consent Framework | Standard di conformità GDPR |
| PII | Informazioni di identificazione personale (non inviarle mai!) | E-mail, telefono, nome reale |
| Cache-busting | Aggiunta di timestamp per impedire risposte memorizzate in cache | `?ts=1737485823910` |
### Acronimi tecnici
| Acronimo | Termine completo | Cosa significa |
| -------- | ---------------------------------------------- | --------------------------------------- |
| RMN | Retail Media Network | Epsilonpiattaforma pubblicitaria di |
| CTA | Invito all'azione | Pulsanti/link cliccabili |
| JSON | JavaScript Object Notation | Formato dati per richieste/risposte API |
| HTTPS | HTTP Secure | Protocollo web crittografato |
| GDPR | Regolamento generale sulla protezione dei dati | Legge sulla privacy dell'UE |
| TLS | Transport Layer Security | Protocollo di crittografia |
| DNS | Domain Name System | Sistema dei nomi di dominio |
| SSL | Secure Sockets Layer | Protocollo di crittografia |
| RFC | Request for Comments | Documenti sugli standard tecnici |
---
# 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/it/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.