Configuration des actions externes
Les actions externes permettent aux parcours de compte dans Journey Optimizer B2B edition de se connecter à des systèmes externes directement à partir de la zone de travail de parcours. Lorsqu’une audience de compte atteint un nœud d’action externe, le système effectue un appel sortant asynchrone vers un service externe configuré, en transmettant les données d’attribut d’audience pour les comptes, les personnes ou les deux. Le service externe traite les données et répond à l’aide d’un rappel , renvoyant les données et métadonnées de l’audience qui peuvent être utilisées pour guider l’exécution du parcours.
Cette fonctionnalité prend en charge deux types de nœuds de parcours :
- Action externe - Appelle un service externe et continue le long d’un seul chemin sortant. Idéal pour les intégrations à déclenchement et à oubli telles que la mise à jour d’un enregistrement CRM ou le déclenchement d’une notification en aval.
- Chemins de partage externes - Appelle un service externe et évalue la réponse pour acheminer les comptes le long de l’un des chemins définis.
Présentation de l’implémentation
La configuration des actions externes nécessite une coordination entre trois rôles successifs :
Implémenter le service externe implement-service
Le développeur doit créer et publier un service web public conforme à l'interface du fournisseur de services d'actions externes de Adobe Journey Optimizer B2B edition 🔗.
Une fois le service actif, fournissez l’URL de la spécification OpenAPI et les informations d’authentification à l’administrateur de produit chargé de configurer l’action.
Configurer l’action configure-action
Une action doit être configurée et activée avant que les marketeurs puissent l'utiliser dans un parcours. Les actions sont créées à l’état Brouillon et vos modifications sont enregistrées automatiquement. Il reste en tant que brouillon jusqu’à ce que vous l’activiez.
-
Accédez à Administration > Configurations.
-
Cliquez sur Actions externes dans le panneau intermédiaire.
-
Cliquez sur Créer une action en haut à droite.
-
Saisissez l’URL de la spécification OpenAPI pour votre service externe et cliquez sur Créer.
note note NOTE Votre service externe doit être actif et accessible pour que cette étape réussisse. -
Une fois l’URL résolue, passez en revue les Détails du service.
Les détails du service sont lus directement à partir de la spécification OpenAPI lors de la création de l’action. Vous ne pouvez pas modifier ces propriétés dans la configuration après leur création.
table 0-row-3 1-row-3 2-row-3 3-row-3 Propriété Description Propriété de spécification OpenAPI Nom Nom de l’action info.titleDescription Description de l’action info.descriptionURL URL vers la spécification OpenAPI qui définit le service externe servers.url -
Saisissez les informations d’identification Authentification pour le service externe (
components.securitySchemes).note note NOTE Les champs d’identification affichés dépendent du mécanisme d’authentification défini dans le service externe. Les types pris en charge sont les suivants : clé API, OAuth2 et authentification de base HTTP. 
Vous pouvez modifier les informations d’identification selon vos besoins lorsque l’action configurée a le statut Brouillon ou Actif.
-
Cliquez sur Suivant.
-
Définissez les propriétés Configurations pour définir la manière dont l’action échange des données avec le service externe.
note note NOTE Les propriétés marquées comme Statiques ne peuvent pas être mises à jour au moment de la configuration et sont basées sur la définition de service. -
Type d’action (statique) - Le type de nœud de parcours pris en charge :
- Action externe (
enableSplitPath= false) - Chemin de partage de l’action externe (
enableSplitPath= true)
Vous ne pouvez pas modifier le type d’action après avoir créé la configuration d’action.
- Action externe (
-
Accessoires (Statique) - (Chemin de division d’action externe uniquement) Les variables renvoyées par le service externe pour être disponibles en tant que conditions de chemin dans un nœud de chemin de division externe. (
invocationPayloadDef.accessorsMetadata) -
Contexte du Parcours (Statique) - Portée des données d’audience envoyées dans la requête (
supportedEntityType) :-
Compte - Envoie uniquement les comptes
-
Personnes - Envoie uniquement des personnes
-
Personnes sur le compte - Envoie les comptes et les personnes associées au compte
-
-
Champs sortants - Mappez chaque champ de la table à un champ XDM. Ces champs sont envoyés au service externe dans le corps de la requête. Propriétés de définition de service :
invocationPayloadDef.accountFields,invocationPayloadDef.fields.
-
Champs entrants - Mappez chaque champ de la table à un champ XDM modifiable. Ces champs sont renseignés à partir de la réponse du service externe. Propriétés de définition de service :
callbackPayloadDef.accountFields,callbackPayloadDef.fields. Modifiable après la création. -
Paramètres d’en-tête - Saisissez une valeur pour chaque ligne à transmettre en tant qu’en-tête HTTP dans la requête. Propriété de définition du service :
invocationPayloadDef.headers. -
Délai d’expiration - Saisissez le nombre de minutes à attendre pour que le service externe appelle le rappel avant que la demande ne soit considérée comme ayant échoué. Propriété de définition du service :
timeout. -
Attributs globaux - Saisissez une valeur pour chaque ligne à inclure en tant que champ statique dans le corps de la requête. Propriété de définition du service :
invocationPayloadDef.globalAttributes.
-
-
Cliquez sur la flèche Précédent pour revenir à la liste et conserver l’action à l’état Brouillon.
Ou cliquez sur Activer pour définir la configuration de l’action sur l’état Actif. L’action externe configurée doit être active pour pouvoir être utilisée dans les parcours de compte.
Ajouter un nœud externe à un parcours add-journey-node
Une fois qu’une action est activée, les spécialistes marketing peuvent ajouter un nœud Action externe ou Chemin de partage externe à n’importe quel parcours de compte. Pour plus d’informations sur l’ajout et l’utilisation de ces nœuds dans la zone de travail du parcours de compte, voir Nœuds externes.