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.
Chaque script a deux réglages. Une erreur sur l'un d'eux est la cause la plus fréquente d'un tag qui remonte de faux chiffres.
Où : le Contexte du script
| Contexte du script | S'exécute quand | À utiliser pour |
|---|---|---|
ALL | Toujours | La plupart des chargements d'analytics et de tag manager |
IFRAME_ONLY | L'adresse de l'expérience contient embedded=1 | Les scripts qui dialoguent avec une page de votre site autour de l'expérience |
NON_IFRAME_ONLY | L'adresse ne contient pas embedded=1 | Un bandeau cookies dont vous n'avez besoin que dans ce cas, ou un tag que votre propre page déclenche déjà quand elle intègre l'expérience |
Seules les intégrations dans un site web contiennent embedded=1 : le tag JavaScript l'ajoute, et vous ajoutez vous-même embedded=1 à une iframe écrite à la main. Les apps et les bornes ne l'utilisent pas : leurs scripts utilisent donc ALL, comme le signal d'inactivité de la borne. Voir URLs et paramètres d'intégration.
Quand une expérience s'affiche dans votre site, les outils d'analytics de votre page comptent généralement déjà la visite. Le même tag dans l'iframe la compte une seconde fois.
Quand : l'Événement déclencheur
| Événement déclencheur | Se déclenche |
|---|---|
VISIT | À la visite normale de la page |
REGISTRATION | À l'étape d'inscription |
Placez les événements de conversion dans un script REGISTRATION distinct, plutôt que d'ajouter des conditions au script de pages vues. C'est plus facile à suivre, et plus facile à désactiver si le tag de conversion se déclenche mal. À l'inscription, vos autres scripts actifs restent chargés eux aussi.
Ce qu'un script peut lire
Avant l'exécution de vos scripts, la page met ces valeurs à disposition :
window.omnilab?.group?.uniqueKey
window.omnilab?.group?.configuration?.variables
window.omnilab?.contact?.externalId
window.omnilab?.contact?.email
window.location.pathnameLes valeurs de contact n'existent que si le participant est connu à ce stade du parcours. Dans un script VISIT, pour un visiteur anonyme, elles sont vides, ce qui est normal.
Seules deux valeurs sont garanties
window.omnilab.group.uniqueKey et window.location.pathname existent pour toutes les organisations. Tout ce qui se trouve sous configuration.variables est un espace libre créé par un administrateur, et aucune clé n'est prédéfinie pour vous. Vérifiez lesquelles existent avant d'en utiliser une, et prévoyez toujours une valeur de repli pour une clé qui pourrait manquer.
Désactiver les scripts pour une campagne
Les scripts de Global s'exécutent sur toutes les campagnes, dans toutes les organisations. Pour les écarter d'une campagne, suivez Modifier les textes, ouvrez le groupe Global, et définissez global.scripts.ignore sur true. Republiez ensuite la campagne. Pour n'écarter que certains scripts, limitez-les plutôt à une seule organisation ou à certaines campagnes.
Un seul script pour plusieurs organisations
Si vous gérez plusieurs organisations, comme des régions, des marques ou des centres, lisez les variables d'organisation pour qu'un seul script s'adapte. Cela évite de maintenir plusieurs copies presque identiques :
<script>
var vars = window.omnilab?.group?.configuration?.variables || {};
window.dataLayer = window.dataLayer || [];
window.dataLayer.push({
event: 'view_page',
organisation_key: window.omnilab?.group?.uniqueKey,
country: vars.country,
locale: vars.locale || 'en_GB',
});
</script>Voir Variables d'organisation.
Étapes suivantes
À propos des tags et scripts
Chargez votre tag manager, vos pixels publicitaires et votre bandeau cookies dans les expériences, pour qu'elles se comportent comme le reste de votre site.
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é.