Rudderstack

[RudderStack][1] est une infrastructure de données clients open-source permettant de collecter et d’acheminer les données d’événements personnalisés vers votre entrepôt de données préféré et des dizaines d’autres fournisseurs d’analyses, tels que Braze. Il est prêt 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. Visitez le site [Rudderstack][22] ] 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 Suivant.

Dans la destination Braze, spécifiez la clé de l’application, la clé de l’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 des événements.

Étape 3 : Choisissez 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 :

• Mode côte à côte / appareil: Rudderstack enverra les données d’événement à Braze directement depuis votre client (navigateur ou application mobile).
• Mode serveur à serveur / cloud: Le SDK de Braze envoie les données d’événement directement à Rudderstack où elles sont transformées avant d’être acheminées vers Braze.
• Mode hybride: Utilisez le mode hybride pour envoyer des é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.

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

Avec ce mode, vous pouvez envoyer vos événements à Braze en utilisant le SDK de Braze mis en place 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][android]
• [iOS][ios]
• [Swift][swift]
• [Web][web]
• [React Native][react]
• [Flutter][flutter]

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

Intégration de 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 permettre l’intégration, vous devrez mapper les méthodes de Rudderstack à Braze, comme décrit dans les méthodes prises en charge.

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 (identifier, suivre, page, écran et groupe) à 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 :

• Activer les groupes d’abonnement dans les appels de groupe: 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 Groupe.
• Utiliser l’opération d’attributs personnalisés: 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 Envoyer des caractéristiques d’utilisateur en tant qu’attributs personnalisés imbriqués.
• Suivre les événements pour les utilisateurs anonymes: Activez ce paramètre pour suivre l’activité de l’utilisateur anonyme 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:

• Filtrage des événements côté client: 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 Filtrage des événements côté client.
• Déduplication des caractéristiques : Activez ce paramètre pour dédupliquer les traits de l’utilisateur dans l’appel identify.
• Afficher les journaux de Braze: Ce paramètre ne s’applique que lorsque vous utilisez le SDK JavaScript comme source. Activez-la pour afficher les journaux de Braze à vos utilisateurs.
• Catégories de cookies OneTrust: 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.

• identifier
• suivre
• écran
• page
• groupe
• alias

Envoyer les caractéristiques de l’utilisateur sous forme d’attributs personnalisés imbriqués

Vous pouvez envoyer les traits d’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 “Utiliser le tableau de bord des opérations sur les attributs personnalisés” dans RudderStack lors de la configuration de la destination Braze. Cette fonctionnalité n’est disponible qu’en mode cloud.

Vous pouvez envoyer les caractéristiques de l’utilisateur sous forme d’attributs personnalisés imbriqués dans vos événements identify dans le 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": "alex@example.com",
  "firstName": "Alex",
  "gender": "M",
  "pets": [{
      "breed": "beagle",
      "id": 1,
      "name": "Scooby",
      "type": "dog"
    },
    {
      "breed": "calico",
      "id": 2,
      "name": "Garfield",
      "type": "cat"
    }
  ]
})

Pour envoyer les caractéristiques de l’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": "alexa@example.com",
    "firstName": "Alexa",
    "gender": "woman",
    "pets": [{
        "breed": "beagle",
        "id": 1,
        "name": "Scooby",
        "type": "dog"
      },
      {
        "breed": "calico",
        "id": 2,
        "name": "Garfield",
        "type": "cat"
      }
    ]
  }
});

Il y a [1]: https://rudderstack.com/ [3]: https://www.rudderstack.com/docs/dashboard-guides/sources/ [15]: /docs/fr/api/basics/#endpoints [20]: https://www.rudderstack.com/docs/event-spec/ecommerce-events-spec/ [21]: /docs/fr/user_guide/data_and_analytics/export_braze_data/exporting_revenue_data/#revenue-data [22]: https://www.rudderstack.com/docs/destinations/streaming-destinations/braze/#getting-started [android]: https://github.com/rudderlabs/rudder-integration-braze-android [ios]: https://github.com/rudderlabs/rudder-integration-braze-ios/tree/master [swift]: https://github.com/rudderlabs/rudder-integration-braze-swift [web]: https://github.com/rudderlabs/rudder-sdk-js/tree/production/src/integrations/Braze [react]: https://github.com/rudderlabs/rudder-sdk-react-native/tree/develop/libs/rudder-integration-braze-react-native [Flutter]: https://github.com/rudderlabs/rudder-sdk-flutter/tree/develop/packages/integrations/rudder_integration_braze_flutter