> 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/data-api/api-overview/integration-workflow-options-1.md).

# Opzioni del flusso di lavoro di integrazione degli annunci per i rivenditori

Epsilon's Retail Media L'integrazione standard garantisce che il tuo sito web offra un'esperienza utente fluida mostrando rapidamente annunci pertinenti ai clienti. In qualità di retailer, devi semplicemente sincronizzare il tuo catalogo prodotti e i dati dei clienti con Epsilon's Retail Media. È importante notare che Epsilon Retail Media è integrato tramite il backend del retailer. L'integrazione garantisce che gli annunci pertinenti vengano visualizzati sul tuo sito web, migliorando l'esperienza di acquisto dell'utente unendo gli elenchi pubblicitari con i contenuti organici. Ecco alcuni dei vantaggi principali:

1. **Esperienza utente migliorata**: gli annunci sono integrati perfettamente con i contenuti organici, offrendo un'esperienza di navigazione fluida.
2. **Pertinenza**: gli annunci sono contestualmente pertinenti, aumentando il coinvolgimento degli utenti.
3. **Efficienza**: la rapida erogazione dei contenuti pubblicitari migliora i tempi di caricamento della pagina.
4. **Reportistica**: ottieni informazioni dettagliate su impressioni pubblicitarie, clic e ordini.

## Integrazione standard

Il flusso di lavoro di integrazione standard prevede i seguenti passaggi:

1. Sincronizza i dati
2. Eroga annunci
3. Segnala le azioni

{% hint style="info" %}
I clienti non vedono gli elenchi finché non vengono uniti in un elenco finale. Ciò garantisce che ottengano informazioni complete e accurate.
{% endhint %}

<figure><img src="/files/ba0oBRTAghaTwxg1KJsg" alt="" width="100%"><figcaption></figcaption></figure>

### Flusso di lavoro

Ecco la serie di eventi:

#### Prima dell'erogazione degli annunci

**Sincronizza i dati dei prodotti**: sincronizza il tuo catalogo prodotti con Epsilon Retail Media utilizzando la [API](https://developers.citrusad.com/integration/docs/use-apis) o un file giornaliero [sincronizzazione dei file](https://developers.citrusad.com/integration/docs/use-apis). Sincronizza facoltativamente i dati dei tuoi clienti con Epsilon Retail Media utilizzando l'API o una sincronizzazione giornaliera tramite file.

#### Quando gli annunci vengono erogati

1. **L'utente visita il tuo sito web**: un cliente apre il tuo sito web e naviga verso una pagina specifica in cui Epsilon’s Retail Media è integrato.
2. **Il sito web richiede i dati**: il tuo sito web richiede i dati al tuo server backend in base al contesto della pagina (ad esempio, `customerId`, `sessionId`, `dtmCookieID`, `productFilters`).
3. Il backend richiede gli annunci a Epsilon Retail Media: il tuo server backend chiama la Epsilon Retail Media API, richiedendo annunci pertinenti al contesto della pagina del cliente.
4. **Epsilon Retail Media Restituisce annunci pertinenti**: Epsilon Retail Media restituisce gli annunci più pertinenti per la richiesta, inclusi i codici prodotto e gli URL per gli annunci banner.
5. **Unisci gli annunci ai contenuti organici**: il tuo server backend unisce la risposta dell'annuncio da Epsilon Retail Media ai contenuti organici del tuo sito web.
6. **Fornisci tutti i contenuti al cliente**: il tuo server invia gli annunci combinati e i contenuti organici al browser del cliente in un'unica risposta.

#### Dopo l'erogazione degli annunci

1. **Segnala impression**: quando il cliente visualizza un annuncio, un'impression viene segnalata a Epsilon Retail Media per il singolo adId.
2. **Segnala clic**: quando il cliente fa clic su un annuncio, un clic viene segnalato a Epsilon Retail Media per il singolo `adId`.
3. **Segnala ordini**: quando il cliente completa un acquisto, i dettagli dell'ordine (articoli, prezzi, quantità) insieme a `customerId`, `sessionId`, `dtmCookieId` vengono segnalati a Epsilon Retail Media.

## Opzioni di integrazione flessibili

Epsilon Retail Media offre anche due metodi di integrazione aggiuntivi personalizzati per soddisfare le diverse esigenze e preferenze dei retailer. Ciascun metodo presenta vantaggi e compromessi unici, consentendo ai retailer di scegliere l'approccio più adatto in base ai propri requisiti specifici e alle proprie capacità tecniche.

### Approccio 1: Richieste singole dal browser

Questo approccio prevede chiamate backend separate per i prodotti organici e gli annunci, riducendo le modifiche al backend e garantendo che gli utenti vedano sempre gli elenchi più aggiornati. Ecco alcuni dei vantaggi per i retailer che utilizzano questo approccio:

* **Tempi di sviluppo ridotti**: più facile da implementare con modifiche minime al backend, risparmiando tempo di sviluppo e risorse.
* **Elenchi aggiornati**: garantisce che venga visualizzato il contenuto pubblicitario più recente, aumentando potenzialmente la pertinenza dell'annuncio e il coinvolgimento degli utenti.

#### Flusso di lavoro

Ecco la serie di eventi:

<figure><img src="/files/0mR2m1JGuU6KAwR6r4RY" alt="" width="100%"><figcaption></figcaption></figure>

#### Quando gli annunci vengono erogati

Nel caso delle richieste da browser, l'erogazione degli annunci differisce dall'integrazione standard nel seguente modo:

**Gestione della richiesta**

* Gli elenchi dei prodotti vengono nascosti all'utente finché gli elenchi organici non vengono uniti a Epsilon Retail Media offerte.
* Invece di fare in modo che il tuo servizio backend esistente richieda direttamente i dati a Epsilon Retail Media, ora utilizzi un nuovo servizio del retailer.
* Il servizio del retailer effettua la chiamata backend a Epsilon Retail Media con le informazioni sul posizionamento pertinenti.
* Anche se ti colleghi al tuo server backend e Epsilon Retail Media separatamente prima dell'unione, devi comunque raccogliere tutti i dettagli sul prodotto necessari per i codici prodotto forniti nel Epsilon Retail Media response.

**Unione e invio dei contenuti**

* Il browser unisce gli annunci organici e il Epsilon Retail Media offerte.
* Dopo l'unione, il browser invia il contenuto combinato al cliente.

### Approccio 2: Unione dopo la visualizzazione al cliente

Questo approccio mostra prima il contenuto organico e unisce gli annunci in un secondo momento, richiedendo modifiche minime al backend e garantendo che gli utenti ricevano un accesso ininterrotto agli annunci organici.

#### Flusso di lavoro

In questo approccio, segui un flusso di lavoro simile a quello precedente; tuttavia, invii i risultati dei prodotti organici al cliente non appena sono disponibili. Dopo la visualizzazione dei risultati organici, unisci e riordini i risultati una volta ricevuto il contenuto da Epsilon Retail Media. È probabile che questo metodo di integrazione richieda meno tempo per essere implementato, poiché richiede risorse di sviluppo minime.

<figure><img src="/files/yb9nqSigDfMBH1vVzEwF" alt="" width="100%"><figcaption></figcaption></figure>

#### Quando vengono inviati gli annunci

Gli annunci organici vengono mostrati inizialmente e il Epsilon Retail Media la risposta viene unita una volta ricevuta dal browser. Occasionalmente, gli elenchi organici vengono mostrati all'utente prima dell'unione e del riordinamento degli annunci di prodotto. Quando Epsilon Retail Media fornisce un elenco di codici prodotto, è comunque necessario recuperare tutte le informazioni dettagliate rilevanti per ciascuno di tali prodotti.

## Confronto dei metodi di integrazione

Ecco un rapido confronto di tutti i diversi metodi di integrazione che puoi utilizzare:

|                               | Integrazione standard                                                 | Singole richieste del browser                                 | Unione dopo la visualizzazione al cliente                                                                     |
| ----------------------------- | --------------------------------------------------------------------- | ------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
| Flusso di lavoro              | Singola richiesta al backend, unione prima della visualizzazione      | Richieste separate per prodotti organici e annunci            | Contenuto organico mostrato per primo, annunci uniti in seguito                                               |
| Modifiche al backend          | Il servizio backend esistente gestisce Epsilon Retail Media richieste | Nuovo servizio backend per Epsilon Retail Media richieste     | Modifiche minime ai servizi backend esistenti                                                                 |
| Sforzo di sviluppo            | Moderato                                                              | Inferiore                                                     | Minimo                                                                                                        |
| Unione degli annunci          | Il backend unisce gli annunci con il contenuto organico               | Il browser unisce gli annunci con il contenuto organico       | Il browser unisce gli annunci con il contenuto organico                                                       |
| Visualizzazione degli annunci | Annunci visualizzati con il contenuto organico                        | Annunci visualizzati con il contenuto organico                | Annunci visualizzati con il contenuto organico                                                                |
| Vantaggi                      | - Integrazione fluida - Elaborazione backend unificata                | - Minori modifiche al backend - Logica degli annunci separata | - Integrazione rapida - Modifiche al backend minime                                                           |
| Svantaggi                     | - Sforzo di sviluppo moderato - Logica degli annunci unificata        | - Servizio backend aggiuntivo - Logica degli annunci separata | - Potenziale ritardo nella visualizzazione degli annunci - Gli annunci si uniscono dopo il contenuto organico |


---

# 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/data-api/api-overview/integration-workflow-options-1.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.