Types de conditions pour les extensions Edge

NOTE
Adobe Experience Platform Launch est désormais une suite de technologies destinées à la collecte de données dans Adobe Experience Platform. Plusieurs modifications terminologiques ont par conséquent été apportées à la documentation du produit. Reportez-vous au document suivant pour consulter une référence consolidée des modifications terminologiques.

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.

IMPORTANT
Si vous développez une extension web, consultez le guide sur les types de condition pour les extensions web à la place.
Ce document suppose également que vous connaissez les modules de bibliothèque et leur intégration dans les extensions Edge. Si vous avez besoin d’une introduction, consultez la présentation sur le formatage des modules de bibliothèque avant de revenir à ce guide.

Les types de conditions se composent généralement des éléments suivants :

  1. 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.
  2. 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 :

  1. Valeur booléenne (true ou false).
  2. 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.

recommendation-more-help
12b4e4a9-5028-4d88-8ce6-64a580811743