# Analytics Le tableau de bord DZBuild fournit les analytics dont la plupart des marchands ont besoin — sans configuration. Pour des analyses plus poussées, vous pouvez alimenter Google Analytics, Looker Studio ou votre propre data warehouse via l'API publique. ## Où se trouvent les analytics[​](#où-se-trouvent-les-analytics "Lien direct vers Où se trouvent les analytics") Ouvrez [`/dashboard`](https://dzbuild.com/dashboard) — les analytics sont sur la page **d'accueil** du tableau de bord, sous les boutons de plage de dates. Il n'existe pas de page `/dashboard/analytics` ni d'entrée Analytics dans la barre latérale, sauf si l'add-on Advanced Analytics est actif. La vue par défaut porte sur les **7 derniers jours**. Ensuite, le tableau de bord rouvre sur le dernier préréglage choisi dans ce navigateur (une plage personnalisée n'est pas mémorisée). Préréglages : Aujourd'hui, Hier, 7 jours, 30 jours, Ce mois-ci, Le mois dernier, Cette année, plus une plage personnalisée allant jusqu'à 365 jours. Un filtre de trafic à côté des préréglages limite les chiffres de visiteurs à tout le trafic, aux pages de destination seulement ou à la boutique seulement ; les chiffres de commandes et le taux de conversion couvrent toujours toute la boutique. Chaque KPI affiche un badge de variation en pourcentage comparant la période sélectionnée à la période immédiatement précédente de même longueur. KPIs principaux : | Métrique | Définition | | ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Revenu** | Valeur marchande des commandes **livrées** uniquement : sous-total moins remise, hors livraison et frais de paiement. Une commande compte le jour où elle a été *livrée*, pas le jour où elle a été passée. | | **Profit** | Revenu moins le coût des marchandises de ces commandes livrées (quantité × prix de revient du produit). Vous devez renseigner le **prix de revient** de vos produits — s'il est vide, le profit égale le revenu. | | **Commandes** | Toute commande créée dans la période, quel que soit son statut (annulées et retournées incluses). | | **Commandes livrées** | Commandes livrées à l'intérieur de la période. | | **Commandes annulées** | Commandes créées dans la période avec le statut `cancelled`. | | **AOV** | Moyenne du *total* de la commande — livraison et frais de paiement inclus — sur les commandes non annulées et non retournées. | | **Visiteurs** | Empreintes de visiteurs distinctes ayant consulté la vitrine dans la période. | | **Pages vues** | Total des chargements de pages de la vitrine. | | **Nouveaux clients** | Fiches clients créées dans la période. | | **Taux de conversion** | Commandes ÷ Visiteurs, exprimé en pourcentage (en utilisant le décompte de commandes tous statuts). | Les KPIs ne se recoupent pas entre eux — c'est voulu Revenu, Commandes et AOV sont calculés à partir de trois ensembles de commandes et de trois champs monétaires différents. Le Revenu ne compte que le livré et se cale sur la date de *livraison* ; Commandes compte tous les statuts et se cale sur la date de *création* ; l'AOV moyenne le total complet des commandes non annulées et non retournées. Ainsi, Revenu ÷ Commandes ne donnera pas l'AOV, et AOV × Commandes ne donnera pas le Revenu. Graphiques sous les KPIs : * **Heures de pointe des ventes** : commandes et pages vues pour chaque heure de la journée sur la période choisie, avec l'heure de vente la plus chargée mise en évidence. * **Visiteurs & Pages vues** : visiteurs uniques, pages vues et commandes dans le temps. * **Commandes par statut** * **Top produits** — les 10 meilleures ventes classées par unités vendues (commandes annulées et retournées exclues), avec la quantité, le revenu (propriétaire de la boutique uniquement) et les vues uniques de la fiche produit. Les noms de produits ne sont pas cliquables. * **Top wilayas** : les 10 wilayas totalisant le plus de commandes sur la période (tous statuts), tracées selon le nombre de commandes. Tous les graphiques respectent la plage de dates. ### Les comptes staff ne voient pas les données financières[​](#les-comptes-staff-ne-voient-pas-les-données-financières "Lien direct vers Les comptes staff ne voient pas les données financières") Si un membre de l'équipe n'est pas le propriétaire de la boutique, le revenu, le profit et l'AOV ne parviennent jamais à son compte : ils ne sont pas simplement masqués dans l'interface. Le staff voit les commandes, les visiteurs, les pages vues et le taux de conversion ; la colonne revenu disparaît de Top produits. ## Comment les chiffres de visiteurs sont collectés[​](#comment-les-chiffres-de-visiteurs-sont-collectés "Lien direct vers Comment les chiffres de visiteurs sont collectés") Les compteurs de visiteurs et de pages vues proviennent d'un beacon JavaScript sur la vitrine. Pour chaque page vue, il enregistre une empreinte de navigateur, le type de page, le domaine référent, la source de trafic, l'appareil et un ID de session. Deux limites à connaître : * Les visiteurs qui ont désactivé JavaScript, ou qui partent avant l'exécution du beacon, ne sont **pas comptés**. * Le suivi est plafonné par visiteur : une session très intense cesse donc d'ajouter des pages vues au-delà d'un certain seuil. ## Add-on Advanced Analytics (Entreprise)[​](#add-on-advanced-analytics-entreprise "Lien direct vers Add-on Advanced Analytics (Entreprise)") L'add-on **Advanced Analytics** ajoute une instance [Umami](https://umami.is) privée hébergée par DZBuild — sans cookies, et aucune donnée de visiteur ne quitte DZBuild. Réservé au plan Entreprise, il se gère sur `/dashboard/addons/advanced-analytics`. Ce qu'il apporte en plus des graphiques intégrés : compteur de visiteurs en temps réel, rapports d'ensemble et de sessions, top pages et référents, répartitions appareil / navigateur / OS et pays, comparaison de périodes, répartitions UTM, événements personnalisés, métriques de performance — et un **rapport de funnel**, absent du tableau de bord intégré. La page de l'add-on propose aussi un bouton **Vue complète** qui ouvre votre tableau de bord Umami en lecture seule : vous pouvez parcourir et filtrer les rapports affichés, mais vous ne pouvez pas y créer ni modifier de rapports. ## Connecter des outils externes[​](#connecter-des-outils-externes "Lien direct vers Connecter des outils externes") ### Google Analytics 4[​](#google-analytics-4 "Lien direct vers Google Analytics 4") Installez via [Pixels](https://dzbuild.com/fr/fr/docs/marketing/pixels.md). GA4 reçoit les mêmes événements de vitrine que DZBuild envoie pour Facebook (`view_item`, `add_to_cart`, `begin_checkout`, `purchase`), plus `generate_lead` quand un visiteur soumet un formulaire personnalisé de landing page. ### Google Tag Manager, Mixpanel, Amplitude[​](#google-tag-manager-mixpanel-amplitude "Lien direct vers Google Tag Manager, Mixpanel, Amplitude") DZBuild ne pousse **pas** d'événements nommés dans le dataLayer de GTM : un conteneur GTM seul ne donne donc rien à GTM sur quoi déclencher. Pour faire remonter les événements e-commerce dans GTM, vous devez **aussi** ajouter un pixel Google Analytics (ou Google Ads) — la vitrine émet alors des appels `gtag('event', …)` que GTM peut capter comme événements Google Tag. Pour Mixpanel ou Amplitude, déclenchez un tag Custom HTML dans GTM à partir de ces événements Google Tag, ou à partir de `window.trackPixelEvent`. ### Looker Studio / Power BI / votre warehouse[​](#looker-studio--power-bi--votre-warehouse "Lien direct vers Looker Studio / Power BI / votre warehouse") Utilisez l'[API DZBuild](https://dzbuild.com/fr/fr/api-docs/intro.md) à l'adresse `https://api.dzbuild.app/v1` : * `GET /v1/orders` — paginer les commandes, filtrer par date. `GET /v1/orders/{id}` pour une commande. * `GET /v1/analytics?range=30d` renvoie les chiffres du tableau de bord : les KPIs avec leur variation par rapport à la période précédente, plus les commandes, le revenu, les visiteurs, les appareils, les sources de trafic, les top produits et les top wilayas. `range` accepte les préréglages du tableau de bord (`today`, `yesterday`, `7d`, `30d`, `this_month`, `last_month`, `this_year`) et vaut `this_month` par défaut ; `range=custom&from=YYYY-MM-DD&to=YYYY-MM-DD` couvre jusqu'à 365 jours. Le revenu, le profit et l'AOV sont retirés sauf si la clé appartient au propriétaire de la boutique. Nécessite le scope `analytics:read`. * `GET /v1/quotas` renvoie les limites de requêtes de votre clé API, pratique pour sécuriser un job planifié. `GET /v1/usage` et `GET /v1/usage/history` comptent vos appels API, pas vos ventes. * `GET /v1/customers`, `GET /v1/products`, `GET /v1/landing-pages` pour les jointures. Les clés API sont réservées au plan Entreprise Seul le propriétaire de la boutique sur un plan **Entreprise** actif peut créer des clés, sur [`/dashboard/api`](https://dzbuild.com/dashboard/api). Les autres propriétaires y voient une carte de mise à niveau, et les membres de l'équipe un avis réservé au propriétaire. Vous créez la clé vous-même, jusqu'à 3 par boutique, et elle s'authentifie immédiatement. Pour des données quasi temps réel, abonnez-vous aux webhooks. L'add-on publie sept sujets de commande et rien d'autre : `order.created`, `order.confirmed`, `order.processing`, `order.shipped`, `order.delivered`, `order.cancelled`, `order.returned`. Voir [Webhooks](https://dzbuild.com/fr/fr/api-docs/webhooks/overview.md). ## Vie privée[​](#vie-privée "Lien direct vers Vie privée") DZBuild ne suit pas les clients à travers les sites. Les pixels navigateur (quand vous les installez) le font, mais c'est entre vous et le fournisseur — et la CAPI DZBuild n'envoie que ce que vous configurez dans [Pixels](https://dzbuild.com/fr/fr/docs/marketing/pixels.md). DZBuild ne génère pas de politique de confidentialité pour vous. Si vous en avez besoin, ajoutez-la comme page ou landing page et créez le lien vous-même. ## FAQ[​](#faq "Lien direct vers FAQ") **Q : Pourquoi mon nombre de visiteurs diffère-t-il de Google Analytics ?** R : Méthodes de collecte différentes. DZBuild compte des empreintes de navigateur distinctes via son propre beacon et plafonne les sessions très intenses ; GA compte des sessions et applique son propre filtrage des bots. **Q : Où voir les retours / annulations ?** R : Filtrez la liste des commandes sur [`/dashboard/orders`](https://dzbuild.com/dashboard/orders) par statut, ou utilisez l'add-on [Gestion avancée des commandes](https://dzbuild.com/fr/fr/docs/addons/advanced-orders.md). Via l'API : `GET /v1/orders?status=returned`. **Q : Puis-je exporter les graphiques ?** R : Non. Les graphiques du tableau de bord n'ont aujourd'hui aucun export CSV ni JSON. Pour récupérer les données sous-jacentes, utilisez l'API (`GET /v1/orders`, `GET /v1/analytics`) ou l'add-on d'export Google Sheets. **Q : Quelle est la fraîcheur des données ?** R : Les compteurs et les graphiques sont mis en cache 120 secondes par boutique et par plage de dates, et recharger pendant cette fenêtre renvoie les mêmes chiffres. Tant que l'accueil du tableau de bord est ouvert, une nouvelle commande s'ajoute aussitôt au compteur Commandes et à la liste des dernières commandes.