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

# Áttekintés

## Fizikai architektúra

A Epsilon Retail Media Reporting API biztonságos hozzáférést biztosít a Epsilon Retail Media adattárházhoz. Maga az adattárház a Epsilon Retail Media platformból származó adatokat és betintéseket tartalmaz.

Az Epsilon Retail Media adattárház egy elosztott modell. Bizonyos adatok helyileg a Epsilon Retail Media platformpéldányokon belül találhatók, más adatok pedig egy központosított, globális adattárházban.

Az alábbi diagram az adatmodell szerkezetét mutatja be.

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

| Réteg                                                    | Leírás                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Platformadatok                                           | <p>Forrásadatok a Epsilon Retail Media platformról. Maga a platform több fizikai példány között van elosztva. Példányonként egy nagy kiskereskedő létezik, vagy bizonyos esetekben biztonságosan meg van osztva több kisebb kiskereskedő között.<br>A platformadatokhoz való közvetlen hozzáférés külső kapcsolatok számára nem engedélyezett.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| Előkészített adatok (Staged Data)                        | <p>A releváns platformadatok közel valós időben kerülnek előkészítésre az adattárházban. Az előkészített adatokat platformpéldányonként ugyanazon a fizikai helyen tartják karban, mint a platformadatokat.<br>Az előkészített adatokhoz való közvetlen hozzáférés általában nem engedélyezett külső kapcsolatok számára.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| Alapadatkészlet (Core Dataset)                           | <p>Napi rendszerességgel kötegelt folyamatok veszik át az előkészített adatokat, és egy egyszerűen használható hópehely-sémába modellezik azokat, amelyet alapadatkészletnek (Core Dataset) neveznek. Az alapadatkészletet platformpéldányonként is ugyanazon a fizikai helyen tartják karban, mint az előkészített adatokat és a platformadatokat.<br>Minden alapadatkészlet-tény mind az egyedi tranzakciók, mind az összesített részletezettség szintjén elérhető.<br>A változások nyomon követése számos dimenzióban jelen van.<br>Az alapadatkészletekhez való közvetlen hozzáférés (kérésre) engedélyezett bizonyos ügyfelek számára, elsősorban kiskereskedői szinten (jóváhagyástól függően).</p>                                                                                                                                                                                   |
| Összesített alapadatkészletek (Aggregated Core Datasets) | <p>Miután az alapadatkészletek frissültek, kötegelt folyamatok veszik az egyedi alapadatkészleteket, és átviszik őket egy központi helyre (a globális adattárházba). Az egyedi alapadatkészleteket ezután egyetlen, egyesített összesített alapadatkészletbe konszolidálják.<br>Megjegyzés: a globális adattárházban csak az összesített tényadatok tárolódnak (tranzakciós adatok nem).<br>Az összesített alapadatkészlethez való közvetlen hozzáférés általában nem engedélyezett külső kapcsolatok számára.</p>                                                                                                                                                                                                                                                                                                                                                                          |
| Jelentéskészítési adatpiac (Reporting Datamart)          | <p>Miután az összesített alapadatkészlet frissült, a napi kötegelt folyamatok egy tovább egyszerűsített és összesített jelentéskészítési adatpiacot számítanak ki.<br>Az alapadatkészletekhez hasonlóan a jelentéskészítési adatpiac is egy hópehely-séma. Csak a dimenziók aktuális verziói érhetők el. Az ügyfeleknek a napi pillanatképek alapján helyileg, a saját adattárházukon belül kell karbantartaniuk a változási előzményeket.<br>A jelentéskészítési adatpiac olyan nézeteket is tartalmaz, amelyek feldíszítenek bizonyos tényeket, és még jobban egyszerűsítik a lekérdezést az ügyfelek számára.<br>A jelentéskészítési adatpiachoz való közvetlen hozzáférés (kérésre) az ügyfelek széles körének engedélyezett, mind a kiskereskedők, mind a beszállítók számára (jóváhagyástól függően).</p>                                                                             |
| <p>Betintések (Insights)<br>\[hamarosan]</p>             | <p>A jelentéskészítési adatpiacra épülő nézetek sorozata, amelyek az ügyfelek által gyakran kért, előre megépített betintéseket (Insights) biztosítják. Például:<br>Kampányhatékonyság (megvalósult hirdetési statisztikák, pl. CTR/ROAS)<br>Készletfeltöltési arányok (a fizetett hirdetésekkel kitöltött kérések %-a)<br>Share of Voice (a beszállító megjelenési aránya kategóriák/keresési kifejezések stb. szerint)<br>Számlázás (pénztárca-költés kampányonként és időszakonként)<br><br>A Betintések réteghez való hozzáférés (kérésre) az ügyfelek széles körének engedélyezett, mind a kiskereskedők, mind a beszállítók számára (jóváhagyástól függően).<br>Ez a dokumentum megosztja az Insights réteg felépítéséhez használt SQL-kódot is, így a jelentéskészítési adatpiacot saját adattárházukba másoló ügyfelek megérthetik, hogyan replikálhatják egyszerűen a logikát.</p> |
| <p>Vizualizáció<br>\[korlátozott kiadás]</p>             | <p>A jelentéskészítési adatpiacra és az Insights rétegre épülő nézetek sorozata, amely a meglévő BI platformon láthatóval egyenértékű adatokat biztosít.<br>A vizualizációs réteghez való hozzáférés jelenleg (kérésre) engedélyezett azon ügyfelek számára, mind a kiskereskedők, mind a beszállítók számára, akik pontosan úgy igénylik az adatokhoz való hozzáférést, ahogyan az a korábbi BI platformunkon megjelent (jóváhagyástól függően).<br>MEGJEGYZÉS: Hacsak nem szükséges a korábbi BI platformmal való pontos egyeztetés, javasolt helyette a jelentéskészítési adatpiac vagy az Insights réteg megfelelőinek használata. Ezek hosszabb időtartamra vonatkozóan részletesebb adatokat is tartalmaznak.</p>                                                                                                                                                                     |

## Logikai adatmodell

A hozzáférési típustól függően a rendelkezésre álló adatok számos gyakran kért Epsilon Retail Media platform-témakört tartalmaznak, mint például:

(a további meghatározásokért kérjük, olvassa el a Szójegyzéket)

* Dimenzióadatok
  * Kampányok
  * Termékkatalógusok
  * Termékek
  * Csapatok
    * Kiskereskedők
    * Beszállítók
  * Pénztárcák
  * Keresési kifejezések
  * Kategóriák
  * Elhelyezések
* Tényadatok
  * Hirdetéskérési statisztikák (kérések száma keresési kifejezés vagy kategória stb. szerint)
  * Megvalósult hirdetési statisztikák (megjelenések/kattintások/hirdetési költés keresési kifejezés vagy kategória stb. szerint)
  * Speciális attribúciós statisztikák (csak ahol konfigurálva van - megtekintéses konverzió, halo kattintásos attribúció stb.)
  * FTA kampányköltési statisztikák
  * Főkönyvi tranzakcióösszegzések (számlázási információk, egyenlegfeltöltések stb.)
  * Rendelési statisztikák

A Reporting API-t jellemzően a Core Dataset és/vagy a Reporting Datamart sémáinak megosztására használják. Mindkét séma lefedi a fent említett tématagolásokat, csak eltérő aggregációs szinteken (a Core Dataset tranzakciószintű részleteket kínál a tényadatokhoz, valamint aggregátumokhoz).

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

## Felhasználótípus

A látható tématagolások köre arra korlátozódik, amire a szervezete jogosult. A szervezeti hozzáférésnek 4 típusa van:

* Névtér szint: Egy ügyfél, aki a teamek egy teljes hálózatát vezérli (mind a beszállítói, mind a kiskereskedői teameket). A névtér szintű hozzáférés láthatóságot biztosít az összes adatra a(z) adott implementációjában Epsilon Retail Media.
* Kiskereskedő szint: Egy ügyfél, aki kifejezetten csak egy kiskereskedői team (vagy kiskereskedői teamek egy csoportja).
* Beszállító szint: Egy ügyfél, aki kifejezetten csak egy beszállítói team (vagy beszállítói teamek egy csoportja).
  * Integrátor szint: A Beszállítói szint kiterjesztése, azzal a kivétellel, hogy teljes hozzáférésük van bizonyos Kiskereskedői szintű objektumokhoz (kizárólag a Kiskereskedő mérlegelése alapján).

Ezek a főbb lefedett tématagolások, és ezek alkalmazása a 3 típusú hozzáférésre.

| Tématagolás                                                                            | Névtér      | Kiskereskedő                                                                      | Beszállító                                                                                                              | Integrátor                                                                                                              |
| -------------------------------------------------------------------------------------- | ----------- | --------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| Kampányok                                                                              | Minden adat | A kiskereskedői team(ek)hez kapcsolódó                                            | A beszállítói team(ek)hez kapcsolódó                                                                                    | A beszállítói team(ek)hez kapcsolódó                                                                                    |
| Termékkatalógusok                                                                      | Minden adat | A kiskereskedői team(ek)hez kapcsolódó                                            | Nincsenek adatok                                                                                                        | Azon kiskereskedői team(ek)hez kapcsolódó, amelyek jóváhagyást adtak az Integrátornak                                   |
| Termékek                                                                               | Minden adat | A kiskereskedői team(ek)hez kapcsolódó                                            | Csak a Realised Ad Statistics supplier\_product táblában megjelenő termékekre                                           | Azon kiskereskedői team(ek)hez kapcsolódó, amelyek jóváhagyást adtak az Integrátornak                                   |
| Csapatok                                                                               | Minden adat | A kiskereskedői team(ek)hez kapcsolódó                                            | A beszállítói team(ek)hez kapcsolódó                                                                                    | A beszállítói team(ek)hez kapcsolódó                                                                                    |
| Kiskereskedők                                                                          | Minden adat | A kiskereskedői team(ek)hez kapcsolódó                                            | Csak a Realised Ad Statistics supplier\_retailer táblában megjelenő kiskereskedőkre                                     | Csak a Realised Ad Statistics-ban megjelenő kiskereskedőkre                                                             |
| Beszállítók                                                                            | Minden adat | Csak a Realised Ad Statistics retailer\_supplier táblában megjelenő beszállítókra | A beszállítói team(ek)hez kapcsolódó                                                                                    | A beszállítói team(ek)hez kapcsolódó                                                                                    |
| Pénztárcák                                                                             | Minden adat | Csak a kiskereskedői team egyenlegei                                              | Csak a beszállítói team(ek) egyenlegei                                                                                  | Csak a beszállítói team(ek) egyenlegei                                                                                  |
| Keresési kifejezések                                                                   | Minden adat | A kiskereskedői team(ek)hez kapcsolódó                                            | Csak a Realised Ad Statistics-ban megjelenő keresési kifejezésekre (csak eredeti formájában jelenik meg a ténytáblában) | Csak a Realised Ad Statistics-ban megjelenő keresési kifejezésekre (csak eredeti formájában jelenik meg a ténytáblában) |
| Kategóriák                                                                             | Minden adat | A kiskereskedői team(ek)hez kapcsolódó                                            | Csak a Realised Ad Statistics-ban megjelenő kategóriákra (csak eredeti formájában jelenik meg a ténytáblában)           | Csak a Realised Ad Statistics-ban megjelenő kategóriákra (csak eredeti formájában jelenik meg a ténytáblában)           |
| Hirdetéskérési statisztikák                                                            | Minden adat | A kiskereskedői team(ek)hez kapcsolódó                                            | Nincsenek adatok                                                                                                        | Nincsenek adatok                                                                                                        |
| Speciális attribúciós statisztikák                                                     | Minden adat | A kiskereskedői team(ek)hez kapcsolódó                                            | A beszállítói team(ek)hez kapcsolódó                                                                                    | A beszállítói team(ek)hez kapcsolódó                                                                                    |
| FTA kampányköltési statisztikák                                                        | Minden adat | A kiskereskedői team(ek)hez kapcsolódó                                            | A beszállítói team(ek)hez kapcsolódó                                                                                    | A beszállítói team(ek)hez kapcsolódó                                                                                    |
| Főkönyvi tranzakcióösszegzések                                                         | Minden adat | Csak a kiskereskedői team egyenlegei                                              | Csak a beszállítói team(ek) egyenlegei                                                                                  | Csak a beszállítói team(ek) egyenlegei                                                                                  |
| Rendelési statisztikák                                                                 | Minden adat | A kiskereskedői team(ek)hez kapcsolódó                                            | Nincsenek adatok                                                                                                        | Nincsenek adatok                                                                                                        |
| Megvalósult hirdetési statisztikák (megjelenések / kattintások, hirdetési költés stb.) | Minden adat | A kiskereskedői team(ek)hez kapcsolódó                                            | A beszállítói team(ek)hez kapcsolódó                                                                                    | A beszállítói team(ek)hez kapcsolódó                                                                                    |
| Elhelyezések                                                                           | Minden adat | A kiskereskedői team(ek)hez kapcsolódó                                            | Csak az Ad Request és a Realised Ad Statistics-ban megjelenő elhelyezésekre.                                            | Azon kiskereskedői team(ek)hez kapcsolódó, amelyek jóváhagyást adtak az Integrátornak                                   |

## Felhasználói hozzáférési mód

Kétféle hozzáférési mód létezik, attól függően, hogy milyen felhőplatformokat használ.

| Felhasználótípus                              | Hozzáférési mód                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| --------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Natív Google Cloud Platform (GCP) felhasználó | Közvetlen hozzáférés Mivel az adattárházunk a BigQueryben (a GCP adattárház-szolgáltatásában) van telepítve, a GCP-t használó ügyfelek közvetlenül hozzáférhetnek az adatbázisokhoz. Ez lehetővé teszi az objektumok megtekintését és lekérdezését a BigQuery UI-n keresztül a saját GCP-projektjében. Csupán egy e-mail-címet kell megadnia a GCP-projektjéből, és mi ennek megfelelően megadjuk a jogosultságokat (a jóváhagyások függvényében). Megjegyzés: A Direct Access felhasználók hívásokat is kezdeményezhetnek a BigQuery API-hoz scripteken keresztül stb. (a BigQuery API használatán kívül). |
| Egyéb (nem GCP) felhasználók                  | API Ha nem GCP-t használ (pl. Azure vagy AWS), akkor a(z) Epsilon Retail Media létrehoz egy fiókot az Ön számára (szolgáltatásfiók), és megadja a hitelesítési adatokat (a jóváhagyások függvényében). Ez a fiók csak BigQuery API szintű hozzáférést biztosít (a felhőkonzolhoz nem fog tudni hozzáférni).                                                                                                                                                                                                                                                                                                 |

Verzió: 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/hu/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.
