> 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/cs/reporting/reporting-overview.md). # Přehled ## Fyzická architektura Reporting API poskytuje zabezpečený přístup k datovému skladu Epsilon Retail Media Reporting API poskytuje zabezpečený přístup k Epsilon Retail Media datovému skladu. Sám datový sklad obsahuje data a poznatky pocházející z platformy Epsilon Retail Media . Datový sklad Epsilon Retail Media má distribuovaný model. Některá data jsou uchovávána lokálně v rámci instancí platformy Epsilon Retail Media , jiná data v centralizovaném, globálním datovém skladu. Následující diagram znázorňuje strukturu datového modelu.
| Vrstva | Popis | | ----------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Platformová data |

Zdrojová data z platformy Epsilon Retail Media . Platforma sama je distribuována napříč několika fyzickými instancemi. Instance existuje pro každého velkého prodejce, nebo je v některých případech bezpečně sdílena mezi několika menšími prodejci.
Přímý přístup k platformovým datům není pro externí připojení povolen.

| | Připravená data (Staged Data) |

Relevantní platformová data jsou v téměř reálném čase připravována do datového skladu. Připravená data jsou udržována pro každou instanci platformy ve stejné fyzické lokaci jako platformová data.
Přímý přístup k připraveným datům není obecně pro externí připojení povolen.

| | Základní datová sada (Core Dataset) |

Na denní bázi přebírají dávkové procesy připravená data a modelují je do snadno použitelného schématu sněhové vločky označovaného jako Core Dataset. Core Dataset je rovněž udržován pro každou instanci platformy ve stejné fyzické lokaci jako připravená data a platformová data.
Každá fakta v Core Datasetu jsou k dispozici jak na úrovni jednotlivých transakcí, tak na agregované úrovni detailu.
Sledování změn je k dispozici také u mnoha dimenzí.
Přímý přístup k Core Datasets je povolen (na vyžádání) určitým klientům, především na úrovni prodejců (podléhá schválení).

| | Agregované základní datové sady |

Po aktualizaci Core Datasets přebírají dávkové procesy jednotlivé Core Datasets a přenášejí je do centralizovaného místa (globálního datového skladu). Jednotlivé Core Datasets jsou pak konsolidovány do jediné, sjednocené Aggregated Core Dataset.
Poznámka: v globálním datovém skladu jsou uložena pouze agregovaná faktická data (nikoli transakční data).
Přímý přístup k Aggregated Core Dataset není obecně pro externí připojení povolen.

| | Reporting Datamart |

Po aktualizaci Aggregated Core Dataset vypočítávají denní dávkové procesy dále zjednodušený a agregovaný Reporting Datamart.
Stejně jako Core Datasets je i Reporting Datamart schématem sněhové vločky. Nabízeny jsou pouze aktuální verze dimenzí. Klienti si musí udržovat historii změn lokálně ve svých vlastních datových skladech podle potřeby na základě denních snímků.
Reporting Datamart obsahuje také pohledy, které doplňují určitá fakta a ještě více zjednodušují dotazování klientům.
Přímý přístup k Reporting Datamartu je povolen (na vyžádání) široké škále klientů, jak prodejcům, tak dodavatelům (podléhá schválení).

| |

Poznatky (Insights)
\[již brzy]

|

Série pohledů vytvořených nad Reporting Datamartem, které poskytují předpřipravené poznatky (Insights) běžně požadované klienty. Například:
Efektivita kampaně (statistiky realizovaných reklam, např. CTR/ROAS)
Míra naplnění inventáře (% žádostí naplněných placenou reklamou)
Share of Voice (podíl dodavatele na zobrazeních podle kategorie/vyhledávaného výrazu atd.)
Fakturace (výdaje z peněženky za kampaň za časové období)

Přístup ke vrstvě Insights je povolen (na vyžádání) široké škále klientů, jak prodejcům, tak dodavatelům (podléhá schválení).
Tento dokument také sdílí kód SQL použitý k vytvoření vrstvy Insights, aby klienti, kteří kopírují Reporting Datamart do svého datového skladu, pochopili, jak tuto logiku snadno replikovat.

| |

Vizualizace
\[omezené vydání]

|

Série pohledů vytvořených nad vrstvou Reporting Datamart a Insights, které poskytují ekvivalentní data jako v původní BI platformě.
Přístup k vizualizační vrstvě je v současné době povolen (na vyžádání) klientům, jak prodejcům, tak dodavatelům, kteří vyžadují přístup k datům přesně tak, jak byla prezentována v naší původní BI platformě (podléhá schválení).
POZNÁMKA: Pokud není potřeba provést přesné odsouhlasení s původní BI platformou, doporučuje se místo toho použít ekvivalenty z vrstvy Reporting Datamart nebo Insights. Ty navíc obsahují detailnější data za delší časová období.

| ## Logický datový model V závislosti na vašem typu přístupu zahrnují dostupná data mnoho běžně požadovaných Epsilon Retail Media tematických oblastí platformy, jako například: (další definice naleznete v Slovníku) * Dimenzionální data * Kampaně * Katalogy produktů * Produkty * Týmy * Prodejci * Dodavatelé * Peněženky * Vyhledávané výrazy * Kategorie * Umístění * Faktická data * Statistiky žádostí o reklamu (počet žádostí podle vyhledávaného výrazu nebo kategorie atd.) * Statistiky realizovaných reklam (zobrazení/kliknutí/výdaje na reklamu podle vyhledávaného výrazu nebo kategorie atd.) * Rozšířené statistiky atribučního modelu (pouze kde je nakonfigurováno – zobrazení na základě imprese, atribuční model pro kliknutí halo efektu atd.) * Statistiky útrat za kampaně FTA * Přehledy transakcí v účetní knize (fakturační údaje, dobití peněženky atd.) * Statistiky objednávek Reporting API se obvykle používá ke sdílení schémat v rámci Core Dataset a/nebo Reporting Datamart. Obě tato schémata pokrývají výše uvedené tematické oblasti, pouze na různých úrovních agregace (Core Dataset nabízí podrobnosti na úrovni transakcí pro fakta i agregáty).
Namespace Diagram
## Typ uživatele Tematické oblasti, které budete moci vidět, budou omezeny podle toho, k čemu má vaše organizace oprávnění. Existují 4 typy přístupu organizace: * Úroveň Namespace: Klient, který řídí celou síť týmů (týmy dodavatele i prodejce). Přístup na úrovni Namespace uděluje viditelnost pro všechny údaje pro danou implementaci Epsilon Retail Media. * Úroveň Retailer: Klient, který je pouze konkrétním týmem prodejce (nebo skupinou týmů prodejce). * Úroveň Supplier: Klient, který je pouze konkrétním týmem dodavatele (nebo skupinou týmů dodavatele). * Úroveň Integrator: Rozšíření úrovně Supplier s tím rozdílem, že mají plný přístup k určitým objektům na úrovni Retailer (pouze na základě uvážení prodejce). Toto jsou hlavní pokrývané tematické oblasti a způsob, jakým se vztahují na 3 typy přístupu. | Tematická oblast | Namespace | Retailer | Supplier | Integrator | | ---------------------------------------------------------------------------- | ------------ | ---------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- | | Kampaně | Všechna data | Související s týmem/týmy prodejce | Související s týmem/týmy dodavatele | Související s týmem/týmy dodavatele | | Katalogy produktů | Všechna data | Související s týmem/týmy prodejce | Žádná data | Související s týmem/týmy prodejce, které udělily schválení integrátorovi | | Produkty | Všechna data | Související s týmem/týmy prodejce | Pouze pro produkty vystupující pouze v tabulce supplier\_product ve statistikách Realised Ad Statistics | Související s týmem/týmy prodejce, které udělily schválení integrátorovi | | Týmy | Všechna data | Související s týmem/týmy prodejce | Související s týmem/týmy dodavatele | Související s týmem/týmy dodavatele | | Prodejci | Všechna data | Související s týmem/týmy prodejce | Pouze pro prodejce vystupující pouze v tabulce supplier\_retailer ve statistikách Realised Ad Statistics | Pouze pro prodejce vystupující ve statistikách Realised Ad Statistics | | Dodavatelé | Všechna data | Pouze pro dodavatele vystupující pouze v tabulce retailer\_supplier ve statistikách Realised Ad Statistics | Související s týmem/týmy dodavatele | Související s týmem/týmy dodavatele | | Peněženky | Všechna data | Pouze peněženky týmu prodejce | Pouze peněženky týmu/týmů dodavatele | Pouze peněženky týmu/týmů dodavatele | | Vyhledávané výrazy | Všechna data | Související s týmem/týmy prodejce | Pouze pro vyhledávané výrazy vystupující ve statistikách Realised Ad Statistics (zobrazuje se pouze tak, jak je v tabulce faktů) | Pouze pro vyhledávané výrazy vystupující ve statistikách Realised Ad Statistics (zobrazuje se pouze tak, jak je v tabulce faktů) | | Kategorie | Všechna data | Související s týmem/týmy prodejce | Pouze pro kategorie vystupující ve statistikách Realised Ad Statistics (zobrazuje se pouze tak, jak je v tabulce faktů) | Pouze pro kategorie vystupující ve statistikách Realised Ad Statistics (zobrazuje se pouze tak, jak je v tabulce faktů) | | Statistiky požadavků na reklamu | Všechna data | Související s týmem/týmy prodejce | Žádná data | Žádná data | | Rozšířené statistiky atribučního modelu | Všechna data | Související s týmem/týmy prodejce | Související s týmem/týmy dodavatele | Související s týmem/týmy dodavatele | | Statistiky útrat za kampaně FTA | Všechna data | Související s týmem/týmy prodejce | Související s týmem/týmy dodavatele | Související s týmem/týmy dodavatele | | Přehledy transakcí v účetní knize | Všechna data | Pouze peněženky týmu prodejce | Pouze peněženky týmu/týmů dodavatele | Pouze peněženky týmu/týmů dodavatele | | Statistiky objednávek | Všechna data | Související s týmem/týmy prodejce | Žádná data | Žádná data | | Statistiky realizovaných reklam (imprese / kliknutí, útrata za reklamu atd.) | Všechna data | Související s týmem/týmy prodejce | Související s týmem/týmy dodavatele | Související s týmem/týmy dodavatele | | Umístění | Všechna data | Související s týmem/týmy prodejce | Pouze pro umísťování vystupující ve statistikách Ad Request a Realised Ad Statistics. | Související s týmem/týmy prodejce, které udělily schválení integrátorovi | ## Metoda přístupu uživatele Existují dva typy metod přístupu v závislosti na tom, jaké cloudové platformy používáte. | Typ uživatele | Metoda přístupu | | -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Nativní uživatel Google Cloud Platform (GCP) | Přímý přístup Jelikož je náš datový sklad nasazen v BigQuery (služba datového skladu GCP), klienti, kteří sami používají GCP, budou moci k datovým sadám přistupovat přímo. To vám umožní zobrazit objekty a dotazovat se na ně prostřednictvím uživatelského rozhraní BigQuery ve vašem vlastním projektu GCP. Stačí nám poskytnout e-mailovou adresu z vašeho projektu GCP a my vám udělíme příslušná oprávnění (po schválení). Poznámka: Uživatelé s přímým přístupem mohou také provádět volání do BigQuery API pomocí skriptů atd. (kromě použití rozhraní BigQuery API). | | Ostatní uživatelé (mimo GCP) | API Pokud nejste v GCP (např. Azure nebo AWS), pak Epsilon Retail Media pro vás vytvoří účet (servisní účet) a poskytne přihlašovací údaje (po schválení). Tento účet vám poskytne přístup pouze na úrovni BigQuery API (nebudete moci přistupovat ke cloudové konzoli). | Verze: 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/cs/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.