Ajout de paramètres Google Analytics pour Koha

Juin 10, 2020 | Koha

Ajout de paramètres Google Analytics pour Koha

Vous êtes ici :
< Retour

Création du compte Google Analytics

  1. Créer le compte Google Analytics
  2. Configurer le compte Google Analytics dans les paramètres d’administration
  3. Créer une propriété qui permet de partager des données et créer des rapports.
  4. Trouver les informations de votre flux de propriété

Si vous ne voulez pas faire appel aux services Google, sachez qu’il existe d’autres outils d’analyses de données d’utilisations de site web. N’hésitez pas à faire une demande camelot

À noter: la version Google Universal Analytics cessera d’être utilisée à partir du 1er juillet 2023. Vous pouvez cependant faire la transition de votre compte vers Google Analytics4 (voir l’article Passer à Google Analytics4 ).
(au besoin, modifier la langue de cette publication au bas de page)

ancienne version Universal Analytics


Si vous avez l’ancienne version Universal Analytics, suivre cette méthode:

Trouver votre identifiant de flux de propriété
Cet ID de mesure (aka tracking ID) est très important, c’est ce qui liera Koha avec votre Google Analytics.

  1. Aller dans votre page d’administration du site Google Analytics > Adminitration > Flux de données.
  2. Cliquer sur le flux
  3. Copier l’identifiant du champ ID de mesure /trackID (ex. GQ-12345 )

voir cet article Configurer Analytics pour un site Web (Universal Analytics) pour plus d’information.

Configurations Koha

Méthode par la préférence système OPACUserJS

L’ancienne version Universal Analytics pouvait être configurée dans la préférence système OPACUserJS

  1. Aller dans la préférence système OPACUserJS
  2. Copier et coller le code dans la préférence

Si vous avez encore la version Google Universal Analytics, sachez que celle-ci cessera d’être utilisée à partir du 1er juillet 2023. Utilisez plutôt la version Google Analytics4.

Pour utiliser Universal Analytics, copier et coller ce code dans la préférence OPACUserJS

//Begin Google Analytics script
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
})(window,document,'script','https://www.google-analytics.com/analytics.js','ga');
ga('create', 'trackID', 'auto');
ga('send', 'pageview');
//End Google Analytics script

  1. Dans le code, remplacer le terme «trackID» par votre numéro de «tracking ID» du compte Google
    —> chercher « trackID » dans la troisième avant-dernière ligne

Dans cet exemple, le « trackID » = 1234567.

exemple de code dans la préférence OpacUserJS

  1. Entourer le code Google par des balises d’ouverture et de fin
//Begin Google Analytics script
             ... code google
//End Google Analytics script
  1. Enregistrer

Code de balises de propriété

Depuis août 2022, Google offre la nouvelle version Google Analytics4. Cette version est beaucoup plus conviviale, elle vous permet de copier le code complet des balises de propriété et il ne reste qu’à l’ajouter dans Koha.

Pour trouver ces informations:

  1. Aller dans votre page d’administration du site Google Analytics > Adminitration > Flux de données.
  2. Cliquer sur le flux
  3. Dans la page du flux, cliquer sur le bouton «Voir les instructions sur la balise»
    –> Google ouvrira une page d’instructions «Intégrer manuellement»
  4. Copier le code de balise Google
code à copier des instructions d'intégration manuelle

Configurations Koha

Méthode par une publication OpacCredits

Si le langage JavaScript vous est inconnu, vous pouvez tout de même ajouter des outils analytiques à l’aide d’une publication OpacCredits.

  1. Aller dans Outils > Personnalisation HTML
  2. Cliquer sur la flèche du bouton «Nouvelle entrée» et choisir «Nouvelle entrée à l’aide de l’éditeur texte»

  1. Remplir le formulaire:
    • localisation d’affichage: choisir «OpacCredits»
    • Bibliothèque: afficher à toutes les bibliothèques
    • titre: inscrire un nom facile à reconnaitre (ex. Google Analytics )
    • date de publication (important – version 23.05 Koha): choisir la date du jour, c’est grâce à cette date que Koha appliquera les analytics sur l’OPAC ****

À noter: la version 23.05 oblige une date de publication pour permettre l’ajout de publication de type nouvelles ou personnalisations HTML sur l’OPAC.

  1. Dans le contenu du message, coller le code de balise Google (de l’étape 4) dans chaque onglet de langue (Par défaut, français et anglais)
code de balise Google dans le formulaire de publication OpacCredits
code de balise Google dans le formulaire de publication OpacCredits
code de balise Google dans le formulaire de publication OpacCredits

  1. Enregistrer la publication
  2. Aller sur votre OPAC et faire quelques tests d’utilisations
  3. Consulter le tableau de bord de Google Analytics > Rapports > Temps réel
Icône rapport sous l'accueil du site Google Analystics , suivi de la deuxième option «Temps réel»


–> Lorsque tout sera bien configuré, vos tests d’utilisations devraient apparaître instantanément dans votre rapport d’analyse.

Consulter la publication OpacCredits

La meilleure méthode pour consulter le code de votre propriété Google Analytics dans la publication est la suivante:

  1. Aller dans Outils > Personnalisation HTML
  2. Trouver la publication de localisation = «OpacCredits» et le bon titre (ex. Google Analytics)
  3. Cliquer sur la flèche du bouton et choisir l’option «Éditeur texte»
    –> Koha devrait montrer le code caché du témoin de Google Analytics

À noter: le mode «Éditeur texte» est la seule méthode de consultation. Malheureusement, il ne sera pas possible de modifier ce code par l’éditeur standard (clic au centre du mot « modifier »).

Il faut absolument cliquer sur la flèche du bouton pour pouvoir la consulter.

Ressources de la Communauté


Setting up Google Analytics with Koha (vidéo) (anglais)

Tags:
Table des matières