Tealium
Tealium est un centre de données universel et une plateforme de données client composée d’EventStream, AudienceStream et iQ Tag Management qui vous permet de connecter des données mobiles, web et alternatives provenant de sources tierces. La connexion de Tealium à Braze permet un flux de données d’événements personnalisés, d’attributs utilisateur et d’achats qui vous permet d’agir sur vos données en temps réel.
L’intégration de Braze et Tealium vous permet de suivre vos utilisateurs et de diriger les données vers divers fournisseurs d’analyse utilisateur. Tealium vous permet de :
- Synchroniser les audiences de Tealium avec AudienceStream vers Braze pour les utiliser dans la personnalisation des Campaigns et des Canvas Braze ou la création de segments.
- Importer des données entre les plateformes. Braze propose à la fois une intégration SDK côte à côte pour vos applications Android, iOS et web et une intégration serveur-à-serveur qui peut être utilisée sur toute plateforme capable de rapporter des données d’événements.
Tealium EventStream est un centre de collecte de données et d’API qui se trouve au cœur de vos données. EventStream gère l’ensemble de la chaîne d’approvisionnement en données, de la configuration et de l’installation à l’identification, la validation et l’enrichissement des données utilisateur entrantes. EventStream agit en temps réel grâce aux flux d’événements et aux connecteurs. Voici les fonctionnalités qui composent EventStream.
- Sources de données (installation et collecte de données)
- Événements en direct (inspection des données en temps réel)
- Spécifications et attributs d’événement (exigences et validation de la couche de données)
- Flux d’événements (types d’événements filtrés)
- Connecteurs d’événements (actions du hub API)
Tealium AudienceStream est un moteur omnicanal de segmentation client et d’action en temps réel. AudienceStream exploite les données qui affluent dans EventStream et crée des profils de visiteurs représentant les attributs les plus importants de l’engagement de vos clients avec votre marque. Consultez notre article AudienceStream pour les étapes de configuration.
Tealium iQ vous permet de déclencher du code dans vos applications en utilisant une balise dans l’interface de gestion des balises Tealium iQ. Cette balise collectera, contrôlera et livrera les données d’événements des plateformes mobiles et web, vous permettant de configurer une implémentation native de Braze sans ajouter de code spécifique à Braze dans vos applications. Les utilisateurs peuvent choisir d’intégrer des commandes à distance mobiles via la gestion des balises iQ ou des fichiers de configuration JSON (approche recommandée par Tealium). Les utilisateurs qui utilisent le SDK Web Braze doivent s’intégrer via la balise web iQ.
Pour en savoir plus sur les avantages et les inconvénients de chaque méthode, reportez-vous à la section suivante Gestionnaire des balises Tealium iQ.
Tealium propose des actions de connecteur par lots et non par lots. Le connecteur non par lots doit être utilisé lorsque les requêtes en temps réel sont importantes pour le cas d’utilisation et qu’il n’y a pas d’inquiétude quant au respect des spécifications de limite de débit de l’API Braze. Contactez le service d’assistance de Braze ou votre gestionnaire de la satisfaction client si vous avez des questions.
Pour les connecteurs par lots, les requêtes sont mises en file d’attente jusqu’à ce que l’un des seuils suivants soit atteint :
- Nombre maximum de requêtes : 75
- Temps maximum depuis la requête la plus ancienne : 10 minutes
- Taille maximale des requêtes : 1 Mo
Tealium ne regroupe pas par défaut les événements de consentement (préférences d’abonnement) ou les événements de suppression d’utilisateur.
Conditions préalables
| Condition | Description |
|---|---|
| Compte Tealium | Un compte Tealium avec un accès serveur et/ou côté client est requis pour profiter de ce partenariat. |
| Bibliothèques des sources installées et sources Tealium | L’origine de toute donnée envoyée dans Tealium, telle que des applications mobiles, des sites web ou des serveurs backend. Vous devez installer les bibliothèques dans votre application, site ou serveur avant de pouvoir configurer un connecteur Tealium avec succès. |
| Endpoint REST et SDK de Braze | Votre URL d’endpoint REST ou SDK. Votre endpoint dépendra de l’URL de Braze pour votre instance. |
| Clé d’identification de l’application Braze (côte à côte uniquement) | Votre clé d’identifiant d’application. Elle se trouve sous Tableau de bord de Braze > Gérer les paramètres > Clé API. |
| Version du code (côte à côte uniquement) | Correspond à la version du SDK et doit être au format major.minor (par exemple, 3.2 et non 3.0.1). La version du code doit être 3.0 ou supérieure. |
| Clé API REST (serveur-à-serveur uniquement) | Une clé API REST Braze avec les autorisations users.track et users.delete. Elle peut être créée sous Tableau de bord de Braze > Console de développement > Clé API REST > Créer une nouvelle clé API. |
Choisissez votre type d’intégration
| Intégration | Détails |
|---|---|
| Côte à côte | Utilise le SDK de Tealium pour traduire les événements en appels natifs de Braze, ce qui permet d’accéder à des fonctionnalités plus avancées et à une utilisation plus complète de Braze que l’intégration serveur-à-serveur. Si vous prévoyez d’utiliser les commandes à distance Braze, notez que Tealium ne prend pas en charge toutes les méthodes Braze (par exemple, Content Cards). Pour utiliser une méthode Braze qui n’est pas mappée via une commande à distance correspondante, vous devrez invoquer la méthode en ajoutant du code Braze natif à votre base de code. |
| Serveur-à-serveur | Transmet les données de Tealium aux endpoints de la REST API Braze. Ne prend pas en charge les fonctionnalités de l’interface utilisateur de Braze telles que les messages in-app, Content Cards ou les notifications push. Il existe également des données capturées automatiquement, telles que des champs au niveau de l’appareil, qui ne sont pas disponibles par cette méthode. Envisagez une intégration côte à côte si vous souhaitez utiliser ces fonctionnalités. |
Intégration SDK côte à côte
Commandes à distance
Les commandes à distance sont une fonctionnalité des bibliothèques iOS et Android de Tealium qui vous permettent de passer des appels depuis le SDK Tealium — via les serveurs Braze — vers Braze. Le module de commande à distance Braze installera automatiquement et créera les bibliothèques Braze nécessaires et gérera tout le rendu des messages et le suivi analytique. Pour utiliser la commande à distance mobile Braze, vous aurez besoin des bibliothèques Tealium installées dans vos applications.
Tealium propose deux façons d’intégrer les commandes à distance mobiles ; il n’y a aucune perte de fonctionnalité entre les types d’intégration et le code natif sous-jacent est identique.
| Méthode de commande à distance mobile | Avantages | Inconvénients |
|---|---|---|
| Balise de commande à distance | Modifiez facilement les mappages et les données envoyées à la commande à distance en utilisant l’interface utilisateur de Tealium iQ. Cela permet d’envoyer des données ou des événements supplémentaires à un SDK tiers après que l’application soit déjà dans l’App Store, sans que le client ait à mettre à jour l’application. |
Le module de gestion des balises dans l’application repose sur une webview cachée pour traiter JavaScript. |
| Fichier de configuration JSON (Recommandé) |
L’utilisation de la méthode JSON élimine le besoin d’avoir une webview cachée dans l’application et réduit considérablement la consommation de mémoire. Le fichier JSON peut être hébergé à distance ou localement dans l’application du client. |
Pour le moment, il n’y a pas d’interface utilisateur pour gérer cela, donc cela nécessite un peu d’effort supplémentaire. Remarque : Tealium travaille sur l’ajout d’une interface de gestion qui résoudra ce problème et apportera le même niveau de flexibilité aux commandes à distance JSON qu’avec la version de gestion des balises iQ. |
Utilisez les mappages de données de commande à distance mobile Braze pour définir des attributs utilisateur par défaut et des attributs personnalisés, et suivre les achats et les événements personnalisés. Reportez-vous au tableau suivant pour les méthodes Braze correspondantes.
| Commande à distance | Méthode Braze |
|---|---|
| appendcustomarrayattribute | addToCustomAttributeArrayWithKey() |
| emailnotification | setEmailNotificationSubscriptionType() |
| incrementcustomattribute | incrementCustomAttribute() |
| initialize | startWithApiKey() |
| logcustomevent | logCustomEvent() |
| logpurchase | logPurchase() |
| pushnotification | setPushNotificationSubscriptionType() |
| removecustomattribute | setCustomAttributeWithKey() |
| setcustomattribute | setCustomAttributeArrayWithKey() |
| setcustomarrayattribute | setCustomAttributeArrayWithKey() |
| setlastknownlocation | setLastKnownLocationWithLatitude() |
| unsetcustomattribute | unsetCustomAttributeWithKey() |
| useralias | addAlias() |
| userattribute | ABKUser() |
| useridentifier | changeUser() |
Vous pouvez trouver plus de détails sur la configuration de la commande à distance mobile Braze et un aperçu des méthodes prises en charge dans la documentation développeur de Tealium :
Les commandes à distance mobiles de Braze ne prennent pas en charge toutes les méthodes et tous les canaux de communication de Braze (par exemple, Content Cards). Pour utiliser une méthode Braze qui n’est pas mappée via une commande à distance correspondante, vous devrez invoquer la méthode directement en ajoutant du code Braze natif à votre base de code.
Balise du SDK Web Braze
Utilisez la balise du SDK Web Braze pour déployer le SDK Web Braze sur votre site web. Tealium iQ Tag Management permet aux clients d’ajouter Braze comme balise dans le tableau de bord Tealium pour suivre l’activité des visiteurs. Les balises sont généralement utilisées par les marketeurs pour comprendre l’efficacité de la publicité en ligne, du marketing par e-mail et de la personnalisation du site.
- Dans Tealium, accédez à iQ > Tags > + Add Tag > Braze Web SDK.
- Dans la boîte de dialogue de configuration des balises, entrez la clé API (votre clé d’identification d’application Braze), l’URL de base (endpoint SDK Braze) et la version du code SDK Web Braze. Vous pouvez également activer la journalisation pour enregistrer des informations dans la console web à des fins de débogage.
- Dans la boîte de dialogue Load Rules, choisissez « Charger sur toutes les pages » ou sélectionnez Create Rule pour déterminer quand et où charger une instance de cette balise sur votre site.
- Dans la boîte de dialogue Data Mappings, sélectionnez Create Mappings pour mapper les données Tealium à Braze. Les variables de destination de la balise SDK Web Braze sont intégrées dans l’onglet Data Mapping de la balise. Les tableaux suivants répertorient les catégories de destination disponibles et décrivent chaque nom de destination.
- Sélectionnez Finish.
Ressources d’intégration côte à côte
- Commande à distance iOS : Documentation Tealium, Dépôt GitHub Tealium
- Commande à distance Android : Documentation Tealium, Dépôt GitHub Tealium
- Balise SDK Web : Documentation Tealium
Intégration serveur-à-serveur
Cette intégration transfère les données de Tealium vers la REST API Braze.
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 les notifications push. Il existe également des données capturées automatiquement (telles que des champs au niveau de l’appareil) qui ne sont pas disponibles par cette méthode.
Si vous souhaitez utiliser ces données et ces fonctionnalités, envisagez notre intégration SDK côte à côte.
Étape 1 : Configurer une source
Tealium exige que vous configuriez d’abord une source de données valide pour que votre connecteur puisse s’en servir.
- Depuis la barre latérale dans Tealium sous Server-Side, accédez à Sources > Data Sources > + Add Data Source.
- Recherchez la plateforme souhaitée dans les catégories disponibles et nommez votre source ; il s’agit d’un champ obligatoire.
- À partir des options Event Specifications, choisissez les spécifications d’événement que vous souhaitez inclure. Les spécifications d’événement vous aident à identifier les noms d’événements et les attributs requis à suivre dans votre installation. Ces spécifications seront appliquées aux événements entrants.
Prenez le temps de réfléchir aux données qui vous sont les plus utiles et aux spécifications qui semblent les plus appropriées pour votre cas d’utilisation. Des spécifications d’événements personnalisés sont également disponibles. - La boîte de dialogue suivante passe à l’étape Get Code. Le code de base et le code de suivi des événements fournis ici servent de guide d’installation. Téléchargez le PDF fourni si vous souhaitez partager ces instructions avec votre équipe. Sélectionnez Save & Continue lorsque vous avez terminé.
- Vous pourrez désormais voir votre source enregistrée ainsi qu’ajouter ou supprimer des spécifications d’événement.
À partir de la vue détaillée de la source de données, vous pouvez effectuer les actions suivantes :- Afficher et copier la clé de source de données
- Voir les instructions d’installation
- Retourner à la page Get Code
- Ajouter ou supprimer des spécifications d’événement
- Accéder à la vue des événements en direct liés à une spécification d’événement
- Et plus encore…
- Enfin, sélectionnez Save / Publish en haut de la page. Si vous ne publiez pas votre source, vous ne pourrez pas la trouver lors de la configuration de votre connecteur Braze.
Reportez-vous à Data Sources pour plus d’instructions sur la configuration et la modification de votre source de données.
Étape 2 : Créer un connecteur d’événement
Un connecteur est une intégration entre Tealium et un autre fournisseur utilisé pour transmettre des données. Ces connecteurs contiennent des actions qui représentent les API prises en charge par leur partenaire.
- Depuis la barre latérale dans Tealium sous Server-Side, accédez à EventStream > Event Connectors.
- Sélectionnez le bouton bleu + Add Connector pour parcourir la place de marché des connecteurs. Dans la nouvelle boîte de dialogue qui apparaît, utilisez la recherche pour trouver le connecteur Braze.
- Pour ajouter ce connecteur, cliquez sur la tuile du connecteur Braze. Lorsque vous cliquez dessus, vous pouvez voir le résumé de la connexion et une liste des informations requises, des actions prises en charge et des instructions de configuration. La configuration comprend trois étapes : source, configuration et action.
Source
Une fois la source configurée, retournez à la page du connecteur Braze sous EventStream > Event Connectors > + Add Connector > Braze.
Ensuite, sélectionnez la source de données que vous venez de créer et, sous Event Feed, sélectionnez All Events ou une spécification d’événement spécifique, le chemin recommandé pour envoyer uniquement les valeurs modifiées dans Braze. Sélectionnez Continue.
Configuration
Ensuite, sélectionnez Add Connector en bas de la page. Nommez votre connecteur et fournissez votre endpoint API Braze et votre clé API REST Braze ici.
Si vous avez déjà créé un connecteur, vous pouvez éventuellement utiliser un connecteur existant de la liste des connecteurs disponibles et le modifier pour répondre à vos besoins avec l’icône de crayon ou le supprimer avec l’icône de corbeille.
Action
Ensuite, nommez votre action de connecteur et sélectionnez un type d’action qui enverra les données selon le mappage que vous configurez. Ici, vous allez mapper les attributs, événements et achats de Braze aux noms d’attribut, d’événement et d’achat de Tealium.
Tous les champs proposés ne sont pas obligatoires.
Cette action vous permet de suivre les attributs des utilisateurs, des événements et des achats en une seule action.
| Paramètres | Description |
|---|---|
| ID utilisateur | Utilisez ce champ pour mapper le champ ID utilisateur de Tealium à son équivalent Braze. Mappez un ou plusieurs attributs d’ID utilisateur. Lorsque plusieurs identifiants sont spécifiés, la première valeur non vide est choisie en fonction de l’ordre de priorité suivant : ID externe, ID Braze, nom d’alias et libellé d’alias. - L’ID externe et l’ID Braze ne doivent pas être spécifiés si vous importez des jetons de notification push. - Si vous spécifiez un alias d’utilisateur, le nom d’alias et le libellé d’alias doivent être définis. Pour plus d’informations, consultez l’endpoint /users/track de Braze. |
| Attributs utilisateur | Utilisez les noms de champs existants du profil utilisateur de Braze pour mettre à jour les valeurs du profil utilisateur dans le tableau de bord de Braze ou ajoutez vos propres données d’attributs utilisateur personnalisés aux profils utilisateurs. - Par défaut, de nouveaux utilisateurs seront créés s’il n’en existe aucun. - En définissant Update Existing Only sur true, seuls les utilisateurs existants seront mis à jour et aucun nouvel utilisateur ne sera créé.- Si un attribut Tealium est vide, il sera converti en null et supprimé du profil utilisateur Braze. Les enrichissements doivent être utilisés si des valeurs nulles ne doivent pas être envoyées à Braze pour supprimer un attribut utilisateur. |
| Modifier les attributs utilisateur | Utilisez ce champ pour incrémenter ou décrémenter certains attributs utilisateur. - Les attributs entiers peuvent être incrémentés par des entiers positifs ou négatifs. - Les attributs de tableau peuvent être modifiés en ajoutant ou en supprimant des valeurs provenant des tableaux existants. |
| Événement | Un événement représente une seule occurrence d’un événement personnalisé par un utilisateur particulier à un horodatage. Utilisez ce champ pour suivre et mapper les attributs d’événement comme ceux de l’objet événement Braze. - L’attribut d’événement Name est requis pour chaque événement mappé.- L’attribut d’événement Time est automatiquement défini sur l’heure actuelle à moins qu’il ne soit explicitement mappé. - Par défaut, de nouveaux événements seront créés s’il n’en existe pas. En définissant Update Existing Only sur true, seuls les événements existants seront mis à jour et aucun nouvel événement ne sera créé.- Mappez les attributs de type tableau pour ajouter plusieurs événements. Les attributs de type tableau doivent être de longueur égale. - Des attributs à valeur unique peuvent être utilisés et appliqués à chaque événement. |
| Modèle d’événement | Fournissez des modèles d’événement à référencer dans les données du corps. Les modèles peuvent être utilisés pour transformer des données avant de les envoyer à Braze. Reportez-vous au guide des modèles de Tealium pour en savoir plus. |
| Variable de modèle d’événement | Fournissez des variables de modèle d’événement comme entrée de données. Reportez-vous au guide des variables de modèle de Tealium pour en savoir plus. |
| Achat | Utilisez ce champ pour suivre et mapper les attributs d’achat des utilisateurs comme ceux de l’objet achat Braze. - Les attributs d’achat Product ID, Currency et Price sont requis pour chaque achat mappé.- L’attribut d’achat Time est automatiquement défini sur l’heure actuelle à moins qu’il ne soit explicitement mappé.- Par défaut, de nouveaux achats seront créés s’il n’en existe pas. En définissant Update Existing Only sur true, seuls les achats existants seront mis à jour et aucun nouvel achat ne sera créé.- Mappez les attributs de type tableau pour ajouter plusieurs articles d’achat. Les attributs de type tableau doivent être de longueur égale. - Les attributs à valeur unique peuvent être utilisés et s’appliqueront à chaque élément. |
| Modèle d’achat | Les modèles peuvent être utilisés pour transformer les données avant qu’elles ne soient envoyées à Braze. - Définissez un modèle d’achat si vous avez besoin de prendre en charge des objets imbriqués. - Lorsqu’un modèle d’achat est défini, la configuration définie dans la section des achats de votre action sera ignorée. - Reportez-vous au guide des modèles de Tealium pour en savoir plus. |
| Variable de modèle d’achat | Fournissez les variables de modèle de produit comme entrée de données. Reportez-vous au guide des variables de modèle de Tealium pour en savoir plus. |
Cette action vous permet de supprimer des utilisateurs du tableau de bord de Braze.
| Paramètres | Description |
|---|---|
| ID utilisateur | Utilisez ce champ pour mapper le champ ID utilisateur de Tealium à son équivalent Braze. - Mappez un ou plusieurs attributs d’ID utilisateur. Lorsque plusieurs identifiants sont spécifiés, la première valeur non vide est choisie en fonction de l’ordre de priorité suivant : ID externe, ID Braze, nom d’alias et libellé d’alias. - Lors de la spécification d’un alias d’utilisateur, le nom d’alias et le libellé d’alias doivent être définis tous les deux. Pour plus d’informations, consultez l’endpoint /users/delete de Braze. |
Si vous souhaitez modifier vos options choisies, sélectionnez Back pour modifier ou Finish pour terminer.
Sélectionnez Continue.
Votre connecteur s’affiche désormais dans la liste des connecteurs sur votre page d’accueil Tealium. 
Veillez à sélectionner Save / Publish pour votre connecteur lorsque vous avez terminé. Les actions que vous avez configurées se déclencheront désormais lorsque les connexions de déclenchement seront remplies.
Étape 3 : Tester votre connecteur Tealium
Une fois votre connecteur opérationnel, vous devriez le tester pour vous assurer qu’il fonctionne correctement. La façon la plus simple de le tester est d’utiliser l’outil Trace de Tealium. Pour commencer à utiliser Trace, assurez-vous d’avoir ajouté l’extension de navigateur Tealium Tools.
- Pour démarrer un nouveau traçage, sélectionnez Trace dans la barre latérale sous les options Server-Side. Sélectionnez Start et capturez l’ID de traçage.
- Ouvrez l’extension du navigateur et entrez l’ID de traçage dans AudienceStream Trace.
- Examinez le journal en temps réel.
- Recherchez l’action que vous souhaitez valider en sélectionnant l’entrée Actions Triggered pour la développer.
- Recherchez l’action que vous voulez valider et consultez l’état du journal.
Reportez-vous à la documentation Trace de Tealium pour obtenir des instructions plus détaillées sur la mise en œuvre de l’outil Trace de Tealium.
Démonstration d’intégration
Dépassements potentiels de points de données
Il existe trois principales façons d’enregistrer accidentellement des points de données inutiles lors de l’intégration de Braze via Tealium :
Envoi de données en double — n’envoyez que les deltas d’attributs Braze
Tealium ne transmet pas les deltas d’attributs utilisateur à Braze. Par exemple, si vous avez une action EventStream qui suit le prénom, l’e-mail et le numéro de téléphone portable d’un utilisateur, Tealium enverra les trois attributs à Braze chaque fois que l’action est déclenchée. Tealium ne cherchera pas ce qui a changé ou a été mis à jour pour n’envoyer que ces informations.
Solution :
Vous pouvez vérifier votre backend pour évaluer si un attribut a changé ou non, et si c’est le cas, appeler les méthodes pertinentes de Tealium pour mettre à jour le profil utilisateur. C’est ce que font généralement les utilisateurs qui intègrent Braze directement.
OU
Si vous ne stockez pas votre propre version d’un profil utilisateur dans votre backend et ne pouvez pas déterminer si les attributs changent ou non, vous pouvez utiliser AudienceStream et
créer des enrichissements pour n’envoyer les attributs utilisateur que lorsque les valeurs ont changé. Consultez la documentation de Tealium sur les règles d’enrichissement.
Envoi de données non pertinentes ou réécriture inutile de données
Si plusieurs EventStreams ciblent le même flux d’événements, toutes les actions activées pour ce connecteur se déclencheront automatiquement à chaque fois qu’une action unique sera déclenchée. Cela pourrait également entraîner l’écrasement de données dans Braze et l’enregistrement de points de données inutiles.
Solution :
Configurez une spécification d’événement distincte ou un flux pour suivre chaque action.
OU
Désactivez les actions (ou connecteurs) que vous ne souhaitez pas déclencher en utilisant les bascules dans le tableau de bord Tealium.
Initialisation de Braze trop tôt
Les utilisateurs intégrant Tealium en utilisant la balise du SDK Web Braze peuvent voir une augmentation spectaculaire de leur MAU. Si Braze est initialisé au chargement de la page, Braze créera un profil anonyme chaque fois qu’un utilisateur web navigue sur le site pour la première fois. Cela inclut le trafic de bots, ce qui peut gonfler votre nombre d’utilisateurs actifs. Certains peuvent vouloir suivre le comportement des utilisateurs uniquement lorsque ceux-ci ont effectué une action, telle que « Connecté » ou « Regardé une vidéo », afin de réduire leur nombre de MAU.
Solution :
Configurez les règles de chargement pour déterminer exactement quand et où une balise se charge sur votre site. Pour des conseils plus complets sur le filtrage du trafic de bots et l’initialisation conditionnelle du SDK, consultez Filtrage du trafic de bots.