Configurer une action personnalisée

Si vous utilisez un système tiers pour envoyer des messages ou souhaitez que les parcours envoient des appels d’API à un système tiers, c’est à cet emplacement que vous configurez la connexion de ce système aux parcours. Par exemple, vous pouvez vous connecter aux systèmes suivants avec des actions personnalisées : Epsilon, Slack, Adobe Developer, Firebase, etc.

Les actions personnalisées sont des actions supplémentaires définies par les utilisateurs techniques et mises à la disposition des professionnels du marketing. Une fois configurés, elles apparaissent dans la palette gauche de votre parcours, dans la catégorie Action. En savoir plus sur cette page.

Limites

Les actions personnalisées sont assorties de quelques limites répertoriées dans cette page.

Dans les paramètres d’action personnalisés, vous pouvez transmettre une collection simple, ainsi qu’une collection d’objets. En savoir plus au sujet de ces limites de collection sur cette page.

Notez également qu’un format spécifique est attendu pour les paramètres d’action personnalisés (par exemple : chaîne, décimal, etc.). Vous devez veiller au respect de cette exigence. En savoir plus sur ce cas d’utilisation.

Consentement et gouvernance des données

Dans Journey Optimizer, vous pouvez appliquer des politiques de gouvernance des données et de consentement à vos actions personnalisées, afin d’empêcher l’exportation de champs spécifiques vers des systèmes tiers ou d’exclure les clients qui n’ont pas consenti à recevoir des communications par e-mail, push ou SMS. Pour plus d’informations, consultez les pages suivantes :

• Gouvernance des données.
• Consentement.

Étapes de configuration

Les principales étapes nécessaires pour configurer une action personnalisée sont les suivantes :

1. Dans la section du menu ADMINISTRATION, sélectionnez Configurations. Dans la section Actions, cliquez sur Gérer. Cliquez sur Créer une action pour créer une nouvelle action. Le volet de configuration des actions s'ouvre dans la droite de l'écran.

   

2. Saisissez le nom de l'action.

   REMARQUE

   N'utilisez ni espaces ni caractères spéciaux. Utilisez 30 caractères au maximum.

3. Ajoutez une description à l'action. Cette étape est facultative.

4. Le nombre de parcours qui font appel à cette action apparaît dans le champ Utilisé(e) dans. Vous pouvez cliquer sur le bouton Afficher les parcours pour faire apparaître la liste des parcours utilisant cette action.

5. Définissez les différents paramètres de Configuration d'URL. Voir cette page.

6. Configurez la section Authentification. Cette configuration est la même que pour les sources de données. Consultez cette section.

7. Définissez les paramètres d'action. Voir cette page.

8. Cliquez sur Enregistrer.

   L'action personnalisée est maintenant configurée et prête à être utilisée dans vos parcours. Voir cette page.

   REMARQUE

   Lorsqu'une action personnalisée est utilisée dans un parcours, la plupart des paramètres sont en lecture seule. Vous ne pouvez modifier que les champs Nom, Description, URL et la section Authentification.

Configurer des URL

Lors de la configuration d'une action personnalisée, vous devez définir les paramètres de configuration d'URL suivants :

1. Dans le champ URL, spécifiez l'URL du service externe :

   • Si l’URL est statique, saisissez l’URL dans ce champ.

   • Si l’URL comprend un chemin dynamique, saisissez uniquement la partie statique de l’URL, c’est-à-dire le schéma, l’hôte, le port et, éventuellement, une partie statique du chemin.

     Exemple : https://xxx.yyy.com/somethingstatic/

     Vous spécifiez le chemin dynamique de l’URL lors de l’ajout de l’action personnalisée à un parcours. En savoir plus.

   REMARQUE

   Pour des raisons de sécurité, nous vous recommandons vivement d’utiliser le schéma HTTPS pour l’URL. L'utilisation des adresses Adobe qui ne sont pas publiques et des adresses IP n'est pas autorisée.

   Seuls les ports par défaut sont autorisés lors de la définition d’une action personnalisée : 80 pour http et 443 pour https.

2. Sélectionnez la Méthode d'appel : il peut s'agir de POST ou de PUT.

   REMARQUE

   Le méthode DELETE n’est pas prise en charge. Si vous devez mettre à jour une ressource existante, sélectionnez la méthode PUT.

3. Définissez les en-têtes et les paramètres de requête :

   • Dans la section En-têtes, cliquez sur Ajouter un champ d’en-tête pour définir les en-têtes HTTP du message de requête à envoyer au service externe. Les champs d’en-tête Type de contenu et CharSet sont définis par défaut. Vous ne pouvez pas modifier ni supprimer ces champs.

   • Dans la section Paramètres de requête, cliquez sur Ajouter un champ de paramètre de requête pour définir les paramètres à ajouter à l’URL.

   

4. Saisissez le libellé ou le nom du champ.

5. Sélectionnez le type : Constant ou Variable. Si vous avez sélectionné Constant, saisissez la valeur constante dans le champ Valeur. Si vous avez sélectionné Variable, vous spécifiez cette variable lors de l’ajout de l’action personnalisée à un parcours. En savoir plus.

   

   REMARQUE

   Après avoir ajouté l’action personnalisée à un parcours, vous pouvez toujours y ajouter des champs d’en-tête si le parcours a le statut de brouillon. Si vous ne souhaitez pas que le parcours soit affecté par les modifications de configuration, dupliquez l’action personnalisée et ajoutez les champs d’en-tête à la nouvelle action personnalisée.

   Les en-têtes sont validés conformément à des règles d’analyse. En savoir plus dans cette documentation.

Définition des paramètres d’action

Dans la section Paramètres d'action, collez un exemple de payload JSON à envoyer au service externe.

Vous aurez la possibilité de définir le type de paramètre (par exemple : string, integer, etc.).

Vous pourrez également préciser si le paramètre est une constante ou une variable :

• Le paramètre « Constant » signifie que la valeur du paramètre est définie dans le volet de configuration des actions par une persona ayant un rôle technique. La valeur reste identique dans tous les parcours et le marketeur ne la voit pas lors de l'utilisation de l'action personnalisée dans le parcours. Il peut s'agir, par exemple, d'un identifiant attendu par le système tiers. Dans ce cas, le champ situé à droite du bouton bascule Constante/Variable correspond à la valeur transmise.
• Le paramètre « Variable » signifie que la valeur du paramètre varie. Le marketeur qui utilise cette action personnalisée dans un parcours sera libre de transmettre la valeur de son choix ou bien d’indiquer où récupérer la valeur de ce paramètre (à partir de l’événement, d‘Adobe Experience Platform, etc.). Dans ce cas, le champ situé à droite du bouton bascule Constante/Variable correspond au libellé que le marketeur voit dans le parcours pour nommer ce paramètre.

Ressources Business.Adobe.com