Ajouter un script
Ajoutez un tag ou un script dans l'organisation Global, choisissez quand il s'exécute, et republiez les campagnes en ligne pour qu'il y soit chargé.
Un script enregistré n'a aucun effet sur une campagne en ligne tant que cette campagne n'est pas republiée. C'est l'étape que l'on oublie le plus souvent.
Avant de commencer
- Il vous faut un accès Admin aux Paramètres Généraux de Global.
- Munissez-vous du code du script, fourni par votre équipe web ou par l'écran de configuration de l'outil. Retirez les lignes de commentaire HTML qui l'entourent, comme
<!-- Google Tag Manager -->. - Identifiez le contexte et le déclencheur nécessaires : voir Où et quand s'exécute un script.
Préparer votre test
Testez le script sur une campagne avant qu'il ne soit chargé dans une campagne en ligne.
- Avec un environnement de staging : suivez d'abord cette page dans cet environnement, sur une campagne que personne n'utilise.
- Sans environnement de staging : ajoutez le script ici, puis publiez une seule campagne inutilisée, et testez-la.
Toute republication charge le script
Une fois enregistré, le script se charge dans toute campagne publiée par n'importe qui, dans toutes les organisations, pas seulement dans votre campagne de test. Tant que votre test n'est pas concluant, limitez-le à la campagne de test : voir Un script pour certaines campagnes seulement.
Ajouter le script
Dans le sélecteur d'organisation, choisissez Global, puis sélectionnez Paramètres Généraux. Ensuite :
-
Sélectionnez l'onglet Scripts.

-
Sélectionnez Ajouter un script.

-
Dans le champ Nom, indiquez ce qu'il fait et qui en est responsable, par exemple
GTM container (web team).
Un nom clair se retrouve facilement un an plus tard ; « Script 3 », beaucoup moins.
-
Choisissez le Contexte du script, c'est-à-dire où il s'exécute. Voir Où et quand s'exécute un script.

-
Choisissez l'Événement déclencheur, c'est-à-dire quand il s'exécute, par exemple VISIT.

-
Réglez l'option Actif ? sur Oui.

-
Collez le code dans le champ Code du script.

-
Sélectionnez Enregistrer la configuration.

Tester le script
Publiez votre campagne de test, et seulement celle-là. Puis, sur cette campagne :
- Déroulez le parcours participant complet : navigation, formulaires, boutons et étape de récompense.
- Ouvrez la console du navigateur, et cherchez les erreurs introduites par le script.
- Vérifiez que le tag s'est déclenché, dans l'outil de destination plutôt que dans Studio.
- Si le consentement est en jeu, refusez-le, et vérifiez que vos tags restent silencieux.
Une fois le test réussi, retirez du code la restriction à la campagne de test, puis sélectionnez à nouveau Enregistrer la configuration.
Republier les campagnes
Dans chaque campagne qui doit charger le script :
-
Sélectionnez Publier.

Si vous enregistrez le script et vous arrêtez là, les campagnes en ligne continuent de fonctionner sans lui, même si l'écran des paramètres semble correct.
Désactiver un script
Pour arrêter un script rapidement, réglez l'option Actif ? sur Non au lieu de le supprimer. Réactivez-le une fois que vous avez compris ce qui s'est passé. La désactivation demande, elle aussi, de republier les campagnes : intégrez cette étape dès maintenant à votre plan de retour arrière, pas pendant un incident.
En cas de blocage
- Le tag ne se déclenche pas sur une campagne en ligne : la campagne n'a pas été republiée depuis l'ajout du script.
- Il se déclenche deux fois : l'expérience est intégrée dans une page qui déclenche déjà le même tag. Réglez le Contexte du script sur
NON_IFRAME_ONLY, et vérifiez que l'adresse intégrée contientembedded=1: le tag JavaScript l'ajoute. - Au clic sur Enregistrer la configuration, le message « Script invalide : il doit s'agir de HTML valide, avec du JavaScript valide dans des balises
<script>. » s'affiche : le code doit commencer par<scriptet se terminer par</script>, ou contenir à la fois un bloc<script>et un bloc<noscript>. Retirez les lignes de commentaire, et vérifiez que le JavaScript qu'il contient n'a pas d'erreur de syntaxe. - L'expérience ne fonctionne plus après l'ajout d'un script : désactivez le script, republiez, et vérifiez que l'expérience se rétablit avant d'enquêter.
Étapes suivantes
Où et quand s'exécute un script
Choisissez le contexte et le déclencheur d'un script, et voyez quelles valeurs il peut lire sur l'organisation et le participant en cours.
Exemples de scripts
Du code prêt à l'emploi : tag managers, pixels publicitaires, bandeaux cookies, événements de conversion, scripts limités à une organisation ou à des campagnes.