Utiliser le Tag Manager (script de tracking) – Fastory

Le Tag Manager vous permet d'injecter vos propres scripts HTML, CSS ou JavaScript dans vos expériences, vos bots et votre Fanzone, en choisissant précisément le moment où ils se déclenchent. Vous pouvez ainsi brancher vos outils de mesure, vos pixels publicitaires ou vos personnalisations sans jamais toucher au contenu de vos expériences.

À quoi ça sert ?

Le Tag Manager fonctionne comme un gestionnaire de tags classique : vous créez un script, vous choisissez l'événement qui le déclenche, puis vous ciblez les expériences ou les bots concernés. Le script s'exécute ensuite automatiquement côté joueur, au bon moment.

C'est l'outil idéal pour :

envoyer des événements vers vos outils d'analyse (Google Analytics, Matomo, etc.) ;

déclencher un pixel de conversion quand un visiteur participe à un jeu ou gagne un lot ;

transmettre une réponse d'opt-in vers votre CRM ;

personnaliser l'apparence d'une expérience avec votre propre CSS.

Comme les scripts sont gérés au niveau du workspace, vous pouvez les activer, les modifier ou les supprimer à tout moment, sans modifier vos expériences.

Accéder au Tag Manager

Le Tag Manager est disponible via un add-on. Deux niveaux existent :

Tag Manager basique : déclencheurs liés aux expériences et à la Fanzone ;

Tag Manager avancé : ajoute les déclencheurs liés aux bots (ouverture, réponses, concours, instants gagnants).

Une fois l'add-on activé :

Ouvrez les réglages de votre workspace.

Dans la section Plus, cliquez sur Tag Manager.

La liste de vos scripts s'affiche, avec leur titre, leur événement déclencheur, leur ciblage et leur date de création.

L'accès au Tag Manager dépend de votre rôle dans le workspace. Si la page vous est refusée, rapprochez-vous d'un administrateur.

Créer un script

Depuis la page Tag Manager, cliquez sur le bouton Script en haut à droite.

Donnez un titre à votre script dans le champ Titre. Le titre est obligatoire et limité à 30 caractères.

Choisissez la catégorie de consentement dans Dans quelle catégorie se positionne votre script.

Choisissez l'événement déclencheur dans Quand souhaitez-vous déclencher le script ?.

Selon l'événement, ciblez une ou plusieurs expériences dans Dans quelle expérience, ou un ou plusieurs bots dans Dans quel bot. Vous pouvez aussi sélectionner Toutes les expériences ou Tous les bots.

Collez votre code dans l'éditeur, via les onglets HTML, CSS ou JS.

Cliquez sur Valider en bas du panneau.

Votre script est actif immédiatement sur les expériences en ligne concernées : il n'est pas nécessaire de republier vos expériences après avoir créé ou modifié un script.

Les événements déclencheurs disponibles

Chaque script est associé à un événement précis. Voici la liste complète.

Événements liés aux expériences et à la Fanzone

Disponibles avec le Tag Manager basique et le Tag Manager avancé :

Événement	Moment du déclenchement
Quand le visiteur arrive sur l'expérience	À l'ouverture de l'expérience
Quand le visiteur arrive sur votre Fanzone	À l'arrivée sur la Fanzone du workspace
Quand le visiteur arrive sur un écran	À chaque changement d'écran dans l'expérience
Quand le jeu commence	Au lancement d'une partie
Quand le jeu finit	À la fin d'une partie, gagnée ou perdue
Quand le visiteur joue à un jeu	À chaque participation enregistrée
Quand le visiteur arrive sur l'écran gagné	À l'affichage de l'écran de victoire
Quand le visiteur arrive sur l'écran perdu	À l'affichage de l'écran de défaite
Quand il y a une réponse au quiz	À chaque réponse envoyée dans un quiz
Quand le visiteur clique sur un bouton	À chaque clic sur un bouton de l'expérience

Événements liés aux bots

Disponibles uniquement avec le Tag Manager avancé :

Événement	Moment du déclenchement
Quand le bot s'ouvre	À l'ouverture du bot
Quand le bot se ferme	À la fermeture du bot
Quand il y a une réponse au bot	À chaque réponse envoyée dans le bot
Quand il y a une réponse à une question d'opt-in	Quand le visiteur répond à un opt-in
Quand le visiteur participe à un concours	À l'inscription au concours
Quand le visiteur gagne un concours d'instant gagnant	Quand un lot est remporté

Les catégories de consentement

Chaque script doit être rattaché à une catégorie, alignée sur la notification de consentement aux cookies affichée aux visiteurs :

Catégorie	Usage typique
Essentiel	Scripts indispensables au fonctionnement
Personnalisation	Scripts qui adaptent le contenu au visiteur
Mesure d'audience	Outils d'analyse et de statistiques
Design	Scripts d'apparence, disponibles uniquement pour les événements d'arrivée sur l'expérience ou la Fanzone

Côté joueur, un script ne s'exécute que si le visiteur a accepté la catégorie de cookies correspondante. C'est ce qui garantit la conformité RGPD de vos tags. Notez aussi que la catégorie choisie filtre la liste des événements proposés : la catégorie Design ne propose par exemple que les événements d'arrivée.

Insérer des variables dynamiques

Vos scripts peuvent embarquer des variables remplacées automatiquement au moment du déclenchement. Dans les onglets HTML et JS, cliquez sur Ajoutez une variable puis choisissez la variable à insérer : elle apparaît dans votre code sous la forme <<nomDeLaVariable>>.

Les variables communes à tous les événements :

Variable	Contenu
storyId	ID de la story
visitorId	ID du visiteur
visitorEmail	Email du visiteur
brickId	ID de l'écran
brickName	Nom de l'écran
currentUrl	L'URL visitée par l'utilisateur
userAgent	Le user agent du visiteur
referral	Le referral du visiteur
date	La date de l'évènement

Des variables supplémentaires sont proposées selon l'événement choisi :

fin de partie : gameSuccess (le joueur a-t-il gagné ?), score, personalityScore, successRate ;

participation à un jeu : participation ;

événements de bot : sequenceId et sequenceName ;

réponse au bot : questionId, questionName, answerValue ;

réponse d'opt-in : optinValue (la réponse du visiteur à l'opt-in) et optinName ;

participation à un concours : contestId, contestName ;

instant gagnant : rewardId, rewardName et le code de la dotation.

Exemple : pour envoyer la réponse d'opt-in vers votre outil, insérez <<optinValue>> dans votre script. À l'exécution, la variable est remplacée par la valeur réelle, par exemple true si le visiteur a coché la case.

Bonnes pratiques

Donnez des titres explicites à vos scripts, par exemple GA4 - participation jeu, pour retrouver facilement chaque tag dans la liste.

Choisissez la catégorie de consentement la plus honnête : un pixel publicitaire ou un outil de statistiques n'a pas sa place en Essentiel.

Ciblez précisément vos expériences plutôt que de sélectionner Toutes les expériences par défaut : vous éviterez des déclenchements inattendus sur de futures campagnes.

Testez toujours votre script en conditions réelles : ouvrez l'expérience publiée, acceptez la catégorie de cookies concernée, puis vérifiez dans votre outil de mesure que l'événement arrive bien.

Pensez à tester aussi le cas où le consentement est refusé, pour vérifier que votre parcours reste fonctionnel.

Modifiez ou supprimez vos scripts directement depuis la liste : les changements s'appliquent aux expériences en ligne sans republication.

Cas d'usage concrets

Si vous voulez mesurer les participations dans Google Analytics, utilisez l'événement de participation

Créez un script avec l'événement Quand le visiteur joue à un jeu, catégorie Mesure d'audience, ciblé sur votre campagne. Dans l'onglet JS, envoyez un événement à votre outil avec les variables storyId et visitorId.

Si vous voulez déclencher un pixel de conversion à la victoire, utilisez l'écran gagné

Créez un script avec l'événement Quand le visiteur arrive sur l'écran gagné et collez le pixel fourni par votre régie publicitaire dans l'onglet HTML.

Si vous voulez transmettre les opt-ins de votre bot à votre CRM, utilisez la réponse d'opt-in

Avec le Tag Manager avancé, créez un script sur l'événement Quand il y a une réponse à une question d'opt-in et insérez les variables <<optinValue>>, <<optinName>> et <<visitorEmail>> dans votre appel.

FAQ

À quoi sert le Tag Manager de Fastory ?

Le Tag Manager de Fastory permet de déclencher vos propres scripts HTML, CSS ou JavaScript sur vos expériences, vos bots et votre Fanzone, sans modifier le contenu de vos expériences. Il sert notamment à brancher des outils de mesure d'audience, des pixels de conversion ou des scripts de personnalisation.

Quels événements peuvent déclencher un script dans le Tag Manager de Fastory ?

Seize événements sont disponibles : arrivée sur l'expérience, arrivée sur la Fanzone, arrivée sur un écran, début et fin de jeu, participation, écran gagné, écran perdu, réponse au quiz, clic sur un bouton, ainsi que six événements liés aux bots (ouverture, fermeture, réponse, réponse d'opt-in, participation à un concours, gain d'instant gagnant). Les événements de bot nécessitent le Tag Manager avancé.

Quelle est la différence entre le Tag Manager basique et le Tag Manager avancé ?

Le Tag Manager basique donne accès aux événements liés aux expériences et à la Fanzone. Le Tag Manager avancé ajoute les événements liés aux bots : ouverture, fermeture, réponses, opt-ins, concours et instants gagnants. Les deux sont des add-ons activables au niveau du workspace.

Comment insérer une variable dynamique comme optinValue dans un script du Tag Manager ?

Dans l'éditeur de script, onglet HTML ou JS, cliquez sur Ajoutez une variable et sélectionnez la variable souhaitée. Elle est insérée dans votre code sous la forme <<optinValue>> et sera remplacée par la valeur réelle au moment du déclenchement du script.

Le Tag Manager de Fastory respecte-t-il le consentement RGPD des visiteurs ?

Oui. Chaque script est rattaché à une catégorie de consentement (Essentiel, Personnalisation, Mesure d'audience ou Design) et ne s'exécute que si le visiteur a accepté la catégorie de cookies correspondante dans la notification de consentement.

Faut-il republier une expérience après avoir créé ou modifié un script dans le Tag Manager ?

Non. Les scripts sont gérés au niveau du workspace et pris en compte automatiquement sur vos expériences déjà en ligne. Il suffit que l'expérience ciblée soit publiée pour que le script s'exécute.

Pourquoi mon script du Tag Manager ne se déclenche-t-il pas ?

Vérifiez trois points : l'expérience ou le bot ciblé correspond bien à celui que vous testez, l'événement choisi se produit réellement dans votre parcours, et vous avez accepté la catégorie de cookies du script lors de votre test. Vérifiez aussi que le titre a bien été validé et que le script apparaît dans la liste du Tag Manager.