Types d’actions pour les extensions Edge

REMARQUE

Adobe Experience Platform Launch devient une suite de technologies destinées à la collecte de données dans Experience Platform. Ces modifications seront appliquées à l’ensemble de la documentation du produit au cours des prochaines semaines. Reportez-vous au document suivant pour consulter une référence consolidée des modifications terminologiques.

Un module de bibliothèque de type action est conçu pour exécuter une action, n’importe quelle action. Les effets de cette action ne dépendent que de vous. Voulez-vous envoyer une balise ou peut-être transformer certaines données de l’événement ?

IMPORTANT

Ce document couvre les types d’action pour les extensions Edge. Si vous développez une extension web, reportez-vous au guide sur les types d’action pour les extensions web à la place.

Ce document suppose que vous connaissez les modules de bibliothèque et leur intégration dans les extensions de Platform Launch. Si vous avez besoin d’une introduction, consultez la présentation sur le formatage des modules de bibliothèque avant de revenir à ce guide.

Par exemple, si vous voulez transférer certaines données à un point d’entrée tiers, votre module peut se présenter comme suit :

module.exports = (context) {
  const { arc, utils } = context;
  const { fetch } = utils;
  const { event: { xdm } } = arc;
  return fetch('http://someendpoint.com', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json'
    },
    body: JSON.stringify(xdm)
  })
};

Maintenant, imaginez une situation dans laquelle vous voulez que l’utilisateur Adobe Experience Platform Launch puisse configurer le point d’entrée. Vous pouvez permettre à l’utilisateur d’entrer un point d’entrée, puis d’enregistrer le message dans l’objet paramètres, celui-ci ressemblant à ceci :

{
  "endpoint": "http://someendpoint.com"
}

Pour pouvoir agir sur le point d’entrée défini par l’utilisateur, votre module doit changer comme suit :

module.exports = (context) {
  const { arc, utils } = context;
  const { fetch } = utils;
  const { event: { xdm } } = arc;
  const  { endpoint } = settings;
  return fetch(endpoint, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json'
    },
    body: JSON.stringify(xdm)
  })
};

Résultat de l’action

Le résultat renvoyé par un module d’action peut être n’importe quel résultat. Si l’action doit exécuter une tâche asynchrone, vous pouvez renvoyer une promesse qui renvoie le résultat souhaité une fois qu’elle a été résolue.

Le résultat de l’action est stocké dans une clé ruleStash qui est mise à la disposition de tous les modules via le paramètre context (context.arc.ruleStash). Vous pouvez en savoir plus sur ruleStash ici.

Sur cette page