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.

Choisissez quand un script se déclenche, pour qu'un tag de conversion ne parte pas sur une simple visite et qu'un tag réservé à l'intégration ne s'exécute pas là où il n'a aucun sens. Chaque script porte deux réglages, et se tromper dessus est la première cause de chiffres faux.

Où : le contexte

Contexte	S'exécute quand	À utiliser pour
Partout	Expériences autonomes et intégrées	La plupart des chargements d'analytics et de tag manager
Intégré uniquement	L'expérience est dans votre site ou votre app	Un tag qui compterait double parce que votre page le déclenche déjà
Autonome uniquement	L'expérience constitue sa propre page	Un bandeau cookies nécessaire seulement quand OmniLab est toute la page

La distinction « intégré » compte plus qu'il n'y paraît. Quand une expérience tourne dans votre site, l'analytics de votre page compte déjà la visite — un second tag dans l'iframe la compte une deuxième fois.

Quand : le déclencheur

Déclencheur	Se déclenche
Chargement de page	À la visite normale
Inscription	À l'étape d'inscription

Utilisez un script distinct déclenché à l'inscription pour les événements de conversion, plutôt que de surcharger le script de visite avec des conditions. C'est plus simple à raisonner, et plus simple à désactiver si le tag de conversion se déclenche mal.

Ce qu'un script peut lire

Avant l'exécution de vos scripts, OmniLab met certaines valeurs à disposition sur la page :

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 déjà connu à ce stade du parcours. Les lire dans un script de chargement de page pour un visiteur anonyme ne renvoie rien — ce qui est correct, pas un bug.

Seules deux valeurs sont garanties

window.omnilab.group.uniqueKey et window.location.pathname existent pour toute organisation. Tout ce qui se trouve sous configuration.variables est un magasin libre créé par un administrateur — aucune clé n'est prédéfinie. Vérifiez lesquelles existent avant de les référencer, et prévoyez toujours une valeur de repli.

Faire servir un seul script à plusieurs organisations

Si vous gérez plusieurs organisations — régions, marques ou lieux — utilisez les variables d'organisation pour qu'un seul script s'adapte, au lieu de maintenir plusieurs copies presque identiques :

country: window.omnilab?.group?.configuration?.variables?.country,
locale: window.omnilab?.group?.configuration?.variables?.locale || 'en_US',

Voir Variables au niveau organisation.

Pour aller plus loin

Tags et scriptsAjouter un scriptOù ces réglages se choisissent.Tags et scriptsExemples de scriptsDu code qui fonctionne pour les cas courants.OrganisationsVariables au niveau organisationFaire qu'un script s'adapte à plusieurs organisations.