Entrée basée sur l'API

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

Voici quelques cas d’usage pour une Entrée basée sur l’API :

• Informer les clients lorsque certains de vos produits sont de nouveau en stock ;
• Annoncer aux utilisateurs que le prix d’un produit populaire a baissé ;
• Notifier les abonnés de la sortie d’un nouvel épisode de podcast.

Contrairement aux Événements classiques, tous ces événements commerciaux peuvent se produire en dehors de l’application. Par exemple, la disponibilité d’un produit ne peut être vérifiée que dans une base de données externe. C’est là que l’Entrée basée sur l’API s’avère utile : vous pouvez configurer l’envoi d’une requête pour lancer un parcours chaque fois que certaines modifications se produisent en dehors de l’application (par exemple, dans votre base de données externe).

Voici comment cela fonctionne :

1. Créez un parcours avec une Entrée basée sur l’API. Dans les paramètres de l’Entrée, vous trouverez le modèle de la requête qui lance le parcours.
2. Ajoutez des conditions de segmentation à la requête en utilisant le Langage de segmentation. Vous pouvez également ajouter des variables de contenu à la requête pour modifier le contenu du message en fonction du contexte.
3. Automatisez la requête si nécessaire. Par exemple, une information sur un changement de prix peut être immédiatement envoyée de la base de données au webhook. Une fois que cela se produit, le webhook doit automatiquement envoyer la requête pour lancer le parcours. Vous pouvez également envoyer la requête manuellement si vous n’avez pas besoin d’automatisation.

Vous pouvez envoyer la requête un nombre illimité de fois pour modifier les conditions de segmentation ou le contenu du message.

Pour plus de détails, suivez les instructions ci-dessous.

1. Créez un parcours avec une Entrée basée sur l’API :

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 du push et de l’e-mail chaque fois que le parcours est lancé 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 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é attribué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 l’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 ou copiez le langage de segmentation depuis les Segments que vous avez créés précédemment. Veuillez noter que vous devez configurer les Tags nécessaires au préalable.

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 de débit des 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 5 000 utilisateurs par seconde ou définir un autre nombre.

8. Si vous prévoyez de redémarrer votre campagne fréquemment et que vous ne voulez pas que les mêmes utilisateurs entrent plusieurs fois dans le parcours, définissez le Frequency Capping.

Par exemple, vous avez créé une campagne pour informer les utilisateurs d’une réduction de prix pour 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 le Frequency Capping afin que la notification ne soit pas envoyée à plusieurs reprises aux utilisateurs qui correspondent à plusieurs filtres.

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

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