Intégration WooCommerce — Statnive Docs

Présentation

Rapport de chiffre d'affaires Statnive pour WooCommerce — cinq cartes KPI (Chiffre d'affaires net, Commandes, Panier moyen, Total des remboursements, TVA + Livraison), tableau Chiffre d'affaires par canal, liste des produits les plus vendus et entonnoir du panier à l'achat avec conversion par étape

Depuis la v1.0.0, l’extension Statnive gratuite pour WordPress embarque un Rapport de chiffre d’affaires dédié qui transforme les données de vos commandes WooCommerce en un tableau de bord axé CRO dans /wp-admin. Pas de configuration, pas d’offre payante, pas de transfert vers des tiers — toutes les données restent dans votre base de données WordPress.

L’intégration repose sur l’Attribution de commande de WooCommerce 8.5+, est compatible HPOS + Validation par blocs, et est READ-ONLY vis-à-vis de WooCommerce — Statnive utilise uniquement les accesseurs $order->get_*() et n’écrit jamais dans une table WooCommerce ni dans les métadonnées d’article.

Prérequis

WordPress 6.2+ (testé jusqu’à 7.0)
PHP 8.1+ (relevé depuis 8.0 en v0.4.13)
WooCommerce 8.5+ (Attribution de commande requise pour l’attribution par canal)
Action Scheduler (inclus avec WooCommerce depuis la version 5.4)

Cinq KPI dans le Rapport de chiffre d’affaires

KPI	Source	Notes
Commandes	`COUNT(orders)` avec statuts `processing` + `completed`	Les commandes remboursées sont suivies séparément sous Total des remboursements
Chiffre d’affaires (net)	`net_total − refund_total`	Hors taxes et livraison ; un indicateur `Brut : X €` apparaît en dessous
Panier moyen	`net_revenue / orders`	Affichage décimal précis selon les paramètres de devise de la boutique WooCommerce
Total des remboursements + Taux	`refund_total`, `refund_rate = remboursements / brut`	Affiché sous la forme combinée « Total remboursements · Taux : X % »
Taxes + Livraison	`tax_total + shipping_total`	Valeur combinée, explicitement étiquetée « Exclus du chiffre d’affaires »

Sept ventilations

Le Rapport de chiffre d’affaires affiche sept dimensions sur la page ; les onze endpoints (wc-status, backfill, summary, timeseries, by-channel, by-utm, by-landing, products, funnel, refunds, coupons) sont également exposés via l’API REST.

Chiffre d’affaires par canal

Tableau triable avec Canal · Commandes · Chiffre d’affaires · Panier moyen sur les 8 canaux regroupés par Statnive :

Direct
Assistants IA — 14 hôtes : ChatGPT (chatgpt.com, chat.openai.com), Claude (claude.ai), Gemini (gemini.google.com, bard.google.com, notebooklm.google.com), Copilot (copilot.microsoft.com), Perplexity (perplexity.ai), Meta AI (meta.ai), Le Chat / Mistral (chat.mistral.ai), DeepSeek (deepseek.com, chat.deepseek.com), You (you.com), iAsk (iask.ai), Jasper (jasper.ai), Writesonic (writesonic.com). La détection IA s’exécute avant le classificateur de moteurs de recherche, de sorte que les référents IA ne sont jamais attribués par erreur à Recherche organique.
Recherche organique
Réseaux sociaux
E-mail
Référent
Recherche payante (depuis le paramètre UTM medium = cpc, ppc, paidsearch, paid_search)
Social payant (depuis le paramètre UTM medium = cpm, paid_social)

Produits populaires

Les 10 meilleurs produits par défaut (triables par unités ou chiffre d’affaires, maximum 100). Les variations sont regroupées sous leur produit parent. Les remboursements sont appliqués à la ligne de commande.

Entonnoir Panier → Achat

Quatre étapes, côté serveur depuis WooCommerce — aucun JS supplémentaire à installer :

Produit vu — événement : wc_product_view
Ajouté au panier — événement : wc_add_to_cart
Commande commencée — événement : wc_checkout_start
Achat finalisé — événement : wc_purchase

Le taux de conversion par étape (actuel/précédent) et le taux de conversion global (achats/entrée la plus large) s’affichent avec les nombres de sessions.

Mise à jour v1.1.0. Le dénominateur du « % global » est passé de la première étape à l’étape la plus large, et l’interface par étape affiche désormais le % de conversion, et non le % d’abandon. Cela rejoint la convention adoptée par WooCommerce Analytics en WC 9.x.

Chiffre d’affaires par source / medium / campagne UTM

Tableau paginé des valeurs utm_source, utm_medium et utm_campaign observées sur les commandes attribuées, avec commandes, chiffre d’affaires et panier moyen par ligne.

Chiffre d’affaires par page d’atterrissage

Tableau paginé des pages d’atterrissage d’entrée avec commandes et chiffre d’affaires par page — répond à la question « quelle surface d’entrée envoie réellement des acheteurs ? ».

Remboursements

Tendance du taux de remboursement sur la période, suivie d’une liste des produits les plus remboursés ; les remboursements sont appliqués au niveau de la ligne de commande.

Tableau paginé des utilisations de codes promo : code, nombre, montant total de remise et chiffre d’affaires net après remise.

Découpage des dates en v1.1.0

Les commandes sont regroupées par COALESCE(date_paid_gmt, date_created_gmt) afin que les renouvellements d’abonnement et les commandes à paiement différé (BACS, chèque, paiement à la livraison, webhooks à finalisation tardive) tombent le jour où le paiement a été encaissé, et non le jour où la commande a été passée. La v1.0.0 n’utilisait que date_created_gmt, ce qui plaçait à tort les paiements de renouvellement dans le passé.

Remplissage rétroactif sans configuration

La première fois que vous ouvrez le Rapport de chiffre d’affaires après avoir activé la v1.0.0 sur un site WooCommerce, Statnive met en file d’attente des tâches en arrière-plan via Action Scheduler pour importer les commandes historiques. Le statut apparaît en haut du Rapport de chiffre d’affaires pendant son exécution.

Taille des lots : 500 commandes par hook Action Scheduler (statnive/wc/backfill/chunk)
Statuts comptabilisés : processing et completed. Les lignes remboursées réduisent le chiffre d’affaires de la ligne sur leur commande parente, plutôt que d’être comptabilisées comme un statut distinct.
Visibilité : WooCommerce → État → Actions planifiées, filtrer par statnive/wc/backfill/chunk

Alternative en ligne de commande

Pour les sites où vous préférez déclencher ou surveiller le remplissage depuis la ligne de commande :

wp statnive woocommerce-backfill

La commande est idempotente — la relancer pendant qu’un remplissage est en cours renvoie un code 409.

Tables de base de données

La v1.0.0 ajoute cinq nouvelles tables via dbDelta. Vos tables et données Statnive existantes sont préservées lors de la mise à jour depuis la 0.4.x.

Table	Rôle
`wp_statnive_orders`	Métadonnées de commande, instantané d’attribution, canal
`wp_statnive_order_attribution`	Canal, paramètres UTM, hôte référent, étapes de l’entonnoir
`wp_statnive_order_items`	Lignes de commande, produits, UGS, suivi des remboursements
`wp_statnive_order_refunds`	Événements de remboursement avec montant et motif
`wp_statnive_order_coupons`	Utilisation des bons de réduction par commande, montants des remises

Le préfixe des tables suit votre $wpdb->prefix WordPress.

Posture de confidentialité et de sécurité

READ-ONLY vis-à-vis de WooCommerce. Uniquement des accesseurs $order->get_*() ; Statnive n’écrit jamais dans une table WooCommerce ni dans les métadonnées d’article. Vérifié empiriquement avec CHECKSUM TABLE avant/après sur un site comptant 1 933 commandes.
Sans cookies. Aucun stockage navigateur d’aucune sorte pour l’identification des visiteurs.
Sels à rotation quotidienne (générés par CSPRNG, fenêtre de chevauchement de 48 heures) — un même visiteur produit un hash différent chaque jour, rendant impossible la ré-identification d’un jour à l’autre.
Pas de stockage d’IP brute. L’IP est hachée, utilisée pour la recherche GeoIP, puis immédiatement supprimée. IPv4 : dernier octet mis à zéro. IPv6 : 80 derniers bits mis à zéro.
GPC + DNT sont respectés côté serveur.
API WordPress Privacy : l’exportateur et l’effaceur sont enregistrés à l’activation.
Désinstallation opt-in (désactivée par défaut). La réinstallation préserve l’historique des statistiques et du chiffre d’affaires.

Pages d’administration principales

Après l’activation de la v1.1.0, la navigation d’administration Statnive comporte ces pages ciblées :

Vue d’ensemble (/wp-admin/admin.php?page=statnive) — Visiteurs, Sessions, Pages vues, Durée moyenne, ainsi que les Principales sources et les Pages les plus consultées
Rapport de chiffre d’affaires (/wp-admin/admin.php?page=statnive-revenue) — les cinq KPI et les sept ventilations décrits ci-dessus
Ask me! (/wp-admin/admin.php?page=statnive-ask) — 116 questions formulées par les propriétaires, réparties en 10 catégories, 63 répondent aujourd’hui (v1.1.0+)
Réglages (/wp-admin/admin.php?page=statnive-settings) — confidentialité, rétention, exclusions, GeoIP

Aucune configuration spécifique à WooCommerce n’est requise. L’intégration est toujours active dès lors que WooCommerce est installé.

Mise à jour depuis 0.4.x

Mise à jour transparente. Cinq nouvelles tables sont ajoutées via dbDelta ; les 21 tables existantes et leurs données ne sont pas modifiées. Sur un site WooCommerce, le Rapport de chiffre d’affaires se remplit en quelques minutes après l’activation grâce au remplissage rétroactif sans configuration. Aucune modification de code n’est requise.

Consultez le journal des modifications v1.0.0 pour les notes de version complètes.