> 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/reporting/reporting-overview.md). # Panoramica ## Architettura fisica L'API di Epsilon Retail Media Reporting fornisce un accesso sicuro al Epsilon Retail Media data warehouse. Il data warehouse stesso contiene dati e insight provenienti dalla Epsilon Retail Media piattaforma. Il Epsilon Retail Media data warehouse è un modello distribuito. Alcuni dati sono conservati localmente all'interno delle Epsilon Retail Media istanze della piattaforma, altri dati in un data warehouse globale e centralizzato. Il diagramma seguente mostra la struttura del modello dati.
| Livello | Descrizione | | ---------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Dati della piattaforma |

Dati di origine dalla Epsilon Retail Media piattaforma. La piattaforma stessa è distribuita su più istanze fisiche. Esiste un'istanza per ogni grande rivenditore o, in alcuni casi, è condivisa in modo sicuro tra diversi rivenditori più piccoli.
L'accesso diretto ai Dati della piattaforma non è consentito a connessioni esterne.

| | Dati Staged |

I Dati della piattaforma rilevanti vengono inseriti nello staging del data warehouse in tempo quasi reale. I Dati Staged vengono mantenuti per ciascuna istanza della piattaforma nella stessa posizione fisica dei Dati della piattaforma.
L'accesso diretto ai Dati Staged generalmente non è consentito a connessioni esterne.

| | Dataset Core |

Su base giornaliera, i processi batch prendono i Dati Staged e li modellano in uno schema snowflake semplice da usare, denominato Dataset Core. Anche il Dataset Core viene mantenuto per ciascuna istanza della piattaforma nella stessa posizione fisica dei Dati Staged e dei Dati della piattaforma.
Ogni fatto del Dataset Core è disponibile sia a livello di singola transazione che a livello di dettaglio aggregato.
Il tracciamento delle modifiche è presente anche su molte dimensioni.
L'accesso diretto ai Dataset Core è consentito (su richiesta) ad alcuni clienti, principalmente a livello di rivenditore (soggetto ad approvazione).

| | Dataset Core aggregati |

Dopo l'aggiornamento dei Dataset Core, i processi batch prendono i singoli Dataset Core e li trasferiscono in una posizione centralizzata (il data warehouse globale). I singoli Dataset Core vengono quindi consolidati in un unico Dataset Core aggregato unificato.
Nota: nel data warehouse globale vengono memorizzati solo i dati di fatto aggregati (non i dati transazionali).
L'accesso diretto al Dataset Core aggregato generalmente non è consentito a connessioni esterne.

| | Datamart di Reporting |

Dopo l'aggiornamento del Dataset Core aggregato, i processi batch giornalieri calcolano un Datamart di Reporting ulteriormente semplificato e aggregato.
Come i Dataset Core, anche il Datamart di Reporting è uno schema snowflake. Vengono offerte solo le versioni correnti delle dimensioni. I clienti devono mantenere lo storico delle modifiche localmente all'interno dei propri data warehouse, come richiesto in base agli snapshot giornalieri.
Il Datamart di Reporting contiene anche viste che arricchiscono determinati fatti e semplificano ulteriormente le query per i clienti.
L'accesso diretto al Datamart di Reporting è consentito (su richiesta) a un'ampia gamma di clienti, sia rivenditori che fornitori (soggetto ad approvazione).

| |

Insight
\[in arrivo]

|

Una serie di viste create sopra il Datamart di Reporting che forniscono Insight predefiniti comunemente richiesti dai clienti. Ad esempio:
Efficacia della campagna (statistiche sugli annunci realizzati, ad es. CTR/ROAS)
Tassi di riempimento dell'inventario (% di richieste soddisfatte con pubblicità a pagamento)
Quota di voce (quota di impressioni del fornitore per categoria/termine di ricerca ecc.)
Fatturazione (spesa del wallet per campagna per periodo di tempo)

L'accesso al livello Insight è consentito (su richiesta) a un'ampia gamma di clienti, sia rivenditori che fornitori (soggetto ad approvazione).
Questo documento condivide anche il codice SQL utilizzato per costruire il livello Insight, in modo che i clienti che copiano il Datamart di Reporting nel proprio data warehouse possano comprendere come replicare facilmente la logica.

| |

Visualizzazione
\[rilascio limitato]

|

Una serie di viste create sopra il Datamart di Reporting e il livello Insight che fornisce i dati equivalenti a quelli visualizzati nella piattaforma BI legacy.
L'accesso al livello di Visualizzazione è attualmente consentito (su richiesta) ai clienti, sia rivenditori che fornitori, che richiedono l'accesso ai dati esattamente come venivano presentati nella nostra piattaforma BI legacy (soggetto ad approvazione).
NOTA: A meno che non vi sia la necessità di riconciliare esattamente i dati con la piattaforma BI legacy, si consiglia di utilizzare invece gli equivalenti del Datamart di Reporting o del livello Insight. Essi contengono anche dati più granulari su archi temporali più lunghi.

| ## Modello dati logico A seconda del tipo di accesso, i dati disponibili includono molte aree tematiche comunemente richieste della Epsilon Retail Media piattaforma, tra cui: (fare riferimento al Glossario per ulteriori definizioni) * Dati dimensionali * Campagne * Cataloghi di prodotti * Prodotti * Team * Rivenditori * Fornitori * Wallet * Termini di ricerca * Categorie * Posizionamenti * Dati di fatto * Statistiche sulle richieste di annunci (numero di richieste per termine di ricerca o categoria ecc.) * Statistiche sugli annunci realizzati (impressioni/clic/spesa pubblicitaria per termine di ricerca o categoria ecc.) * Statistiche di attribuzione avanzate (solo se configurate - visualizzazione impression view-through, attribuzione clic halo, ecc.) * Statistiche sulla spesa delle campagne FTA * Riepiloghi delle transazioni mastro (informazioni di fatturazione, ricariche del portafoglio, ecc.) * Statistiche sugli ordini L'API Reporting viene in genere utilizzata per condividere gli schemi all'interno del Core Dataset e/o del Reporting Datamart. Entrambi questi schemi coprono le aree tematiche sopra menzionate, solo a diversi livelli di aggregazione (con il Core Dataset che offre dettagli a livello di transazione per i fatti e per gli aggregati).
Namespace Diagram
## Tipo di utente Le aree tematiche che sarai in grado di visualizzare saranno limitate in base a ciò che la tua organizzazione ha il diritto di vedere. Esistono 4 tipi di accesso organizzativo: * Livello Namespace: un cliente che controlla un'intera rete di team (sia team di fornitori che di retailer). L'accesso a livello di Namespace concede la visibilità a tutti i dati per una determinata implementazione di Epsilon Retail Media. * Livello Retailer: un cliente che è solo un team di un retailer specifico (o un gruppo di team di retailer). * Livello Fornitore: un cliente che è solo un team di un fornitore specifico (o un gruppo di team di fornitori). * Livello Integratore: un'estensione del livello Fornitore, con la differenza che ha accesso completo a determinati oggetti a livello di Retailer (esclusivamente a discrezione del Retailer). Queste sono le principali aree tematiche coperte e il modo in cui si applicano ai 3 tipi di accesso. | Area tematica | Namespace | Retailer | Fornitore | Integratore | | --------------------------------------------------------------------- | ------------ | ---------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- | | Campagne | Tutti i dati | Relativi al team (o ai team) del Retailer | Relativi al team (o ai team) del Fornitore | Relativi al team (o ai team) del Fornitore | | Cataloghi di prodotti | Tutti i dati | Relativi al team (o ai team) del Retailer | Nessun dato | Relativi al team (o ai team) del Retailer che hanno concesso l'approvazione all'Integratore | | Prodotti | Tutti i dati | Relativi al team (o ai team) del Retailer | Solo per i prodotti presenti nella tabella supplier\_product di Realised Ad Statistics | Relativi al team (o ai team) del Retailer che hanno concesso l'approvazione all'Integratore | | Team | Tutti i dati | Relativi al team (o ai team) del Retailer | Relativi al team (o ai team) del Fornitore | Relativi al team (o ai team) del Fornitore | | Rivenditori | Tutti i dati | Relativi al team (o ai team) del Retailer | Solo per i Retailer presenti nella tabella supplier\_retailer di Realised Ad Statistics | Solo per i Retailer presenti in Realised Ad Statistics | | Fornitori | Tutti i dati | Solo per i Fornitori presenti nella tabella retailer\_supplier di Realised Ad Statistics | Relativi al team (o ai team) del Fornitore | Relativi al team (o ai team) del Fornitore | | Wallet | Tutti i dati | Solo portafogli del team del Retailer | Solo portafogli del team (o dei team) del Fornitore | Solo portafogli del team (o dei team) del Fornitore | | Termini di ricerca | Tutti i dati | Relativi al team (o ai team) del Retailer | Solo per i termini di ricerca presenti in Realised Ad Statistics (appare solo così com'è nella tabella dei fatti) | Solo per i termini di ricerca presenti in Realised Ad Statistics (appare solo così com'è nella tabella dei fatti) | | Categorie | Tutti i dati | Relativi al team (o ai team) del Retailer | Solo per le categorie presenti in Realised Ad Statistics (appare solo così com'è nella tabella dei fatti) | Solo per le categorie presenti in Realised Ad Statistics (appare solo così com'è nella tabella dei fatti) | | Statistiche sulle richieste di annunci | Tutti i dati | Relativi al team (o ai team) del Retailer | Nessun dato | Nessun dato | | Statistiche di attribuzione avanzate | Tutti i dati | Relativi al team (o ai team) del Retailer | Relativi al team (o ai team) del Fornitore | Relativi al team (o ai team) del Fornitore | | Statistiche sulla spesa delle campagne FTA | Tutti i dati | Relativi al team (o ai team) del Retailer | Relativi al team (o ai team) del Fornitore | Relativi al team (o ai team) del Fornitore | | Riepiloghi delle transazioni mastro | Tutti i dati | Solo portafogli del team del Retailer | Solo portafogli del team (o dei team) del Fornitore | Solo portafogli del team (o dei team) del Fornitore | | Statistiche sugli ordini | Tutti i dati | Relativi al team (o ai team) del Retailer | Nessun dato | Nessun dato | | Statistiche degli annunci realizzati (Impression / Clic AdSpend ecc.) | Tutti i dati | Relativi al team (o ai team) del Retailer | Relativi al team (o ai team) del Fornitore | Relativi al team (o ai team) del Fornitore | | Posizionamenti | Tutti i dati | Relativi al team (o ai team) del Retailer | Solo per i posizionamenti che appaiono nelle statistiche sulle richieste di annunci e sugli annunci realizzati. | Relativi al team (o ai team) del Retailer che hanno concesso l'approvazione all'Integratore | ## Metodo di accesso utente Esistono due tipi di metodo di accesso, a seconda delle piattaforme cloud utilizzate. | Tipo di utente | Metodo di accesso | | ----------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Utente nativo Google Cloud Platform (GCP) | Accesso diretto Poiché il nostro data warehouse è distribuito in BigQuery (il servizio di data warehouse di GCP), i clienti che utilizzano GCP saranno in grado di accedere direttamente ai set di dati. Ciò consentirà di visualizzare gli oggetti ed eseguire query tramite l'interfaccia utente di BigQuery nel proprio progetto GCP. È sufficiente fornirci un indirizzo e-mail del proprio progetto GCP e concederemo i privilegi di conseguenza (in attesa di approvazione). Nota: gli utenti con accesso diretto possono anche effettuare chiamate all'API di BigQuery tramite script, ecc. (oltre a utilizzare l'API di BigQuery). | | Altri utenti (non GCP) | API Se non sei su GCP (ad es. Azure o AWS), Epsilon Retail Media creerà un account per te (account di servizio) e fornirà le credenziali (in attesa di approvazione). Questo account ti darà accesso solo a livello di API BigQuery (non sarai in grado di accedere alla console cloud). | Versione: 1ace13f --- # 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/reporting/reporting-overview.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.