Exemples de scripts

Du code prêt à l'emploi : tag managers, pixels publicitaires, bandeaux cookies, événements de conversion, scripts limités à une organisation ou à des campagnes.

3 min de lecture

Cette page s'adresse à la personne qui écrit le script. Copiez un exemple, remplacez les identifiants, et transmettez-le à l'administrateur chargé de l'ajouter. Les scripts s'exécutent dans vos pages de campagne, pas dans Studio. Pour les valeurs qu'un script peut lire et ses deux réglages, voir Où et quand s'exécute un script.

Votre code doit contenir de vraies balises script

Le champ Code du script attend un ou plusieurs blocs <script>...</script> valides : le code commence par <script et se termine par </script>, ou contient aussi un bloc <noscript>. Les scripts inline et les chargeurs de scripts externes fonctionnent tous les deux. Retirez les lignes de commentaire HTML que contient souvent l'extrait fourni par un outil, comme <!-- Google Tag Manager --> : elles font échouer la vérification.

Exemple de script inline
<script>
window.dataLayer = window.dataLayer || [];
window.dataLayer.push({
  event: "omnilab_view",
  organisation_key: window.omnilab?.group?.uniqueKey,
  page: window.location.pathname,
});
</script>
Exemple de script externe
<script async src="https://www.lindenhall.example/js/analytics.js"></script>

Pour les patterns qui fonctionnent et ceux qui perturbent les campagnes, voir Patterns courants et pièges à éviter.

Transmettre le script à votre administrateur

Indiquez à l'administrateur :

  • le nom du script ;
  • le Contexte du script : ALL, IFRAME_ONLY ou NON_IFRAME_ONLY ;
  • l'Événement déclencheur : VISIT ou REGISTRATION ;
  • s'il doit démarrer actif ou inactif ;
  • une consigne de retour arrière, et le résultat de votre test : voir Tester le script.

Exemples de scripts complets

Chargeur de base Google Tag Manager

Utilisez-le quand votre équipe veut disposer de GTM avant de déclencher d'autres événements.

Chargeur Google Tag Manager
<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-LH12345');
</script>

Événement de page vue avec variables d'organisation

dataLayer.push de page vue
<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?.language || '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: 'campaign pages',
});
</script>

country, region, language et locale sont des variables d'organisation créées par Lindenhall, pas des champs intégrés : voir Ce qu'un script peut lire.

Événement d'inscription avec dataLayer.push

Utilisez-le pour envoyer un événement de type conversion après l'inscription.

dataLayer.push d'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>

À l'inscription, window.omnilab?.contact?.externalId et window.omnilab?.contact?.email sont aussi disponibles, si votre plan de mesure en a besoin.

Déclencheur d'inscription Meta Pixel

Utilisez-le quand le Meta Pixel de base est déjà sur la page, et que vous devez seulement déclencher un événement depuis vos pages de campagne.

Événement d'inscription Meta Pixel
<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>

Une seule organisation

Les campagnes de toutes les organisations chargent les scripts de Global. Utilisez ce pattern pour un pixel ou un tag propre à un seul centre.

Exécuter pour une seule organisation
<script>
(function () {
  if (window.omnilab?.group?.uniqueKey !== 'lindenhall') return;

  // Le tag propre à Lindenhall se place ici.
  window.dataLayer = window.dataLayer || [];
  window.dataLayer.push({ event: 'lindenhall_view', page: window.location.pathname });
})();
</script>

uniqueKey est la Clé Unique du Groupe de l'organisation, ici lindenhall. Sur les campagnes de toute autre organisation, le script s'arrête dès sa première ligne.

Un script pour certaines campagnes seulement

Utilisez ce pattern quand un script doit s'exécuter sur certaines campagnes et pas sur d'autres. Chaque entrée est le chemin d'une campagne : la partie de son lien après le domaine, par exemple /lindenhall-autumn-kiosk.

Exécuter seulement sur les campagnes listées
<script>
(function () {
  var CAMPAIGNS = ['/lindenhall-autumn-kiosk', '/lindenhall-christmas-kiosk'];
  var path = window.location.pathname;
  var listed = CAMPAIGNS.some(function (c) {
    return path === c || path.indexOf(c + '/') === 0;
  });
  if (!listed) return;

  window.dataLayer = window.dataLayer || [];
  window.dataLayer.push({ event: 'kiosk_view', page: path });
})();
</script>

Une entrée correspond au chemin exact, ou au début d'un chemin plus long : /lindenhall-autumn seul ne correspond donc à aucune campagne. Cela fonctionne aussi bien sur votre adresse par défaut que sur votre domaine personnalisé. Transmettez la liste à l'administrateur avec le code : elle s'allonge à chaque lancement d'une nouvelle campagne concernée.

Pixels publicitaires

Chargeur de base Meta Pixel
<script>
!function(f,b,e,v,n,t,s){if(f.fbq)return;n=f.fbq=function(){n.callMethod?
n.callMethod.apply(n,arguments):n.queue.push(arguments)};if(!f._fbq)f._fbq=n;
n.push=n;n.loaded=!0;n.version='2.0';n.queue=[];t=b.createElement(e);t.async=!0;
t.src=v;s=b.getElementsByTagName(e)[0];s.parentNode.insertBefore(t,s)}(window,
document,'script','https://connect.facebook.net/en_US/fbevents.js');
fbq('init', '<YOUR-PIXEL-ID>');
fbq('track', 'PageView');
</script>

Google Ads et TikTok suivent le même modèle : collez le tag de base que vous fournit la plateforme, sur le déclencheur VISIT. Déclenchez les conversions depuis un script REGISTRATION : voir Quand : l'Événement déclencheur.

Bandeau cookies

Chargez votre propre outil de consentement comme sur votre site, sur le déclencheur VISIT :

Chargeur d'outil de consentement
<script src="https://cdn.consent-tool.example/loader.js" data-site-id="<YOUR-SITE-ID>"></script>

Faites ensuite en sorte que vos autres scripts attendent sa réponse au lieu de se déclencher quoi qu'il arrive. La plupart des outils de consentement exposent un callback ou une variable globale que vous pouvez tester : suivez la documentation de l'outil.

Testez ce qui se passe en cas de refus

Le cas de l'acceptation fonctionne presque toujours. C'est en cas de refus que les tags se déclenchent malgré tout, et c'est là que se situe le risque réglementaire. Refusez le consentement et vérifiez que vos pixels restent silencieux.

Étapes suivantes

Sur cette page