Quand WordPress n’est que votre éditeur et qu’un site Astro ou Next.js affiche les articles aux lecteurs, votre extension d’analytics WordPress reste muette. Elle compte les pages que WordPress construit pour les visiteurs, et sur un site headless, WordPress n’en construit aucune. Les lecteurs chargent le front-end, et WordPress ne fait que répondre à ses appels d’API.
La solution habituelle est un outil d’analytics distinct sur le front-end. Ça marche, mais les chiffres vivent alors ailleurs que votre contenu. Une page vue arrive sous la forme d’une adresse comme /blog/my-post/, sans savoir quel article elle affiche, qui l’a écrit ni quand il a été publié.
Il existe une autre voie : renvoyer les pages vues du front-end vers WordPress, et rattacher chacune à l’article qu’elle affiche.
Comment ça marche dans Vireo
Vireo Analytics vous donne une balise script pour le front-end. La balise charge le traceur de Vireo depuis votre site WordPress et lui envoie chaque page vue. WordPress rattache la page à un article, si bien que Pages les plus vues, l’écran de statistiques propre à chaque article et la colonne Vues de l’administration se remplissent comme avec un thème.
Vireo n’accepte ces pages vues que depuis l’adresse de front-end que vous saisissez. Collez la balise sur n’importe quel autre site et rien n’est enregistré. C’est gratuit pour un front-end.
La mettre en place
- Dans WordPress, allez dans Vireo Analytics, Réglages, Autres sites, Front-end découplé.
- Saisissez l’« Adresse du site front-end » : l’adresse que voient les lecteurs,
https://compris. - Cliquez sur « Enregistrer les réglages ».
- Copiez la balise affichée sous « Ajouter au front-end ».
Elle ressemble à ceci, avec vos propres adresses :
<script defer src="https://cms.example.com/wp-content/plugins/vireo-analytics/assets/js/tracker.js" data-endpoint="https://cms.example.com/..."></script>
Copiez toujours la balise depuis l’écran des réglages plutôt que de la taper. L’adresse du endpoint dépend de votre hébergeur, et l’écran affiche celle qui fonctionne chez vous.
La balise doit rester un script classique. Le traceur lit ses réglages dans sa propre balise, et un script qu’un bundler a transformé en module ne peut pas le faire. Les deux frameworks ci-dessous la laissent intacte si vous l’ajoutez comme indiqué.
Astro
Collez la balise dans le layout que toutes les pages utilisent, juste avant </body> :
---
// src/layouts/Base.astro
---
<html lang="en">
<head>...</head>
<body>
<slot />
<script defer src="https://cms.example.com/wp-content/plugins/vireo-analytics/assets/js/tracker.js" data-endpoint="https://cms.example.com/..."></script>
</body>
</html>
Astro bundle les balises <script> simples, mais une balise dotée d’attributs autres que src est laissée telle quelle : celle-ci reste donc un script classique sans aucune modification.
Si vous utilisez les view transitions d’Astro, le traceur compte tout seul chaque changement de page, en écoutant l’événement astro:page-load d’Astro. Gardez la balise dans le layout partagé pour qu’elle soit sur toutes les pages où un lecteur peut atterrir. Astro n’exécute qu’une fois par visite un script chargé depuis la même adresse : le traceur ne se charge donc pas deux fois quand les lecteurs naviguent.
Next.js
Avec l’App Router, ajoutez-la au layout racine avec next/script. Il transmet les attributs data- à la balise script :
// app/layout.tsx
import Script from 'next/script';
export default function RootLayout({ children }: { children: React.ReactNode }) {
return (
<html lang="en">
<body>{children}</body>
<Script
src="https://cms.example.com/wp-content/plugins/vireo-analytics/assets/js/tracker.js"
data-endpoint="https://cms.example.com/..."
data-spa="history"
/>
</html>
);
}
Gardez data-spa="history" dans la balise. Next.js change de page sans recharger, en mettant à jour l’adresse via l’History API du navigateur. Avec cet attribut, chacun de ces changements, ainsi que chaque retour ou avance, compte comme une page vue. Sans lui, seuls les chargements complets de page sont comptés.
Le même attribut fonctionne avec tout autre framework dont le routeur utilise l’History API. Si le vôtre fait autre chose, appelez vireo('pageview') après le rendu de chaque nouvelle page.
Rattacher les pages aux articles
Vireo rattache par chemin. Si le front-end conserve les permaliens de WordPress, c’est-à-dire que /my-post/ sur le front-end est l’article à /my-post/ dans WordPress, il n’y a rien à faire.
Si les chemins diffèrent, par exemple parce que le front-end place les articles sous /blog/, ajoutez l’ID WordPress de l’article dans le head de chaque page :
<meta name="vireo:post-id" content="123">
Vous avez déjà l’ID : c’est id dans l’API REST et databaseId dans WPGraphQL. Dans Astro, affichez la balise dans le head du layout d’article. Dans Next.js, ajoutez-la via generateMetadata avec other: { 'vireo:post-id': String(post.id) }.
Vireo essaie d’abord le chemin et n’utilise l’ID que si le chemin ne correspond à aucun article. Les pages qui ne sont pas des articles, comme votre page d’accueil ou une liste par étiquette, sont tout de même comptées par adresse. Pour les cas plus délicats, un développeur peut associer chemins et articles en PHP avec le filtre vireo_headless_post_id.
Événements personnalisés
Sur un thème WordPress, Vireo affiche un petit stub vireo() qui met les appels en file d’attente jusqu’au chargement du traceur. Sur un front-end, il n’y a pas de stub : protégez donc l’appel :
window.vireo?.('event', 'newsletter_signup');
Les événements du front-end apparaissent dans Principaux événements avec tous les autres. La documentation du traceur liste les règles pour les noms et les valeurs d’événements.
Trafic de test et Search Console
Les pages vues ne sont acceptées que depuis l’adresse saisie, ce qui garde les déploiements de prévisualisation et localhost hors de vos chiffres. Un développeur peut ajouter d’autres adresses avec le filtre vireo_headless_allowed_origins.
Pour Search Console, connectez la propriété correspondant à l’adresse du front-end, puisque c’est le site que Google indexe. Les recherches derrière chaque article explique ce que vous en tirez.
Un front-end qui n’est pas votre blog
Le réglage headless sert à un front-end qui affiche vos articles WordPress. Un site distinct, comme un site de documentation ou une landing page construite avec autre chose, est plutôt un site connecté : il a ses propres chiffres, et un sélecteur de site dans la Vue d’ensemble permet de passer de l’un à l’autre. Un site connecté est gratuit, et il peut collecter les Core Web Vitals avec une seconde balise.