Tealium AudienceStream
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.
L’intégration entre Braze et Tealium s’appuie sur les profils de visiteurs d’AudienceStream. Les comportements partagés segmentent ces profils pour créer des ensembles de visiteurs présentant des traits communs, appelés audiences. Ces audiences peuvent contribuer à alimenter votre pile technologique marketing en temps réel via des connecteurs.
Tealium AudienceStreams et EventStreams offrent à la fois 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 de préoccupation 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.
Conditions préalables
| Nom | Description |
|---|---|
| Compte Tealium | Un compte Tealium avec accès côté serveur est requis. Nous vous recommandons également d’utiliser les intégrations côté client pour tirer parti de ce partenariat. |
| Clé API REST | Une clé API REST Braze avec les autorisations users.track, users.delete et subscription.status.set.Celle-ci peut être créée dans le tableau de bord de Braze > Console de développement > Clé API REST > Créer une nouvelle clé API |
| Endpoint REST Braze | L’URL de votre endpoint REST. Votre endpoint dépendra de l’URL de Braze pour votre instance. |
Intégration
Étape 1 : Configurer des attributs et des badges
Comprendre les attributs
La première étape pour utiliser AudienceStream consiste à créer des attributs. Les attributs vous permettent de définir les caractéristiques importantes qui représentent les habitudes, les préférences, les actions et l’engagement d’un visiteur envers votre marque.
Attributs de visite : les attributs de visite se rapportent à la visite (ou session) en cours de l’utilisateur. Les données stockées dans ces attributs persistent pendant toute la durée de la visite. Voici quelques exemples d’attributs de visite :
- Durée de la visite (nombre)
- Navigateur actuel (chaîne de caractères)
- Appareil actuel (chaîne de caractères)
- Nombre de pages vues (nombre)
Attributs de visiteur : les attributs de visiteur se rapportent à l’utilisateur actuel. Les données stockées dans ces attributs persistent pendant toute la durée de vie de l’utilisateur. Voici quelques exemples d’attributs de visiteur :
- Valeur vie des commandes (nombre)
- Prénom (chaîne de caractères)
- Date de naissance (date)
- Marques achetées (Tally)
Consultez Tealium pour une liste complète des types de données disponibles.
Enrichissement des attributs
Une fois que vous avez identifié les attributs souhaités, vous pouvez les configurer avec des enrichissements, c’est-à-dire des règles de gestion qui déterminent quand et comment mettre à jour les valeurs des attributs. Chaque type de données offre sa propre sélection d’enrichissements pour manipuler la valeur de l’attribut. Cela est associé au paramètre « WHEN ». Les options suivantes sont disponibles pour chaque attribut de visite et de visiteur :
- New Visitor : se produit la première fois qu’un visiteur arrive sur votre site.
- New Visit : se produit lors d’une nouvelle visite d’un visiteur.
- Any Event : se produit lors de tout événement.
- Visit Ended : se produit lorsqu’une visite se termine.
Vous pouvez également créer une condition personnalisée, appelée règle, qui déterminera le moment où l’enrichissement se produira.
Badges
Les badges sont des attributs spéciaux de visiteur qui représentent des modèles de comportement précieux. Les badges sont attribués ou retirés aux visiteurs en fonction de la logique de leurs enrichissements. Cette logique combine généralement plusieurs conditions pour capturer des segments de visiteurs ou définit un seuil lorsqu’une valeur particulière est atteinte.
Exemple d’attribut et de badge
Créez un attribut de visiteur « Lifetime Order Value » qui calcule le montant cumulé dépensé (order_total) par le client pour toutes les commandes terminées (événement d’achat). Pour configurer la valeur vie des commandes dans votre compte Tealium, suivez les instructions ci-dessous :
- Naviguez vers AudienceStream > Visitor/Visit Attributes et cliquez sur Add Attribute.
- Sélectionnez le périmètre Visitor et cliquez sur Continue.
- Sélectionnez le type de données Number et cliquez sur Continue.
- Saisissez le nom de l’attribut, « Lifetime Order Value ».
- Cliquez sur Add Enrichment et sélectionnez Increment or Decrement Number.
- Sélectionnez l’attribut contenant la valeur à incrémenter (
order_total). - Laissez le paramètre « WHEN » sur « Any Event », puis cliquez sur Create a New Rule.
- Créez une règle qui identifie le moment où un événement d’achat s’est produit.
- Cliquez sur Save, puis sur Finish.
Désormais, tous les clients auront un attribut de valeur vie des commandes qui leur est associé.
Vous pouvez créer des badges qui vous aident à classer et à cibler vos utilisateurs en fonction de certains attributs qu’ils partagent. Dans l’exemple suivant, nous créons un badge VIP pour les utilisateurs dont la « Lifetime Order Value » est supérieure à 500 $.
- Naviguez vers AudienceStream > Visitor/Visit Attributes et cliquez sur Add Attribute.
- Sélectionnez le périmètre Visitor et cliquez sur Continue.
- Sélectionnez le type de données Badge et cliquez sur Continue.
- Saisissez le nom du badge, « VIP ».
- Cliquez sur Add Enrichment et sélectionnez Assign Badge.
- Laissez le paramètre « WHEN » sur « Any Event ».
- Créez une règle pour l’attribution du badge en sélectionnant Create Rule. Attribuez un titre à cette règle et, à l’aide de l’attribut créé précédemment, définissez la règle comme suit : « …has attribute “Lifetime Order Value greater than 500” ».
- Cliquez sur Save, puis sur Finish.
Étape 2 : Créer une audience
Sur la page d’accueil de Tealium, sélectionnez Audiences sous AudienceStream dans la barre de navigation latérale. Ici, vous pouvez créer une audience d’utilisateurs ayant des attributs communs. L’entrée ou la sortie d’un utilisateur de cette audience sera le déclencheur de l’action de connecteur, configurée à l’étape suivante, qui transmettra ces informations au profil utilisateur dans Braze.
Commencez par nommer votre audience, puis réfléchissez aux attributs qui correspondraient au type d’audience que vous essayez de créer. Par exemple, pour créer une audience d’utilisateurs VIP, vous pourriez créer une audience de visiteurs possédant le badge VIP.
Veillez à enregistrer / publier votre audience lorsque vous avez terminé.
Étape 3 : Créer un connecteur d’événement
Un connecteur est une intégration entre Tealium et un autre fournisseur utilisée pour transmettre des données. Ces connecteurs contiennent des actions qui représentent les API prises en charge par leur partenaire.
- Dans la barre latérale de Tealium, sous Server-Side, naviguez vers AudienceStream > Audience 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 afficher 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 : la source, la configuration et l’action.
Source
Dans la boîte de dialogue Source qui s’affiche, sélectionnez l’audience que vous avez créée à l’étape précédente et un déclencheur qui vous semble adapté à votre situation. Vous pouvez également activer la limite de fréquence pour contrôler la fréquence de déclenchement de cette action.
Configuration
Une boîte de dialogue de configuration apparaît 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.
Après avoir créé ou sélectionné un connecteur pour relier cette audience, cliquez sur Done pour continuer.
Action
Ensuite, nommez votre action de connecteur et sélectionnez un type d’action qui enverra des données selon le mappage que vous avez configuré. Ici, vous mapperez les attributs Braze aux noms d’attributs Tealium. Selon le type d’action que vous choisissez, les champs requis par Tealium seront plus ou moins nombreux. Vous trouverez ci-dessous des exemples et des explications concernant ces champs.
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. Bien que l’action Track User soit la même pour AudienceStream et EventStream, Tealium recommande de définir les mappages d’attributs utilisateur avec les actions AudienceStream et les mappages d’événements et d’achats avec les actions EventStream.
| Paramètres | Description |
|---|---|
| User ID | Utilisez ce champ pour mapper le champ User ID 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 : External ID, Braze ID, Alias Name et Alias Label. - L’External ID et le Braze ID ne doivent pas être spécifiés si vous importez des jetons de notification push. - Si vous spécifiez un alias d’utilisateur, l’Alias Name et l’Alias Label 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 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 utilisateur. - 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 null 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 type tableau peuvent être modifiés en ajoutant ou en supprimant des valeurs des tableaux existants. |
| Événement | Un événement représente une occurrence unique d’un événement personnalisé par un utilisateur particulier à un horodatage donné. 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 payload. 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 des 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 |
|---|---|
| User ID | Utilisez ce champ pour mapper le champ User ID 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 : External ID, Braze ID, Alias Name et Alias Label. - Lors de la spécification d’un alias d’utilisateur, l’Alias Name et l’Alias Label doivent être définis tous les deux. Pour plus d’informations, consultez l’endpoint /users/delete de Braze. |
Cette action vous permet d’ajouter ou de supprimer des utilisateurs des groupes d’abonnement SMS ou e-mail de Braze.
| Paramètres | Description |
|---|---|
| Type de groupe | Utilisez ce champ pour indiquer s’il s’agit d’un groupe d’abonnement SMS ou e-mail. |
| Type de mise à jour | Mappez cette action à un événement de désabonnement ou d’abonnement. |
| Attributs | - Subscription Group ID (requis) : l’ID du groupe d’abonnement lié au type de groupe mappé dans le champ précédent. - External ID : l’ID externe de l’utilisateur. Spécifique au groupe e-mail : - Email : l’adresse e-mail de l’utilisateur. Si l’External ID n’est pas défini, l’e-mail sera requis. Spécifique au groupe SMS : - Phone : le numéro de téléphone au format E.164. Par exemple, +14155552671. Si l’External ID n’est pas défini, le numéro de téléphone sera requis. |
Sélectionnez Finish.
Résumé
Affichez le résumé du connecteur que vous avez créé. Si vous souhaitez modifier les options choisies, sélectionnez Back pour modifier ou Finish pour terminer.
Votre connecteur est maintenant affiché dans la liste des connecteurs sur votre page d’accueil Tealium.
Veillez à enregistrer ou à publier votre connecteur lorsque vous avez terminé. Les actions que vous avez configurées se déclencheront désormais lorsque les conditions de déclenchement seront remplies.
Étape 4 : Tester votre connecteur Tealium
Une fois votre connecteur opérationnel, vous devriez le tester pour vous assurer qu’il fonctionne correctement. La manière 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 lancer une nouvelle trace, sélectionnez Trace dans la barre latérale sous les options Server-Side. Cliquez sur Start et capturez l’ID de trace.
- Ouvrez l’extension de navigateur et saisissez l’ID de trace dans AudienceStream Trace.
- Examinez le journal en temps réel.
- Vérifiez l’action que vous souhaitez valider en cliquant sur l’entrée Actions Triggered pour la développer.
- Recherchez l’action que vous souhaitez 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ée
Il existe principalement trois façons de dépasser accidentellement les limites de données lors de l’intégration de Braze via Tealium :
Envoi de données en double — n’envoyez que les deltas Braze des attributs
Tealium n’envoie pas à Braze les deltas des attributs utilisateur. 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 ces trois attributs à Braze chaque fois que l’action sera 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 que vous ne pouvez pas savoir 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é.
Envoi de données non pertinentes ou écrasement inutile de données
Si vous avez plusieurs EventStreams qui 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 est déclenchée, ce qui pourrait également entraîner l’écrasement de données dans Braze.
Solution :
Configurez une spécification d’événement ou un flux distinct 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 de Tealium.
Initialisation de Braze trop tôt
Si vous intégrez Tealium en utilisant la balise du SDK Web Braze, vous pourriez constater une augmentation spectaculaire de vos 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 souhaiter ne suivre le comportement des utilisateurs que 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 des 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.