Configurer une action personnalisée configure-a-custom-action
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, utilisez des actions personnalisées pour configurer 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 spécialistes 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 custom-actions-limitations
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.
Les actions personnalisées prennent en charge le format JSON uniquement lors de l’utilisation de requêtes ou de payloads de réponse.
Bonnes pratiques custom-action-enhancements-best-practices
Lorsque vous choisissez un point d’entrée à cibler à l’aide d’une action personnalisée, assurez-vous de ce qui suit :
- Ce point d’entrée peut prendre en charge le débit des parcours à l’aide de configurations de l’API de limitation ou de l’API de plafonnement pour le limiter. Faites preuve de prudence si une configuration de limitation ne peut pas descendre sous 200 TPS. Tout point d’entrée ciblé devra prendre en charge au moins 200 TPS.
- Ce point d’entrée doit avoir un temps de réponse aussi bas que possible. Selon le débit attendu, un temps de réponse élevé peut avoir un impact sur le débit réel.
Un plafond de 300 000 appels sur une minute est défini pour toutes les actions personnalisées. En outre, la limitation par défaut est effectuée par hôte et par sandbox. Par exemple, sur un sandbox, si vous avez deux points d’entrée avec le même hôte (par exemple, https://www.adobe.com/endpoint1 et https://www.adobe.com/endpoint2), la limitation s’applique à tous les points d’entrée sous l’hôte adobe.com. Le point d’entrée 1 et le point d’entrée 2 partagent la même configuration de limitation. En outre, le fait qu’un point d’entrée atteigne la limite a un impact sur l’autre point d’entrée.
Cette limite a été définie en fonction de l’utilisation de la clientèle, afin de protéger les points d’entrée externes ciblés par des actions personnalisées. Vous devez prendre cela en compte dans vos parcours basés sur l’audience en définissant un taux de lecture approprié (5 000 profils/s lors de l’utilisation d’actions personnalisées). Si nécessaire, vous pouvez remplacer ce paramètre en définissant une limitation ou un ralentissement plus élevé via nos API de limitation/ralentissement. Consultez cette page.
Vous ne devez pas cibler les points d’entrée publics avec des actions personnalisées pour diverses raisons :
- Sans limitation ou ralentissement approprié, il existe un risque d’envoyer trop d’appels à un point d’entrée public qui ne prend pas en charge un tel volume.
- Les données de profil peuvent être envoyées par le biais d’actions personnalisées, de sorte que le ciblage d’un point d’entrée public peut entraîner le partage accidentel d’informations personnelles en externe.
- Vous n’avez aucun contrôle sur les données renvoyées par les points d’entrée publics. Si un point d’entrée modifie son API ou commence à envoyer des informations incorrectes, celles-ci seront rendues disponibles dans les communications envoyées, avec des impacts négatifs potentiels.
Consentement et gouvernance des données privacy
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 :
Étapes de configuration configuration-steps
Les principales étapes nécessaires pour configurer une action personnalisée sont les suivantes :
-
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.
-
Saisissez le nom de l'action.
note note NOTE Seuls les caractères alphanumériques et les traits de soulignement sont autorisés. La longueur maximale est de 30 caractères. -
Ajoutez une description à l'action. Cette étape est facultative.
-
Le nombre de parcours qui font appel à cette action s’affiche dans le champ Utilisé dans. Vous pouvez cliquer sur le bouton Afficher les parcours pour afficher la liste des parcours utilisant cette action.
-
Définissez les différents paramètres de Configuration d'URL. Voir cette page.
-
Configurez la section Authentification. Cette configuration est la même que pour les sources de données. Consultez cette section.
-
Définissez les paramètres d'action. Voir cette page.
-
Cliquez sur Enregistrer.
L'action personnalisée est maintenant configurée et prête à être utilisée dans vos parcours. Voir cette page.
note note NOTE Lorsqu'une action personnalisée est utilisée dans un parcours, la plupart des paramètres sont en lecture seule. Vous pouvez uniquement modifier les champs Nom, Description, URL et la section Authentification.
Configuration du point d’entrée url-configuration
Lors de la configuration d’une action personnalisée, vous devez définir les paramètres de configuration de point d’entrée suivants :
-
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.
note note NOTE 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. -
-
Sélectionnez la Méthode d’appel : il peut s’agir de POST, GET ou PUT.
note note NOTE Le méthode DELETE n’est pas prise en charge. Si vous devez mettre à jour une ressource existante, sélectionnez la méthode PUT. -
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 supprimer ces champs. Seul l’en-tête Content-Type peut être modifié. Sa valeur doit respecter le format JSON. Voici la valeur par défaut :
- 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.
-
Saisissez le libellé ou le nom du champ.
-
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.
note note NOTE 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.
Prise en charge du protocole mTLS mtls-protocol-support
Vous pouvez utiliser le protocole mTLS (Mutual Transport Layer Security) pour améliorer la sécurité des connexions sortantes aux actions personnalisées Adobe Journey Optimizer. Le protocole mTLS est une méthode de sécurité de bout en bout pour une authentification mutuelle qui garantit que les deux parties qui partagent des informations sont celles qu’elles prétendent être avant que les données ne soient partagées. Le protocole mTLS inclut une étape supplémentaire par rapport à TLS, dans laquelle le serveur demande également le certificat du client et le vérifie de son côté.
L’authentification TLS mutuelle (mTLS) est prise en charge dans les actions personnalisées. Aucune configuration supplémentaire n’est requise dans l’action personnalisée ou le parcours pour activer mTLS. Cela se produit automatiquement lorsqu’un point d’entrée compatible avec mTLS est détecté. En savoir plus.
Définir les paramètres de payload define-the-message-parameters
Vous pouvez définir le paramètre de payload comme décrit ci-dessous :
-
Dans la section Requête, collez un exemple de payload JSON à envoyer au service externe. Ce champ est facultatif et disponible uniquement pour les méthodes d’appel POST et PUT.
Activez l’option Autoriser les valeurs nulles pour conserver les valeurs nulles dans l’appel externe. Notez que l’envoi de tableaux d’entiers, de chaînes, etc. avec des valeurs nulles n’est pas entièrement pris en charge. Par exemple, le tableau suivant d’entiers
[1, null, 2, 3]est envoyé en tant que[1, 2, 3]même si cette option est cochée. En outre, si ce tableau est nul, il est envoyé en tant que tableau vide.
-
Dans la section Réponse, collez un exemple de payload renvoyée par l’appel. Ce champ est facultatif et disponible pour toutes les méthodes d’appel. Pour plus d’informations sur l’utilisation des réponses d’appel API dans les actions personnalisées, reportez-vous à cette page.
.) ni commencer par un caractère $.
Dans la configuration des champs, vous devez procédez comme suit :
-
Sélectionnez le type de paramètre, par exemple : chaîne, entier, etc.
-
Définissez une constante ou un paramètre de 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 Cet élément ne varie pas et les spécialistes du marketing ne le voient 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, la valeur constante est définie sur le champ à droite du bouton (bascule) Constante/Variable.
-
Le paramètre « Variable » signifie que la valeur du paramètre peut varier. Les spécialistes marketing qui utilisent cette action personnalisée dans un parcours sont libres de transmettre la valeur de leur 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 la personne spécialisée dans le marketing voit dans le parcours pour nommer ce paramètre.
Pour les paramètres facultatifs, activez l’option Est facultatif à la fin de la ligne. En cochant cette option, vous marquez le paramètre comme non obligatoire et laissez les personnes praticiennes du parcours choisir de le remplir ou non lors de la création de cette action personnalisée dans un parcours.
-