Types de conditions pour les extensions Edge
Dans une règle de balise, une condition est évaluée suite à l’apparition d’un événement. Toutes les conditions doivent renvoyer la valeur vraie pour que la règle continue son traitement. Les types de conditions sont fournis par les extensions et évaluent si un élément est vrai ou faux, renvoyant une valeur booléenne.
Par exemple, une extension peut fournir un type de condition « viewport contains » dans lequel l’utilisateur peut spécifier un sélecteur CSS. Lorsque la condition est évaluée sur le site web du client, l’extension peut trouver des éléments correspondant au sélecteur CSS et renvoyer si la fenêtre d’affichage de l’utilisateur contient l’un d’entre eux.
Ce document explique comment définir des types de conditions pour une extension Edge dans Adobe Experience Platform.
Les types de conditions se composent généralement des éléments suivants :
- Vue affichée dans l’interface utilisateur de l’Experience Platform et dans l’interface utilisateur de collecte de données qui permet aux utilisateurs de modifier les paramètres de la condition.
- Un module de bibliothèque émis dans la bibliothèque d’exécution de balise pour interpréter les paramètres et évaluer une condition.
Par exemple, si vous souhaitez évaluer si l’utilisateur se trouve sur l’hôte example.com
, votre module pourra ressembler à ceci.
module.exports = (context) => {
const URL = context.arc.event.xdm.web.webpageDetails.URL;
return URL.endsWith("adobelaunch.com");
};
Si vous souhaitez que le nom d’hôte soit configurable par l’utilisateur pour autoriser la saisie d’un nom d’hôte et l’enregistrer dans l’objet Paramètres, l’objet peut ressembler à cet exemple.
{
"hostname": "example.com"
}
Pour fonctionner sur le nom d’hôte défini par l’utilisateur, votre module doit changer de la façon suivante :
module.exports = (context) => {
const URL = context.arc.event.xdm.web.webpageDetails.URL;
return URL.endsWith(settings.hostname);
};
Résultat de la condition
Le résultat renvoyé par un module de condition peut être l’un des suivants :
- Valeur booléenne (
true
oufalse
). - Une promesse qui, une fois résolue, renvoie une valeur booléenne.
Contexte du module Bibliothèque
Tous les modules de condition ont accès à une variable context
fournie lors de l’appel du module. Vous pouvez en savoir plus ici.