Segment

Segment est une plateforme de données clients qui vous aide à collecter, nettoyer et activer vos données clients.

L’intégration de Braze et Segment vous permet de suivre vos utilisateurs et d’acheminer les données vers différents fournisseurs d’analyse des utilisateurs. Segment vous permet de :

• Synchroniser Segment Engage avec Braze pour une utilisation dans la segmentation de Campaign et Canvas de Braze.
• Importer des données entre les deux plateformes. Nous proposons une intégration SDK côte à côte pour vos applications Android, iOS et web, ainsi qu’une intégration serveur à serveur pour la synchronisation de vos données avec les REST API de Braze.
• Connecter les données à Segment via Currents.

Conditions préalables

Intégration

Pour intégrer Braze et Segment, vous devez définir Braze comme destination conformément au type d’intégration que vous avez choisi (mode de connexion). Si vous êtes un nouveau client de Braze, vous pouvez transmettre des données historiques à Braze à l’aide des rediffusions Segment. Ensuite, vous devez configurer des mappages et tester votre intégration pour garantir un flux de données fluide entre Braze et Segment.

Étape 1 : Créer une destination Braze

Après avoir configuré vos sources avec succès, vous devrez configurer Braze comme destination pour chaque source (iOS, Android, web, etc.). Vous disposerez de nombreuses options pour personnaliser le flux de données entre Braze et Segment à l’aide des paramètres de connexion.

Étape 2 : Choisir le framework de destination et le type de connexion

Dans Segment, accédez à Destinations > Braze > Configure Braze > Select your Source > Setup.

Vous pouvez intégrer la source web (Analytics.js) et les bibliothèques natives côté client de Segment à Braze à l’aide d’une intégration côte à côte (mode appareil) ou d’une intégration serveur à serveur (mode cloud).

Votre choix de mode de connexion sera déterminé par le type de source pour lequel la destination est configurée.

Remarque

Consultez Segment pour en savoir plus sur les deux options d’intégration (modes de connexion), y compris les avantages de chacune.

Intégration SDK côte à côte

Également appelée mode appareil, cette intégration associe le SDK et les méthodes de Segment au SDK Braze, ce qui permet d’accéder à toutes les fonctionnalités fournies par notre SDK, telles que le push, les messages in-app et d’autres méthodes natives de Braze.

Remarque

Lorsque vous utilisez le mode appareil de Segment, vous n’avez pas besoin d’intégrer directement le SDK Braze. Lors de l’ajout de Braze en tant que destination en mode appareil pour Segment, le SDK Segment initialise le SDK Braze et appelle les méthodes Braze mappées pertinentes.

Important

Pour les intégrations en mode appareil sur mobile, vous devez ajouter le plugin de destination Braze à votre application en plus de configurer la destination dans le tableau de bord Segment. Le SDK Segment n’inclut pas le plugin Braze par défaut — sans celui-ci, le SDK Segment ne peut pas transmettre les données ou les appels de méthodes mappées à Braze, et les fonctionnalités telles que le push, les messages in-app et Content Cards ne fonctionneront pas. Consultez les onglets spécifiques à chaque plateforme ci-dessous pour les instructions d’installation.

Lorsque vous utilisez une connexion en mode appareil, comme si vous intégriez le SDK Braze de manière native, le SDK Braze attribuera un device_id et un identifiant backend, braze_id, à chaque utilisateur. Cela permet à Braze de capturer l’activité anonyme de l’appareil en faisant correspondre ces identifiants plutôt que userId.

Remarque

Si vous utilisez des filtres de destination avec des destinations en mode appareil (Kotlin ou Swift), vous devez configurer le plugin de destination avec la prise en charge des filtres activée. Consultez la documentation sur les filtres de destination de Segment pour plus de détails sur les versions de plugins prises en charge.

• android
• ios
• web ou javascript
• react native

Important

Le code source de l’intégration en mode appareil Android est maintenu par Braze et est mis à jour régulièrement pour refléter les nouvelles versions du SDK Braze.

Le SDK Braze que vous utilisez dépend du SDK Segment que vous utilisez :

	SDK Segment	SDK Braze
Recommandé	Analytics-Kotlin	Braze Segment Kotlin
Hérité	Analytics-Android	Braze Segment Android

Pour configurer Braze comme destination en mode appareil pour votre source Android, choisissez Actions comme Destination framework, puis sélectionnez Save.

Pour terminer l’intégration côte à côte, vous devez ajouter le plugin de destination Braze Kotlin à votre application Android. Ce plugin fait le lien entre le SDK Segment et le SDK Braze, permettant aux données en mode appareil de circuler vers Braze. Suivez les instructions d’installation de Segment pour ajouter la dépendance du plugin et l’initialiser avec votre instance d’analyse Segment.

Le code source de l’intégration en mode appareil Android est maintenu par Braze et est mis à jour régulièrement pour refléter les nouvelles versions du SDK Braze.

Important

Le code source de l’intégration en mode appareil iOS est maintenu par Braze et est mis à jour régulièrement pour refléter les nouvelles versions du SDK Braze.

Le SDK Braze que vous utilisez dépend du SDK Segment que vous utilisez :

	SDK Segment	SDK Braze
Recommandé	Analytics-Swift	Braze Segment Swift
Hérité	Analytics-iOS	Braze Segment iOS

Pour configurer Braze comme destination en mode appareil pour votre source iOS, choisissez Actions comme Destination framework, puis sélectionnez Save.

Pour terminer l’intégration côte à côte, vous devez ajouter le plugin de destination Braze Swift à votre application iOS. Ce plugin fait le lien entre le SDK Segment et le SDK Braze, permettant aux données en mode appareil de circuler vers Braze. Suivez les instructions d’installation de Segment pour ajouter la dépendance du plugin (via Swift Package Manager ou CocoaPods) et l’initialiser avec votre instance d’analyse Segment.

Le code source de l’intégration en mode appareil iOS est maintenu par Braze et est mis à jour régulièrement pour refléter les nouvelles versions du SDK Braze.

Le framework Braze Web Mode (Actions) de Segment est recommandé pour configurer Braze en tant que destination en mode appareil pour votre source web.

Dans Segment, sélectionnez Actions comme framework de destination et Device Mode comme mode de connexion.

Le code source du plugin React Native Braze est maintenu par Segment et est mis à jour régulièrement pour refléter les nouvelles versions du SDK Braze.

Lorsque vous connectez une source Segment React Native à Braze, vous devez configurer une source et une destination par système d’exploitation. Par exemple, vous devez configurer une destination iOS et une destination Android.

Dans la base de code de votre application, initialisez de manière conditionnelle le SDK Segment par type d’appareil, à l’aide de la clé d’écriture source associée à chaque application.

Lorsqu’un jeton de notification push est enregistré depuis un appareil et envoyé à Braze, il est associé à l’identifiant de l’application utilisé lors de l’initialisation du SDK. L’initialisation conditionnelle par type d’appareil permet de confirmer que tous les jetons push envoyés à Braze sont associés à l’application concernée.

Important

Si l’application React Native initialise Braze avec le même identifiant d’application Braze pour tous les appareils, tous les utilisateurs React Native seront considérés comme des utilisateurs Android ou iOS dans Braze, et tous les jetons push seront associés à ce système d’exploitation.

Pour configurer Braze comme destination en mode appareil pour chaque source, choisissez Actions comme Destination framework, puis sélectionnez Save.

Intégration serveur à serveur

Également appelée mode cloud, cette intégration transmet les données de Segment aux REST API de Braze. Utilisez le framework Braze Cloud Mode (Actions) de Segment pour configurer une destination en mode cloud pour n’importe laquelle de vos sources.

Contrairement à l’intégration côte à côte, l’intégration serveur à serveur ne prend pas en charge les fonctionnalités de l’interface utilisateur de Braze, telles que les messages in-app, Content Cards ou l’enregistrement automatique des jetons push. Il existe également des données capturées automatiquement (telles que les utilisateurs anonymes et les champs au niveau de l’appareil) qui ne sont pas disponibles via le mode cloud.

Si vous souhaitez utiliser ces données et ces fonctionnalités, envisagez d’utiliser l’intégration SDK côte à côte (mode appareil).

Le code source de la destination Braze Cloud Mode (Actions) est maintenu par Segment.

Étape 3 : Paramètres

Définissez les paramètres de votre destination. Tous les paramètres ne s’appliqueront pas à tous les types de destinations.

• mobile device-mode
• web device-mode
• cloud-mode

Étape 4 : Mapper les méthodes

Braze prend en charge les méthodes Segment Page, Identify et Track. Les types d’identifiants utilisés dans ces méthodes varient selon que les données sont envoyées via une intégration serveur à serveur (mode cloud) ou côte à côte (mode appareil). Dans les destinations Braze Web Mode Actions et Cloud Mode Actions, vous pouvez également choisir de configurer un mappage pour un appel d’alias Segment.

Remarque

Bien que les alias d’utilisateur soient pris en charge en tant qu’identifiant dans la destination Braze Cloud Mode (Actions), il convient de noter que l’appel d’alias de Segment n’est pas directement lié aux alias d’utilisateur Braze.

La destination Cloud Mode (Actions) propose une action Créer un alias qui peut être utilisée pour créer un utilisateur uniquement avec un alias ou pour ajouter un alias à un profil external_id existant. L’action Identifier l’utilisateur peut être utilisée conjointement avec l’action Créer un alias pour fusionner un utilisateur uniquement avec un alias avec un external_id une fois que celui-ci est devenu disponible pour l’utilisateur.

Il est également possible de concevoir une solution de contournement et d’utiliser braze_id pour envoyer des données utilisateur anonymes en mode cloud. Cela nécessite d’inclure manuellement le braze_id de l’utilisateur dans tous vos appels d’API Segment. Pour en savoir plus sur la configuration de cette solution de contournement, consultez la documentation de Segment.

Les données de destination envoyées à Braze peuvent être regroupées par lots dans Cloud Mode Actions. La taille des lots est limitée à 75 événements, et ces lots s’accumuleront sur une période de 30 secondes avant d’être vidés. Le traitement par lots des requêtes est effectué par action. Par exemple, les appels Identify (attributs) seront regroupés dans une requête et les appels Track (événements personnalisés) seront regroupés dans une seconde requête. Braze recommande d’activer cette fonctionnalité car elle réduira le nombre de requêtes envoyées de Segment à Braze. Cela réduira à son tour le risque que la destination atteigne les limites de débit de Braze et retente les requêtes.

Vous pouvez activer le traitement par lots pour une action en accédant à votre destination Braze > Mappings. À partir de là, cliquez sur l’icône à 3 points à droite du mappage et sélectionnez Edit Mapping. Faites défiler vers le bas de la section Select mappings et assurez-vous que Batch Data to Braze est défini sur Yes.

• identify
• track
• page

Identify

L’appel Identify vous permet de lier un utilisateur à ses actions et d’enregistrer des attributs le concernant.

Certains traits spéciaux de Segment correspondent à des champs de profil d’attributs standard dans Braze :

Traits spéciaux Segment	Attributs standard Braze
userId	external_id
firstName	first_name
lastName	last_name
email	email
birthday	dob
address.country	country
address.city	home_city
gender	gender

D’autres champs de profil Braze réservés tels que email_subscribe et push_subscribe peuvent être envoyés en utilisant la convention de nommage Braze pour ces champs et en les transmettant en tant que traits dans un appel Identify.

Ajouter un utilisateur à un groupe d’abonnement

Vous pouvez également abonner ou désabonner un utilisateur d’un groupe d’abonnement donné à l’aide des champs suivants dans le paramètre traits.

Utilisez le champ de profil Braze réservé appelé braze_subscription_groups, qui peut être associé à un tableau d’objets. Chaque objet du tableau doit avoir deux clés réservées :

1. subscription_group_state : indique si l’utilisateur est "subscribed" ou "unsubscribed" d’un groupe d’abonnement spécifique.
2. subscription_group_id : représente l’ID unique du groupe d’abonnement. Vous pouvez trouver cet ID dans le tableau de bord de Braze sous Gestion des groupes d’abonnement.

• swift
• kotlin
• typescript

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
analytics.identify(
  userId: "{your-user}",
  traits: [
    "braze_subscription_groups": [
      [
        "subscription_group_id": "{your-group-id}",
        "subscription_group_state": "subscribed"
      ],
      [
        "subscription_group_id", "{your-group-id}",
        "subscription_group_state": "unsubscribed"
      ]
    ]
  ]
)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
analytics.identify(
  "{your-user}",
  buildJsonObject {
    put("braze_subscription_groups", buildJsonArray {
        add(
          buildJsonObject {
            put("subscription_group_id", "{your-group-id}")
            put("subscription_group_state", "subscribed")
          }
        )
        add(
          buildJsonObject {
            put("subscription_group_id", "{your-group-id}")
            put("subscription_group_state", "unsubscribed")
          }
        )
      }
    )
  }
)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
analytics.identify(
  "{your-user}",
  {
    braze_subscription_groups: [
      {
        subscription_group_id: "{your-group-id}",
        subscription_group_state: "subscribed"
      },
      {
        subscription_group_id: "{your-group-id}",
        subscription_group_state: "unsubscribed"
      }
    ]
  }
)

Attributs personnalisés

Tous les autres traits seront enregistrés en tant qu’attributs personnalisés.

Méthode Segment	Méthode Braze	Exemple
Identify avec un ID utilisateur	Définir un ID externe	Segment : analytics.identify("dawei"); Braze : Braze.changeUser("dawei")
Identify avec des traits réservés	Définir les attributs de l’utilisateur	Segment : analytics.identify({email: "[email protected]"}); Braze : Braze.getUser().setEmail("[email protected]");
Identify avec des traits personnalisés	Définir des attributs personnalisés	Segment : analytics.identify({fav_cartoon: "Naruto"}); Braze : Braze.getUser().setCustomAttribute("fav_cartoon": "Naruto");
Identify avec un ID utilisateur et des traits	Segment : définir un ID externe et un attribut	Combinez les méthodes précédentes.

Dans les destinations Web Mode Actions et Cloud Mode Actions, les mappages ci-dessus peuvent être définis à l’aide de l’action Update User Profile.

Important

Lorsque vous transmettez des données d’attributs utilisateur, vérifiez que vous ne transmettez que des valeurs pour les attributs qui ont changé depuis la dernière mise à jour. Vous éviterez ainsi d’enregistrer inutilement des points de données. Pour les sources côté client, utilisez l’outil Middleware open source de Segment pour optimiser votre intégration et limiter l’utilisation des points de données en supprimant les appels identify() dupliqués provenant de Segment.

Track

Lorsque vous suivez un événement, nous l’enregistrons en tant qu’événement personnalisé en utilisant le nom fourni.

Les métadonnées envoyées dans l’objet de propriétés de l’appel Track seront enregistrées dans Braze en tant que propriétés d’événement personnalisées pour l’événement associé. Tous les types de données de propriétés d’événements personnalisés sont pris en charge.

Dans les destinations Web Mode Actions et Cloud Mode Actions, les mappages ci-dessus peuvent être définis à l’aide de l’action Track Event.

Méthode Segment	Méthode Braze	Exemple
Track	Enregistré en tant qu’événement personnalisé.	Segment : analytics.track("played_game"); Braze : Braze.logCustomEvent("played_game");
Track avec propriétés	Enregistré en tant que propriété d’événement.	Segment : analytics.track("played_game", {name: "BotW", weapon: "boomerang"}); Braze : Braze.logCustomEvent("played_game", { "name": "BotW", "weapon": "boomerang"});
Track avec produit	Enregistré en tant qu’événement d’achat.	Segment : analytics.track("Order Completed", {products: [product_id: "ab12", price: 19]}); Braze : Braze.logPurchase("ab12", 19);

Commande terminée

Lorsque vous suivez un événement portant le nom Order Completed en utilisant le format décrit dans l’API eCommerce de Segment, nous enregistrons les produits que vous avez répertoriés en tant qu’achats.

Dans les destinations Web Mode Actions et Cloud Mode Actions, le mappage par défaut peut être personnalisé via l’action Track Purchase.

Page

L’appel Page vous permet d’enregistrer chaque fois qu’un utilisateur voit une page de votre site web, ainsi que toutes les propriétés facultatives relatives à cette page.

Ce type d’événement peut être utilisé comme déclencheur dans les destinations Web Mode Actions et Cloud Actions pour enregistrer un événement personnalisé dans Braze.

Étape 5 : Tester votre intégration

Lorsque vous utilisez l’intégration côte à côte (mode appareil), vos indicateurs d’aperçu (sessions à vie, MAU, DAU, adhérence, sessions quotidiennes et sessions quotidiennes par MAU) peuvent être utilisés pour vérifier que Braze reçoit des données de Segment.

Vous pouvez consulter vos données sur les pages des événements personnalisés ou du chiffre d’affaires, ou en créant un segment. La page Événements personnalisés du tableau de bord vous permet de consulter le nombre d’événements personnalisés au fil du temps. Notez que vous ne pourrez pas utiliser de formules incluant les statistiques MAU et DAU lors de l’utilisation d’une intégration serveur à serveur (mode cloud).

Si vous envoyez des données d’achat à Braze (voir la commande terminée dans l’onglet Track de l’étape 3), la page du chiffre d’affaires vous permet de consulter les données relatives aux revenus ou aux achats sur des périodes spécifiques ou le chiffre d’affaires total de votre application.

Créer un segment vous permet de filtrer vos utilisateurs en fonction des données d’événements personnalisés et d’attributs.

Important

Si vous utilisez une intégration serveur à serveur (mode cloud), les filtres liés aux données de session collectées automatiquement (tels que « première utilisation de l’application » et « dernière utilisation de l’application ») ne fonctionneront pas. Utilisez une intégration côte à côte (mode appareil) si vous souhaitez les utiliser dans votre intégration Segment et Braze.

Suppression et blocage d’utilisateurs

Si vous devez supprimer ou bloquer des utilisateurs, notez que la fonctionnalité de suppression d’utilisateurs de Segment est mappée à l’endpoint Braze /users/delete. Notez que la vérification de ces suppressions peut prendre jusqu’à 30 jours.

Vous devez vous assurer de sélectionner un identifiant utilisateur commun entre Braze et Segment (comme external_id). Une fois que vous avez lancé une requête de suppression avec Segment, vous pouvez consulter son état dans l’onglet des requêtes de suppression de votre tableau de bord Segment.

Rediffusions Segment

Segment fournit un service aux clients qui leur permet de « retransmettre » toutes les données historiques à un nouveau partenaire technologique. Les nouveaux clients de Braze qui souhaitent importer toutes les données historiques pertinentes peuvent le faire via Segment. Adressez-vous à votre représentant Segment si cela vous intéresse.

Segment se connectera à notre endpoint /users/track pour importer les données utilisateur dans Braze en votre nom.

Important

Tous les identifiants pris en charge dans la destination Cloud Mode Actions sont pris en charge dans le cadre des rediffusions Segment.

Bonnes pratiques

Nuances du mappage des données.

Scénarios dans lesquels les données ne sont pas transmises comme prévu :

1. Attributs personnalisés imbriqués
   • Bien que les attributs personnalisés imbriqués puissent techniquement être envoyés à Braze via Segment, le payload complet sera envoyé à chaque fois. Cela entraînera des points de données par clé transmise dans l’objet imbriqué chaque fois que le payload est envoyé.
     
     Pour ne dépenser qu’un sous-ensemble de points de données lors de l’envoi du payload, vous pouvez utiliser la fonctionnalité de fonctions de destination personnalisées appartenant à Segment. Cette fonctionnalité de la plateforme Segment vous permet de personnaliser la manière dont les données sont envoyées vers les destinations en aval.

Remarque

Les fonctions de destination personnalisées sont contrôlées dans Segment, et Braze a une visibilité limitée sur les fonctions configurées en externe.

2. Transmission de données anonymes de serveur à serveur.
   • Les clients peuvent utiliser les bibliothèques serveur à serveur de Segment pour transmettre des données anonymes vers d’autres systèmes. Consultez la section sur les méthodes de mappage pour en savoir plus sur l’envoi d’utilisateurs sans external_id vers Braze via une intégration serveur à serveur (mode cloud).