Comment utiliser des variables custom en S2S ou en JS
Les variables personnalisées permettent d’enrichir les tags partenaires ou les connecteurs S2S avec des informations spécifiques à votre implémentation.
Elles peuvent être créées à partir d’un script JavaScript personnalisé et utilisées ensuite dans différents contextes d’activation, notamment :
- les tags partenaires configurés dans le TMS Eulerian ;
- les connecteurs server-to-server, aussi appelés S2S.
Il est également possible d’utiliser des variables pré-définies dans le script de la variable personnalisée. Ces variables permettent de remonter des paramètres issus de votre intégration ad-centric, site-centric ou user-centric.
Fonctionnement des variables personnalisées
Une fois créée, une variable personnalisée peut être appelée à l’aide de la macro suivante :
<TMPL_VAR jsvar.$NOM_VAR />Dans cette macro,
$NOM_VAR doit être remplacé par le nom de la variable personnalisée configurée.Par exemple, si la variable personnalisée s’appelle
montantHT, elle pourra être appelée avec la macro suivante :<TMPL_VAR jsvar.montantHT />Cette macro peut ensuite être utilisée dans un tag partenaire ou dans un connecteur S2S afin de transmettre automatiquement la valeur de la variable au partenaire concerné.
Pour consulter la liste complète des variables disponibles au format
TMPL_VAR, vous pouvez vous référer à la documentation suivante : Liste des TMPL_VAR .
Ajouter une variable personnalisée
Chemin d’accès :
Activation > Paramétrage > Configuration des connecteurs > Variables personnalisées
Cliquez ensuite sur Ajouter.
Paramètre à renseigner
Nom
Saisir le nom de la variable personnalisée. La saisie est libre.
Rédiger le script JavaScript d’intégration
Une fois la variable créée, il faut rédiger le script JavaScript d’intégration.
Le script doit respecter les nomenclatures du format JavaScript.
Vous pouvez ajouter des variables pré-définies au sein du script en cliquant sur Insérer une variable pré-définie.
Ces variables contiennent notamment des paramètres issus :
- des données de votre site ;
- de vos leviers ;
- de vos audiences configurées.
Une fois le script rédigé, il est nécessaire d’activer la variable personnalisée en passant le paramètre Actif à Oui.
InfoAvant d’activer une variable personnalisée, merci de valider la bonne intégration de cette dernière avec votre AM dédié : am@eulerian.com .
Intégration au sein du TMS
Votre variable personnalisée est désormais disponible au sein du TMS Eulerian, dans la configuration des tags partenaires.
Chemin d’accès :
Activation > TMSDans les détails d’un tag partenaire, l’ajout des variables personnalisées s’effectue via l’encart Paramètres personnalisés.
Vous pouvez intégrer une variable personnalisée dans un tag partenaire de deux manières :
- en sélectionnant la variable personnalisée depuis la liste des variables disponibles ;
- ou en utilisant directement la macro associée à la variable.
Le format de la macro est le suivant :
<TMPL_VAR jsvar.$NOM_VAR />Par exemple, pour une variable personnalisée nommée
montantHT, la macro à utiliser sera :<TMPL_VAR jsvar.montantHT />La valeur de cette variable sera alors automatiquement injectée dans le tag partenaire au moment de son déclenchement.
Intégration server-to-server
Pour ajouter une variable personnalisée au sein d’un connecteur partenaire S2S, suivez le chemin suivant :
Chemin d’accès :
Activation > S2SDans les détails d’un connecteur partenaire S2S, l’ajout des variables personnalisées s’effectue via l’encart Paramètres personnalisés.
Comme pour le TMS, une variable personnalisée peut être ajoutée au connecteur S2S depuis la liste des variables disponibles, ou être appelée directement via sa macro :
<TMPL_VAR jsvar.$NOM_VAR />Par exemple :
<TMPL_VAR jsvar.montantHT />Cette macro permet de transmettre la valeur de la variable personnalisée au partenaire dans le cadre de l’appel server-to-server.
Une fois configurée, la variable sera automatiquement passée au sein du connecteur S2S au partenaire concerné.