Campagnes déclenchées par API et par action

Lors de la configuration de campagnes, il est toujours recommandé de tester vos messages avant de les lancer. Cet article de référence explique comment créer un segment d’essai qui vous permettra d’inspecter les requêtes API, les payloads et de consulter les journaux de livrabilité.

Étape 1 : Créer un segment d’utilisateurs test

La seule façon de tester le déclenchement d’une Campaign via l’API ou un événement personnalisé est de passer la Campaign en production. Dans le cadre du déploiement d’une nouvelle Campaign, nous recommandons vivement d’ajouter un segment d’utilisateurs test aux Campaigns lors des tests de livrabilité du déclenchement. Cela constitue un filet de sécurité : même si une Campaign est envoyée accidentellement, elle ne sera adressée qu’aux utilisateurs internes.

1. Importer des utilisateurs test
   Les utilisateurs test peuvent être importés dans Braze via un fichier CSV ou une requête ponctuelle par lot via Postman. Lors de l’importation de ces utilisateurs, nous recommandons de définir un attribut personnalisé sur leurs profils (tel que internal_test_user: true) qui pourra être utilisé pour créer un segment de groupe test.
   
   
2. Ajouter des utilisateurs test en tant qu’utilisateurs test reconnus par Braze
   Marquer vos utilisateurs test comme utilisateurs test reconnus par Braze dans le tableau de bord vous donne accès à une journalisation détaillée pour chaque utilisateur, vous permettant d’inspecter les requêtes API, leurs payloads et de consulter les journaux de livrabilité. Ces journaux peuvent vous aider à déterminer s’il y a eu des problèmes lors de la livraison des Campaigns aux utilisateurs finaux.
   
   
3. Créer un segment
   Pour créer un segment d’utilisateurs test, créez un segment d’utilisateurs dont l’attribut personnalisé internal_test_user est défini sur true. Ce segment peut être supprimé lorsque la Campaign passe en production.

Étape 2 : Tests d’envoi

Ensuite, vous pouvez effectuer un envoi test depuis le tableau de bord de Braze ou utiliser Inbox Vision (e-mail uniquement) pour voir à quoi ressemblera la mise en page pendant que la campagne est encore en mode brouillon. Vous pouvez ensuite envoyer la campagne à votre segment d’essai pour vérifier qu’elle fonctionne comme prévu. Que la campagne soit déclenchée par API ou par action, utilisez Postman pour envoyer une requête ponctuelle à l’API Braze, déclenchant ainsi la campagne.

Étape 3 : Utiliser la journalisation Braze pour inspecter les résultats entrants

Utilisez la journalisation Braze pour résoudre les problèmes de déclenchement, d’envoi et d’événements.

• Le journal des événements utilisateurs vous montrera le payload brut de la requête de déclenchement par API, l’événement personnalisé déclenchant la campagne, ainsi que toutes les propriétés de déclencheur ou d’événement associées.
• L’observabilité de la messagerie indique pourquoi un message particulier n’a peut-être pas été envoyé.

Étape 4 : Supprimer le segment d’essai et déployer la campagne

Une fois que le message se déclenche et s’affiche correctement avec tous les liens cliqués enregistrés, vous pouvez supprimer le segment et mettre à jour la campagne. Si vous préférez lancer la campagne à partir de zéro afin que les quelques impressions des utilisateurs test ne soient pas incluses, vous pouvez dupliquer la campagne et la relancer sans le segment d’utilisateurs test.