Configurer une 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, c'est à cet emplacement que vous configurez la connexion de ce système aux parcours. L'action personnalisée définie par les utilisateurs techniques sera alors disponible dans la palette gauche du parcours, dans la catégorie Action (voir cette page. À titre dʼexemple, Epsilon, Slack, Adobe.io, Firebase, etc. sont des systèmes auxquels vous pouvez vous connecter à lʼaide dʼactions personnalisées.

Les limites sont répertoriées dans cette page.

Vous pouvez transmettre des collections de manière dynamique à l’aide d’actions personnalisées. Reportez-vous à ce cas d’utilisation.

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.

Configuration d'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.

  3. Dans la section En-têtes , définissez les en-têtes HTTP du message de demande à envoyer au service externe :

    1. Pour ajouter un champ d’en-tête, cliquez sur Ajouter un champ d’en-tête.

    2. Saisissez la clé du champ d’en-tête.

    3. Pour définir une valeur dynamique pour la paire clé-valeur, sélectionnez Variable. Sinon, sélectionnez Constante.

      Par exemple, pour un horodatage, vous pouvez définir une valeur dynamique.

    4. Si vous avez sélectionné Constante, saisissez la valeur constante.

      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.

    5. Pour supprimer un champ d’en-tête, pointez sur le champ d’en-tête et cliquez sur l’icône Supprimer .
      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.

    Après avoir ajouté l’action personnalisée à un parcours, vous pouvez toujours y ajouter des champs d’en-tête si le parcours est en état 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.

    REMARQUE

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

Définition des paramètres d’action

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

REMARQUE

Les noms de champ de la payload ne peuvent pas contenir de caractère "." . Ils ne peuvent pas commencer par le caractère "$".

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 « Constante » signifie que la valeur du paramètre est définie dans le volet de configuration des actions par une personne 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.

Sur cette page