Utilisez l'extension. C'est un seul réglage et il survit à un changement de thème, ce que les autres solutions ne font pas.

L'extension

  1. Ouvrez skomi-plugin-wordpress et, sous Releases, téléchargez le skomi-wordpress.zip joint à la plus récente.
  2. Dans WordPress, allez dans Extensions → Ajouter une extension → Téléverser une extension, choisissez le fichier, installez-le et activez-le.
  3. Allez dans Réglages → Skomi Analytics.
  4. Collez votre identifiant de site et enregistrez.

⚠ Prenez le zip de la release, pas celui du bouton vert « Code → Download ZIP ». Celui-là enveloppe tout dans un dossier nommé d'après le dépôt et la branche, et WordPress installe une extension sous le dossier que contient le zip. L'extension atterrirait sous le mauvais nom, et le module WooCommerce ci-dessous (qui demande skomi-wordpress par son nom) cesserait de la trouver.

L'identifiant de site est sur la page de votre site dans Skomi. C'est un UUID, et ce n'est pas un secret : il apparaît dans le code source de chaque page qu'il mesure.

Deux réglages comptent et le reste peut rester tel quel :

  • Activé, qui l'est. Le désactiver arrête la collecte et conserve votre identifiant de site : vous n'aurez donc pas à aller le rechercher ensuite.
  • Identifiant de site. Un identifiant qui n'est pas un UUID est refusé avec un message plutôt qu'enregistré, parce qu'un mauvais identifiant enregistré imprime une balise de script cassée sur chaque page.

Un réglage par défaut à connaître : les visites des personnes connectées à WordPress ne sont pas mesurées. Sur un petit site, vos propres rechargements sont plus nombreux que le vrai trafic, et rien dans un tableau de bord ne le dit. Il y a une case à cocher si vous les voulez.

Si vous vendez via WooCommerce, ajoutez aussi Skomi pour WooCommerce, installé de la même façon. Il rapporte le total, la devise et le numéro de chaque commande, et c'est le numéro de commande qui empêche une page de remerciement rechargée de compter une deuxième vente.

Les deux sont téléversés plutôt que trouvés dans le répertoire des extensions : ils ne sont pas sur wordpress.org. Le code source des deux est public, et il vaut la peine de le lire entièrement avant d'installer quoi que ce soit sur un site qui encaisse de l'argent.

Coller la balise à la main

Vous n'en avez pas besoin si vous avez utilisé l'extension. C'est ici parce que certains sites ne peuvent pas en ajouter, et parce qu'une balise collée dans un thème est la façon la plus courante dont l'analytics s'arrête discrètement sur WordPress : un changement de thème l'emporte avec lui, sans erreur et sans rien qui se remarque.

Récupérez d'abord l'extrait depuis votre tableau de bord. Il ressemble à ceci, avec votre propre identifiant de site dans le chemin :

<script src="https://t.skomi.com/s/your-site-id.js" defer></script>

Une extension d'en-tête et de pied de page

L'option vers laquelle se tourner si vous préférez ne pas toucher à un thème. Des extensions comme WPCode ou Head & Footer Code ajoutent une page de réglages avec un champ pour l'en-tête et un champ pour le pied de page. Collez la balise dans le champ pied de page et enregistrez.

Cela survit à chaque changement de thème et à chaque mise à jour de thème, ce qui est tout l'argument en sa faveur.

Un thème enfant

Si vous utilisez déjà un thème enfant, ajoutez ceci à son functions.php :

add_action( 'wp_footer', function () {
    ?>
    <script src="https://t.skomi.com/s/your-site-id.js" defer></script>
    <?php
}, 100 );

wp_footer se déclenche juste avant la balise </body> fermante, et la priorité 100 place la balise après les scripts que WordPress met en file à la priorité par défaut de 20.

⚠ Un thème enfant, pas le thème lui-même. Modifier le footer.php d'un thème parent fonctionne jusqu'à la mise à jour de ce thème, et alors la balise a disparu sans erreur et sans le moindre signe que quelque chose a changé. Vous cessez tout simplement de collecter.

Le champ propre à votre thème

Beaucoup de thèmes commerciaux ont un réglage « code personnalisé », « code de suivi » ou « scripts ». Si le vôtre en a un, c'est la même idée qu'une extension d'en-tête et de pied de page avec une chose de moins à installer. Utilisez le champ de pied de page ou de body plutôt que celui de l'en-tête.

⚠ C'est aussi l'option qui disparaît avec le thème : c'est donc la plus faible des trois, à moins d'être certain que le thème est définitif.

Ce que votre extension de cache va faire

Ceci s'applique quelle que soit la façon dont la balise est arrivée sur la page, extension ou non.

Videz le cache après avoir ajouté la balise. Une page en cache a été générée avant que la balise n'existe et ne la contient pas : rien n'arrive et rien n'est cassé.

Excluez le script Skomi de la « combinaison du JavaScript » et de toute option qui copie les scripts tiers sur votre propre serveur. Skomi construit un paquet par site à partir des produits que vous avez activés, et le navigateur est censé aller chercher le paquet courant. Une copie figée dans le lot de votre extension d'optimisation est gelée au jour où elle a été copiée : activer un produit plus tard ne changerait rien, et il n'y aurait rien à voir qui explique pourquoi.

Les extensions d'optimisation qui se contentent de différer ou de retarder le script ne posent pas de problème : la balise porte déjà defer.

Plus d'un site

Un multisite WordPress, ou plusieurs installations, veut dire plusieurs sites dans Skomi : chaque domaine est enregistré séparément et reçoit son propre identifiant, et chaque sous-site a besoin de sa propre balise. Les sous-domaines d'un domaine enregistré sont acceptés par le site auquel ils appartiennent.

Vérifier que cela fonctionne

Chargez une page de votre site puis regardez votre tableau de bord. Si rien n'arrive, parcourez que vérifier quand l'extrait ne fonctionne pas ; sur WordPress la réponse est presque toujours un cache qui n'a pas été vidé, ou une extension d'optimisation qui a réécrit la balise.