Avec Matomo Tag Manager, vous affichez le widget ViaSay sur toutes les pages de votre site sans modifier son code. Il suffit d'une balise et d'un déclencheur. La personne qui gère Matomo peut le faire seule, sans développeur.
Avant de commencer
Un compte Matomo qui peut créer des balises et publier le conteneur (l'espace qui regroupe les balises de votre site).
Matomo Tag Manager déjà installé sur votre site : son code est chargé sur chacune de vos pages.
Le code de votre Widget ViaSay, dans Build > Integrate > Channels > Integration. Si vous n'avez pas encore de Widget, commencez par Créer un Widget ViaSay.
Astuce : réglez Audience Distribution sur 0 % pendant la mise en place. Le code est déployé mais le widget reste masqué. Vous l'affichez ensuite en changeant le pourcentage dans Integration, sans toucher à Matomo.
Étape 1 : créer la balise
Une balise (tag) est le code que Matomo ajoute à vos pages. Ici, c'est celui du widget.
Ouvrez Tag Manager, puis cliquez sur Tags dans le menu de gauche.
Cliquez sur Create New Tag.
Choisissez le type Custom HTML, dans la catégorie Custom. Il accepte n'importe quel code, dont le script du widget.
Dans Name, saisissez « Widget ViaSay ».
Dans Custom HTML, collez le code de votre Widget. Laissez Position sur Body End.
Le token (l'identifiant de votre Widget) de la capture est fictif : collez le code de votre propre Widget.
Étape 2 : afficher le widget sur toutes les pages
Un déclencheur (trigger) dit à Matomo quand lancer la balise. Le déclencheur Pageview la lance à chaque page vue, donc sur tout le site.
Descendez jusqu'à Configure when the tag should do this.
Ouvrez la première liste déroulante et choisissez Pageview.
Cliquez sur Create New Tag en bas du formulaire.
La balise apparaît dans la liste, avec le déclencheur Pageview. Elle n'est pas encore en ligne : il reste à la tester, puis à la publier.
Étape 3 : tester avant de publier
Le mode aperçu (preview) affiche votre site avec la nouvelle balise, visible par vous seul.
Cliquez sur Preview / Debug dans le menu de gauche.
Saisissez l'adresse de votre site, puis cliquez sur Debug. Votre site s'ouvre dans un nouvel onglet.
Dans le panneau Matomo en bas de page, vérifiez que Widget ViaSay figure dans Fired Tags.
Cliquez sur Stick to Top si le panneau masque le bas de la page : le widget apparaît alors en bas à droite.
Étape 4 : publier
Cliquez sur Publish dans le menu de gauche, ou sur le lien Publish a new version now de la bannière verte.
Saisissez un nom de version, par exemple « Widget ViaSay ».
Cliquez sur Create New Version And Publish Release.
Cliquez sur Disable Preview dans le menu de gauche, pour quitter le mode aperçu.
Vérifier que ça fonctionne
Ouvrez votre site dans une fenêtre de navigation privée.
Naviguez sur quelques pages : le widget doit s'afficher sur chacune d'elles.
Vous le voyez à l'emplacement réglé dans Format & Design. Si Audience Distribution est réglé sur 0 %, il reste masqué jusqu'à ce que vous changiez le pourcentage (voir la section suivante).
Si ça ne fonctionne pas
Le widget ne s'affiche pas, alors que la balise s'est déclenchée : son affichage est peut-être réglé sur 0 %. C'est un réglage courant pendant la mise en place : le code est en ligne, mais le widget reste masqué tant que vos équipes ne l'ont pas passé à 100 %. Ouvrez Integration et ajustez Audience Distribution. L'article Gérer la visibilité de votre widget détaille ce réglage.
Le type Custom HTML n'est pas proposé : Matomo permet de désactiver ces balises par sécurité. Demandez à un administrateur de les réactiver dans Administration > General Settings.
Widget ViaSay n'apparaît pas dans Fired Tags : la balise n'a pas de déclencheur. Ouvrez-la et reprenez l'étape 2.
Le panneau de debug ne s'affiche pas : ajoutez ?mtmPreviewMode= suivi de l'identifiant du conteneur à l'adresse de votre site. Matomo l'affiche dans l'écran Preview / Debug.
Le widget n'apparaît toujours pas : vérifiez que le token collé dans la balise est celui de votre Widget.
Étapes suivantes
Gérer la visibilité de votre widget : choisissez les pages où il s'affiche.
Acceptation des cookies pour l'affichage du widget : adaptez l'affichage au consentement de vos visiteurs.
Installer le Widget avec Google Tag Manager : la même installation avec l'outil de Google.