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 configurer Braze comme destination conformément au type d’intégration choisi (mode de connexion). Si vous êtes un nouveau client Braze, vous pouvez transmettre des données historiques à Braze en utilisant les replays Segment. Ensuite, vous devez configurer les 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, naviguez vers Destinations > Braze > Configure Braze > Select your Source > Setup.

Vous pouvez intégrer la source web de Segment (Analytics.js) et les bibliothèques clientes natives avec Braze en utilisant soit une intégration côte à côte (device-mode), soit une intégration serveur à serveur (cloud-mode).

Votre choix de mode de connexion sera déterminé par le type de source pour laquelle 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 device-mode, cette intégration mappe le SDK et les méthodes de Segment au SDK de Braze, permettant l’accès à 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 device-mode de Segment, laissez Segment initialiser Braze. N’initialisez pas également le SDK Braze dans votre application. Le plugin de destination configure Braze et ouvre des sessions ; une seconde initialisation native peut enregistrer des sessions en double. Utilisez identify de Segment pour définir l’ID utilisateur. Le plugin mappe cet appel vers changeUser().

Important

Pour les intégrations en device-mode 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 de Segment n’inclut pas le plugin Braze par défaut — sans celui-ci, le SDK de Segment ne peut pas transmettre les données ou les appels de méthodes mappés à Braze, et les fonctionnalités telles que le push, les messages in-app et les Content Cards ne fonctionneront pas. Consultez les onglets spécifiques à chaque plateforme dans cette section pour les instructions d’installation.

Lors de l’utilisation d’une connexion en device-mode, de manière similaire à l’intégration native du SDK Braze, le SDK Braze attribuera un device_id et un identifiant backend, braze_id, à chaque utilisateur. Cela permet à Braze de capturer l’activité anonyme depuis l’appareil en faisant correspondre ces identifiants au lieu du userId.

Remarque

Si vous utilisez des filtres de destination avec des destinations en device-mode (Kotlin ou Swift), vous devez configurer le plugin de destination avec le support des filtres activé. 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 Android en device-mode est maintenu par Braze et est régulièrement mis à jour pour refléter les nouvelles versions du SDK Braze.

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

	SDK Segment	SDK Braze
Recommandé	Analytics-Kotlin	Braze Segment Kotlin
Ancien	Analytics-Android	Braze Segment Android

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

Pour compléter 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 device-mode 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’analytique Segment.

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

Important

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

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

	SDK Segment	SDK Braze
Recommandé	Analytics-Swift	Braze Segment Swift
Ancien	Analytics-iOS	Braze Segment iOS

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

Pour compléter 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 device-mode de circuler vers Braze. Suivez les instructions d’installation de Segment pour ajouter la dépendance du plugin (via le gestionnaire de paquets Swift ou CocoaPods) et l’initialiser avec votre instance d’analytique Segment.

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

Le framework Web Mode (Actions) de Braze de Segment est recommandé pour configurer Braze comme destination en device-mode 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 régulièrement mis à jour pour refléter les nouvelles versions du SDK Braze.

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

Dans votre base de code d’application, initialisez conditionnellement le SDK Segment par type d’appareil, en utilisant la clé d’écriture source respective associée à chaque application.

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

Important

Si l’application React Native initialise Braze avec le même identifiant d’application Braze pour tous les appareils, alors 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 device-mode pour chaque source, choisissez Actions comme Destination framework, puis sélectionnez Save.

Intégration serveur à serveur

Également appelée cloud-mode, cette intégration transfère les données de Segment vers les REST API de Braze. Utilisez le framework Braze Cloud Mode (Actions) de Segment pour configurer une destination en cloud-mode 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 Braze, telles que les messages in-app, les Content Cards ou l’enregistrement automatique des jetons push. Il existe également des données capturées automatiquement (comme les utilisateurs anonymes et les champs au niveau de l’appareil) qui ne sont pas disponibles via le cloud-mode.

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

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’appliquent pas à tous les types de destination.

• device-mode mobile
• device-mode web
• 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 dépendront de la transmission des données via une intégration serveur à serveur (cloud-mode) ou côte à côte (device-mode). Dans les destinations Braze Web Mode Actions et Cloud Mode Actions, vous pouvez également choisir de configurer un mappage pour un appel alias Segment.

Remarque

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

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

Il est également possible d’élaborer une solution de contournement et d’utiliser braze_id pour envoyer des données d’utilisateurs anonymes en cloud-mode. Cela nécessite d’inclure manuellement le braze_id de l’utilisateur dans tous vos appels API Segment. Vous pouvez en apprendre davantage sur la configuration de cette solution de contournement dans la documentation de Segment.

Les données de destination envoyées à Braze peuvent être regroupées en lots dans Cloud Mode Actions. La taille des lots est plafonnée à 75 événements, et ces lots s’accumulent sur une période de 30 secondes avant d’être envoyés. Le regroupement 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. En retour, cela réduira le risque que la destination atteigne les limites de débit de Braze et doive retenter les requêtes.

Vous pouvez activer le regroupement pour une action en naviguant vers votre destination Braze > Mappings. De là, cliquez sur l’icône à 3 points à côté du mappage et sélectionnez Edit Mapping. Faites défiler jusqu’au 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 d’associer un utilisateur à ses actions et d’enregistrer des attributs le concernant.

Certains traits spéciaux de Segment sont mappés vers 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 réservés de Braze 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 comme 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é en utilisant les champs suivants dans le paramètre traits.

Utilisez le champ de profil réservé de Braze appelé braze_subscription_groups, qui peut être associé à un tableau d’objets. Chaque objet du tableau doit contenir 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 Subscription Group Management.

• 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 comme attributs personnalisés.

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

Dans les destinations Web Mode Actions et Cloud Mode Actions, ces mappages peuvent être configurés à l’aide de l’action Update User Profile.

Important

Lors de la transmission de données d’attributs utilisateur, vérifiez que vous ne transmettez que les valeurs des attributs qui ont changé depuis la dernière mise à jour. Cela garantira que vous n’enregistrez pas inutilement des points de données. Pour les sources côté client, utilisez l’outil open source Middleware de Segment pour optimiser votre intégration et limiter l’utilisation des points de données en dédupliquant les appels identify() identiques provenant de Segment.

Track

Lorsque vous suivez un événement, nous enregistrerons cet événement comme un événement personnalisé en utilisant le nom fourni.

Les métadonnées envoyées dans l’objet properties de l’appel Track seront enregistrées dans Braze comme propriétés de l’événement personnalisé 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, ces mappages peuvent être configurés à l’aide de l’action Track Event.

Méthode Segment	Méthode Braze	Exemple
Track	Enregistré comme événement personnalisé.	Segment : analytics.track("played_game"); Braze : Braze.logCustomEvent("played_game");
Track avec propriétés	Enregistré comme 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é comme é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 avec le nom Order Completed en utilisant le format décrit dans l’API eCommerce de Segment, nous enregistrerons les produits que vous avez listés comme des 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 des propriétés optionnelles concernant la 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

Lors de l’utilisation de l’intégration côte à côte (device-mode), 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 les données de Segment.

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

Si vous envoyez des données d’achat à Braze (voir la commande terminée dans l’onglet Track de l’étape 3), la page des revenus vous permet de visualiser les données sur les revenus ou les 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 (cloud-mode), les filtres liés aux données de session capturé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 (device-mode) si vous souhaitez les utiliser dans votre intégration Segment et Braze.

Suppression et blocage des utilisateurs

Si vous devez supprimer ou bloquer des utilisateurs, notez que la fonctionnalité de suppression d’utilisateurs de Segment est mappée sur l’endpoint /users/delete de Braze. 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). Après avoir initié une demande de suppression avec Segment, vous pouvez consulter le statut dans l’onglet des demandes de suppression de votre tableau de bord Segment.

Relecture de Segment

Segment propose à ses clients un service de « relecture » de l’ensemble des données historiques vers un nouveau partenaire technologique. Les nouveaux clients Braze qui souhaitent importer toutes les données historiques pertinentes peuvent le faire via Segment. Contactez votre représentant Segment si cette fonctionnalité 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 relectures Segment.

Bonnes pratiques

Nuances de mappage des données.

Scénarios dans lesquels les données ne seront 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, l’intégralité du payload sera envoyée à chaque fois. Cela engendrera des points de donnée par clé transmise dans l’objet imbriqué à chaque envoi du payload.
     
     Pour ne consommer qu’un sous-ensemble de points de donnée lors de l’envoi du payload, vous pouvez utiliser la fonctionnalité personnalisée de fonctions de destination proposée par Segment. Cette fonctionnalité de la plateforme Segment vous permet de personnaliser la manière dont les données sont envoyées aux destinations en aval.

Remarque

Les fonctions de destination personnalisées sont gérées au sein de Segment, et Braze dispose d’une visibilité limitée sur les fonctions qui ont été configurées de manière externe.

2. Transmission de données anonymes de serveur à serveur.
   • Les clients peuvent utiliser les bibliothèques serveur à serveur de Segment pour acheminer les 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 à Braze via une intégration serveur à serveur (mode cloud).