Comment il se charge
Sur un thème WordPress, Vireo affiche son tracker dans le pied de page via wp_footer(). Il n’y a rien à ajouter. Pour les templates sans hook de pied de page, voir Installation.
Le tracker envoie une page vue par page avec navigator.sendBeacon(), une fois la page chargée. Une page ouverte en arrière-plan est comptée quand elle devient visible.
Les vues vont vers un petit point de terminaison, endpoint.php dans le dossier du plugin, qui charge WordPress sans les plugins ni le thème. Si votre hébergeur bloque les fichiers PHP dans wp-content, ou si un CDN sert le plugin depuis une autre adresse, Vireo utilise admin-ajax.php à la place. Il revérifie toutes les heures. Ce que coûte une page vue, mesuré.
Vireo exclut son tracker du report d’exécution JavaScript et de la minification dans WP Rocket, Perfmatters, LiteSpeed Cache et FlyingPress, pour qu’il ne soit pas retenu jusqu’à ce que quelqu’un fasse défiler la page.
Événements personnalisés
vireo('event', name);
vireo('event', name, value);
name: ce qui s’est passé, par exemplenewsletter_signup. Il est converti en minuscules et ne garde quea-z,0-9,_et-, jusqu’à 100 caractères.value: facultatif, jusqu’à 100 caractères, sert à détailler un événement sur son propre écran.
Sur un thème WordPress, vireo() existe dès le début de la page et met les appels en file d’attente jusqu’au chargement du tracker : vous pouvez donc l’appeler tôt sans risque.
<button onclick="vireo('event', 'pricing_toggle', 'yearly')">Yearly</button>
Sans aucun JavaScript, placez data-vireo-event="name" sur un élément, avec un data-vireo-value="value" facultatif. Un clic sur cet élément, ou sur n’importe quoi qu’il contient, envoie cet événement. C’est toujours actif, rien à activer.
<a href="/pricing/" data-vireo-event="pricing_click" data-vireo-value="header">Pricing</a>
Les événements apparaissent sous Principaux événements et peuvent devenir des objectifs dans Vireo Pro.
Applications monopages
| Vous utilisez | À faire |
|---|---|
| Les view transitions d’Astro | Rien. Chaque astro:page-load est compté. |
| Un routeur qui utilise l’History API | Ajoutez data-spa="history" à la balise du tracker. Chaque pushState et chaque navigation avant ou arrière est comptée. |
| Autre chose | Appelez vireo('pageview') après le rendu de la nouvelle page. |
Une navigation vers la même adresse que la précédente n’est pas comptée deux fois.
Attributs de la balise script
En dehors d’un thème WordPress, sur un front-end découplé ou un site connecté, le tracker est une balise script que vous collez. Copiez-la depuis les réglages de Vireo plutôt que de l’écrire à la main.
| Attribut | Signification |
|---|---|
data-endpoint |
Où envoyer les vues. Obligatoire en dehors de WordPress. |
data-site |
La clé d’un site connecté. À omettre pour un front-end découplé. |
data-spa="history" |
Compter les navigations de l’History API comme des pages vues. |
data-post-id |
L’ID de l’article WordPress de la page, quand vous le connaissez. La balise meta vireo:post-id a priorité. |
Une page découplée peut aussi désigner son article WordPress avec <meta name="vireo:post-id" content="123">.
Ce qu’envoie un beacon
Une page vue envoie le chemin, le référent et l’ID de l’article quand il y en a un. Un événement envoie son nom et sa valeur. Quand le lecteur quitte la page ou passe sur un autre onglet, une dernière petite requête envoie le chemin et le nombre de secondes pendant lesquelles la page est restée devant lui depuis le dernier envoi, pour le temps sur la page. Rien n’est stocké dans le navigateur et aucun cookie n’est déposé.
La balise des sites découplés et connectés est le même script : ces sites obtiennent donc aussi le temps sur la page.
Le tracker n’envoie rien quand le navigateur a activé Do Not Track ou Global Privacy Control, ni quand il s’agit d’un navigateur automatisé comme Playwright, Puppeteer, Cypress, PhantomJS ou Nightmare.
Événements automatiques
Les événements automatiques que vous cochez sous Réglages > Suivi envoient des événements ordinaires (download, form_submit, mailto_click, tel_click, outbound). « Liens et boutons cliqués » fonctionne autrement : il envoie un rapport de clic avec la page, le chemin de destination et le texte visible, pour le rapport « Liens et boutons les plus cliqués », et jamais de chaîne de requête ni ce qui a été saisi dans un formulaire. Voir Événements et liens cassés.