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.

2 min de lecture

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 scriptS'exécute quandÀ utiliser pour
ALLToujoursLa plupart des chargements d'analytics et de tag manager
IFRAME_ONLYL'adresse de l'expérience contient embedded=1Les scripts qui dialoguent avec une page de votre site autour de l'expérience
NON_IFRAME_ONLYL'adresse ne contient pas embedded=1Un 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éclencheurSe 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 :

Valeurs couramment disponibles pour les scripts
window.omnilab?.group?.uniqueKey
window.omnilab?.group?.configuration?.variables
window.omnilab?.contact?.externalId
window.omnilab?.contact?.email
window.location.pathname

Les 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 :

Un script de pages vues pour toutes les organisations
<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

Sur cette page