Scripts (injection de JavaScript personnalisée)

Dans cet article, vous allez gérer le JavaScript personnalisé qu'OmniLab peut charger dans Pages depuis l'organisation globale. Les administrateurs configurent et gouvernent ces scripts de manière centralisée, tandis que les développeurs doivent écrire et relire le code lui-même.

Prérequis

• Vous disposez d'un accès administrateur sur l'organisation globale.
• Le code du script a été validé par le bon responsable technique.
• Vous avez un environnement de test ou de préproduction disponible.
• Vous savez comment désactiver rapidement le script s'il provoque un problème.

Comment les scripts se comportent

Les scripts sont configurés uniquement dans l'organisation globale, mais ils peuvent tout de même lire les valeurs de l'organisation courante. Cela signifie qu'un même script global peut s'adapter à chaque organisation en lisant window.omnilab?.group?.configuration?.variables.

Les modifications de script ne sont prises en compte dans Pages qu'après une nouvelle publication de la campagne. Si vous enregistrez un script sans republier la campagne, l'expérience en direct continue d'utiliser la version précédente.

Référence des champs

Configurer un script

Utiliser les variables au niveau organisation dans les scripts

Un script global peut tout de même se comporter différemment selon l'organisation en lisant les valeurs exposées sur l'objet de page OmniLab.

La plupart des variables au niveau organisation utilisent ce préfixe commun dans le script :

window.omnilab?.group?.configuration?.variables?.

Ajoutez ensuite l'un de ces noms de variable après ce préfixe :

Ajoutez un fallback dans le script lorsque c'est nécessaire, par exemple centerLanguage || 'English' ou locale || 'en_US'.

Par exemple :

window.omnilab?.group?.configuration?.variables?.country
window.omnilab?.group?.configuration?.variables?.centerLanguage || 'English'
window.omnilab?.group?.configuration?.variables?.locale || 'en_US'
window.omnilab?.group?.configuration?.variables?.region

D'autres valeurs utiles existent en dehors de l'objet des variables d'organisation :

window.omnilab?.group?.uniqueKey
window.location.pathname

Exemples de scripts

Chargeur de base Google Tag Manager

Utilisez cet exemple quand votre équipe veut que GTM soit disponible avant d'émettre d'autres événements.

<script>
(function (w, d, s, l, i) {
  w[l] = w[l] || [];
  w[l].push({
    'gtm.start': new Date().getTime(),
    event: 'gtm.js',
  });
  var f = d.getElementsByTagName(s)[0],
    j = d.createElement(s),
    dl = l != 'dataLayer' ? '&l=' + l : '';
  j.async = true;
  j.src = 'https://www.googletagmanager.com/gtm.js?id=' + i + dl;
  f.parentNode.insertBefore(j, f);
})(window, document, 'script', 'dataLayer', 'GTM-AB12C3D');
</script>

Événement de vue avec variables d'organisation

Ce modèle pousse un événement de vue et l'enrichit avec des variables au niveau organisation.

<script>
window.dataLayer = window.dataLayer || [];
window.dataLayer.push({
  event: 'view_page',
  country: window.omnilab?.group?.configuration?.variables?.country,
  region: window.omnilab?.group?.configuration?.variables?.region,
  language:
    window.omnilab?.group?.configuration?.variables?.centerLanguage || 'English',
  locale:
    window.omnilab?.group?.configuration?.variables?.locale || 'en_US',
  page: window.location.pathname,
  page_type: 'Experience',
  organisation_key: window.omnilab?.group?.uniqueKey?.toUpperCase(),
  surface: 'Pages',
});
</script>

Événement d'inscription avec dataLayer.push

Utilisez cet exemple quand vous voulez émettre un événement de conversion après une inscription.

<script>
window.dataLayer = window.dataLayer || [];
window.dataLayer.push({
  event: 'registration_complete',
  organisation_key: window.omnilab?.group?.uniqueKey?.toUpperCase(),
  country: window.omnilab?.group?.configuration?.variables?.country,
  locale:
    window.omnilab?.group?.configuration?.variables?.locale || 'en_US',
  page: window.location.pathname,
  registration_status: 'complete',
});
</script>

Déclencheur d'inscription Meta Pixel

Utilisez ce modèle quand le script de base Meta Pixel est déjà présent et qu'il vous suffit de déclencher un événement depuis OmniLab Pages.

<script>
if (typeof window.fbq === 'function') {
  window.fbq('track', 'CompleteRegistration', {
    organisation_key: window.omnilab?.group?.uniqueKey,
    country: window.omnilab?.group?.configuration?.variables?.country,
    locale:
      window.omnilab?.group?.configuration?.variables?.locale || 'en_US',
    page: window.location.pathname,
  });
}
</script>

Checklist opérationnelle

• Vérifiez que le script ne bloque pas le chargement de page ni les actions utilisateur.
• Testez le consentement, la soumission des formulaires, les parcours de récompense et les redirections sur de vrais parcours de campagne.
• Examinez avec soin l'accès au DOM et la collecte de données.
• Gardez des notes de version pour retrouver rapidement ce qui a changé si un problème survient.

Pour aller plus loin