> 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/overview-1.md). # Panoramica ## Cosa sono le Pagine del brand? Le Pagine del brand sono esperienze di landing page personalizzate presenti sul tuo sito web che mostrano contenuti specifici del brand. Sono ospitate sul tuo dominio e rese attraverso i tuoi componenti UI. Le Pagine del brand vengono gestite separatamente dalle campagne pubblicitarie standard nella Epsilon piattaforma.\ Sebbene utilizzino un flusso di lavoro di creazione e revisione simile, rappresentano esperienze di landing page personalizzate sul sito di un retailer e non annunci pubblicitari tradizionali. **Esempio:** Un utente visita `yoursite.com/brands/nike` e vede una pagina a marchio Nike con prodotti Nike, ma che ha l'aspetto e l'esperienza d'uso di una parte del tuo sito web. ## Cosa costruirai In qualità di ingegnere del retailer, dovrai: * Aggiungere un instradamento per gli URL delle Pagine del brand (ad esempio, `/brands/{slug}`). {% hint style="info" %} I retailer non sono tenuti a predisporre un URL per ogni Pagina del brand. Gli URL vengono gestiti automaticamente dalla piattaforma. Tuttavia, l'URL di base della Pagina del brand (prefisso incluso) deve essere configurato durante l'onboarding (ad esempio, nella Guida di stile del retailer). Se l'URL completo o il prefisso non vengono forniti, l'URL della Pagina del brand non verrà popolato nella pagina di configurazione. {% endhint %} * Chiamare l'API delle Pagine del brand utilizzando lo slug estratto. * Rendere i moduli di contenuto restituiti. * Implementare il tracciamento delle impressioni, dei clic e delle aggiunte al carrello. * Configurare un reverse proxy per il tracciamento prima parte. {% hint style="info" %} Questo passaggio è richiesto solo per il tracciamento lato client. {% endhint %} ### Le tue responsabilità rispetto a Epsilon's | Ti occupi di | Epsilon Fornisce | | --------------------------------------------- | -------------------------------------------- | | ✅ Integrazione API per recuperare i contenuti | ✅ Contenuti e modelli della pagina del brand | | ✅ Rendering dei contenuti sul tuo sito | ✅ Infrastruttura di tracciamento | | ✅ Configurazione del reverse proxy | ✅ Analisi e reportistica | | ✅ Fornitura della tua guida di stile | ✅ Strumenti di gestione della campagna | | ✅ Test e validazione | ✅ Supporto tecnico | ## Come funzionano le Pagine del brand ### Flusso end-to-end {% hint style="info" %} Il contenuto della pagina del brand viene configurato e visualizzato in anteprima nell'interfaccia utente di Epsilon UI. I retailer integrano le Pagine del brand esclusivamente tramite API e sono responsabili del rendering dell'esperienza finale sui loro siti. {% endhint %} Durante il processo di revisione, i retailer possono visualizzare in anteprima il contenuto della pagina del brand configurato prima dell'approvazione. ### Modelli e Moduli Durante l'onboarding, Epsilon collabora con il tuo team per creare modelli che definiscono: * I moduli di contenuto disponibili (come hero, griglia prodotti, testo e immagini), con nomi di modulo configurabili nell'interfaccia utente per allinearsi con la tassonomia del tuo retailer. * I vincoli per ciascun modulo (limiti di caratteri, dimensioni delle immagini, ecc.). * Lo stile che si allinea con le linee guida del tuo brand. I brand selezionano un modello quando creano la loro campagna, quindi inseriscono il contenuto nel rispetto di tali vincoli. {% hint style="info" %} L'API Pagine del brand restituisce moduli di contenuto e URL di tracciamento. I retailer sono responsabili dell'applicazione dello stile utilizzando i propri componenti UI e il proprio sistema di design. {% endhint %} **Esempi** I seguenti esempi illustrano come i brand possono popolare i moduli di contenuto comuni durante la creazione di una Pagina del brand. Si tratta solo di input di esempio che possono essere modificati in base al modello selezionato e agli obiettivi della campagna. **Modulo HERO** * **Titolo:** Scopri la nuova collezione estiva * **Sottotitolo:** Stili freschi per ogni occasione * **CTA:** Acquista ora **Modulo TESTO** Esplora i nostri ultimi arrivi progettati per comfort, stile e prestazioni - perfetti da indossare ogni giorno. **Modulo IMMAGINE** * Didascalia:\*\* Nuovi arrivi ora disponibili * **Testo alt:** Modello che indossa la collezione estiva * URL: **PRODUCTModulo \_GRID** Utilizza una griglia di prodotti per mostrare i prodotti più venduti o stagionali e stimolare il coinvolgimento e le conversioni. #### Configurazione del modulo: | Modulo | Descrizione | Elementi configurabili (Riepilogo) | | -------------- | ----------------------------------------------------------- | -------------------------------------------------------------------------- | | HERO | Banner a tutta larghezza con immagine, titolo e CTA | Titolo, sottotitolo, CTA, immagine, sovrapposizione | | PRODUCT\_GRID | Griglia o carosello di prodotti | Prodotti, titolo della sezione, descrizione, CTA | | TEXT | Blocco di testo (titolo, testo principale) | Campi di testo, CTA | | IMAGE | Singola immagine con link opzionale | Immagine, didascalia, testo alternativo, link opzionale | | IMAGE\_GALLERY | Immagini multiple in un layout a griglia | Immagini, didascalie, testo alternativo, titolo della sezione, descrizione | | FILTER\_MENU | Schede di filtraggio orizzontali per le griglie di prodotti | Etichette di filtraggio e ordinamento | | SPLIT\_LAYOUT | Layout a più colonne con moduli annidati | Struttura del layout e moduli annidati | {% hint style="info" %} Ogni elemento configurabile può essere impostato come obbligatorio, opzionale (consentito) o disabilitato, a seconda dei requisiti del modulo e del retailer. Alcuni campi possono anche imporre limiti massimi di caratteri quando contrassegnati come obbligatori o consentiti. {% endhint %} ### Module Tags Templates may include an optional `tags` campo su ciascun modulo — un elenco di etichette di testo brevi (ad es., `["header"]`) che la tua integrazione può utilizzare per decisioni di layout, analisi o associazione di moduli ai tuoi componenti. #### Come funzionano i tag nella risposta API * Quando un modulo presenta dei tag, questi appaiono come un `tags` array sull'elemento corrispondente in `contentData`. * Quando un modulo non ha tag, la `tags` proprietà viene omessa completamente dalla risposta - non apparirà come `"tags": []`. * Considera l'assenza del campo `tags` allo stesso modo di "nessun tag" - non generare un errore se è assente. * I tag sono supportati anche sui moduli annidati all'interno di `SPLIT_LAYOUT` – non solo sul modulo split radice. {% hint style="info" %} Importante I tag sono etichette opache concordate tra il retailer e il suo team di integrazione. Non sono legati ai tag di tracciamento degli annunci o a qualsiasi altro sistema — fai sempre riferimento a questi come *"tag del modulo"* o *"tag del modulo della pagina del brand"* per evitare confusione. {% endhint %} Esempio di modulo di risposta con un tag ```json { "id": "image-1", "contentType": "IMAGE", "order": 1, "tags": ["header"], "imageUrl": "https://example.com/images/banner.jpg" } ``` **Esempio di modulo di risposta senza tag (proprietà tags omessa):** ```json { "id": "image-2", "contentType": "IMAGE", "order": 2, "imageUrl": "https://example.com/images/promo.jpg" } ``` #### Cosa significa questo per la risposta dell'API Il `POST /ads/v3/brand-pages` risposta riflette queste stesse regole: un tipo di modulo appare solo in `contentData` quando fa parte del modello live e la pagina del brand ha configurato i contenuti per quel modulo. I campi all'interno di un modulo potrebbero non essere presenti nel JSON, `null`, o vuoti quando il modello li contrassegna come opzionali o disabilitati, oppure quando il brand li lascia non impostati: questo è previsto e non indica un payload difettoso. Implementa il rendering con tipi opzionali e accessori sicuri, ad esempio eseguendo il rendering di un blocco CTA solo quando `ctaText` e una destinazione di navigazione sono presenti; nascondi il media hero quando `mediaUrl`è assente. `trackers`a livello di pagina o su un nodo può essere omesso quando non c'è un'interazione tracciabile. Componi gli URL solo quando disponi sia di una chiave di template applicabile da `trackingTypes` sia del corrispondente `trackers.`\`.params`, se fornito dall'API. --- # 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/overview-1.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.