> 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/fr/reporting/reporting-overview.md). # Présentation ## Architecture physique L'API Epsilon Retail Media Reporting API fournit un accès sécurisé au Epsilon Retail Media data warehouse. Le data warehouse lui-même contient des données et des informations provenant de la Epsilon Retail Media plateforme. Le Epsilon Retail Media data warehouse est un modèle distribué. Certaines données sont conservées localement au sein des Epsilon Retail Media instances de la plateforme, d'autres données dans un data warehouse mondial centralisé. Le schéma suivant montre la structure du modèle de données.
| Couche | Description | | ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Données de la plateforme |

Données sources de la Epsilon Retail Media plateforme. La plateforme elle-même est distribuée sur plusieurs instances physiques. Une instance existe par grand distributeur ou, dans certains cas, est partagée de manière sécurisée entre plusieurs petits distributeurs.
L'accès direct aux données de la plateforme n'est pas autorisé pour les connexions externes.

| | Données intermédiaires |

Les données de la plateforme pertinentes sont transférées en temps quasi réel dans le data warehouse. Les données intermédiaires sont conservées par instance de plateforme au même emplacement physique que les données de la plateforme.
L'accès direct aux données intermédiaires n'est généralement pas autorisé pour les connexions externes.

| | Jeu de données principal |

Chaque jour, des traitements par lots prennent les données intermédiaires et les modélisent selon un schéma en flocon de neige simple à utiliser, appelé jeu de données principal. Le jeu de données principal est également conservé par instance de plateforme au même emplacement physique que les données intermédiaires et les données de la plateforme.
Chaque fait du jeu de données principal est disponible au niveau de détail des transactions individuelles et au niveau agrégé.
Le suivi des modifications est également présent sur de nombreuses dimensions.
L'accès direct aux jeux de données principaux est autorisé (sur demande) à certains clients, principalement au niveau du distributeur (sous réserve d'approbations).

| | Jeux de données principaux agrégés |

Une fois les jeux de données principaux mis à jour, des traitements par lots prennent les jeux de données principaux individuels et les transfèrent vers un emplacement centralisé (le data warehouse mondial). Les jeux de données principaux individuels sont ensuite consolidés dans un seul jeu de données principal agrégé et unifié.
Remarque : seules les données de faits agrégées (et non les données transactionnelles) sont stockées dans le data warehouse mondial.
L'accès direct au jeu de données principal agrégé n'est généralement pas autorisé pour les connexions externes.

| | Datamart de suivi des performances |

Une fois le jeu de données principal agrégé mis à jour, des traitements par lots quotidiens calculent un datamart de suivi des performances encore plus simplifié et agrégé.
Comme les jeux de données principaux, le datamart de suivi des performances est également un schéma en flocon de neige. Seules les versions actuelles des dimensions sont proposées. Les clients doivent maintenir l'historique des modifications localement dans leurs propres data warehouses selon leurs besoins, sur la base de captures quotidiennes.
Le datamart de suivi des performances contient également des vues qui enrichissent certains faits et simplifient encore plus les requêtes pour les clients.
L'accès direct au datamart de suivi des performances est autorisé (sur demande) à un large éventail de clients, tant distributeurs que fournisseurs (sous réserve d'approbations).

| |

Insights
\[bientôt disponible]

|

Une série de vues construites au-dessus du datamart de suivi des performances qui fournissent des Insights préconçus couramment demandés par les clients. Par exemple :
Efficacité de la campagne (statistiques publicitaires réalisées, ex. CTR/ROAS)
Taux de remplissage de l'inventaire (% de requêtes remplies avec de la publicité payante)
Part de voix (part d'impressions du fournisseur par catégorie/terme de recherche etc.)
Facturation (dépenses du portefeuille par campagne par période)

L'accès à la couche Insights est autorisé (sur demande) à un large éventail de clients, tant distributeurs que fournisseurs (sous réserve d'approbations).
Ce document partage également le code SQL utilisé pour construire la couche Insights afin que les clients qui copient le datamart de suivi des performances dans leur data warehouse puissent comprendre comment répliquer facilement la logique.

| |

Visualisation
\[version limitée]

|

Une série de vues construites au-dessus du datamart de suivi des performances et de la couche Insights qui fournit des données équivalentes à celles présentées dans l'ancienne plateforme BI.
L'accès à la couche de visualisation est actuellement autorisé (sur demande) aux clients, tant distributeurs que fournisseurs, qui nécessitent un accès aux données exactement telles qu'elles étaient présentées dans notre ancienne plateforme BI (sous réserve d'approbations).
REMARQUE : À moins d'avoir besoin d'une réconciliation exacte avec l'ancienne plateforme BI, il est conseillé d'utiliser plutôt les équivalents du datamart de suivi des performances ou de la couche Insights. Ils contiennent également des données plus granulaires sur des périodes plus longues.

| ## Modèle logique de données Selon votre type d'accès, les données disponibles incluent de nombreux domaines fonctionnels de la Epsilon Retail Media plateforme couramment demandés, tels que : (veuillez vous référer au lexique pour d'autres définitions) * Données dimensionnelles * Campagnes * Catalogues de produits * Produits * Équipes * Distributeurs * Fournisseurs * Portefeuilles * Termes de recherche * Catégories * Emplacements * Données de faits * Statistiques de requêtes publicitaires (nombre de requêtes par terme de recherche ou catégorie etc.) * Statistiques publicitaires réalisées (impressions/clics/dépenses publicitaires par terme de recherche ou catégorie etc.) * Statistiques d'attribution améliorée (uniquement si configuré - vue d'impression directe, attribution de clics halo, etc.) * Statistiques de dépenses de campagne FTA * Résumés des transactions du grand livre (informations de facturation, recharges de portefeuille, etc.) * Statistiques de commandes L'API de reporting est généralement utilisée pour partager les schémas au sein du jeu de données Core et/ou du Datamart de reporting. Ces deux schémas couvrent les domaines fonctionnels susmentionnés, mais à des niveaux d'agrégation différents (le jeu de données Core offrant des détails au niveau des transactions pour les faits ainsi que des agrégats).
Namespace Diagram
## Type d'utilisateur Les domaines fonctionnels que vous pourrez voir seront restreints selon ce que votre organisation est autorisée à voir. Il existe 4 types d'accès organisationnel : * Niveau Namespace : Un client qui contrôle un réseau entier d'équipes (équipes de fournisseurs et de distributeurs). L'accès au niveau Namespace accorde une visibilité sur toutes les données pour une implémentation donnée de Epsilon Retail Media. * Niveau Distributeur : Un client qui est une équipe de distributeur spécifique (ou un groupe d'équipes de distributeur) uniquement. * Niveau Fournisseur : Un client qui est une équipe de fournisseur spécifique (ou un groupe d'équipes de fournisseur) uniquement. * Niveau Intégrateur : Une extension du niveau Fournisseur, sauf qu'ils ont accès à certains objets du niveau Distributeur dans leur totalité (à la seule discrétion du distributeur). Voici les principaux domaines fonctionnels couverts et la façon dont ils s'appliquent aux 3 types d'accès. | Domaine fonctionnel | Namespace | Distributeur | Fournisseur | Intégrateur | | ----------------------------------------------------------------------- | ------------------ | ----------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | | Campagnes | Toutes les données | Lié à l'équipe ou aux équipes du distributeur | Lié à l'équipe ou aux équipes du fournisseur | Lié à l'équipe ou aux équipes du fournisseur | | Catalogues de produits | Toutes les données | Lié à l'équipe ou aux équipes du distributeur | Aucune donnée | Lié à l'équipe ou aux équipes du distributeur qui ont accordé l'approbation à l'intégrateur | | Produits | Toutes les données | Lié à l'équipe ou aux équipes du distributeur | Uniquement pour les produits apparaissant dans la table supplier\_product des statistiques publicitaires réalisées | Lié à l'équipe ou aux équipes du distributeur qui ont accordé l'approbation à l'intégrateur | | Équipes | Toutes les données | Lié à l'équipe ou aux équipes du distributeur | Lié à l'équipe ou aux équipes du fournisseur | Lié à l'équipe ou aux équipes du fournisseur | | Distributeurs | Toutes les données | Lié à l'équipe ou aux équipes du distributeur | Uniquement pour les distributeurs apparaissant dans la table supplier\_retailer des statistiques publicitaires réalisées | Uniquement pour les distributeurs apparaissant dans les statistiques publicitaires réalisées | | Fournisseurs | Toutes les données | Uniquement pour les fournisseurs apparaissant dans la table retailer\_supplier des statistiques publicitaires réalisées | Lié à l'équipe ou aux équipes du fournisseur | Lié à l'équipe ou aux équipes du fournisseur | | Portefeuilles | Toutes les données | Portefeuilles de l'équipe du distributeur uniquement | Portefeuilles de l'équipe ou des équipes du fournisseur uniquement | Portefeuilles de l'équipe ou des équipes du fournisseur uniquement | | Termes de recherche | Toutes les données | Lié à l'équipe ou aux équipes du distributeur | Uniquement pour les termes de recherche apparaissant dans les statistiques publicitaires réalisées (apparaît uniquement en l'état dans la table de faits) | Uniquement pour les termes de recherche apparaissant dans les statistiques publicitaires réalisées (apparaît uniquement en l'état dans la table de faits) | | Catégories | Toutes les données | Lié à l'équipe ou aux équipes du distributeur | Uniquement pour les catégories apparaissant dans les statistiques publicitaires réalisées (apparaît uniquement en l'état dans la table de faits) | Uniquement pour les catégories apparaissant dans les statistiques publicitaires réalisées (apparaît uniquement en l'état dans la table de faits) | | Statistiques de requêtes publicitaires | Toutes les données | Lié à l'équipe ou aux équipes du distributeur | Aucune donnée | Aucune donnée | | Statistiques d'attribution améliorée | Toutes les données | Lié à l'équipe ou aux équipes du distributeur | Lié à l'équipe ou aux équipes du fournisseur | Lié à l'équipe ou aux équipes du fournisseur | | Statistiques de dépenses de campagne FTA | Toutes les données | Lié à l'équipe ou aux équipes du distributeur | Lié à l'équipe ou aux équipes du fournisseur | Lié à l'équipe ou aux équipes du fournisseur | | Résumés des transactions du grand livre | Toutes les données | Portefeuilles de l'équipe du distributeur uniquement | Portefeuilles de l'équipe ou des équipes du fournisseur uniquement | Portefeuilles de l'équipe ou des équipes du fournisseur uniquement | | Statistiques de commandes | Toutes les données | Lié à l'équipe ou aux équipes du distributeur | Aucune donnée | Aucune donnée | | Statistiques publicitaires réalisées (Impressions / Clicks AdSpend etc) | Toutes les données | Lié à l'équipe ou aux équipes du distributeur | Lié à l'équipe ou aux équipes du fournisseur | Lié à l'équipe ou aux équipes du fournisseur | | Emplacements | Toutes les données | Lié à l'équipe ou aux équipes du distributeur | Uniquement pour les emplacements apparaissant dans les statistiques de requêtes publicitaires et de publicités réalisées. | Lié à l'équipe ou aux équipes du distributeur qui ont accordé l'approbation à l'intégrateur | ## Méthode d'accès utilisateur Deux types de méthodes d'accès existent, selon les plateformes cloud que vous utilisez. | Type d'utilisateur | Méthode d'accès | | --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Utilisateur natif Google Cloud Platform (GCP) | Accès direct Comme notre entrepôt de données est déployé dans BigQuery (le service d'entrepôt de données de GCP), les clients qui sont eux-mêmes sur GCP pourront accéder directement aux jeux de données. Cela vous permettra de voir les objets et de les interroger via l'interface utilisateur de BigQuery dans votre propre projet GCP. Il vous suffit de nous fournir une adresse e-mail de votre projet GCP et nous vous accorderons les privilèges en conséquence (en attente d'approbation). Notez que les utilisateurs avec accès direct peuvent également passer des appels à l'API BigQuery via des scripts, etc. (en plus d'utiliser l'API BigQuery). | | Autres utilisateurs (non GCP) | API Si vous n'êtes pas sur GCP (par exemple Azure ou AWS), alors Epsilon Retail Media créera un compte pour vous (compte de service) et fournira les identifiants (en attente d'approbation). Ce compte vous donnera uniquement un accès au niveau de l'API BigQuery (vous ne pourrez pas accéder à la console cloud). | 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/fr/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.