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 le site de RudderStack pour savoir 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 de 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é API REST de Braze, le cluster de données et l’option du SDK natif (mode appareil uniquement). Lorsque l’option du SDK natif est activée, le SDK natif de Braze sera utilisé pour envoyer les événements.

É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énement à Braze directement depuis votre client (navigateur ou application mobile).
• Serveur à serveur / mode cloud : Le SDK de Braze envoie les données d’événement directement à RudderStack, où elles sont transformées puis acheminées vers Braze.
• Mode hybride : Utilisez le mode hybride pour envoyer les événements iOS et Android générés automatiquement et générés par l’utilisateur vers Braze à l’aide d’une seule connexion.

Remarque

Découvrez les modes de connexion de RudderStack et les avantages de chacun d’entre eux.

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 de RudderStack pour votre plateforme sur le dépôt GitHub de Braze, comme décrit dans les méthodes prises en charge :

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

Pour terminer l’intégration en mode appareil, reportez-vous aux instructions détaillées de RudderStack concernant l’ajout de Braze à votre projet.

Intégration serveur à serveur (mode cloud)

Dans ce mode, le SDK envoie les données d’événement 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 de RudderStack à Braze, comme décrit dans les 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, leurs SDK côté serveur fonctionnent dans le backend de RudderStack et ne peuvent charger aucun SDK spécifique à Braze.

Important

L’intégration serveur à serveur ne prend pas en charge les fonctionnalités de l’interface de Braze, telles que les notifications push ou les messages in-app. 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 bloque leur envoi via le mode appareil.
3. Envoie les événements générés automatiquement (messages in-app, notifications push qui nécessitent le SDK de Braze) via le mode appareil.

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

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

Une fois la configuration initiale terminée, 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 la section Group.
• Use Custom Attributes Operation : activez ce paramètre si vous souhaitez utiliser la fonctionnalité d’attributs personnalisés imbriqués de Braze pour créer des segments et personnaliser vos messages à l’aide d’un objet d’attribut personnalisé. Pour plus d’informations, consultez la section 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 ne s’appliquent que 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 la section Client-side Events Filtering.
• Deduplicate Traits : activez ce paramètre pour dédupliquer les traits de l’utilisateur dans l’appel identify.
• Show Braze logs : ce paramètre ne s’applique que lorsque vous utilisez le SDK JavaScript comme source. Activez-le pour afficher les journaux de 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 sous forme d’attributs personnalisés imbriqués

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

Vous pouvez envoyer les traits utilisateur sous forme d’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": "Mike"
      }
    ]
  },
  "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 sous forme d’attributs personnalisés via les appels track, page ou screen, transmettez traits comme 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": "Mike"
        },
        {
          "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. Reportez-vous à la section Tableau d’objets pour plus d’informations sur l’envoi d’attributs personnalisés imbriqués.