Prise en main du développement des extensions

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.

Pour vous aider à vous préparer à construire des extensions, nous utiliserons l’outil de génération de modèles automatique en open-source fourni par les ingénieurs Adobe pour créer les fichiers et la structure de fichiers nécessaires pour votre package d’extensions, afin que tout ce qu’il vous reste à faire soit la partie qui vous intéresse : écrire le code.

Conditions préalables

Configuration de l’extension

Créez un répertoire dans lequel vos fichiers d’extension seront installés.

mkdir example && cd example

Ce guide utilise l’outil de génération automatique de modèles d’extension pour élaborer la structure d’extension initiale afin que les développeurs puissent rapidement commencer à coder. Si vous le souhaitez, ce processus peut être effectué manuellement sans l’outil de génération de modèles automatique.

Exécutez l’outil de génération de modèles automatique.

npx @adobe/reactor-scaffold

L’outil de génération de modèles automatique vous invite à définir certaines options de configuration initiales comme suit :

  • Nom d’affichage : nom visible de l’extension
  • Version : version de l’extension
  • Description : brève description de l’objet de l’extension
  • Auteur : nom de l’auteur de l’extension

L’outil de génération de modèles automatique fournit ensuite des options pour la construction de la structure d’extension :

  • Vue de configuration de l’extension : la vue, fichier HTML, depuis laquelle une extension rassemble les paramètres globaux d’un utilisateur.
  • Types d’événement : définit une activité d’observation. Par exemple, savoir quand un utilisateur fait défiler rapidement une page ou quand un utilisateur a interagi avec un élément de page. Les événements peuvent ensuite être utilisés dans les règles pour exécuter des actions.
  • Types de condition : les types de condition évaluent si un élément est vrai ou faux. Par exemple, le type de condition peut renvoyer si le navigateur de l’utilisateur est Chrome, s’il utilise un iPad ou s’il se trouve sur un domaine spécifique.
  • Types d’action : action à effectuer lorsqu’un événement se produit. Par exemple, envoyer une balise d’analyse, afficher une offre, enregistrer un cookie ou ouvrir une conversation d’assistance.
  • Types d’éléments de données : un type d’élément de données récupère une donnée. Cette donnée peut se trouver dans un enregistrement local, dans un cookie, dans un élément DOM ou dans un emplacement personnalisé.
  • Modules partagés : un module partagé est un mécanisme par lequel les extensions peuvent communiquer avec d’autres extensions.
  • Vues : chaque type d’événement, de condition, d’action ou d’élément de données peut fournir une vue permettant à un utilisateur de fournir des paramètres.
NOTE
  • Les exécutions suivantes de l’outil de génération de modèles automatique ignorent la configuration initiale.
  • Plusieurs événements, conditions, actions peuvent être ajoutés.
  • Une seule vue de configuration peut exister.

Étapes suivantes

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