> 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/order-data-1.md).

# Dati sugli ordini

Epsilon Retail Media richiede i dati dell'ordine per generare annunci pertinenti. La sincronizzazione degli ordini è anche estremamente utile per le dashboard degli inserzionisti e dei rivenditori all'interno del Epsilon Retail Media portale, poiché gli ordini vengono utilizzati nei calcoli di vendite, conversioni, valore delle vendite e ROAS. Questi dati sono estremamente utili per i team pubblicitari, in quanto possono analizzare l'efficacia degli investimenti e contribuire con un ulteriore budget di spesa.

<figure><img src="/files/tpBaDoGiAyLOl2m8m696" alt="Reporting.png" width="100%"><figcaption><p>Immagine della schermata della campagna</p></figcaption></figure>

## Sincronizzazione dei dati dell'ordine

La sincronizzazione dei dati dell'ordine prevede che il rivenditore invii un customer's **`sessionId`** nella richiesta di annuncio, e poi nella sincronizzazione dei dati dell'ordine con Epsilon Retail Media. Con queste informazioni, Epsilon Retail Media è in grado di verificare il `adId`s fornito per le `sessionId`richieste di annunci del e attribuire di conseguenza all'interno della finestra di attribuzione configurata.

Se desiderato, il `sessionId` può essere sostituito con un identificatore cliente con hash a lungo termine per l'attribuzione tra le sessioni. Per saperne di più, parla con il tuo Technical Account Manager.

<figure><img src="/files/jORnLeVjd6R0YA3S6JJx" alt="Group 95.png" width="100%"><figcaption></figcaption></figure>

#### Requisiti di integrazione

Con questa integrazione, sei tenuto a inviare Epsilon Retail Media l'identificatore di sessione univoco del cliente nella richiesta di annuncio e nella conferma dell'ordine, come nell'esempio seguente:

```json
{
   "orders": [
       {
        "customerId": "npc-s243-ir",
        "catalogId": "6adb93d0-7he4-4d4e-9b47-e5d3714c976a",
        "sessionId": "5cat7-9964-4f",
        "orderDate": "2021-12-02T15:00:00Z",
        "id": "3h30e938-c158-4d78-a0af-b48bbwfrcss4",
        "orderItems": [
            {
                  "gtin": "9891998566P",
                  "quantity": 3,
                  "regularUnitPrice": "1.00",
                  "totalOrderItemPriceAfterDiscounts": "3.00"
                }
              ]
            }
    ]
}
```

{% hint style="info" %}
Questo `sessionId` deve essere identico a quello fornito nella richiesta di annuncio inviata a Epsilon Retail Media.
{% endhint %}


---

# 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/order-data-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.