Architecture physique
L'API de reporting CitrusAd offre un accès sécurisé à l'entrepôt de données CitrusAd. L'entrepôt de données lui-même contient des données et des informations provenant de la plateforme CitrusAd.
L'entrepôt de données CitrusAd est un modèle distribué. Certaines données sont conservées localement dans les instances de la plateforme CitrusAd, et d'autres le sont dans un entrepôt de données global centralisé.
Le diagramme suivant illustre la structure du modèle de données.
| Couche | Description |
|---|---|
| Données de la plateforme | Source des données de la plateforme CitrusAd. La plateforme elle-même est distribuée sur plusieurs instances physiques. Une instance existe par grand détaillant, ou, dans certains cas, est partagée en toute sécurité entre plusieurs détaillants plus petits. L'accès direct aux données de la plateforme n'est pas autorisé par des connexions externes. |
| Données intermédiaires | Les données pertinentes de la plateforme sont stockées dans l'entrepôt de données en temps quasi réel. Les données intermédiaires sont conservées par instance de la plateforme, dans le 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é par des connexions externes. |
| Ensemble de données de base | Chaque jour, des processus groupés prennent les données intermédiaires et les modélisent dans un schéma « en flocon de neige » simple à utiliser, appelé Ensemble de données de base. L'ensemble de données de base est également conservé par instance de la plateforme, dans le même emplacement physique que les données intermédiaires et les données de la plateforme. Chaque ensemble de données de base est disponible à la fois au niveau 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 ensembles de données de base est autorisé (sur demande) pour certains clients, principalement au niveau du détaillant (sous réserve d'approbation). |
| Ensembles de données de base agrégés | Une fois les ensembles de données de base mis à jour, les processus groupés prennent les ensembles de données de base individuels et les transfèrent vers un emplacement centralisé (l'entrepôt de données global). Les ensembles de données de base individuels sont ensuite consolidés en un seul ensemble de données de base agrégé unifié. Remarque : seules les données des informations agrégées (et non les données transactionnelles) sont stockées dans l'entrepôt de données global. L'accès direct à l'ensemble de données de base agrégé n'est généralement pas autorisé par des connexions externes. |
| Reporting Datamart | Après la mise à jour de l'ensemble de données de base agrégées, des processus groupés quotidiens calculent un nouveau Datamart de reporting simplifié et agrégé. Tout comme les ensembles de données de base, le Reporting Datamart présente également un schéma de type flocon de neige. Seules les versions actuelles des dimensions sont proposées. Les clients doivent maintenir à jour l'historique des modifications localement, dans leurs propres entrepôts de données, et selon les besoins, sur la base de vues quotidiennes. Le Reporting Datamart contient également des vues qui décorent certains faits et simplifient encore plus les requêtes des clients. L'accès direct au Reporting Datamart est autorisé (sur demande) pour un large éventail de clients, détaillants et fournisseurs (sous réserve d'approbation). |
| Insights [disponibles prochainement] | Une série de vues construites sur le Reporting Datamart qui fournissent des informations prédéfinies souvent demandées par les clients. Par exemple : Efficacité de la campagne (statistiques publicitaires réalisées, par exemple CTR/ROAS) Taux de remplissage de l'inventaire (% de requêtes satisfaites avec la publicité payante) Part de voix (part des fournisseurs dans les impressions par catégorie/terme de recherche, etc.) Facturation (dépenses du portefeuille par campagne et par période) L'accès à la couche Insights est autorisé (sur demande) pour un large éventail de clients, détaillants et fournisseurs (sous réserve d'approbation). Ce document partage également le code SQL utilisé pour construire la couche Insights afin que les clients copiant le Reporting Datamart dans leur entrepôt de données puissent comprendre comment répliquer facilement la logique. |
| Visualisation [version limitée] | Une série de vues construites sur la couche Reporting Datamart and Insights qui fournit des données équivalentes à celles de la plateforme BI héritée. L'accès à la couche Visualisation est actuellement autorisé (sur demande) pour les clients, détaillants et fournisseurs, qui ont besoin d'accéder aux données exactement comme indiqué dans notre ancienne plateforme BI (sous réserve d'approbation). REMARQUE : à moins que vous n'ayez besoin de réconcilier exactement les données de l'ancienne plateforme de BI, il est conseillé d'utiliser les équivalents de la couche Reporting Datamart ou Insights. Ces équivalents contiennent également des données plus précises sur des périodes plus longues. |
Modèle de données logiques
Selon votre type d'accès, les données disponibles comprennent de nombreux domaines de la plateforme CitrusAd, tels que :
(veuillez vous référer au glossaire pour d'autres définitions)
- Données dimensionnelles
- Campagnes
- Catalogues de produits
- Produits
- Équipes
- Détaillants
- Fournisseurs
- Portefeuilles
- Termes de recherche
- Catégories
- Emplacements
- Données factuelles
- Statistiques relatives aux requêtes d'annonces (nombre de requêtes par terme de recherche ou catégorie, etc.)
- Statistiques des annonces réalisées (impressions/clics/dépenses publicitaires par terme ou catégorie de recherche, etc.)
- Statistiques de l'attribution améliorée (là où elles sont configurées uniquement : affichage des impressions, attribution des clics halo, etc.)
- Statistiques sur les dépenses de la campagne FTA
- Résumés des transactions inscrites sur le grand livre comptable (informations de facturation, rechargements de portefeuille, etc.)
- Statistiques des commandes
L'API de reporting est généralement utilisée pour partager les schémas au sein de l'ensemble de données de base et/ou du Reporting Datamart. Ces deux schémas couvrent les sujets susmentionnés, mais à différents niveaux d'agrégation (l'ensemble de données de base offrant des informations au niveau des transactions pour les faits et les agrégats).
Type d'utilisateur
Les domaines que vous pourrez voir seront restreints en fonction de ce que votre organisation a le droit de voir. Il existe 4 types d'accès organisationnel :
- Niveau espace de noms : un client qui contrôle tout un réseau d'équipes (équipes des fournisseurs et équipes des détaillants). L'accès au niveau espace de noms permet de visualiser toutes les données pour une implémentation donnée de CitrusAd.
- Niveau détaillant : un client appartenant à une équipe de détaillant spécifique (ou à un groupe d'équipes de détaillants) uniquement.
- Niveau fournisseur : un client qui est une équipe fournisseur spécifique (ou un groupe d'équipes de fournisseurs) uniquement.
- Niveau intégrateur : une extension du niveau fournisseur, avec un accès intégral à certains objets au niveau détaillant (à la discrétion du détaillant uniquement).
Il s'agit des domaines principaux qui sont couverts et de la manière dont ils s'appliquent aux 3 types d'accès.
| Domaine thématique | Espace de noms | Détaillant | Fournisseur | Intégrateur |
|---|---|---|---|---|
| Campagnes | Toutes les données | Concernant l'équipe ou les équipes des détaillants | Concernant l'équipe ou les équipes des fournisseurs | Concernant l'équipe ou les équipes des fournisseurs |
| Catalogues de produits | Toutes les données | Concernant l'équipe ou les équipes des détaillants | Pas de données | Concernant l'équipe ou les équipes de détaillants qui ont donné leur accord à l'intégrateur. |
| Produits | Toutes les données | Concernant l'équipe ou les équipes des détaillants | Uniquement pour les produits apparaissant dans le tableau supplier_product des statistiques sur les annonces réalisées uniquement. | Concernant l'équipe ou les équipes de détaillants qui ont donné leur accord à l'intégrateur. |
| Équipes | Toutes les données | Concernant l'équipe ou les équipes des détaillants | Concernant l'équipe ou les équipes des fournisseurs | Concernant l'équipe ou les équipes des fournisseurs |
| Détaillants | Toutes les données | Concernant l'équipe ou les équipes des détaillants | Uniquement pour les détaillants apparaissant dans le tableau supplier_retailer des statistiques sur les annonces réalisées uniquement. | Uniquement pour les détaillants apparaissant dans les statistiques des annonces réalisées |
| Fournisseurs | Toutes les données | Uniquement pour les fournisseurs apparaissant dans le tableau retailer_supplier des statistiques des annonces réalisées uniquement. | Concernant l'équipe ou les équipes des fournisseurs | Concernant l'équipe ou les équipes des fournisseurs |
| Portefeuilles | Toutes les données | Portefeuilles de l'équipe du détaillant uniquement | Portefeuilles des équipes des fournisseurs uniquement | Portefeuilles des équipes des fournisseurs uniquement |
| Termes de recherche | Toutes les données | Concernant l'équipe ou les équipes des détaillants | Uniquement pour les termes de recherche qui apparaissent dans les statistiques des annonces réalisées (affichage tel quel dans le tableau des informations) | Uniquement pour les termes de recherche qui apparaissent dans les statistiques des annonces réalisées (affichage tel quel dans le tableau des informations) |
| Catégories | Toutes les données | Concernant l'équipe ou les équipes des détaillants | Uniquement pour les catégories apparaissant dans les statistiques des annonces réalisées (affichage uniquement tel quel dans le tableau des informations) | Uniquement pour les catégories apparaissant dans les statistiques des annonces réalisées (affichage uniquement tel quel dans le tableau des informations) |
| Statistiques des requêtes d'annonces | Toutes les données | Concernant l'équipe ou les équipes des détaillants | Pas de données | Pas de données |
| Statistiques de l'attribution améliorée | Toutes les données | Concernant l'équipe ou les équipes des détaillants | Concernant l'équipe ou les équipes des fournisseurs | Concernant l'équipe ou les équipes des fournisseurs |
| Statistiques sur les dépenses de la campagne FTA | Toutes les données | Concernant l'équipe ou les équipes des détaillants | Concernant l'équipe ou les équipes des fournisseurs | Concernant l'équipe ou les équipes des fournisseurs |
| Résumés des transactions inscrites au grand livre | Toutes les données | Portefeuilles de l'équipe du détaillant uniquement | Portefeuilles des équipes des fournisseurs uniquement | Portefeuilles des équipes des fournisseurs uniquement |
| Statistiques des commandes | Toutes les données | Concernant l'équipe ou les équipes des détaillants | Pas de données | Pas de données |
| Statistiques des annonces réalisées (impressions/clics, dépenses publicitaires, etc.) | Toutes les données | Concernant l'équipe ou les équipes des détaillants | Concernant l'équipe ou les équipes des fournisseurs | Concernant l'équipe ou les équipes des fournisseurs |
| Emplacements | Toutes les données | Concernant l'équipe ou les équipes des détaillants | Uniquement pour les placements apparaissant dans les requêtes d'annonces et les statistiques des annonces réalisées. | Concernant l'équipe ou les équipes de détaillants qui ont donné leur accord à l'intégrateur. |
Méthode d'accès utilisateur
Il existe deux types de méthode d'accès, selon les plateformes cloud que vous utilisez.
| Type d'utilisateur | Méthode d'accès |
|---|---|
| Utilisateur Google Cloud Platform natif (GCP) | Accès direct, puisque notre entrepôt de données est déployé dans BigQuery (le service d'entrepôt de données de GCP). Les clients qui se trouvent eux-mêmes dans GCP peuvent accéder directement aux ensembles de données. Cela vous permet de voir les objets et d'effectuer des requêtes via l'UI BigQuery de 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 (sous réserve d'approbation). Remarque : les utilisateurs disposant d'un accès direct peuvent également passer des appels à l'API BigQuery via des scripts, etc. (en plus d'utiliser l'API BigQuery). |
| Autres utilisateurs (hors GCP) | API Si vous n'utilisez pas GCP (par exemple Azure ou AWS), CitrusAd créera un compte pour vous (compte de service) et vous fournira les informations de connexion (sous réserve 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 : f34ea10