.. meta:: :description lang=fr: Utiliser Google Analytics dans un projet Sphinx :description lang=en: How to use Google Analytics in a Sphinx project ################################################# Utiliser Google Analytics dans un projet Sphinx ################################################# .. warning:: Je ne conseille plus d'utiliser Google Analytics, je l'ai supprimé de mes pages Web et je ne mettrai plus à jour ces tutoriels. Comme ces pages seraient encore disponibles, dans Google Cache ou les sites web de Archive.org, je préfère les garder ici en ligne. .. note:: Cette page parle de Google Analytics Pour plus de détails, il peut être utile d'aller s'informer ailleurs : * par exemple sur `fr.wikipedia.org/wiki/Google_Analytics `_, * ou sur `www.google.com/analytics `_. .. note:: Cette page parle aussi de Sphinx Et donc, pour plus de détails, il peut aussi être utile d'avoir en tête le fonctionnement de Sphinx, notamment sur le *templating* : `sphinx-doc.org/templating.html `_. Google Analytics, par défaut ---------------------------- Le code de base : .. code-block:: javascript (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','//www.google-analytics.com/analytics.js','ga'); ga('create', 'UA-38514290-15', 'ga-beacon.appspot.com'); ga('send', 'pageview'); Donc, la première solution est bien sûr de modifier la page de *template* principale (normalement, ``_templates/layout.html`` ou ``.templates/layout.html``) et d'y ajouter ce code entre deux balises ````. Si possible, il faut le mettre *à la fin de la page*, pour accélérer le chargement. Une version un peu plus consise ------------------------------- *(Et aussi plus facile à maintenir !)* Il suffit de créer un script ``ga.js`` contenant le morceau de code précédant, et l'ajouter sur votre site, n'importe où. Par exemple : `ga.js `_. Il faut alors l'inclure dans chaque page avec ce code ``HTML`` à la fin du fichier (dans ```` ou à la fin de ````) : .. code-block:: html En plus, la balise ``async`` accélèrera le chargement de la page en *déférant* l'exécution du script. Super ! Comment et où l'inclure ----------------------- Pour un exemple, vous pouvez consulter le fichier *template* de ces pages, `layout.html `_. ------------------------------------------------------------------------------ D'autres solutions ? -------------------- Sphinx propose une petite extension pour facilement ajouter le suivi Google Analytics, voir `sur cette liste `_ (`dans ce dossier sur le dépôt de sphinx-contrib `_). C'est simple et rapide à utiliser, ça marche bien, et par exemple je m'en sers notamment sur des petits projets Sphinx : ``_, ``_ et ``_. .. seealso:: GA-Beacon (``_) Comment utiliser une image d'*une seule pixel* pour analyser les visites d'une page ou d'un courriel via Google Analytics. Statistiques pour Google Analytics (``_) Un résumé de l'utilisation de Google Analytics depuis 3 ans sur ce site, et des graphiques pour illustrer quelques chiffres sur les visiteurs que ce site a attiré. .. (c) Lilian Besson, 2011-2021, https://bitbucket.org/lbesson/web-sphinx/