> 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/integration-architecture.md).

# Architettura di integrazione

## Componenti di integrazione

**Componenti richiesti**

1. Client API – Recupera il contenuto della pagina del brand.
2. Renderizzatore di contenuti – Visualizza i moduli sul tuo sito. Gestisce moduli e campi che potrebbero essere mancanti o vuoti senza generare errori; usa una soluzione di fallback o nasconde i blocchi dell'interfaccia utente quando i dati del materiale creativo opzionali sono assenti.
3. Gestore di tracciamento – Compone gli URL di tracciamento da `trackingTemplates` e per ciascuno slot `trackers.<slot>params`, quindi attiva gli eventi C2S e/o S2S.
4. Reverse Proxy – Instrada il tracciamento attraverso il tuo dominio.

Questa sezione descrive la sequenza di runtime ad alto livello per l'erogazione e il tracciamento.

## Flusso di integrazione

**Opzioni di tracciamento (Scegliere una)**

| Metodo                   | Quando usarlo                                                                                                                                                                                                                                  |
| ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| (Da client a server) C2S | Implementazione web standard: pixel di impression basati su browser più reindirizzamenti dei clic o beacon di evento (clic e aggiunte al carrello). Questo approccio è fortemente consigliato da Epsilon per la maggior parte dei rivenditori. |
| (Da server a server) S2S | Da utilizzare quando la tua architettura richiede l'attivazione di eventi lato server, i pixel lato client sono inaffidabili o desideri una conferma lato server in aggiunta al C2S.                                                           |

{% hint style="info" %}
**Un reverse proxy è richiesto solo per il tracciamento C2S (browser). Le chiamate S2S vanno direttamente all'host di tracciamento Epsilon utilizzando gli URL composti da `trackingTemplates.server`** **`+`** **`trackers.<slot>params` (stessa ricetta del C2S, senza `BASEURL`). Non instradare le chiamate S2S attraverso un reverse proxy né modificare l'host o il percorso del modello.**
{% endhint %}

<br>


---

# 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/integration-architecture.md?ask=<question>&goal=<endgoal>
```

`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.
