Profils utilisateur
Les profils utilisateur sont un excellent moyen de trouver des informations sur des utilisateurs spécifiques. Toutes les données persistantes associées à un utilisateur sont stockées dans son profil utilisateur.
Accéder aux profils
Pour accéder au profil d’un utilisateur, rendez-vous sur la page Search Users et recherchez un utilisateur à l’aide de l’un des critères suivants :
- ID utilisateur externe
- ID Braze
- Numéro de téléphone
- Jeton push
- Alias d’utilisateur au format « [user_alias]:[alias_name] », par exemple « amplitude_id:user_123 »
Si une correspondance est trouvée, vous pouvez consulter les informations que vous avez enregistrées pour cet utilisateur avec le SDK Braze. Dans le cas contraire, si votre recherche renvoie plusieurs profils utilisateurs, vous pouvez fusionner chaque profil individuellement ou effectuer une fusion en masse. Pour une présentation complète, consultez Fusionner les utilisateurs en double.
Search Users n’est pas la même chose que User Lookup dans le compositeur de Segment ou de Campaign. User Lookup vérifie si un utilisateur spécifique correspond à votre audience et n’accepte que external_id ou braze_id. Search Users sur cette page prend en charge l’e-mail, le téléphone, le jeton push et l’alias d’utilisateur. Pour plus d’informations, consultez Tester les segments.
Lorsqu’un numéro de téléphone est utilisé dans la recherche, il est converti au format E.164. Les utilisateurs dont les numéros de téléphone ne peuvent pas être convertis au format E.164 (par exemple, parce que le numéro de téléphone comporte un code pays ou un indicatif régional invalide) ne peuvent pas être recherchés par numéro de téléphone.
Cas d’usage
Les profils utilisateurs constituent une ressource précieuse pour la résolution des problèmes et les tests, car vous pouvez facilement accéder aux informations relatives à l’historique d’engagement d’un utilisateur, à son appartenance à un Segment, à son appareil et à son système d’exploitation.
Par exemple, si un utilisateur signale un problème et que vous ne savez pas quel appareil ni quel système d’exploitation il utilise, vous pouvez consulter l’onglet Aperçu pour trouver ces informations (à condition de disposer de son e-mail ou de son ID utilisateur). Vous pouvez également consulter la langue d’un utilisateur, ce qui peut s’avérer utile si vous résolvez un problème lié à une campagne multilingue qui ne s’est pas comportée comme prévu.
Vous pouvez utiliser l’onglet Engagement pour vérifier si un utilisateur donné a bien reçu une Campaign. De plus, si cet utilisateur a effectivement reçu la Campaign, vous pouvez voir quand il l’a reçue. Vous pouvez également vérifier si un utilisateur fait partie d’un certain Segment et s’il est abonné aux notifications push, aux e-mails, ou aux deux. Ces informations sont utiles à des fins de résolution des problèmes. Par exemple, vous devriez vérifier ces informations si un utilisateur ne reçoit pas une Campaign que vous vous attendiez à ce qu’il reçoive, ou s’il reçoit une Campaign que vous ne vous attendiez pas à ce qu’il reçoive.
Éléments du profil utilisateur
Le profil d’un utilisateur comporte cinq sections principales.
- Aperçu : informations de base sur l’utilisateur, données de session, attributs personnalisés, événements personnalisés, achats et dernier appareil sur lequel l’utilisateur s’est connecté.
- Engagement : informations sur les paramètres de contact de l’utilisateur, les Campaigns reçues, les Segments, les statistiques de communication, l’attribution d’installation et le numéro de compartiment aléatoire.
- Historique des événements : événements personnalisés et achats des 30 derniers jours, avec les propriétés d’événement complètes affichées au format JSON.
- Historique des messages : événements récents liés à la communication pour cet utilisateur au cours des 30 derniers jours.
- Éligibilité aux Feature Flags : vérifiez à quels feature flags un utilisateur est actuellement éligible dans le cadre des déploiements, des étapes Canvas et des expériences.
Onglet Aperçu
L’onglet Aperçu contient les informations de base sur un utilisateur et ses interactions avec votre application ou votre site web.
| Catégorie Aperçu | Contenu |
|---|---|
| Profil | Genre, tranche d’âge, emplacement, langue, locale, fuseau horaire et date de naissance. |
| Aperçu des sessions | Nombre de sessions, dates de la première et de la dernière session, et sur quelles applications. |
| Attributs personnalisés | Les attributs personnalisés attribués à cet utilisateur et leur valeur associée, y compris les attributs personnalisés imbriqués. |
| Appareils récents | Nombre d’appareils sur lesquels l’utilisateur s’est connecté, détails de chaque appareil et identifiants publicitaires associés (le cas échéant). |
| Événements personnalisés | Les événements personnalisés effectués par cet utilisateur, combien de fois et quand il les a effectués pour la dernière fois. |
| Achats | Chiffre d’affaires total attribué à cet utilisateur, son dernier achat, le nombre total d’achats et une liste de chaque achat. |
Pour en savoir plus sur ces données, consultez la section Collecte de données du SDK.
Onglet Engagement
L’onglet Engagement contient des informations sur les interactions d’un utilisateur avec les messages que vous lui avez envoyés via Braze.
| Catégorie Engagement | Contenu |
|---|---|
| Paramètres de contact | Statut d’abonnement pour l’e-mail, le SMS et les notifications push, ainsi que les groupes d’abonnement auxquels cet utilisateur est associé pour ces trois canaux. Cette section comprend également les informations du journal des modifications pour les jetons push. Consultez les sections e-mail, SMS et push pour en savoir plus sur la configuration des abonnements et des opt-ins. |
| Campaigns reçues | Campaigns reçues reflète les moments d’envoi et de consultation spécifiques à chaque canal. La plupart des canaux enregistrent un envoi lorsque Braze transmet le message au fournisseur de distribution, même si le message n’est finalement pas distribué. Les Content Cards fonctionnent différemment : les Campaigns n’apparaissent ici qu’après que l’utilisateur a consulté la carte dans l’application. Pour un détail par canal, consultez la section Quand les Campaigns apparaissent dans Campaigns reçues. Lorsqu’un message est reçu, ouvert ou cliqué, Braze met à jour les données de tous les profils partageant le même identifiant de canal que le profil ayant enregistré l’interaction (par exemple, la même adresse e-mail pour l’e-mail, ou le même numéro de téléphone pour le SMS ou WhatsApp). Les utilisateurs partageant un identifiant avec quelqu’un ayant reçu, ouvert ou cliqué le message peuvent correspondre à ce filtre même s’ils ne faisaient pas partie de la Campaign à l’origine ou n’ont pas reçu directement le message. Ces listes utilisent les données d’interaction avec les messages (y compris les règles d’expiration) pour déterminer ce qui apparaît pour le reciblage et l’historique. Sélectionnez une Campaign dans la liste pour la consulter. |
| Segments | Les Segments auxquels cet utilisateur appartient. Sélectionnez un Segment dans la liste pour le consulter. |
| Statistiques de communication | Date à laquelle cet utilisateur a reçu des messages de votre part pour la dernière fois via chaque canal. |
| Attribution d’installation | Informations sur la manière et le moment où un utilisateur a installé votre application. En savoir plus sur la compréhension des installations des utilisateurs. |
| Divers | Le numéro de compartiment aléatoire de l’utilisateur. |
| Messages Canvas reçus | Les messages Canvas que cet utilisateur a reçus et quand. Cette section affiche l’historique des interactions avec les messages (comme les envois et ouvertures d’e-mails), pas l’historique des entrées dans le Canvas. Un utilisateur peut apparaître ici même s’il n’est jamais entré dans le Canvas (par exemple, lorsqu’un autre profil partageant la même adresse e-mail a reçu ou ouvert le message). Une ouverture peut également créer une nouvelle entrée pour un profil e-mail partagé à qui le message n’avait pas été initialement envoyé. Les moments d’envoi, les identifiants de canal partagés et l’expiration des données d’interaction avec les messages suivent les mêmes règles que Campaigns reçues. Consultez la section Quand les Campaigns apparaissent dans Campaigns reçues. Sélectionnez un message dans la liste pour le consulter. |
| Prédictions | Les scores de prédiction d’attrition et de prédiction d’événements pour cet utilisateur. |
Onglet Historique des événements
Pour consulter l’onglet Historique des événements, vous devez disposer des permissions Search Users, View User Event Properties et View PII, car les propriétés d’événement peuvent contenir des données personnelles.
L’onglet Historique des événements affiche les événements personnalisés et les achats enregistrés par un utilisateur. Utilisez-le pour vérifier que les données d’événement arrivent correctement et pour résoudre les problèmes au niveau de l’utilisateur directement dans le tableau de bord, sans avoir besoin d’exports de données ou d’outils externes.
| Catégorie Historique des événements | Contenu |
|---|---|
| Liste des événements | Événements personnalisés et achats des 30 derniers jours (jusqu’aux 100 plus récents), classés du plus récent au plus ancien. |
| Type d’événement | Indique si la ligne est un événement personnalisé ou un achat. |
| Horodatage | Date et heure d’enregistrement de l’événement. |
| Nom de l’événement | Le nom de l’événement personnalisé ou de l’achat. |
| Propriétés d’événement | Les propriétés d’événement complètes, affichées au format JSON. |
Quand les Campaigns apparaissent dans Campaigns reçues
En règle générale, Braze affiche une Campaign sous Campaigns reçues après avoir tenté d’envoyer le message. La distribution au dispositif ou à la boîte de réception de l’utilisateur n’est pas requise pour qu’un envoi soit enregistré. Messages Canvas reçus suit les mêmes règles spécifiques à chaque canal pour chaque type de message Canvas.
Lorsque les horodatages sont affichés au format relatif (par exemple « il y a 6 jours »), survolez-les pour voir la date et l’heure exactes.
- E-mail : Braze enregistre un envoi lorsque le message est transmis à votre fournisseur de services d’e-mailing (ESP). Après cette transmission, le message n’est pas interrompu en raison de la logique Liquid, de la limitation du débit ou du marquage de l’utilisateur comme inaccessible. Les événements suivants sont généralement une distribution ou un rebond.
- Push : Braze enregistre un envoi lorsque le message est transmis au fournisseur de notifications push (par exemple, Apple Push Notification service (APNs) ou Firebase Cloud Messaging (FCM)). Le fournisseur tente généralement de distribuer immédiatement ; si l’appareil est indisponible (par exemple, hors ligne), le fournisseur peut réessayer jusqu’à l’expiration du message.
- Messages in-app : Braze enregistre un envoi lorsque la Campaign est lancée.
- Content Cards : Le moment où Braze enregistre un événement Envoyé dépend du type de distribution et de votre paramètre Création de carte. Une Campaign de Content Cards apparaît sous Campaigns reçues dans le profil utilisateur uniquement après que l’utilisateur a consulté la carte dans l’application. Pour le détail complet, consultez les sections Quand les envois sont enregistrés et Filtres Campaigns reçues et reciblage dans l’article sur les rapports Content Cards.
- SMS, WhatsApp et webhooks : Braze enregistre un envoi lorsque le message entre dans le circuit de distribution de ce canal (par exemple, le fournisseur SMS ou WhatsApp, ou votre endpoint webhook).
Ces descriptions couvrent le moment où un envoi est enregistré pour Campaigns reçues. Elles sont distinctes des interruptions de messages qui peuvent arrêter un message avant qu’il n’atteigne un fournisseur.
Onglet Historique des messages
L’onglet Historique des messages du profil utilisateur affiche les événements récents liés à la communication (environ 40) pour un utilisateur individuel au cours des 30 derniers jours. Ces événements comprennent les messages envoyés à l’utilisateur, reçus, avec lesquels il a interagi, et plus encore.
Les données de cet onglet ne sont pas mises à jour après la fusion d’un utilisateur. De plus, les événements associés aux messages envoyés via l’API (par exemple, l’endpoint /messages/send) n’apparaissent pas dans cet onglet si aucun identifiant de Campaign n’est spécifié dans ces envois.
Les événements RCS ne sont actuellement pas pris en charge dans l’onglet Historique des messages.
Consulter et comprendre les événements
Pour chaque événement dans le tableau Historique des messages, vous pouvez voir le canal de communication, le type d’événement, l’horodatage de l’événement, la Campaign ou le message Canvas associé, ainsi que les données de l’appareil de l’utilisateur. Pour filtrer des événements spécifiques, cliquez sur Filtres et sélectionnez les événements dans la liste.
Événements d’engagement lié aux messages
Les événements d’engagement suivants sont disponibles pour l’e-mail, le SMS, les notifications push, les messages in-app, les Content Cards et les webhooks. Pour en savoir plus sur la façon dont des événements spécifiques sont suivis, consultez le Glossaire des événements d’engagement lié aux messages.
| Canal | Événements d’engagement disponibles |
|---|---|
| Rebond Clic Événements de report Distribution Marqué comme spam Ouverture (voir la note sur l’événement d’ouverture d’e-mail) Envoi Échec provisoire d’envoi Désabonnement |
|
| SMS | Envoi par l’opérateur Distribution Échec de distribution Réception entrante Rejet Envoi |
| Push | Rebond Ouverture influencée iOS au premier plan Ouverture Envoi |
| Message in-app | Clic Impression |
| Content Cards | Clic Rejet Impression Envoi |
| Webhooks | Envoi |
| Interruption Distribution Échec Limite de fréquence Réception entrante Lecture Envoi |
Événements d’interruption de messages
Les événements d’interruption de messages se produisent lorsqu’un message envoyé à un utilisateur a été interrompu en raison d’une logique conditionnelle dans Liquid ou le contenu connecté, ou en raison de délais d’expiration du rendu Liquid.
Les événements d’interruption sont disponibles pour les canaux suivants :
- SMS
- Push
- Webhooks
Les événements d’interruption ne sont actuellement pas disponibles pour les messages in-app et les Content Cards.
Événements de limite de fréquence
Un événement de limite de fréquence se produit lorsqu’un utilisateur est éligible pour recevoir un message, mais ne le reçoit pas en raison des paramètres de limite de fréquence. Vous pouvez personnaliser les paramètres de limite de fréquence depuis Paramètres > Règles de limite de fréquence.
Destinations vides
Certains envois de messages peuvent apparaître dans l’historique des messages avec des destinations vides (signalées par « — »). Cela est dû au fait que certains canaux, comme les Content Cards et les webhooks, ne collectent pas de données d’appareil lors de l’envoi du message.
Les envois de Content Cards sont enregistrés lorsque la carte est disponible pour être consultée. Comme les Content Cards peuvent être consultées sur plusieurs appareils, les données d’appareil ne sont pas enregistrées lors de l’envoi. Ces informations sont plutôt enregistrées lors de l’impression (lorsque la carte est réellement consultée). Les webhooks sont envoyés à un endpoint système (et non à un appareil), les données d’appareil ne sont donc pas applicables.
Note sur l’événement d’ouverture d’e-mail
Le suivi des ouvertures d’e-mails est sujet aux erreurs dans tout outil, y compris Braze. Avec les différentes fonctionnalités de protection de la vie privée proposées par les différents clients de messagerie, qui bloquent le chargement automatique des images ou les chargent de manière proactive sur le serveur, les événements d’ouverture d’e-mail sont susceptibles de produire à la fois des faux positifs et des faux négatifs.
Bien que les statistiques d’ouverture d’e-mails puissent être utiles de manière agrégée, par exemple pour comparer l’efficacité de différentes lignes d’objet, vous ne devez pas considérer qu’un événement d’ouverture individuel pour un utilisateur donné est significatif.
Pourquoi certains champs sont-ils vides dans l’onglet Historique des messages ?
Certains champs peuvent être absents dans l’onglet Historique des messages d’un utilisateur dans les cas suivants :
- Lorsqu’un événement ne contient pas de données pour Message envoyé, cela indique que la Campaign ne possède aucune variante de message.
- Lorsqu’un événement ne contient pas de données pour Campaign/Canvas et Message envoyé, cela indique que ce message a été envoyé depuis une Campaign API (et non des Campaigns déclenchées par API) qui n’a pas spécifié les paramètres
campaign_idetmessage_variation_id. Ces champs sont optionnels et peuvent être omis du corps de la requête. Lorsque ces champs sont spécifiés, ces informations sont renseignées dans les journaux de l’historique des messages.- Si un message particulier est totalement absent de l’historique des messages mais apparaît dans le journal Campaigns reçues, il est probable que l’utilisateur ait reçu la Campaign avant d’être identifié comme l’utilisateur actuel. Si un profil existant est orphelin, le journal Campaigns reçues est transféré, mais l’historique des messages ne l’est pas.
- Lorsque des données manquent pour Campaign/Canvas, un test manuel a peut-être été envoyé. Les tests manuels sont enregistrés dans l’onglet Historique des messages, mais la Campaign ou le Canvas envoyé ne sera pas enregistré.
- Lorsqu’un utilisateur fait partie d’un groupe initiateur ou d’une autre audience de test interne, l’Historique des messages peut afficher des métadonnées de Campaign ou de Canvas limitées par rapport aux envois en production.
Contraintes de taille des données
Braze n’impose pas de limite globale sur la taille totale d’un profil utilisateur. Cependant, certains types de données associés aux utilisateurs ont des capacités de taille définies.
Tableaux d’attributs personnalisés
Les tableaux d’attributs personnalisés (y compris les tableaux d’objets) ont une capacité de 100 Ko. Lorsque vous envoyez un tableau qui dépasse cette capacité, l’attribut personnalisé n’est pas traité. L’API renvoie une réponse de succès (201), mais le tableau n’apparaît pas dans le profil utilisateur et les données existantes pour cet attribut ne sont pas mises à jour.
Si vos tableaux approchent cette capacité, envisagez de limiter le nombre d’objets que vous renseignez afin de maintenir la taille totale en dessous de 100 Ko.
Pour plus d’informations sur les attributs personnalisés, consultez Types de données des attributs personnalisés.