Loop
Track by Loop est le produit de suivi de Loop destiné aux clients eCommerce. Il suit les colis à travers les transporteurs, normalise les statuts d’exécution et envoie ces événements à Braze pour la communication.
Cette intégration est maintenue par Track by Loop.
À propos de l’intégration
Lorsqu’un événement d’expédition se produit (par exemple, expédition créée, en transit, en cours de livraison, livrée ou bloquée), Track by Loop appelle la REST API de Braze pour déclencher une Campaign déclenchée par API ou un Canvas déclenché par API. Chaque appel inclut des propriétés d’expédition et de commande que vous pouvez utiliser pour la personnalisation Liquid. Braze reste le système de référence pour l’éligibilité, la limite de fréquence et la distribution des messages sur les canaux que vous configurez.
Cas d’usage
- Envoyez des mises à jour d’expédition comme « votre commande est en route », « en cours de livraison » et « livrée », avec le numéro de suivi, le transporteur, la date de livraison estimée et une URL de suivi aux couleurs de votre marque.
- Déclenchez des Canvas en cas d’expédition bloquée ou d’erreur de livraison afin que les équipes support et fidélisation puissent répondre aux demandes du type « où est ma commande ? ».
- Mettez en avant le réapprovisionnement, les avis ou des produits associés lorsqu’un colis est livré ou sur le point d’arriver.
- Faites entrer les utilisateurs dans un Canvas à partir du même événement Track by Loop et créez des branches vers l’e-mail, le SMS ou la notification push selon leur statut d’abonnement.
Conditions préalables
Avant de commencer, vous devez disposer des éléments suivants :
| Condition préalable | Description |
|---|---|
| Un compte Track by Loop | Un compte Track by Loop est nécessaire pour cette intégration. |
| Une clé d’API REST de Braze | Une clé d’API REST de Braze disposant des autorisations campaigns.trigger.send, canvas.trigger.send, ou des deux. Créez cette clé dans le tableau de bord de Braze, depuis Paramètres > API et identifiants > Clés d’API. Pour plus d’informations, consultez Créer des clés d’API REST. |
| Un endpoint REST de Braze | L’endpoint REST de votre espace de travail (origine uniquement), par exemple https://rest.iad-01.braze.com. L’hôte doit correspondre à votre cluster Braze (*.braze.com ou *.braze.eu). Pour plus d’informations, consultez Endpoints de l’API REST. |
Intégration
Étape 1 : Créer des Campaigns ou des Canvas déclenchés par API dans Braze
- Dans Braze, créez une Campaign ou un Canvas pour chaque étape de traitement de commande à laquelle vous souhaitez envoyer un message (par exemple, Livré).
- Définissez la distribution sur Déclenchée par API. Pour en savoir plus, consultez la section Distribution déclenchée par API.
- Rédigez le contenu de votre message avec la personnalisation Liquid pour les données de commande, de suivi et du consommateur, et ajoutez un deep link vers la page de suivi. Référencez les propriétés du déclencheur avec
{{api_trigger_properties.${your_property}}}. - Copiez l’identifiant API de cette Campaign ou de ce Canvas. Vous saisirez cette valeur dans Track by Loop lors d’une étape ultérieure.
Étape 2 : Connecter vos identifiants dans Track by Loop
- Dans Track by Loop, accédez à Settings > Integrations > Braze.
- Saisissez votre endpoint REST (origine uniquement), par exemple
https://rest.iad-01.braze.com. - Collez votre clé REST API.
- Sélectionnez Save credentials.
Étape 3 : Mapper les événements de traitement de commande
Sous Event mappings, chaque ligne correspond à un événement de traitement de commande de Track by Loop. Il s’agit des mêmes événements que Track by Loop utilise pour ses autres intégrations marketing.
Pour chaque événement :
- Sélectionnez Campaign ou Canvas.
- Collez l’identifiant API Braze de la Campaign ou du Canvas que vous avez créé.
- Enregistrez la ligne.
Personnalisation
Choisir une Campaign ou un Canvas par événement
Utilisez une Campaign lorsqu’un seul message suffit. Optez pour un Canvas si vous avez besoin de délais, d’un canal de repli ou d’embranchements (par exemple, un SMS si le consommateur n’est pas abonné aux e-mails). Track by Loop enregistre un mappage par événement, sous la forme d’une Campaign ou d’un Canvas.
Utiliser cette intégration
Track by Loop cible un seul destinataire par événement :
- Si un ID client Shopify est présent, Track by Loop définit
external_user_iddans l’objet destinataire avec cet ID sous forme de chaîne de caractères. Cela correspond aux clients qui définissent l’external_idBraze sur l’ID client Shopify. - Si aucun ID client n’est disponible, Track by Loop définit
emaildans l’objet destinataire et applique la priorisation des e-mails de Braze : d’abordunidentified, puismost_recently_updated.
Le consommateur doit déjà disposer d’un profil Braze accessible par cet identifiant.
Tester la connexion
Sur la page des paramètres d’intégration de Braze dans Track by Loop, envoyez un événement test pour confirmer le mappage de votre campagne ou de votre Canvas.
- Sous Test connection, sélectionnez Campaign ou Canvas.
- Collez l’identifiant API d’une campagne ou d’un Canvas actif déclenché par API.
- Saisissez l’adresse e-mail d’un destinataire de test correspondant à un utilisateur Braze existant et pouvant recevoir ce canal.
- Sélectionnez Send test trigger.