Blog
SignalHost pour TYPO3 : installez l’extension, connectez chaque site, et le suivi côté serveur est actif
Publié · 8 min de lecture
Disponible sur TYPO3 Extension Repository
L’extension SignalHost installe Google Tag Manager côté serveur sur vos sites TYPO3 sans une seule ligne de code à coller. Elle ajoute le chargeur de suivi sur chaque page frontend d’un site connecté, le maintient à jour quand quelque chose change de notre côté, et le retire quand vous vous déconnectez. Chaque site d’une installation multisite se connecte séparément, et ce guide suit un site, de l’installation jusqu’au test.
Avant de commencer
- TYPO3 13.4 LTS ou 14.3 LTS, sous PHP 8.2 ou version ultérieure avec l’extension sodium.
- Un compte SignalHost. L’offre gratuite suffit pour essayer : 10 000 requêtes par mois et un conteneur. Vous pouvez créer le compte pendant la connexion.
- Un compte administrateur du backend. Le module SignalHost est réservé aux administrateurs.
- Un site dont la base, dans sa configuration de site, comporte un domaine, comme https://www.example.com/.
1. Installer l’extension
Dans une installation basée sur Composer, ajoutez-la depuis Packagist :
composer require signalhost/server-side-taggingEn mode classique, installez-la plutôt depuis l’Extension Manager ; elle se trouve dans le TYPO3 Extension Repository sous la clé signalhost_server_side_tagging. Elle n’ajoute rien à un site tant que ce site n’est pas connecté.
2. Connecter un site à un conteneur
Dans le backend de TYPO3, ouvrez Sites › SignalHost (Site Management › SignalHost sous TYPO3 13), où chaque site a sa propre carte. Après la connexion, SignalHost vous renvoie vers l’adresse propre du site : ouvrez donc le backend sous le domaine de ce site ; ailleurs, la carte propose un bouton qui ouvre la page sur ce domaine, où vous devrez peut-être vous connecter une fois.
Sur la carte du site, cliquez sur « Connect with SignalHost », ou sur « Create a free account » si vous n’avez pas encore de compte. Rien n’est envoyé à SignalHost avant que vous ne cliquiez sur « Connect ». Sur signalhost.io, connectez-vous. L’écran suivant indique ce que l’extension pourra et ne pourra pas faire, et vous demande quel conteneur le site doit utiliser. Un conteneur est votre propre serveur de tagging : un conteneur web et un conteneur serveur Tag Manager, construits dans votre propre compte Google, si bien qu’ils restent à vous.
Choisissez un conteneur existant, ou cliquez sur « Nouveau conteneur pour … » suivi de l’adresse de votre site et passez par le court assistant. La construction d’un nouveau conteneur prend quelques minutes ; vous pouvez vous connecter tout de suite, et le code est ajouté dès qu’il est prêt. Cliquez sur « Connecter », et vous revenez sur la carte avec le message « Connected. SignalHost's code is now added to every page of this site. » Répétez l’opération pour chaque site que vous voulez suivre.
3. Vérifier que le code est sur votre site
La carte du site indique maintenant « Tracking is live », ou « Tracking starts as soon as your container is ready » tant qu’un nouveau conteneur est encore en construction. Lisez ensuite la ligne « On your home page » : juste après la connexion, l’extension récupère votre page d’accueil comme le ferait un visiteur et y cherche son code. « Code found » est la réponse que vous voulez. « Check again » relance la vérification à tout moment, et les autres réponses sont expliquées sous « Quand quelque chose ne fonctionne pas ».
4. Le tester
Ouvrez votre site dans une fenêtre de navigation privée et parcourez quelques pages ; un visiteur qui refuse votre bannière de cookies est tout de même compté, sous la forme du signal sans cookie de Google. Cliquez ensuite sur « Open statistics & settings » pour ouvrir la page de votre conteneur sur signalhost.io.
Sous « Statistiques avancées », l’onglet « Récent » affiche les pages vues des 30 dernières minutes, dont les vôtres. « Lancer les vérifications », sous « Dépannage » au bas de la page, compare ce que votre serveur de tagging a reçu avec ce que Google Analytics rapporte pour les mêmes 30 minutes. Un chiffre plus faible dans Analytics est normal : il exclut les visiteurs qui ont refusé les cookies. À partir de l’offre Growth, « Suivi des événements en direct » affiche chaque événement à son arrivée.
Ce que l’extension ajoute à votre site
Un petit script par site connecté, et une synchronisation toutes les heures :
- Le chargeur Google Tag Manager, juste avant la fin du head de chaque page frontend, pointé vers l’adresse de tagging propre au site au lieu de googletagmanager.com. Il charge votre conteneur Tag Manager depuis cette adresse. Il est inséré dans la page terminée après le cache de pages de TYPO3, si bien qu’aucun cache n’a besoin d’être vidé. Si le site applique la Content Security Policy de TYPO3, l’extension y ajoute l’adresse de tagging et autorise le chargeur par son empreinte, sauf si la politique autorise déjà les scripts inline.
- Une fois par heure, après l’envoi d’une réponse, l’extension contacte signalhost.io pour rester à jour. Elle n’envoie que les versions de l’extension, de TYPO3 et de PHP, l’adresse du site et le fait que le code a été trouvé ou non sur la page d’accueil : aucune donnée de visiteur, aucun contenu, aucun compte utilisateur. Si signalhost.io est injoignable, le site conserve la dernière configuration valide.
Chaque requête quitte le navigateur sous une forme que les bloqueurs de publicité ne reconnaissent pas, et votre serveur de tagging la transmet à Google Analytics 4 et aux plateformes publicitaires que vous configurez sur la page du conteneur : Google Ads, Meta, TikTok et d’autres. Le suivi respecte votre bannière de cookies via Google Consent Mode. Le chargeur vient après une bannière placée dans le head ; une bannière chargée plus tard doit définir les valeurs par défaut de Consent Mode avant lui.
L’extension ne lit ni les formulaires ni les commandes. Les pages vues arrivent d’elles-mêmes ; un achat ou un prospect atteint votre conteneur lorsque votre site le pousse dans le dataLayer.
Votre propre domaine de suivi
Votre conteneur démarre sur une adresse sous signalhost.io. Avec une offre payante, « Configurer votre propre domaine » sur la page du conteneur le déplace vers un sous-domaine de votre propre site, comme sgtm.votresite.com, avec un seul enregistrement DNS chez votre fournisseur. Cette adresse résiste aux listes de filtres et garde les cookies de clic first-party. Une fois qu’elle est en ligne, l’extension y bascule ce site lors de sa prochaine synchronisation, généralement dans l’heure, et sa Content Security Policy suit. Rien n’est à remplacer à la main, et l’ancienne adresse continue de fonctionner d’ici là.
Ajouter SignalHost à la main
Vous pouvez aussi coller le code vous-même. Sur la page du conteneur, trouvez votre extrait dans la carte « Installer sur votre site » et cliquez sur « Copier ». Collez-le dans le head de chaque page (dans TYPO3, via votre template ou TypoScript), juste après le script de votre bannière de cookies, et cliquez sur « C’est fait ». « Copier pour un agent IA » confie la même tâche à un agent de programmation.
Le collage à la main renonce à ce que fait l’extension : rien ne vérifie votre page d’accueil, rien ne retire le code quand vous vous déconnectez, un site qui applique la Content Security Policy de TYPO3 doit autoriser à la main le script et l’adresse de tagging, et quand votre propre domaine est en ligne, c’est à vous de remplacer le code, à partir de « Mettez à jour le snippet de votre site » sur la carte ou de l’e-mail annonçant le domaine. N’utilisez jamais les deux voies : deux copies comptent chaque visite deux fois.
Mises à jour, gestion et déconnexion
Mettez-la à jour de la même manière que vous l’avez installée : via Composer, ou depuis l’Extension Manager en mode classique.
« Disconnect », sur la carte d’un site, demande une confirmation, puis retire immédiatement le code de SignalHost de chaque page de ce site et révoque son accès. Les autres sites restent connectés, et votre conteneur et ses données restent dans votre compte SignalHost.
Sur signalhost.io, la page du conteneur indique « Installé par l’extension TYPO3 sur » suivi de votre site. Son bouton « Gérer » mène à Paramètres › Sites connectés, où « Déconnecter » fonctionne aussi : l’extension cesse de charger SignalHost lors de sa prochaine synchronisation, généralement dans l’heure.
Désactiver l’extension dans l’Extension Manager, en mode classique, révoque l’accès de chaque site et supprime ce qu’elle a enregistré. composer remove n’exécute aucun code TYPO3 : déconnectez donc d’abord chaque site ; sinon, ils restent listés sous Paramètres › Sites connectés, et vous les déconnectez là.
Quand quelque chose ne fonctionne pas
- La carte indique que SignalHost vous renvoie vers l’adresse propre du site après la connexion : vous avez ouvert le backend sous un autre domaine. Utilisez le bouton situé en dessous pour ouvrir la page sur le domaine du site.
- « Could not check (your server refused a request to itself) » : votre hébergeur bloque les requêtes vers sa propre adresse. Cela ne dit rien de vos visiteurs ; cherchez votre adresse de tagging dans le code source de votre page d’accueil.
- « An older copy is on the page » ou « The code is on the page twice » : une copie a été collée à la main dans un template, du TypoScript ou une autre extension. Retirez-la ; l’extension ajoute la version actuelle, et deux copies comptent chaque visite deux fois.
- Un avis indiquant que votre site charge déjà un conteneur Tag Manager avec l’extrait de Google lui-même : retirez cet extrait, car SignalHost charge désormais le conteneur et les deux ensemble comptent chaque visite deux fois.
- « This site's address has changed since it was connected » : sur une copie, comme une préproduction, rien n’est envoyé. Si le site en ligne a déménagé, déconnectez-le et reconnectez-le.
- Pour tout le reste : écrivez à hello@signalhost.io en indiquant l’adresse de votre site.
Marques
SignalHost est un produit indépendant d’Algorithmo GmbH ; il n’est ni affilié à la TYPO3 Association, à Google, à Meta ou à TikTok, ni approuvé par eux. Google Analytics, Google Ads et Google Tag Manager sont des marques de Google LLC ; Meta est une marque de Meta Platforms, Inc. ; TikTok est une marque de ByteDance Ltd. ; TYPO3 est une marque déposée de la TYPO3 Association.

