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

Ouvrez /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).

⚠️ Attention — 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

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

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)

L'add-on Advanced Analytics ajoute une instance Umami 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

Google Analytics 4

Installez via Pixels. 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

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

Utilisez l'API DZBuild à 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.

⚠️ Attention — 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. 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.

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.

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

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 par statut, ou utilisez l'add-on Gestion avancée des commandes. 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.