RudderStack
RudderStack est une plateforme de données client conçue pour les développeurs, qui collecte et achemine les données d’événements client vers votre entrepôt de données et des dizaines d’autres outils, dont Braze. Elle propose des SDK natifs pour le web et le mobile, des bibliothèques côté serveur pour votre backend, ainsi qu’un cadre de transformation pour façonner les données d’événements en cours d’acheminement.
L’intégration entre Braze et RudderStack vous offre une intégration SDK native pour vos applications Android, iOS et web, ainsi qu’une intégration de serveur à serveur depuis vos services backend. Vous pouvez ainsi envoyer à Braze des attributs utilisateur, des événements personnalisés et des événements eCommerce depuis chaque point de contact, via un pipeline unique.
Cette intégration est maintenue par RudderStack.
À propos de cette intégration
RudderStack se place en amont de Braze en tant que couche de collecte et de routage de vos événements. Vous instrumentez vos applications et services une seule fois avec RudderStack, puis vous diffusez le même flux d’événements vers Braze, ainsi que vers votre entrepôt de données et vos autres destinations, sans ajouter un SDK ou un plan de suivi supplémentaire pour chaque outil.
Pour un marketeur, cela signifie que les attributs utilisateur, les événements comportementaux et l’activité d’achat ou d’e-commerce que vous utilisez pour la segmentation et l’envoi de messages dans Braze arrivent déjà standardisés et gouvernés. Comme RudderStack achemine également ces mêmes événements vers votre entrepôt de données, les audiences que vous créez dans Braze restent cohérentes avec les chiffres communiqués par votre équipe data.
Cas d’usage
- Profils multiplateformes unifiés : Envoyez les traits d’identification depuis le web, iOS, Android et votre backend vers un profil utilisateur Braze unique, en utilisant externalId pour aligner l’identité Braze sur votre système de référence.
- Communication tout au long du cycle de vie eCommerce : Mappez les événements eCommerce standard de RudderStack aux événements eCommerce recommandés par Braze pour alimenter vos campagnes de panier abandonné, d’après-achat, de remboursement et d’annulation.
- Personnalisation pilotée par l’entrepôt de données : Utilisez RudderStack Reverse ETL pour transférer les traits calculés et les résultats de modèles depuis votre entrepôt de données vers Braze sous forme d’attributs personnalisés, afin de les exploiter pour la segmentation.
- Maîtrise du coût des points de données : Activez la déduplication des traits pour que RudderStack n’envoie à Braze que les attributs modifiés, ce qui réduit la consommation de points de données.
- Consentement et filtrage encadrés : Appliquez les catégories de consentement OneTrust et le filtrage des événements avant que les données n’atteignent Braze.
Conditions préalables
Avant de commencer, vous devez disposer des éléments suivants :
| Condition préalable | Description |
|---|---|
| Un compte RudderStack | Un compte RudderStack est nécessaire pour profiter de ce partenariat. |
| Une source configurée | Une source est l’origine des données envoyées à RudderStack, comme un site web, une application mobile ou un serveur backend. Configurez une source avant de définir Braze comme destination. |
| Une clé API REST de Braze | Une clé API REST de Braze disposant des autorisations suivantes : - users.track- users.identify- users.delete- users.alias.new- users.merge- users.export.idsCréez cette clé dans le tableau de bord de Braze en allant dans Paramètres > API et identifiants > Clés API. |
| Une clé d’identifiant d’application par défaut de Braze | Dans le tableau de bord de Braze, accédez à Paramètres > API et identifiants > Identifiants de l’application et copiez l’identifiant de votre application. |
| Un centre de données Braze | Votre centre de données correspond à l’instance de votre tableau de bord de Braze. RudderStack indique les centres de données pris en charge. |
Intégrer RudderStack
Étape 1 : Ajouter une source dans RudderStack
- Connectez-vous à votre tableau de bord RudderStack.
- Configurez la source à partir de laquelle vous souhaitez envoyer des données, par exemple une source JavaScript, iOS, Android ou côté serveur.
- Ouvrez l’onglet Overview de votre source, puis sélectionnez Add Destination > Create new destination.
Étape 2 : Configurer Braze comme destination
- Sélectionnez Braze dans la liste des destinations, puis cliquez sur Continue.
- Saisissez un nom pour la destination.
- Sous Connection settings, renseignez votre Default App Identifier Key, votre REST API Key et votre Data Center.
- Si vous le souhaitez, activez Enable Platform-specific App Identifier Keys (bêta) pour fournir des clés d’identification d’application distinctes pour Android, iOS et le Web, afin d’obtenir une attribution précise dans Braze. Cette option ne s’applique qu’aux modes appareil et hybride, et nécessite une version minimale de l’intégration en mode appareil. Consultez la section fonctionnement de la sélection des clés API.
Étape 3 : Choisir le mode de connexion
Choisissez la manière dont RudderStack transmet les événements à Braze :
- Mode appareil (côte à côte) : RudderStack charge le SDK natif de Braze et envoie les données d’événement à Braze directement depuis votre client (navigateur ou application mobile).
- Mode cloud (de serveur à serveur) : le SDK de RudderStack envoie les données d’événement au serveur RudderStack, qui les transforme et les achemine vers Braze.
- Mode hybride : envoyez à Braze les événements iOS et Android générés automatiquement et générés par les utilisateurs via une seule connexion.
Pour le mode appareil, ajoutez à votre projet l’intégration Braze correspondant à votre plateforme :
En mode hybride, RudderStack initialise le SDK de Braze, envoie tous les événements générés par les utilisateurs (identify, track, page, screen, group) via le mode cloud, et envoie via le mode appareil les événements générés automatiquement qui nécessitent le SDK de Braze, comme les messages in-app et les notifications push.
Pour en savoir plus, consultez les modes de connexion de RudderStack et les avantages de chacun.
Personnaliser RudderStack
Étape 1 : Configurer les paramètres d’événement
Dans le tableau de bord de RudderStack, sous les paramètres d’événement de la destination Braze :
- Enable ecommerce recommended events (bêta) : Mappe les événements de suivi eCommerce de RudderStack aux événements eCommerce recommandés de Braze (ecommerce.*). Ce paramètre est activé par défaut. Pour en savoir plus, consultez Envoyer des événements eCommerce à Braze.
- Enable subscription groups in group call : Envoie le statut du groupe d’abonnement dans vos événements de groupe. Mode cloud uniquement.
- Use Custom Attributes Operation : Vous permet d’utiliser les attributs personnalisés imbriqués de Braze pour créer des Segments et personnaliser vos messages à l’aide d’un objet d’attribut personnalisé. Mode cloud uniquement.
Étape 2 : Configurer les paramètres de déduplication
- Activez Deduplicate Traits dans les paramètres de déduplication de la destination Braze.
- Assurez-vous que votre clé REST API dispose de l’autorisation
users.export.ids.
RudderStack envoie alors uniquement les attributs utilisateur nouveaux ou modifiés à Braze, ce qui réduit la consommation de points de données. Cela fonctionne en mode cloud comme en mode appareil, ainsi que pour les sources Reverse ETL. Consultez User Trait Deduplication in Braze.

La déduplication est disponible avec les offres Growth et Enterprise de RudderStack. En mode cloud, elle utilise l’endpoint Braze /users/export/ids, qui est soumis à une limite de débit. Si cette limite est dépassée, RudderStack envoie tous les attributs sans déduplication jusqu’à ce que le volume repasse sous la limite.
Étape 3 : Configurer le SDK Web et les autres paramètres
Pour le mode appareil Web, configurez les paramètres du SDK Web suivants :
- Show Braze logs : Affiche les logs de Braze à vos utilisateurs.
- Use web push notifications : Active les notifications push Web. Nécessite un service de traitement (service worker) sur votre site.
- Enable HTML in-app messages : Active les messages in-app HTML.
- Track events for anonymous users : Suit l’activité des utilisateurs anonymes et l’envoie à Braze.
Sous other settings :
- Client-side Events Filtering : Indique quels événements sont bloqués ou autorisés à être transmis à Braze. Consultez Client-side Events Filtering.
- OneTrust Cookie Categories : Associe les groupes de consentement aux cookies OneTrust à Braze.

En mode appareil Web, RudderStack charge le SDK natif de Braze depuis https://js.appboycdn.com/. Selon la politique de sécurité du contenu de votre site, vous devrez peut-être ajouter ce domaine à votre liste d’autorisation.
Utiliser RudderStack avec Braze
Étape 1 : Mapper les méthodes RudderStack vers Braze
Braze prend en charge les méthodes RudderStack identify, track, screen, page, group et alias.
| Méthode | Comportement dans Braze |
|---|---|
| identify | Crée ou met à jour un profil utilisateur Braze avec un ID utilisateur unique et des traits facultatifs tels que le nom, l’e-mail et le numéro de téléphone. Utilisez le champ externalId pour définir explicitement un ID utilisateur Braze personnalisé ; Braze utilise en priorité externalId, puis userId à défaut. |
| track | Enregistre les actions des utilisateurs sous forme d’événements personnalisés Braze, avec leurs propriétés. |
| page | Enregistre les consultations de pages du site web et les informations associées à la page. |
| screen | Enregistre les consultations d’écrans mobiles et les informations associées à l’écran. |
| group | Associe un utilisateur à un groupe en envoyant un attribut personnalisé nommé ab_rudder_group_<groupId> défini sur true. Pour mettre à jour le statut du groupe d’abonnement, activez Enable subscription groups in group call et envoyez le statut dans l’appel group : l’e-mail ou le numéro de téléphone est obligatoire. |
| alias | Fusionne les différentes identités d’un utilisateur connu. Pris en charge uniquement en mode cloud. |
Supprimer un utilisateur
Supprimez un utilisateur dans Braze à l’aide de la réglementation Suppression with Delete de l’API User Suppression de RudderStack. Votre clé REST API doit inclure l’autorisation users.delete. RudderStack transmet la demande de suppression, mais ne garantit pas la suppression dans un délai de 30 jours : vérifiez son exécution auprès de Braze.
Attributs personnalisés imbriqués
Lorsque Use Custom Attributes Operation est activé, vous pouvez envoyer des traits utilisateur sous forme d’attributs personnalisés imbriqués et effectuer des opérations d’ajout, de mise à jour et de suppression sur ceux-ci. identifier est obligatoire pour la mise à jour et la suppression. Si aucune opération n’est spécifiée, RudderStack utilise la création. Définissez mergeObjectsUpdateOperation sur true dans les propriétés de l’événement pour fusionner en profondeur les mises à jour.
Pour en savoir plus, consultez Envoyer des traits utilisateur sous forme d’attributs personnalisés imbriqués.
Étape 2 : Envoyer des événements e-commerce à Braze
Lorsque Enable ecommerce recommended events (bêta) est activé, RudderStack mappe les événements track e-commerce RudderStack pris en charge vers les événements e-commerce recommandés de Braze (ecommerce.*) :
| Événement RudderStack | Événement Braze | Action |
|---|---|---|
| Product Viewed | ecommerce.product_viewed | — |
| Product Added | ecommerce.cart_updated | add |
| Product Removed | ecommerce.cart_updated | remove |
| Checkout Started | ecommerce.checkout_started | — |
| Order Completed | ecommerce.order_placed | — |
| Order Refunded | ecommerce.order_refunded | — |
| Order Cancelled | ecommerce.order_cancelled | — |
Les noms d’événements sont mis en correspondance après suppression des espaces superflus et sans tenir compte de la casse : order completed et Order Completed sont donc tous deux mappés. Le mappage est identique en mode cloud et en mode appareil. En mode hybride, les événements track générés par les utilisateurs sont envoyés via le mode cloud, si bien que le même mappage s’applique.

Lorsque ce paramètre est activé, Order Completed est envoyé sous la forme d’un événement personnalisé ecommerce.order_placed par commande, au lieu des achats Braze. Reconstruisez vos analyses d’achats et de chiffre d’affaires Braze ainsi que vos Segments Made Purchase à partir de ecommerce.order_placed. Pour conserver l’ancien mappage des achats, désactivez Enable ecommerce recommended events.
Pour consulter l’ensemble des mappages de champs, les propriétés par produit, les champs automatiques (source, action, métadonnées) et des exemples de payloads, reportez-vous à Braze Recommended Ecommerce Events.
Considérations
Validation des événements eCommerce : Braze exige certains champs pour le traitement des événements de commerce. Voici le comportement de RudderStack lorsqu’un de ces champs est absent :
| Scénario | Comportement |
|---|---|
| Champ obligatoire manquant | RudderStack envoie quand même l’événement, sans le champ. Un champ obligatoire envoyé avec la valeur null, "", {} ou [] est supprimé du payload et traité comme un champ manquant. |
| Braze rejette l’événement | Braze renvoie des erreurs pour ces événements, et RudderStack les affiche également comme interrompus. |
| Mode appareil | Le SDK RudderStack enregistre un avertissement qui liste les champs manquants dans la console du navigateur, Logcat ou la console Xcode, selon le niveau de journalisation de votre SDK. |
| Mode cloud | Un événement rejeté par Braze est abandonné et comptabilisé comme un échec de distribution dans l’onglet Events de la destination dans RudderStack. Cliquez sur la ligne de l’événement dans le tableau Event details pour afficher l’erreur Braze et un exemple de payload. |
| Incompatibilités de type | Elles suivent le même traitement. RudderStack applique une conversion de type sans perte lorsque c’est possible : les chaînes de caractères numériques deviennent des nombres pour les champs float, et les chaînes représentant des entiers deviennent des entiers. Une valeur qui ne peut pas être convertie sans perte est envoyée telle quelle. En mode appareil, le SDK enregistre un avertissement d’incompatibilité de type. En mode cloud, un événement rejeté par Braze pour une incompatibilité de type est abandonné. |
- Traitement par lots et limites de débit MAU : Pour les comptes soumis aux plans tarifaires basés sur les utilisateurs actifs mensuels de Braze, RudderStack regroupe les événements identify et track par lots de 75 événements. Les comptes qui ne disposent pas d’un plan MAU utilisent des lots de 225 événements.
- Fonctionnalités de l’interface Braze : L’intégration de serveur à serveur (mode cloud) ne prend pas en charge les fonctionnalités de l’interface Braze telles que les notifications push ou les messages in-app. Ces fonctionnalités sont prises en charge par l’intégration en mode appareil.
- SDK côté serveur : Les SDK côté serveur de RudderStack (Java, Python, Node.js, Go, Ruby, PHP, .NET, Rust) prennent uniquement en charge le mode cloud, car ils s’exécutent dans votre backend et ne peuvent pas charger le SDK Braze.
- Mode appareil pour Flutter et React Native : La prise en charge du mode appareil pour Flutter et React Native s’applique uniquement à Android et iOS. Pour une version web de Flutter, utilisez le mode cloud ou créez une source JavaScript RudderStack distincte et utilisez sa clé d’écriture pour la version web.
Résolution des problèmes
Mes événements eCommerce échouent en mode cloud
En mode cloud, un événement rejeté par Braze est supprimé et comptabilisé comme un échec de distribution. Ouvrez l’onglet Events de la destination dans RudderStack, cliquez sur la ligne de l’événement dans le tableau Event details, puis examinez l’erreur Braze et l’exemple de payload.
Pour plus d’informations, consultez Missing required fields.
Mes rapports d’achats et de chiffre d’affaires Braze ne sont plus alimentés
Le paramètre Enable ecommerce recommended events est activé : Order Completed est donc envoyé en tant qu’événement personnalisé ecommerce.order_placed au lieu d’un achat Braze. Reconstruisez vos analyses d’achats et de chiffre d’affaires ainsi que vos Segments Made Purchase à partir de ecommerce.order_placed, ou désactivez ce paramètre pour rétablir l’ancien mappage des achats.
Je vois « [Braze Deduplication]: Duplicate user detected, the user is dropped » dans les logs RudderStack
Ce message provient de RudderStack lorsque Deduplicate Traits est activé et que RudderStack supprime les traits utilisateur inchangés avant de les transmettre à Braze. Il ne s’agit pas d’une erreur Braze.
RudderStack compare les traits entrants des appels identify et track au profil utilisateur et ignore les attributs qui n’ont pas changé, ce qui réduit la consommation de points de données Braze. Si vous avez besoin que tous les traits soient envoyés à chaque appel, désactivez Deduplicate Traits dans les paramètres de votre destination Braze dans RudderStack. Gardez toutefois à l’esprit que cela peut augmenter votre consommation de points de données.
Pour plus de détails, consultez User Trait Deduplication in Braze.
Certains attributs personnalisés ne sont pas dédupliqués alors que leurs valeurs n’ont pas changé
Vérifiez que le type de données de chaque attribut personnalisé envoyé dans vos événements correspond au type configuré dans le tableau de bord de Braze, et que les dates et horodatages utilisent un format pris en charge par Braze. Sinon, la déduplication ne fonctionnera pas correctement.