Déclencher des parcours client avec une entrée basée sur l'API

L’entrée basée sur l’API vous permet de lancer un parcours client au moment précis où un événement métier spécifique se produit. Pour démarrer une campagne, vous devez envoyer une requête API spéciale.

1. Créez un parcours avec une entrée basée sur l’API (API-based Entry)

2. Double-cliquez sur l’étape d’entrée basée sur l’API. La fenêtre de configuration de l’entrée s’ouvrira.

3. Vous pouvez modifier le contenu des notifications push et des e-mails à chaque lancement du parcours en utilisant des variables de contenu. La valeur de chaque variable peut être modifiée dans la requête. Si vous n’avez pas besoin de cette option, vous pouvez sauter cette étape.

Par exemple, vous créez un parcours pour notifier les abonnés de la sortie d’un nouvel épisode de podcast. En utilisant une variable de contenu, vous pouvez changer le titre du podcast à chaque fois que vous lancez le parcours.

Tout d’abord, ajoutez les noms des variables dans la fenêtre de configuration de l’entrée basée sur l’API. Vous pouvez utiliser les noms qui vous conviennent le mieux.

Maintenant, créez un Préréglage de notification push ou d’e-mail et insérez la variable à la place du texte que vous souhaitez modifier. La variable doit être dans l’un des formats suivants, selon vos besoins :

• {nom_variable|modificateur_format|} – si la valeur de la variable n’est pas spécifiée lors du lancement de la campagne, les utilisateurs verront un espace vide à sa place.
• {nom_variable|modificateur_format} – si la valeur de la variable n’est pas spécifiée et n’a pas déjà été assignée à un utilisateur (au cas où vous utiliseriez un Tag comme variable), le message ne sera pas envoyé.

Lors de la configuration de l’étape Push ou E-mail dans votre parcours, sélectionnez le préréglage créé et activez l’option Personnaliser le message avec les attributs d’événement. Sélectionnez les variables que vous souhaitez modifier dans la requête lors du lancement du parcours. Choisissez une Entrée basée sur l’API comme source et le nom de la variable comme attribut dynamique :

Cliquez sur Appliquer pour enregistrer les modifications.

4. Dans la fenêtre de configuration de l’Entrée, copiez le modèle de requête pour le modifier :

5. Ajoutez des filtres d’audience au paramètre “filter” en utilisant le langage de segmentation. Veuillez noter que vous devez configurer au préalable les Tags nécessaires.

Par exemple, si vous souhaitez cibler le parcours sur les utilisateurs qui ont ajouté l’article Chaussettes à leur Liste de souhaits, la valeur de “filter” doit ressembler à ceci :

"filter": "A(\"12345-12345\") * "T(\"Wishlist\", EQ, \"Socks\")"

Dans cet exemple, vous devez avoir un Tag Wishlist configuré dans votre application.

6. Si vous avez configuré des variables, spécifiez le contenu souhaité comme leurs valeurs :

7. Si l’option Limites du débit de messages est activée, le nombre d’utilisateurs entrant dans le parcours en même temps chaque seconde sera limité. Vous pouvez utiliser la valeur par défaut de 5000 utilisateurs par seconde ou définir un autre nombre.

8. Si vous prévoyez de relancer fréquemment votre campagne et que vous ne voulez pas que les mêmes utilisateurs entrent plusieurs fois dans le parcours, configurez la Limitation de la fréquence.

Par exemple, vous avez créé une campagne pour informer les utilisateurs d’une baisse de prix sur un produit spécifique. Vous souhaitez relancer le parcours plusieurs fois en envoyant plusieurs requêtes avec différents filtres d’audience. Dans ce cas, vous pouvez ajouter une Limitation de la fréquence pour que la notification ne soit pas envoyée de manière répétée aux utilisateurs qui correspondent à plusieurs filtres.

9. Si vous souhaitez qu’un parcours se lance à chaque fois qu’un certain événement métier se produit, automatisez la requête à l’aide d’un webhook. Une fois l’événement survenu, le webhook doit envoyer automatiquement la requête pour démarrer le parcours.

Vous pouvez également envoyer la requête manuellement si vous n’avez pas besoin d’automatisation.