Skip to content

mParticle de Rokt

La plateforme de données client de mParticle vous permet d’en faire plus avec vos données. Les marketeurs avertis utilisent mParticle pour orchestrer les données dans leur suite d’outils de croissance, et ainsi être performants dans les moments clés du parcours client.

L’intégration de Braze et mParticle vous permet de contrôler de façon fluide le flux d’informations entre les deux systèmes :

Conditions préalables

Condition Description
Compte mParticle Un compte mParticle est nécessaire pour profiter de ce partenariat.
Instance de Braze Votre instance Braze se trouve sur la page d’aperçu de l’API (par exemple, US-01 ou US-02).
Clé d’identification de l’application Braze Votre clé d’identification de l’application.

Elle se trouve dans le tableau de bord de Braze sous Gérer les paramètres > Clé API.
Clé API REST de l’espace de travail (Serveur à serveur) Une clé API REST de Braze

Elle peut être créée dans le tableau de bord de Braze sous Console de développement > Paramètres API > Clé API.

Intégration

Audiences

Utilisez le partenariat entre Braze et mParticle pour configurer votre intégration et importer les audiences mParticle directement dans Braze pour le reciblage, créant ainsi une boucle complète de données d’un système à l’autre.

Toute intégration que vous configurez enregistrera des points de donnée. Si vous avez des questions sur les nuances des points de donnée Braze, votre gestionnaire de compte Braze peut y répondre.

Transfert des audiences

mParticle propose trois façons de définir les attributs d’appartenance à une cohorte, contrôlées par le paramètre de configuration « Envoyer les segments en tant que ». Consultez les sections suivantes pour le traitement de chaque option :

Attribut de chaîne unique

mParticle créera un attribut personnalisé unique appelé SegmentMembership. La valeur de cet attribut est une chaîne d’ID d’audiences mParticle séparés par des virgules qui correspondent à l’utilisateur. Ces ID d’audiences se trouvent dans le tableau de bord mParticle sous Audiences.

Par exemple, si une audience mParticle « Ibiza dreamers » a un ID d’audience de « 11036 », vous pouvez segmenter ces utilisateurs avec le filtre SegmentMembership — matches regex — 11036.

Bien qu’il s’agisse de l’option par défaut dans mParticle, la plupart des utilisateurs en entreprise optent pour les attributs de tableau unique pour l’expérience de filtrage lors de la création de segments dans Braze.

Appartenance au segment mParticle

Attribut de tableau unique

mParticle crée un attribut de tableau personnalisé unique dans Braze pour chaque utilisateur, appelé SegmentMembershipArray. La valeur de cet attribut est un tableau d’ID d’audiences mParticle qui correspondent à l’utilisateur.

Par exemple, si un utilisateur est membre de trois audiences mParticle avec les ID d’audience « 13053 », « 13052 » et « 13051 », vous pouvez segmenter les utilisateurs correspondant à l’une de ces audiences avec le filtre SegmentMembershipArray — includes value — 13051.

Un attribut par segment

mParticle créera un attribut personnalisé booléen pour chaque audience à laquelle un utilisateur appartient. Par exemple, si une audience mParticle s’appelle « Possible Parisians », vous pouvez segmenter ces utilisateurs avec le filtre In Possible Parisians - equals - true.

Attribut personnalisé mParticle

Attribut de tableau unique et attribut de chaîne unique

mParticle enverra les attributs tels que décrits à la fois pour l’attribut de tableau unique et l’attribut de chaîne unique.

Attribut de tableau unique et un attribut par segment

mParticle enverra les attributs tels que décrits à la fois pour l’attribut de tableau unique et un attribut par segment.

Attribut de chaîne unique et un attribut par segment

mParticle enverra les attributs tels que décrits à la fois pour l’attribut de chaîne unique et un attribut par segment.

Attribut de tableau unique, attribut de chaîne unique et un attribut par segment

mParticle enverra les attributs tels que décrits pour l’attribut de tableau unique, l’attribut de chaîne unique et un attribut par segment.

Étape 1 : Créer une audience dans mParticle

Pour créer une audience dans mParticle :

  1. Accédez à Audiences > Single Workspace > + New Audience.
  2. Pour connecter Braze en tant que sortie pour votre audience, vous devez fournir les champs suivants :
Nom du champ Description
Clé API Se trouve dans le tableau de bord de Braze sous Settings > API Keys.
Système d’exploitation de la clé API Sélectionnez le système d’exploitation auquel correspond votre clé API Braze. Cette sélection limitera les types de jetons de notification push transférés lors d’une mise à jour d’audience.
Envoyer les segments en tant que La méthode d’envoi des audiences à Braze. Consultez la section Transfert des audiences pour plus de détails.
Clé API REST de l’espace de travail Clé API REST de Braze avec toutes les autorisations. Elle peut être créée dans le tableau de bord de Braze sous Settings > API Keys.
Type d’identité externe Le type d’identité utilisateur mParticle à transférer en tant qu’ID externe vers Braze. Nous recommandons de laisser la valeur par défaut, Customer ID.
Type d’identité e-mail Le type d’identité utilisateur mParticle à transférer en tant qu’e-mail vers Braze.
Instance de Braze Spécifiez vers quel cluster vos données Braze seront transférées.
  1. Enfin, enregistrez votre audience.

Vous devriez commencer à voir les audiences se synchroniser avec Braze en quelques minutes. L’appartenance à une audience ne sera mise à jour que pour les utilisateurs disposant d’external_ids (c’est-à-dire pas les utilisateurs anonymes). Pour plus d’informations sur la création d’audiences mParticle pour Braze, consultez la documentation mParticle sur les paramètres de configuration.

Étape 2 : Segmenter les utilisateurs dans Braze

Dans Braze, pour créer un segment de ces utilisateurs, accédez à Segments sous Engagement et nommez votre segment. Voici deux exemples de segments selon l’option que vous avez sélectionnée pour Envoyer les segments en tant que. Pour plus de détails sur chaque option, consultez Transfert des audiences.

  • Attribut de tableau unique : Sélectionnez SegmentMembershipArray comme filtre. Ensuite, utilisez l’option « includes value » et saisissez l’ID d’audience souhaité. Filtre de segment mParticle « SegmentMembershipArray » défini sur « includes value » et ID d'audience.

  • Un attribut par segment : Sélectionnez votre attribut personnalisé comme filtre. Ensuite, utilisez l’option « equals » et choisissez la logique appropriée. Filtre de segment mParticle « in possible parisians » défini sur « equals » et « true ».

Une fois enregistré, vous pouvez référencer ce segment lors de la création d’un Canvas ou d’une Campaign à l’étape de ciblage des utilisateurs.

Désactivation et suppression des connexions

Étant donné que mParticle ne gère pas directement les segments dans Braze, il ne supprimera pas les segments lorsque la connexion d’audience mParticle correspondante est supprimée ou désactivée. Dans ce cas, mParticle ne mettra pas à jour les attributs utilisateur d’audience dans Braze pour retirer l’audience de chaque utilisateur.

Pour retirer l’audience d’un utilisateur Braze avant la suppression, ajustez les filtres d’audience pour forcer la taille de l’audience à 0 avant de supprimer une audience. Une fois le calcul de l’audience terminé et renvoyant 0 utilisateur, supprimez l’audience. L’appartenance à l’audience sera alors mise à jour dans Braze à false pour l’option d’attribut unique ou l’ID d’audience sera retiré du format de tableau.

Mappage des données

Les données peuvent être mappées vers Braze à l’aide de l’intégration du kit intégré si vous souhaitez connecter vos applications mobiles et web à Braze via mParticle. Vous pouvez également utiliser l’intégration API serveur à serveur pour transférer les données côté serveur vers Braze.

Quelle que soit l’approche choisie, vous devez configurer Braze en tant que sortie :

Configurer vos paramètres de sortie Braze

Dans mParticle, accédez à Setup > Outputs > Add Outputs et sélectionnez Braze pour ouvrir la configuration du kit Braze. Enregistrez une fois terminé.

Nom du paramètre Description
Clé d’identification de l’application Braze Votre clé d’identification de l’application Braze se trouve dans le tableau de bord de Braze sous Settings > API Keys. Notez que les clés API diffèrent pour chaque plateforme (iOS, Android et Web).
Type d’identité externe Le type d’identité utilisateur mParticle à transférer en tant qu’ID externe vers Braze. Nous recommandons de laisser la valeur par défaut, Customer ID.
Type d’identité e-mail Le type d’identité utilisateur mParticle à transférer en tant qu’e-mail vers Braze. Nous recommandons de laisser la valeur par défaut, Email.
Instance de Braze Le cluster vers lequel vos données Braze seront transférées ; il doit être le même que celui de votre tableau de bord.
Activer le transfert du flux d’événements (Serveur à serveur) Lorsque cette option est activée, tous les événements seront transférés en temps réel. Sinon, tous les événements seront transférés en masse. Lorsque vous choisissez d’activer le transfert du flux d’événements, assurez-vous que les données que vous transmettez à Braze respectent les limites de débit.

Intégration du kit intégré

Les SDK mParticle et Braze seront présents dans votre application grâce à l’intégration du kit intégré. Cependant, contrairement à une intégration directe de Braze, mParticle se charge d’appeler la majorité des méthodes du SDK Braze pour vous. Les méthodes mParticle que vous utilisez pour suivre les données utilisateur seront automatiquement mappées aux méthodes du SDK Braze.

Ces mappages du SDK mParticle pour Android, iOS et Web sont open source et disponibles sur la page GitHub de mParticle.

L’intégration du SDK via le kit intégré vous permet de profiter de notre suite complète de fonctionnalités (notifications push, messages in-app et tout le suivi analytique des messages pertinent).

Étape 1 : Intégrer les SDK mParticle

Intégrez les SDK mParticle appropriés dans votre application en fonction des besoins de votre plateforme :

Étape 2 : Compléter l’intégration du kit d’événements Braze de mParticle

Bien que le SDK Braze n’ait pas besoin d’être directement inclus dans votre site web ou votre application pour cette intégration mParticle, le kit Appboy mParticle suivant doit être installé pour transférer les données de votre application vers Braze.

Le guide d’intégration du kit d’événements Braze de mParticle vous guidera à travers les instructions d’alignement personnalisé entre mParticle et Braze en fonction de vos besoins de messagerie (notifications push, suivi de localisation, etc.).

Étape 3 : Paramètres de connexion pour votre sortie Braze

Dans mParticle, accédez à Connections > Connect > [Votre plateforme souhaitée] > Connect Output pour ajouter Braze en tant que sortie. Ensuite, sélectionnez Save.

Tous les paramètres de connexion ne s’appliquent pas à toutes les plateformes et types d’intégration. Pour un détail des paramètres de connexion et des plateformes auxquelles ils s’appliquent, consultez la documentation de mParticle.

Intégration API serveur à serveur

Il s’agit d’un module complémentaire pour acheminer vos données backend vers Braze si vous utilisez les SDK côté serveur de mParticle (par exemple, Ruby, Python, etc.). Pour configurer cette intégration serveur à serveur avec Braze, suivez la documentation de mParticle.

Paramètres de connexion pour votre sortie Braze

Dans mParticle, accédez à Connections > Connect > [Votre plateforme souhaitée] > Connect Output pour ajouter Braze en tant que sortie. Enregistrez une fois terminé.

Tous les paramètres de connexion ne s’appliquent pas à toutes les plateformes et types d’intégration. Pour un détail des paramètres de connexion et des plateformes auxquelles ils s’appliquent, consultez la documentation de mParticle.

Avant d’activer « Enriched User Attributes » ou « Enriched User Identities », nous vous recommandons de consulter la section Dépassements potentiels de points de donnée pour vous assurer que vous êtes conscient de l’impact de ces paramètres sur l’utilisation des points de donnée.

Détails du mappage des données

Types de données

Tous les types de données ne sont pas pris en charge entre les deux plateformes.

  • Les propriétés d’événement personnalisé prennent en charge les objets de type chaîne, numérique, booléen ou date. Elles ne prennent pas en charge les tableaux ni les objets imbriqués.
  • Les attributs personnalisés prennent en charge les objets de type chaîne, numérique, booléen, date et les tableaux, mais ne prennent pas en charge les objets ni les objets imbriqués.

Mappage des données

Type de données mParticle Type de données Braze Description
Attributs utilisateur (réservés) Attribut standard Par exemple, la clé d’attribut utilisateur réservée $FirstName de mParticle est mappée au champ d’attribut standard first_name de Braze.
Attributs utilisateur (autres) Attribut personnalisé Tout attribut utilisateur transmis à mParticle qui ne fait pas partie de ses clés d’attribut utilisateur réservées est enregistré dans Braze en tant qu’attribut personnalisé.

Les attributs utilisateur prennent en charge les types chaîne, numérique, booléen, date et tableau, mais ne prennent pas en charge les objets ni les objets imbriqués.
Événement personnalisé Événement personnalisé Les événements personnalisés mParticle sont reconnus par Braze en tant qu’événement personnalisé. Les attributs d’événement sont transférés en tant que propriétés d’événement personnalisé.

Les attributs d’événement transmis à Braze en tant que propriétés d’événement prennent en charge les objets de type chaîne, numérique, booléen ou date, mais ne prennent pas en charge les tableaux ni les objets imbriqués.
Événement commercial d’achat Événement d’achat Les événements commerciaux d’achat seront mappés aux événements d’achat Braze.

Activez ou désactivez le paramètre de regroupement des données d’événements commerciaux pour enregistrer les achats au niveau de la commande ou du produit. Par exemple, si false, un seul événement entrant avec deux produits, promotions ou impressions uniques générera au moins deux événements Braze sortants. Si défini sur true, cela générera un seul événement sortant avec un tableau imbriqué de produits, promotions ou impressions, respectivement.

Pour plus d’informations sur les champs commerciaux supplémentaires qui seront enregistrés, consultez la documentation de mParticle.

Lorsque le paramètre « bundle commerce event data » est défini sur false, les attributs de produit transmis à Braze en tant que propriétés d’événement d’achat prennent en charge les objets de type chaîne, numérique, booléen ou date, mais ne prennent pas en charge les tableaux ni les objets imbriqués.
Tous les autres événements commerciaux Événement personnalisé Tous les autres événements commerciaux seront mappés à des événements personnalisés.

Activez ou désactivez le paramètre de regroupement des données d’événements commerciaux pour enregistrer les achats au niveau de la commande ou du produit. Par exemple, si false, un seul événement entrant avec deux produits, promotions ou impressions uniques générera au moins deux événements Braze sortants. Si défini sur true, cela générera un seul événement sortant avec un tableau imbriqué de produits, promotions ou impressions, respectivement.

En plus de certaines valeurs commerciales par défaut, les attributs de produit seront enregistrés en tant que propriétés d’événement Braze. Pour plus d’informations sur les champs commerciaux supplémentaires qui seront enregistrés, consultez la documentation de mParticle

Lorsque le paramètre « bundle commerce event data » est défini sur false, les attributs de produit transmis à Braze en tant que propriétés d’événement prennent en charge les objets de type chaîne, numérique, booléen ou date, mais ne prennent pas en charge les tableaux ni les objets imbriqués.

Mappage de l’identité utilisateur

Pour chaque sortie mParticle, vous pouvez sélectionner le type d’identité externe à envoyer à Braze en tant qu’external_id. Bien que la valeur par défaut soit Customer ID, vous pouvez choisir de mapper un autre ID, tel que MPID, à envoyer à Braze en tant qu’external_id. Sachez que le choix d’un identifiant autre que Customer ID peut influencer la façon dont les données sont envoyées dans Braze.

Par exemple, le mappage de MPID vers votre external_id Braze aura les effets suivants :

  • En raison de la nature de l’attribution du MPID, tous les utilisateurs se verront attribuer un external_id au démarrage de la session.
  • La configuration de Currents peut nécessiter un mappage supplémentaire en raison des différences de types de données entre MPID et external_id.

Transfert des demandes d’effacement (demandes des personnes concernées)

Transférez les demandes d’effacement vers Braze en configurant une sortie de demande de personne concernée vers Braze. Pour transférer les demandes d’effacement vers Braze, suivez la documentation de mParticle.

Dépassements potentiels de points de donnée

Attributs utilisateur enrichis

Activation des attributs/identités utilisateur enrichis (serveur à serveur uniquement)

Dans les paramètres de connexion mParticle, Braze recommande de désactiver Include Enriched User Attributes. Si cette option est activée, mParticle transférera tous les attributs utilisateur disponibles (tels que les attributs standard, les attributs personnalisés et les attributs calculés) du profil existant vers Braze pour chaque événement enregistré. Cela entraîne une consommation élevée de points de donnée, car mParticle envoie à Braze les mêmes attributs inchangés à chaque appel.

Par exemple, si un utilisateur ajoute son prénom, son nom et son numéro de téléphone lors de sa première session, puis s’inscrit ultérieurement à une newsletter en ajoutant les mêmes informations et un e-mail, déclenchant un événement d’inscription à la newsletter :

  • Si activé (par défaut), cinq points de donnée seront consommés. (événement d’inscription, adresse e-mail, prénom, nom et numéro de téléphone)
  • Si désactivé, deux points de donnée seront consommés (événement d’inscription et adresse e-mail)

Considérations lors de la désactivation des attributs utilisateur enrichis

Il y a quelques considérations à prendre en compte lors de la désactivation de Include Enriched User Attributes :

  1. L’intégration serveur à serveur utilise l’API d’événements mParticle pour envoyer des événements à Braze. Chaque requête est déclenchée par un événement. Lorsqu’un attribut utilisateur est modifié, comme la mise à jour d’une adresse e-mail, mais n’est pas associé à un événement spécifique (par exemple, un événement personnalisé de mise à jour de profil), la nouvelle valeur n’est transmise à une sortie comme Braze qu’en tant qu’« attribut enrichi » dans le payload du prochain événement déclenché par l’utilisateur. Lorsque Include Enriched User Attributes est désactivé, cette nouvelle valeur d’attribut non associée à un événement spécifique ne sera pas transmise à Braze.
    • Pour résoudre ce problème, nous recommandons de créer un événement séparé « user attribute updated » qui n’envoie que le ou les attributs utilisateur spécifiques qui ont été mis à jour vers Braze. Notez qu’avec cette approche, vous enregistrez toujours un point de donnée supplémentaire pour l’événement « user attribute updated », mais l’utilisation des points de donnée sera bien inférieure à l’envoi de tous les attributs utilisateur à chaque appel avec la fonctionnalité activée.
  2. Les attributs calculés sont transmis à Braze en tant qu’attribut utilisateur enrichi, donc lorsque « Enriched User Attributes » est désactivé, ceux-ci ne seront plus transmis à Braze. Pour transférer les attributs calculés vers Braze lorsque « Enriched User Attributes » est désactivé, un flux d’attributs calculés pourrait aider sans pousser tous les attributs. Le flux déclenchera une mise à jour en aval vers Braze lorsqu’un attribut calculé change.

Résolution des problèmes

Résolution des problèmes de notifications push iOS avec le kit d’événements Braze

Si les notifications push ne fonctionnent pas lors de l’utilisation du kit d’événements Braze (intégration du kit intégré) sur iOS, vérifiez les points suivants :

  1. Transfert des jetons de notification push : Confirmez que mParticle transfère les jetons de notification push vers Braze. Dans votre tableau de bord mParticle, vérifiez que la connexion du kit Braze a les notifications push activées et que le bon certificat push Apple est configuré dans le tableau de bord de Braze.
  2. Ordre d’initialisation du kit : Le kit Braze doit être initialisé avant que votre application ne demande les autorisations de notification push. Si les autorisations de notification push sont demandées avant que le kit ne soit actif, le jeton de notification push peut ne pas être transféré vers Braze. Vérifiez que le SDK mParticle est démarré tôt dans le cycle de vie de votre application.
  3. Method swizzling : Le kit Apple de mParticle utilise le method swizzling pour transférer automatiquement les jetons de notification push et gérer les événements de notification push. Si vous avez désactivé le swizzling ou si un autre SDK interfère, les jetons de notification push peuvent ne pas atteindre Braze. Vérifiez que le swizzling est activé dans votre configuration mParticle.
  4. Gestion manuelle des jetons : Si vous gérez les jetons de notification push manuellement (par exemple, en implémentant application:didRegisterForRemoteNotificationsWithDeviceToken:), assurez-vous de transmettre le jeton à mParticle en l’assignant à la propriété du jeton de notification push, par exemple : MParticle.sharedInstance().pushNotificationToken = deviceToken. Le kit le transférera ensuite à Braze.
  5. Incompatibilité d’environnement : Confirmez que l’environnement du certificat APNs (développement vs. production) correspond à la build de votre application. Pour plus de détails, consultez la résolution des problèmes de notifications push iOS.

Envoi de données inutiles ou en double vers Braze

Braze comptabilise un point de donnée chaque fois qu’un attribut est transmis à Braze, même si la valeur est inchangée. Pour cette raison, Braze recommande de ne transférer que les données nécessaires pour agir dans Braze et de s’assurer que seuls les deltas d’attributs sont transmis.
New Stuff!