Cas d’utilisation de l’API

La REST API de Braze offre une large gamme d’endpoints conçus pour vous aider à gérer et optimiser votre stratégie d’engagement client. Dans cet article, nous explorerons plusieurs cas d’utilisation pour chaque collection d’endpoints : catalogues, listes et adresses e-mail, exportation, messages, centre de préférences, SMS, groupes d’abonnement, modèles et données utilisateur.

Chaque section présente un scénario avec un guide étape par étape, un exemple de code et un résultat attendu. À la fin de cet article, vous comprendrez mieux comment utiliser la REST API de Braze pour améliorer vos efforts d’engagement client.

Suppression de plusieurs articles dans un catalogue

Une nouvelle année marque le lancement de nouveaux produits chez Kitchenerie, une marque de vente au détail spécialisée dans les articles de cuisine. Dans le tableau de bord de Braze, Kitchenerie dispose d’un catalogue configuré pour sa collection de vaisselle, intitulé « Dishware ». Cette nouvelle année implique également le retrait des produits suivants de sa collection de vaisselle.

• Plain Bisque
• Pearl Porcelain
• Pink Shimmer

Pour supprimer ces produits de son catalogue, Kitchenerie peut utiliser l’endpoint /catalogs/{catalog_name}/items afin de transmettre les ID des articles concernés.

Voici un exemple de requête :

1
2
3
4
5
6
7
8
9
10

curl --location --request DELETE 'https://rest.iad-03.braze.com/catalogs/dishware/items' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR-REST-API-KEY' \
--data-raw '{
  "items": [
    {"id": "plainbisque"},
    {"id": "pearlporcelain"},
    {"id": "pinkshimmer"}
  ]
}'

Après l’envoi de ce payload, la réponse confirme que Braze a bien supprimé les trois articles du catalogue de vaisselle de Kitchenerie.

1
2
3

{
  "message": "success"
}

Supprimer des e-mails de la liste de spam de Braze

Chez MovieCanon, une entreprise de services de streaming, l’équipe de développement est chargée d’auditer régulièrement ses listes d’e-mails afin d’identifier et de conserver les utilisateurs abonnés à ses campagnes par e-mail. Dans le cadre de cet audit, MovieCanon souhaite supprimer cette liste d’e-mails de sa liste de spam :

• august.author.example.com
• [email protected]
• [email protected]
• [email protected]
• [email protected]

Pour accomplir cette tâche, l’équipe de développement a besoin d’une clé API disposant de la permission email.spam.remove afin d’utiliser l’endpoint /email/spam/remove. Cet endpoint supprime les adresses e-mail de la liste de spam de Braze et de la liste de spam gérée par le fournisseur de services d’e-mailing de MovieCanon.

Pour envoyer cette requête, incluez soit une adresse e-mail sous forme de chaîne de caractères, soit un tableau contenant jusqu’à 50 adresses e-mail à modifier. Comme la liste d’e-mails à supprimer contient moins de 50 adresses, MovieCanon peut accomplir cette tâche avec le corps de requête suivant :

1
2

Content-Type: application/json
Authorization: Bearer YOUR-REST-API-KEY

1
2
3

{
  "email": ["august.author.example.com","[email protected]","[email protected]","[email protected]","[email protected]"]
}

Après l’envoi réussi de ce payload, cette réponse confirme que Braze a supprimé les e-mails de la liste de spam de MovieCanon.

1
2
3

{
  "message": "success"
}

Audit de tous les Canvas

Siege Valley Health est un réseau hospitalier comprenant 10 hôpitaux et centres de recherche en activité, avec des milliers de patients. Son équipe marketing souhaite comparer les Canvas envoyés aux patients pour leur rappeler de prendre rendez-vous pour un vaccin antigrippal au cours des 3 dernières années d’utilisation de Braze. L’équipe marketing de Siege Valley Health souhaite également un moyen rapide et efficace de consulter à la fois la liste des Canvas et le récapitulatif analytique.

L’exemple suivant montre comment Siege Valley Health peut accomplir ces deux tâches en utilisant une combinaison d’endpoints plutôt qu’en filtrant depuis le tableau de bord de Braze.

Pour la première tâche d’audit des Canvas, utilisez l’endpoint /canvas/list pour exporter une liste de Canvas incluant le nom et les tags. Voici un exemple de requête :

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

{
  "canvases" : [
  	{
  		"id": "canvas_identifier_1",
  		"last_edited": "2020-07-10T23:59:59",
  		"name": "PatientReminder_FluShot_2020",
  		"tags": {
        "flu_shots", "patienthealth", "2020"
      }
  	},
  	{
  		"id": "canvas_identifier_2",
  		"last_edited": "2020-07-30T23:59:59",
  		"name": "PatientReminder2_FluShot_2020",
  		"tags": {
        "flu_shots", "patienthealth", "reminder", "2020"
      }
  	},
    ... (more Canvases)
  ],
  "message": 'success'
}

Passons à la tâche suivante : consulter le récapitulatif analytique du premier Canvas de la liste de Siege Valley Health. Pour ce faire, nous utiliserions l’endpoint /canvas/data_summary avec les paramètres de requête suivants :

• canvas_id : “canvas_identifier_2”
• ending_at : 2023-07-10T23:59:59
• starting_at : 2020-07-10T23:59:59

Voici un exemple de requête :

1
2

curl --location -g --request GET 'https://rest.iad-01.braze.com/canvas/data_summary?canvas_id=&ending_at=2023-07-10T23:59:59&starting_at=2020-07-10T23:59:59&length=5&include_variant_breakdown=false&include_step_breakdown=false&include_deleted_step_data=false' \
--header 'Authorization: Bearer YOUR-REST-API-KEY'

Vérifier les campagnes et Canvas planifiés à venir

La période la plus chargée de l’année approche à grands pas pour Flash & Thread, une marque de vente au détail qui commercialise des vêtements et des produits de beauté en ligne et en magasin. Son équipe marketing souhaite vérifier les Campaigns et Canvas à venir depuis le tableau de bord de Braze avant le 31 mars 2024 à 12h00. Cela peut être accompli en utilisant l’endpoint /messages/scheduled_broadcasts.

Voici un exemple de requête :

1
2

curl --location --request GET 'https://rest.iad-01.braze.com/messages/scheduled_broadcasts?end_time=2024-03-31T12:00:00' \
--header 'Authorization: Bearer YOUR-REST-API-KEY'

Cet endpoint renvoie la liste des Campaigns et Canvas à venir. À partir de là, l’équipe marketing peut confirmer sa liste de messages en se référant au champ name pour les Campaigns et Canvas dans la réponse.

Consulter un ancien centre de préférences

PoliterWeekly est un magazine numérique dont les abonnés sont joignables par e-mail. Afin de mieux comprendre le parcours utilisateur de ses abonnés, l’équipe marketing souhaite consulter les détails du centre de préférences de PoliterWeekly pour vérifier quand il a été créé et mis à jour pour la dernière fois.

En utilisant l’endpoint /preference_center/v1/{preferenceCenterExternalID}, l’équipe marketing n’a qu’à insérer l’ID externe du centre de préférences comme paramètre de chemin, ce qui donnerait ceci :

1
2

curl --location -g --request GET https://rest.iad-01.braze.com/preference_center/v1/politer_weekly_preference_center_api_id \
--header 'Authorization: Bearer YOUR-REST-API-KEY'

1
2
3
4
5
6
7
8
9
10
11
12
13
14

{
  "name": "PoliterWeekly Notification Preferences",
  "preference_center_api_id": "user_engage_pref_123",
  "created_at": "2021-04-03T12:00:00",
  "updated_at": "2024-08-15T15:00:00",
  "preference_center_title": "Manage Your PoliterWeekly Notification Preferences",
  "preference_center_page_html": "<!DOCTYPE html><html><head><title>Your PoliterWeekly Newsletter Preferences</title><style>body { font-family: Arial, sans-serif; margin: 0; padding: 20px; }.container { max-width: 600px; margin: auto; }h1 { color: #333; }.preference { margin-bottom: 20px; }.preference label { font-size: 16px; }.preference input[type=\"checkbox\"] { margin-right: 10px; }.submit-btn { background-color: #007bff; color: white; padding: 10px 20px; border: none; cursor: pointer; }</style></head><body><div class=\"container\"><h1>Manage your notification preferences</h1><p>Select the types of updates you wish to receive from us:</p><form id=\"preferencesForm\"><div class=\"preference\"><label><input type=\"checkbox\" name=\"newsUpdates\" checked> News Updates</label></div><div class=\"preference\"><label><input type=\"checkbox\" name=\"editorialPicks\"> Editorial Picks</label></div><div class=\"preference\"><label><input type=\"checkbox\" name=\"events\"> Events & Webinars</label></div><div class=\"preference\"><label><input type=\"checkbox\" name=\"specialOffers\"> Special Offers & Promotions</label></div><button type=\"submit\" class=\"submit-btn\">Save Preferences</button></form></div><script>document.getElementById('preferencesForm').addEventListener('submit', function(e) {e.preventDefault();alert('Your preferences have been saved!');});</script></body></html>",
  "confirmation_page_html": "<!DOCTYPE html><html><head><title>PoliterWeekly Preferences Updated</title></head><body><h1>You're good to go!</h1><p>Braze updated your preferences successfully.</p></body></html>",
  "redirect_page_html": null,
  "preference_center_options": {
    "meta-viewport-content": "width=device-width, initial-scale=1"
  },
  "state": "active"
}

Suppression des numéros de téléphone invalides

Chez CashBlastr, l’objectif principal est de simplifier la manière dont les utilisateurs peuvent envoyer et recevoir des paiements rapides. En tant qu’entreprise de services financiers, CashBlastr souhaite maintenir sa liste de numéros de téléphone clients à jour et exacte. L’équipe de développement a été chargée de supprimer la liste suivante de numéros de téléphone marqués comme « invalides » afin que les messages SMS de l’équipe marketing puissent atteindre les clients CashBlastr appropriés.

• 12223135467
• 12183095514
• 14235662245
• 14324567892

Pour envoyer une requête avec l’endpoint /sms/invalid_phone_numbers/remove, les numéros de téléphone doivent être présentés sous forme de tableau de chaînes de caractères au format e.164, avec un maximum de 50 numéros de téléphone par requête. Comme la liste ne dépasse pas 50 numéros de téléphone, voici un exemple du corps de la requête que l’équipe de développement de CashBlastr enverrait :

1
2
3
4
5

Content-Type: application/json
Authorization: Bearer YOUR-REST-API-KEY
{
  "phone_numbers": ["12183095514","14255551212"]
}

Après l’envoi de ce payload, la réponse confirme que Braze a supprimé les numéros de téléphone invalides de CashBlastr de la liste des numéros invalides de Braze.

1
2
3

{
  "message": "success"
}

Consulter le statut du groupe d’abonnement d’un utilisateur

SandwichEmperor est une chaîne de restauration rapide aux États-Unis, et son équipe marketing souhaite vérifier les statuts de groupes d’abonnement pour une liste aléatoire de ses utilisateurs SMS. En utilisant l’endpoint /subscription/status/get, SandwichEmperor peut accomplir cette tâche pour un utilisateur individuel avec l’exemple de requête suivant :

1
2

curl --location -g --request GET 'https://rest.iad-01.braze.com/subscription/status/get?subscription_group_id={{subscription_group_id}}&phone=+11232223333' \
--header 'Authorization: Bearer YOUR-REST-API-KEY'

Cet endpoint répertorie également les statuts de groupes d’abonnement d’un utilisateur pour l’e-mail. Utilisez-le pour consulter le statut du groupe d’abonnement de plusieurs utilisateurs.

Vérification d’un modèle HTML pour l’envoi d’e-mails

Chez WorkFriends, un réseau social qui aide à créer des liens entre des travailleurs de différentes industries, l’équipe marketing est responsable de l’envoi de campagnes par e-mail à ses utilisateurs. Ces campagnes incluent souvent des rappels pour des événements locaux, des newsletters hebdomadaires et des résumés de l’activité du profil.

Dans ce scénario, WorkFriends a toujours utilisé un seul modèle HTML avec son ancienne identité de marque. Afin d’harmoniser son identité de marque, WorkFriends souhaite vérifier s’il existe des informations utiles dans ce modèle HTML à exploiter avant de passer à un nouveau modèle.

1
2
3
4
5
6
7
8
9
10
11

{
  "email_template_id": "WorkFriends_Email_Template_ID",
  "template_name": "Promo template",
  "description": "Promo template",
  "subject": "WorkFriends Weekly Newsletter",
  "preheader": "Another week, another WorkFriends update",
  "body": "<!DOCTYPE html><html><head><title>WorkFriends Weekly Newsletter</title><style>body {font-family: Arial, sans-serif; color: #333;}.container {padding: 20px;}.header {background-color: #f2f2f2; padding: 10px; text-align: center;}.content {margin-top: 20px;}.footer {margin-top: 20px; font-size: 12px; text-align: center; color: #777;}</style></head><body><div class=\"container\"><div class=\"header\"><h2>WorkFriends Weekly Newsletter</h2></div><div class=\"content\"><p>Hello WorkFriends,</p><p>Welcome to another edition of our weekly newsletter. We've got some exciting updates and promos for you this week!</p><!-- Add more content here --><p>Don't forget to check out our latest promos and updates. Stay connected, stay informed!</p></div><div class=\"footer\"><p>Thank you for being a part of WorkFriends.</p><p>Unsubscribe | Update Preferences</p></div></div></body></html>",
  "tags": "promo",
  "created_at": "2020-07-10 13:00:00.000",
  "updated_at": "2024-02-04 17:00:00.000"
}

Après avoir examiné les informations de ce modèle, WorkFriends peut également utiliser l’endpoint /templates/email/update pour mettre à jour le modèle d’e-mail via l’API. Le modèle d’e-mail dans le tableau de bord de Braze reflète ces modifications.