RudderStack

RudderStack est une infrastructure de données client open-source permettant de collecter et d’acheminer les données d’événements client vers votre entrepôt de données préféré et des dizaines d’autres fournisseurs d’analytique, tels que Braze. Elle est prête pour l’entreprise et offre un cadre de transformation robuste pour traiter vos données d’événements à la volée.

L’intégration entre Braze et RudderStack offre une intégration SDK native pour vos applications Android, iOS et web, ainsi qu’une intégration de serveur à serveur à partir de vos services backend.

Conditions préalables

Intégration

Étape 1 : Ajouter une source

Pour commencer à envoyer des données à Braze, vous devez d’abord vous assurer qu’une source est configurée dans votre application RudderStack. Consultez RudderStack pour découvrir comment configurer votre source de données.

Étape 2 : Configurer la destination

Maintenant que votre source de données est configurée, dans le tableau de bord RudderStack, sélectionnez ADD DESTINATION sous Destinations. Dans la liste des destinations disponibles, sélectionnez Braze et cliquez sur Next.

Dans la destination Braze, indiquez la clé d’application, la clé REST API de Braze, le cluster de données et l’option SDK natif (mode appareil uniquement). L’option SDK natif utilisera le SDK natif de Braze pour envoyer les événements si elle est activée.

Étape 3 : Choisir le type d’intégration

Vous pouvez choisir d’intégrer les bibliothèques web et natives côté client de RudderStack avec Braze en utilisant l’une des approches suivantes :

• Intégration côte à côte / mode appareil : RudderStack enverra les données d’événements à Braze directement depuis votre client (navigateur ou application mobile).
• Serveur à serveur / mode cloud : Le SDK de Braze envoie les données d’événements directement à RudderStack, qui les transforme et les achemine ensuite vers Braze.
• Mode hybride : Utilisez le mode hybride pour envoyer les événements iOS et Android auto-générés et générés par l’utilisateur à Braze via une seule connexion.

Remarque

Apprenez-en davantage sur les modes de connexion de RudderStack et les avantages de chacun.

Intégration côte à côte (mode appareil)

Avec ce mode, vous pouvez envoyer vos événements à Braze en utilisant le SDK de Braze configuré sur votre site web ou votre application mobile.

Configurez les mappages vers le SDK RudderStack pour votre plateforme dans le dépôt GitHub de Braze, comme décrit dans la section méthodes prises en charge :

• Android
• iOS
• Swift
• Web
• React Native
• Flutter

Pour finaliser l’intégration en mode appareil, consultez les instructions détaillées de RudderStack pour ajouter Braze à votre projet.

Intégration serveur à serveur (mode cloud)

Dans ce mode, le SDK envoie les données d’événements directement au serveur RudderStack. RudderStack transforme ensuite ces données et les achemine vers la destination souhaitée. Cette transformation est effectuée dans le backend de RudderStack à l’aide du module de transformation de RudderStack.

Pour activer l’intégration, vous devrez mapper les méthodes RudderStack vers Braze, comme décrit dans la section méthodes prises en charge.

Remarque

Les SDK côté serveur de RudderStack (Java, Python, Node.js, Go, Ruby) ne prennent en charge que le mode cloud. En effet, ces SDK côté serveur fonctionnent dans le backend de RudderStack et ne peuvent pas charger de SDK spécifique à Braze.

Important

L’intégration serveur à serveur ne prend pas en charge les fonctionnalités de l’interface utilisateur de Braze, telles que les notifications push ou les In-App Messages. Ces fonctionnalités sont toutefois prises en charge par l’intégration en mode appareil.

Mode hybride

Utilisez le mode hybride pour envoyer tous les événements à Braze depuis vos sources iOS et Android.

Lorsque vous choisissez le mode hybride pour envoyer des événements à Braze, RudderStack :

1. Initialise le SDK de Braze.
2. Envoie tous les événements générés par l’utilisateur (identify, track, page, screen et group) à Braze uniquement via le mode cloud et les empêche d’être envoyés via le mode appareil.
3. Envoie les événements auto-générés (In-App Messages, notifications push nécessitant le SDK de Braze) via le mode appareil.

Pour envoyer des événements via le mode hybride, utilisez l’option mode hybride lors de la connexion de votre source à la destination Braze. Ajoutez ensuite l’intégration Braze à votre projet.

Étape 4 : Configurer les paramètres supplémentaires

Après avoir terminé la configuration initiale, configurez les paramètres suivants pour recevoir correctement vos données dans Braze :

• Enable subscription groups in group call : Activez ce paramètre pour envoyer le statut du groupe d’abonnement dans vos événements de groupe. Pour plus d’informations, consultez Group.
• Use Custom Attributes Operation : Activez ce paramètre si vous souhaitez utiliser la fonctionnalité d’attributs personnalisés imbriqués dans Braze pour créer des Segments et personnaliser vos messages à l’aide d’un objet d’attribut personnalisé. Pour plus d’informations, consultez Send user traits as nested custom attributes.
• Track events for anonymous users : Activez ce paramètre pour suivre l’activité des utilisateurs anonymes et envoyer ces informations à Braze.

Paramètres du mode appareil

Les paramètres suivants s’appliquent uniquement si vous envoyez des événements à Braze via le mode appareil :

• Client-side Events Filtering : Ce paramètre vous permet de spécifier quels événements doivent être bloqués ou autorisés à transiter vers Braze. Pour plus d’informations sur ce paramètre, consultez Client-side Events Filtering.
• Deduplicate Traits : Activez ce paramètre pour dédupliquer les traits utilisateur dans l’appel identify.
• Show Braze logs : Ce paramètre s’applique uniquement lors de l’utilisation du SDK JavaScript comme source. Activez-le pour afficher les journaux Braze à vos utilisateurs.
• OneTrust Cookie Categories : Ce paramètre vous permet d’associer les groupes de consentement aux cookies OneTrust à Braze.

Méthodes prises en charge

Braze prend en charge les méthodes RudderStack identify, track, screen, page, group et alias.

• identify
• track
• screen
• page
• group
• alias

Envoyer les traits utilisateur en tant qu’attributs personnalisés imbriqués

Vous pouvez envoyer les traits utilisateur à Braze en tant qu’attributs personnalisés imbriqués et effectuer des opérations d’ajout, de mise à jour et de suppression sur ceux-ci. Pour cela, activez le paramètre « Use Custom Attributes Operation dashboard » dans RudderStack lors de la configuration de la destination Braze. Cette fonctionnalité est disponible uniquement en mode cloud.

Vous pouvez envoyer les traits utilisateur en tant qu’attributs personnalisés imbriqués dans vos événements identify au format suivant :

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
rudderanalytics.identify("1hKOmRA4GRlm", {
  "cars": {
    "add": [{
      "age": 27,
      "id": 1,
      "name": "Alex Keener"
    }],
    "update": [{
        "age": 30,
        "id": 2,
        "identifier": "id",
        "name": "Rowan"
      },
      {
        "age": 27,
        "id": 1,
        "identifier": "id",
        "name": "Alex"
      }
    ]
  },
  "country": "USA",
  "email": "[email protected]",
  "firstName": "Alex",
  "gender": "M",
  "pets": [{
      "breed": "beagle",
      "id": 1,
      "name": "Scooby",
      "type": "dog"
    },
    {
      "breed": "calico",
      "id": 2,
      "name": "Garfield",
      "type": "cat"
    }
  ]
})

Pour envoyer les traits utilisateur en tant qu’attributs utilisateur personnalisés via les appels track, page ou screen, transmettez traits en tant que champ contextuel dans l’événement :

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
rudderanalytics.track("Product Viewed", {
    revenue: 8.99,
    currency: "USD",
 },{
  "traits": {
    "cars": {
      "add": [{
        "age": 27,
        "id": 1,
        "name": "Alex Keener"
      }],
      "update": [{
          "age": 30,
          "id": 2,
          "identifier": "id",
          "name": "Alex"
        },
        {
          "age": 27,
          "id": 1,
          "identifier": "id",
          "name": "Rowan"
        }
      ]
    },
    "city": "Disney",
    "country": "USA",
    "email": "[email protected]",
    "firstName": "Alexa",
    "gender": "woman",
    "pets": [{
        "breed": "beagle",
        "id": 1,
        "name": "Scooby",
        "type": "dog"
      },
      {
        "breed": "calico",
        "id": 2,
        "name": "Garfield",
        "type": "cat"
      }
    ]
  }
});

Remarque

Pour les opérations de mise à jour et de suppression, identifier est une clé obligatoire. Si les opérations d’ajout, de mise à jour ou de suppression ne sont pas présentes dans le tableau imbriqué, RudderStack utilise par défaut l’opération de création pour créer les propriétés. Consultez la section Tableau d’objets pour en savoir plus sur l’envoi d’attributs personnalisés imbriqués.

Résolution des problèmes

Je vois « [Braze Deduplication]: Duplicate user detected, the user is dropped » dans les journaux RudderStack

Ce message provient de RudderStack lorsque l’option Deduplicate Traits est activée 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 sans différence afin de réduire la consommation de points de donnée Braze. Pour plus de détails, consultez le guide de RudderStack sur la déduplication des traits utilisateur dans Braze.

Si vous avez besoin que chaque trait soit envoyé à chaque appel, désactivez l’option Deduplicate Traits dans les paramètres de votre destination Braze dans RudderStack. Sachez que cela peut augmenter la consommation de points de donnée Braze.