Distribution déclenchée par API
Les campagnes déclenchées par API, ou campagnes déclenchées par le serveur, sont idéales pour les cas d’utilisation transactionnels plus avancés. Les campagnes Braze déclenchées par API permettent aux marketeurs de gérer le contenu des campagnes, les tests multivariés et les règles de rééligibilité depuis le tableau de bord de Braze, tout en déclenchant la distribution de ce contenu depuis leurs propres serveurs et systèmes. La requête API qui déclenche le message peut également inclure des données supplémentaires à intégrer dynamiquement dans le message en temps réel.
Configuration d’une campagne déclenchée par API
La configuration d’une campagne déclenchée par API nécessite quelques étapes. Commencez par créer une nouvelle campagne multicanale ou monocanale (avec test multivarié).
Ensuite, configurez votre texte et vos notifications de la même manière que pour des notifications planifiées, puis sélectionnez API-Triggered Delivery. Pour plus d’informations sur le déclenchement de ces campagnes depuis votre serveur, consultez cet article sur l’envoi de campagnes déclenchées par API.
Réduire le délai entre votre déclencheur API et l’envoi
Si les messages mettent plus de temps que prévu à être envoyés après l’appel à l’endpoint de déclenchement, vérifiez si le profil utilisateur est prêt au moment du déclenchement.
Par défaut, send_to_existing_only est défini sur true dans /campaigns/trigger/send. Braze envoie uniquement aux utilisateurs existants et ne crée pas de nouveaux profils lors de cet appel. Pour créer ou mettre à jour un utilisateur et envoyer le message dans la même requête, définissez send_to_existing_only sur false et incluez un objet attributes pour chaque destinataire.
Pour les Campaigns par e-mail, incluez également email (ainsi que tout autre champ de distribution requis) dans attributes. Si le profil ne possède pas d’adresse e-mail au moment où vous déclenchez l’envoi, Braze effectue de nouvelles tentatives pendant environ 2 heures en attendant l’arrivée des données du profil. Inclure email dans le même appel permet d’éviter ce délai.
Pour consulter l’ensemble des paramètres de requête, des exemples et le comportement de nouvelle tentative, reportez-vous à Envoyer des Campaigns déclenchées par API et à l’objet destinataires.
Ces recommandations s’appliquent aux Campaigns déclenchées par API (/campaigns/trigger/send). L’endpoint d’e-mail transactionnel utilise une structure de requête différente (recipient, au singulier) et ne prend pas en charge send_to_existing_only. Pour créer un utilisateur en ligne avec des envois transactionnels, transmettez attributes dans l’objet recipient à la place.
Utiliser le contenu modélisé inclus dans une requête API
En plus de déclencher le message, vous pouvez également inclure du contenu dans la requête API pour qu’il soit intégré au message via l’objet trigger_properties. Ce contenu peut être référencé dans le corps du message.
Utilisez exactement deux accolades par étiquette Liquid dans trigger_properties et dans le texte du message. Par exemple : {{api_trigger_properties.${your_property}}}. Un { ou } supplémentaire est une cause fréquente d’échecs de personnalisation déclenchée par API.
Consultez l’exemple de notification sociale suivant pour plus de contexte.
Rééligibilité avec les Campaigns déclenchées par API
Le nombre de fois qu’un utilisateur reçoit une Campaign déclenchée par API peut être limité à l’aide des paramètres de rééligibilité. Cela signifie que l’utilisateur ne reçoit la Campaign qu’une seule fois, ou une seule fois dans une fenêtre donnée, quel que soit le nombre de fois où le déclencheur API est activé.
Par exemple, imaginons que vous utilisez une Campaign déclenchée par API pour envoyer à l’utilisateur un message à propos d’un article qu’il a récemment consulté. Dans ce cas, vous pouvez limiter la Campaign à l’envoi d’un maximum d’un message par jour, quel que soit le nombre d’articles consultés, tout en activant le déclencheur API pour chaque article. Si votre Campaign déclenchée par API est transactionnelle, assurez-vous que l’utilisateur reçoit la Campaign à chaque transaction en définissant le délai à zéro minute.
