> 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/de/reporting/reporting-overview.md).

# Übersicht

## Physische Architektur

Die Epsilon Retail Media Reporting-API bietet sicheren Zugriff auf das Epsilon Retail Media Data Warehouse. Das Data Warehouse selbst enthält Daten und Erkenntnisse aus der Epsilon Retail Media Plattform.

Das Epsilon Retail Media Data Warehouse ist ein verteiltes Modell. Einige Daten werden lokal innerhalb der Epsilon Retail Media Plattform-Instanzen aufbewahrt, andere Daten in einem zentralen, globalen Data Warehouse.

Das folgende Diagramm zeigt die Struktur des Datenmodells.

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

| Ebene                                               | Beschreibung                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| --------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Plattformdaten                                      | <p>Quelldaten aus der Epsilon Retail Media Plattform. Die Plattform selbst ist über mehrere physische Instanzen verteilt. Eine Instanz existiert pro großem Einzelhändler oder ist in einigen Fällen sicher auf mehrere kleinere Einzelhändler aufgeteilt.<br>Der direkte Zugriff auf Plattformdaten ist für externe Verbindungen nicht gestattet.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| Staging-Daten                                       | <p>Relevante Plattformdaten werden in nahe zu Echtzeit im Data Warehouse bereitgestellt (Staging). Die Staging-Daten werden pro Plattform-Instanz am selben physischen Standort wie die Plattformdaten verwaltet.<br>Der direkte Zugriff auf Staging-Daten ist externen Verbindungen im Allgemeinen nicht gestattet.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| Kern-Datensatz                                      | <p>Auf täglicher Basis übernehmen Batch-Prozesse Staging-Daten und modellieren sie in ein einfach zu verwendendes Snowflake-Schema, das als Kern-Datensatz bezeichnet wird. Der Kern-Datensatz wird ebenfalls pro Plattform-Instanz am selben physischen Standort wie die Staging-Daten und Plattformdaten verwaltet.<br>Jeder Fakt des Kern-Datensatzes ist sowohl auf der Ebene der einzelnen Transaktion als auch auf aggregierter Detailebene verfügbar.<br>Die Nachverfolgung von Änderungen ist auch in vielen Dimensionen vorhanden.<br>Der direkte Zugriff auf Kern-Datensätze ist bestimmten Kunden (auf Anfrage) hauptsächlich auf Einzelhändlerebene gestattet (vorbehaltlich Genehmigungen).</p>                                                                                                                                                                                             |
| Aggregierte Kern-Datensätze                         | <p>Nachdem die Kern-Datensätze aktualisiert wurden, übernehmen Batch-Prozesse die einzelnen Kern-Datensätze und übertragen sie an einen zentralen Ort (das globale Data Warehouse). Die einzelnen Kern-Datensätze werden dann zu einem einzigen, einheitlichen Aggregierten Kern-Datensatz konsolidiert.<br>Hinweis: Im globalen Data Warehouse werden nur aggregierte Fakten-Daten (keine Transaktionsdaten) gespeichert.<br>Der direkte Zugriff auf den Aggregierten Kern-Datensatz ist externen Verbindungen im Allgemeinen nicht gestattet.</p>                                                                                                                                                                                                                                                                                                                                                      |
| Reporting Datamart                                  | <p>Nachdem der Aggregierte Kern-Datensatz aktualisiert wurde, berechnen tägliche Batch-Prozesse einen weiter vereinfachten und aggregierten Reporting Datamart.<br>Wie die Kern-Datensätze ist auch der Reporting Datamart ein Snowflake-Schema. Es werden nur aktuelle Versionen von Dimensionen angeboten. Kunden müssen den Änderungsverlauf lokal in ihren eigenen Data Warehouses verwalten, wie es auf der Grundlage täglicher Snapshots erforderlich ist.<br>Der Reporting Datamart enthält auch Ansichten, die bestimmte Fakten anreichern und Abfragen für Kunden noch weiter vereinfachen.<br>Der direkte Zugriff auf den Reporting Datamart ist einer Vielzahl von Kunden, sowohl Einzelhändlern als auch Lieferanten, (auf Anfrage) gestattet (vorbehaltlich Genehmigungen).</p>                                                                                                             |
| <p>Insights<br>\[demnächst verfügbar]</p>           | <p>Eine Reihe von Ansichten, die auf dem Reporting Datamart aufgebaut sind und vordefinierte Insights bieten, die häufig von Kunden angefordert werden. Zum Beispiel:<br>Kampagneneffektivität (Realisierte Anzeigenstatistiken, z. B. CTR/ROAS)<br>Inventar-Ausfüllraten (% der Anfragen, die mit bezahlter Werbung gefüllt werden)<br>Share of Voice (Lieferantenanteil an Impressionen nach Kategorie/Suchbegriff usw.)<br>Abrechnung (Wallet-Ausgaben pro Kampagne pro Zeitverlauf)<br><br>Der Zugriff auf die Insights-Ebene ist einer Vielzahl von Kunden, sowohl Einzelhändlern als auch Lieferanten, (auf Anfrage) gestattet (vorbehaltlich Genehmigungen).<br>Dieses Dokument enthält auch SQL-Code, der zum Erstellen der Insights-Ebene verwendet wird, damit Kunden, die den Reporting Datamart in ihr Data Warehouse kopieren, verstehen, wie die Logik einfach repliziert werden kann.</p> |
| <p>Visualisierung<br>\[eingeschränkte Freigabe]</p> | <p>Eine Reihe von Ansichten, die auf dem Reporting Datamart und der Insights-Ebene aufgebaut sind und die gleichen Daten bieten, wie sie in der Legacy-BI-Plattform angezeigt werden.<br>Der Zugriff auf die Visualisierungsebene ist derzeit (auf Anfrage) Kunden gestattet, sowohl Einzelhändlern als auch Lieferanten, die Zugriff auf Daten genau so benötigen, wie sie in unserer Legacy-BI-Plattform dargestellt wurden (vorbehaltlich Genehmigungen).<br>HINWEIS: Sofern nicht die Notwendigkeit besteht, einen genauen Abgleich mit der Legacy-BI-Plattform durchzuführen, wird empfohlen, stattdessen die Entsprechungen des Reporting Datamart oder der Insights-Ebene zu verwenden. Diese enthalten auch granularere Daten über längere Zeiträume.</p>                                                                                                                                        |

## Logisches Datenmodell

Je nach Ihrem Zugriffstyp umfassen die verfügbaren Daten viele häufig angeforderte Epsilon Retail Media Plattform-Themenbereiche wie:

(wichtige Definitionen entnehmen Sie bitte dem Glossar)

* Dimensionale Daten
  * Kampagnen
  * Produktkataloge
  * Produkte
  * Teams
    * Einzelhändler
    * Lieferanten
  * Wallets
  * Suchbegriffe
  * Kategorien
  * Platzierungen
* Fakten-Daten
  * Anzeigen-Request-Statistiken (Anzahl der Anfragen nach Suchbegriff oder Kategorie usw.)
  * Realisierte Anzeigenstatistiken (Impressionen/Klicks/Werbeausgaben nach Suchbegriff oder Kategorie usw.)
  * Erweiterte Zuordnungsstatistiken (nur wenn konfiguriert - Impression View-Through, Halo-Klick-Zuordnung usw.)
  * FTA-Kampagnenausgabenstatistiken
  * Hauptbuch-Transaktionszusammenfassungen (Abrechnungsinformationen, Guthabenaufladungen usw.)
  * Bestellstatistiken

Die Reporting API wird normalerweise verwendet, um die Schemas innerhalb des Core Datasets und/oder des Reporting Datamarts zu teilen. Beide Schemas decken die oben genannten Themenbereiche ab, nur auf unterschiedlichen Aggregationsebenen (wobei das Core Dataset Details auf Transaktionsebene für Fakten sowie Aggregate bietet).

<figure><img src="/files/acX6lrtWUcyXQ768NqR5" alt="Namespace Diagram" width="100%"><figcaption></figcaption></figure>

## Benutzertyp

Die Themenbereiche, die Sie sehen können, sind entsprechend den Berechtigungen Ihrer Organisation eingeschränkt. Es gibt 4 Arten von Organisationszugriffen:

* Namespace-Ebene: Ein Kunde, der ein gesamtes Netzwerk von Teams (sowohl Lieferanten- als auch Händler-Teams) steuert. Der Zugriff auf Namespace-Ebene gewährt Einblick in alle Daten für eine bestimmte Implementierung von Epsilon Retail Media.
* Händler-Ebene: Ein Kunde, der nur ein bestimmtes Händler-Team (oder eine Gruppe von Händler-Teams) ist.
* Lieferanten-Ebene: Ein Kunde, der nur ein bestimmtes Lieferanten-Team (oder eine Gruppe von Lieferanten-Teams) ist.
  * Integrator-Ebene: Eine Erweiterung der Lieferanten-Ebene, mit der Ausnahme, dass diese vollen Zugriff auf bestimmte Objekte auf Händler-Ebene haben (nur nach Ermessen des Händlers).

Dies sind die wichtigsten abgedeckten Themenbereiche und wie sie für die 3 Zugriffsarten gelten.

| Themenbereich                                                       | Namespace  | Händler                                                                                                  | Lieferant                                                                                                          | Integrator                                                                                                         |
| ------------------------------------------------------------------- | ---------- | -------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------ |
| Kampagnen                                                           | Alle Daten | Bezogen auf das/die Händler-Team(s)                                                                      | Bezogen auf das/die Lieferanten-Team(s)                                                                            | Bezogen auf Lieferanten-Team(s)                                                                                    |
| Produktkataloge                                                     | Alle Daten | Bezogen auf das/die Händler-Team(s)                                                                      | Keine Daten                                                                                                        | Bezogen auf das/die Händler-Team(s), die dem Integrator die Genehmigung erteilt haben                              |
| Produkte                                                            | Alle Daten | Bezogen auf das/die Händler-Team(s)                                                                      | Nur für Produkte, die nur in der Tabelle supplier\_product der Realised Ad Statistics erscheinen                   | Bezogen auf das/die Händler-Team(s), die dem Integrator die Genehmigung erteilt haben                              |
| Teams                                                               | Alle Daten | Bezogen auf das/die Händler-Team(s)                                                                      | Bezogen auf das/die Lieferanten-Team(s)                                                                            | Bezogen auf das/die Lieferanten-Team(s)                                                                            |
| Einzelhändler                                                       | Alle Daten | Bezogen auf das/die Händler-Team(s)                                                                      | Nur für Händler, die nur in der Tabelle supplier\_retailer der Realised Ad Statistics erscheinen                   | Nur für Händler, die in Realised Ad Statistics erscheinen                                                          |
| Lieferanten                                                         | Alle Daten | Nur für die Lieferanten, die nur in der Tabelle retailer\_supplier der Realised Ad Statistics erscheinen | Bezogen auf das/die Lieferanten-Team(s)                                                                            | Bezogen auf das/die Lieferanten-Team(s)                                                                            |
| Wallets                                                             | Alle Daten | Nur Händler-Team-Guthaben                                                                                | Nur Lieferanten-Team-Guthaben                                                                                      | Nur Lieferanten-Team-Guthaben                                                                                      |
| Suchbegriffe                                                        | Alle Daten | Bezogen auf das/die Händler-Team(s)                                                                      | Nur für Suchbegriffe, die in Realised Ad Statistics erscheinen (erscheint nur so wie sie ist in der Faktentabelle) | Nur für Suchbegriffe, die in Realised Ad Statistics erscheinen (erscheint nur so wie sie ist in der Faktentabelle) |
| Kategorien                                                          | Alle Daten | Bezogen auf das/die Händler-Team(s)                                                                      | Nur für Kategorien, die in Realised Ad Statistics erscheinen (erscheint nur so wie sie ist in der Faktentabelle)   | Nur für Kategorien, die in Realised Ad Statistics erscheinen (erscheint nur so wie sie ist in der Faktentabelle)   |
| Anzeigenanfragenstatistiken                                         | Alle Daten | Bezogen auf das/die Händler-Team(s)                                                                      | Keine Daten                                                                                                        | Keine Daten                                                                                                        |
| Erweiterte Zuordnungsstatistiken                                    | Alle Daten | Bezogen auf das/die Händler-Team(s)                                                                      | Bezogen auf das/die Lieferanten-Team(s)                                                                            | Bezogen auf das/die Lieferanten-Team(s)                                                                            |
| FTA-Kampagnenausgabenstatistiken                                    | Alle Daten | Bezogen auf das/die Händler-Team(s)                                                                      | Bezogen auf das/die Lieferanten-Team(s)                                                                            | Bezogen auf das/die Lieferanten-Team(s)                                                                            |
| Hauptbuch-Transaktionszusammenfassungen                             | Alle Daten | Nur Händler-Team-Guthaben                                                                                | Nur Lieferanten-Team-Guthaben                                                                                      | Nur Lieferanten-Team-Guthaben                                                                                      |
| Bestellstatistiken                                                  | Alle Daten | Bezogen auf das/die Händler-Team(s)                                                                      | Keine Daten                                                                                                        | Keine Daten                                                                                                        |
| Realisierte Anzeigenstatistiken (Impressions / Clicks AdSpend usw.) | Alle Daten | Bezogen auf das/die Händler-Team(s)                                                                      | Bezogen auf das/die Lieferanten-Team(s)                                                                            | Bezogen auf das/die Lieferanten-Team(s)                                                                            |
| Platzierungen                                                       | Alle Daten | Bezogen auf das/die Händler-Team(s)                                                                      | Nur für Platzierungen, die in Anzeigenanfragen- und realisierten Anzeigenstatistiken erscheinen.                   | Bezogen auf das/die Händler-Team(s), die dem Integrator die Genehmigung erteilt haben                              |

## Benutzerzugriffsmethode

Es gibt zwei Arten von Zugriffsmethoden, je nachdem, welche Cloud-Plattformen Sie verwenden.

| Benutzertyp                                  | Zugriffsmethode                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| -------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Nativer Google Cloud Platform (GCP)-Benutzer | Direkter Zugriff Da unser Data Warehouse in BigQuery (dem Data-Warehouse-Dienst von GCP) bereitgestellt wird, können Kunden, die sich selbst in GCP befinden, direkt auf die Datensätze zugreifen. Dadurch können Sie die Objekte über die BigQuery-Benutzeroberfläche in Ihrem eigenen GCP-Projekt anzeigen und abfragen. Sie müssen uns lediglich eine E-Mail-Adresse aus Ihrem GCP-Projekt mitteilen, und wir gewähren die entsprechenden Berechtigungen (ausstehende Genehmigungen vorbehalten). Hinweis: Benutzer mit direktem Zugriff können auch Aufrufe an die BigQuery API über Skripte usw. tätigen (zusätzlich zur Nutzung der BigQuery API). |
| Andere (nicht GCP-)Benutzer                  | API Wenn Sie sich nicht in GCP befinden (z. B. Azure oder AWS), dann Epsilon Retail Media wird ein Konto für Sie erstellen (Service Account) und die Anmeldedaten bereitstellen (ausstehende Genehmigungen vorbehalten). Dieses Konto gewährt Ihnen nur Zugriff auf BigQuery API-Ebene (Sie können nicht auf die Cloud-Konsole zugreifen).                                                                                                                                                                                                                                                                                                               |

Version: 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/de/reporting/reporting-overview.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.
