Eulerian Tag Manager (Client - side)

Eulerian Tag Manager (Client - side)

Cette documentation explique comment créer et configurer un tag personnalisé dans le TMS Eulerian. Elle détaille les différents types de tags disponibles, les bonnes pratiques de paramétrage des tags Image, Iframe et JavaScript, ainsi que la configuration des règles d’appel et l’utilisation de la bibliothèque de règles TMS.


Créer un tag personnalisé

Où aller : TMS → Ajouter un tag personnalisé
Renseignez un nom unique pour le tag et choisissez son type parmi : Image, Iframe, Server-to-Server ou JavaScript. Si vous disposez du module Eulerian Privacy Manager, associez également une catégorie.


Tags Image et Iframe

Le principe est simple : vous fournissez une URL d'appel unique, enrichie de paramètres dynamiques via les variables TMPL.
Dans le champ "URL du tag", saisissez l'URL directement sans les balises HTML (<img />, <iframe></iframe>) ni leurs attributs (width, height…). Spécifiez toujours le protocole (http:// ou https://), puis remplacez les valeurs dynamiques par des balises <TMPL_VAR valeur />.
Certains tags partenaires se présentent sous forme de script JavaScript qui crée une iframe ou une image en dynamique. Dans ce cas, utilisez directement l'URL générée par le script.
Exemple — code JavaScript d'un partenaire :
var key = "123456789";
var param1 = "valeur1";
var param2 = "valeur2";
var _iframe = document.createElement("iframe");
_iframe.src = "https://t.partenaire.com/?key=" + key + "&param1=" + param1 + "&param2=" + param2;
document.body.appendChild(_iframe);

URL équivalente à renseigner dans le TMS :
https://t.partenaire.com/?key=123456789&param1=valeur1&param2=valeur2
Si le tag partenaire dispose d'une version noscript (image ou iframe), vous pouvez l'intégrer directement en type Image/Iframe dans le TMS sans avoir à gérer le JavaScript.


Tag JavaScript

Un tag JavaScript se décompose en trois blocs à renseigner dans le TMS, qui correspondent aux trois structures courantes des tags partenaires en fonction de leur implementation:
Bloc
Rôle
Contenu typique
Code avant chargement
Exécuté avant l'appel du tag partenaire
Déclarations de variables en amont
URL source JavaScript
URL de la librairie ou de l'appel partenaire
Toujours avec http:// ou https://
Code après chargement
Exécuté après le chargement de la librairie
Fonctions définies dans la librairie partenaire
Appel noscript
URL de fallback si JavaScript est désactivé
Optionnel
Attention — jQuery et manipulation du DOM : dans un tag JavaScript personnalisé, il est interdit d'utiliser jQuery (ou toute autre librairie similaire) pour ajouter des balises HTML directement.
// INTERDIT
jQuery('.righter').append('<div>');

// CORRECT
var div = document.createElement('div');
jQuery('.righter').append(div);


Règles d'appel

Après validation de la création, vous pouvez configurer un premier niveau de conditionnement des appels (pages de déclenchement, conditions…). Ces règles peuvent être affinées à tout moment depuis l'écran d'édition du tag.
Par défaut, tout tag nouvellement créé est en statut inactif — il ne sera pas déclenché sur votre site tant que vous ne l'activez pas manuellement.

Bibliothèque de règles — TMS

La bibliothèque de règles permet de pré-enregistrer des règles de conditionnement réutilisables dans l'éditeur de règles de vos tags. C'est un gain de temps pour le paramétrage et un bon moyen de faciliter la prise en main pour les collègues moins expérimentés.
Où aller : Activation → Paramétrage → Configuration des connecteurs → Bibliothèque de règles TMS


Créer une règle

Cliquez sur "Ajouter une nouvelle règle". L'éditeur qui s'ouvre est identique à celui disponible dans l'écran d'édition de vos tags. Configurez votre règle, donnez-lui un nom, puis enregistrez.


Réutiliser une règle

Dans l'éditeur de règles d'un tag existant, ajoutez une nouvelle clause et sélectionnez l'option "Bibliothèque de règles", puis choisissez la règle souhaitée dans la liste.