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. Le segment vous permet de :

• Synchronisez Segment Engage avec Braze pour une utilisation dans la campagne Braze et la segmentation de Canvas.
• Importez des données entre les deux plateformes. Nous proposons une intégration côte à côte SDK pour vos applications Android, iOS et web, ainsi qu’une intégration serveur à serveur pour la synchronisation de vos données avec les API REST de Braze
• Connectez les données à Segment par le biais de Currents.

Prérequis

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 de rediffusions segmentées. 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éez 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 : Choisissez le framework de destination et le type de connexion

Dans Segmentation, naviguez vers Destinations > Braze > Configurer Braze > Sélectionnez votre source > Configuration.

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.

Intégration du 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, l’envoi de messages intégrés à l’application et d’autres méthodes natives de Braze.

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 identifiant device_id et un identifiant de 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.

• android
• ios
• web or javascript
• react native

Intégration serveur-à-serveur

Également appelée mode cloud, cette intégration transmet les données de Segment aux API REST de Braze. Utilisez le cadre 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 Braze UI, telles que les messages in-app, les cartes de contenu ou l’enregistrement automatique des jetons push. Il existe également des données capturées automatiquement (telles que des utilisateurs anonymes et des 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, pensez à utiliser le SDK d’intégration côte à côte (mode appareil).

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

Étape 3 : Paramètres

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

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

Étape 4 : Méthodes de mappage

Braze prend en charge les méthodes Page, Identify et Track Segment. Les types d’identificateurs utilisés dans le cadre de ces méthodes varient selon que les données sont envoyées via une intégration de 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 de segment.

La destination du mode cloud (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 existantexternal_id. L’action Identifier l’utilisateur peut être utilisée conjointement à l’action Créer un alias pour fusionner un utilisateur uniquement avec un alias une external_id 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 nom de l’utilisateur braze_id 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, Identifier les appels (attributs) sera groupé dans une requête et Suivre les appels (événements personnalisés) sera groupé dans une deuxième 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 tente à nouveau les requêtes.

Vous pouvez activer le traitement par lots pour une action en accédant à Braze Destination > Mappages. À partir de là, cliquez sur l’icône à 3 points à droite du mappage et sélectionnez Modifier le mappage. Faites défiler la section Select mappings vers le bas et assurez-vous que l’option Envoyer les données à Braze par lots est définir sur Oui.

• identify
• track
• page

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"
      }
    ]
  }
)

Étape 5 : Testez votre intégration

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

Vous pouvez consulter vos données sur les pages des événements personnalisés ou sur les pages de 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 utilisateur actif quotidien lors de l’utilisation d’une intégration de serveur à serveur (mode cloud).

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

La création d’un segment vous permet de filtrer vos utilisateurs en fonction de l’événement personnalisé et des données d’attribut.

Suppression et suppression d’utilisateurs

Si vous devez supprimer des utilisateurs, notez que la fonctionnalité de suppression d’utilisateurs de Segment est mappée à l’endpoint /users/deleteBraze. 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 dansexternal_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.

Rediffusion de segments

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 /users/trackendpoint pour importer les données utilisateur dans Braze en votre nom.

Bonnes pratiques