Utilisez l'extension. C'est un seul réglage et il survit à un changement de thème, ce que ne fait pas une balise collée dans un thème.

L'extension

  1. Dans WordPress, allez dans Extensions → Ajouter une extension et cherchez Skomi Analytics.
  2. Installez-la et activez-la.
  3. Allez dans Réglages → Skomi Analytics.
  4. Collez votre identifiant de site et enregistrez.

Elle est référencée sur wordpress.org/plugins/skomi-analytics et se met à jour comme toute extension du répertoire.

Si votre site ne peut pas installer depuis le répertoire, téléchargez skomi-analytics.zip, qui récupère toujours la version la plus récente, et téléversez-le dans Extensions → Ajouter une extension → Téléverser une extension. C'est la même extension, WordPress lui propose donc les mêmes mises à jour.

⚠ Si vous allez vous-même dans le dépôt, prenez le zip d'une 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. Elle se retrouverait sous le mauvais nom, et l'extension WooCommerce ci-dessous (qui demande skomi-analytics 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, une fois enregistré, insérerait une balise de script cassée dans 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 voulez les mesurer.

Si vous vendez via WooCommerce, ajoutez aussi Skomi Analytics for WooCommerce (skomi-analytics-for-woocommerce.zip). Il n'est pas encore dans le répertoire : téléversez-le donc dans Extensions → Ajouter une extension → Téléverser une extension. 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.

Le code source des deux est public, dans skomi-plugin-wordpress et skomi-plugin-woocommerce, 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. Cette partie existe 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 et qu'il insère à la priorité 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 des données.

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 intégrée au paquet de votre extension d'optimisation reste figé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 ce qu'il faut 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.