Campagnes déclenchées par API et par action

Lorsque vous configurez des campagnes, nous vous recommandons de tester vos messages avant de les lancer. Cet article de référence explique comment créer un segment d’essai pour inspecter les requêtes API, les payloads et les journaux de livrabilité.

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

La seule façon de tester le déclenchement d’une campagne avec l’API ou un événement personnalisé est de mettre la campagne en production. Lors du déploiement d’une nouvelle campagne, nous vous recommandons vivement d’ajouter un segment d’utilisateurs test à vos campagnes pour tester la livrabilité du déclenchement. Vous disposez ainsi d’un filet de sécurité : même si une campagne est envoyée par erreur, elle ne parvient qu’aux utilisateurs internes.

1. Importer des utilisateurs test
   Vous pouvez importer des utilisateurs test dans Braze à l’aide d’un fichier CSV ou d’une requête groupée ponctuelle via Postman. Lors de l’importation de ces utilisateurs, nous vous recommandons de définir sur leurs profils un attribut personnalisé (par exemple internal_test_user: true) qui pourra servir à créer un segment de groupe test.
   
   
2. Ajouter les 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 pouvez ainsi inspecter les requêtes API et leurs payloads, et consulter les journaux de livrabilité. Ces journaux vous aident à déterminer si des problèmes sont survenus lors de la livraison des campagnes aux utilisateurs finaux.
   
   
3. Créer le segment
   Pour créer un segment d’utilisateurs test, créez un segment regroupant les utilisateurs dont l’attribut personnalisé internal_test_user est défini sur true. Vous pourrez supprimer ce segment une fois la campagne en production.

Étape 2 : Tester les envois

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 à l’état de brouillon. Vous pouvez ensuite envoyer la campagne à votre segment d’utilisateurs test pour vérifier qu’elle se comporte 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 de Braze afin de déclencher la campagne.

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

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

• Le journal des événements utilisateurs vous montre le payload brut de la requête de déclenchement par API, l’événement personnalisé qui déclenche la campagne, ainsi que les propriétés de déclencheur ou d’événement associées.
• Messaging Observability indique pourquoi un message donné n’a peut-être pas été envoyé.

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

Une fois que le message se déclenche et s’affiche correctement, avec tous les clics sur les liens enregistrés, vous pouvez retirer le segment et mettre à jour la campagne. Si vous préférez lancer une nouvelle campagne pour exclure les quelques impressions des utilisateurs test, vous pouvez dupliquer la campagne et la relancer sans le segment d’utilisateurs test.