Analyse

Découvrez les analyses du SDK Braze, afin de mieux comprendre quelles données Braze collecte, la différence entre les événements personnalisés et les attributs personnalisés, et les meilleures pratiques de gestion des analyses.

Conseil

Lors de la mise en œuvre de Braze, n’oubliez pas de discuter des objectifs marketing avec votre équipe, afin de décider au mieux des données que vous souhaitez suivre et de la manière dont vous souhaitez les suivre avec Braze. Pour un exemple, consultez notre étude de cas sur l’application Taxi/covoiturage à la fin de ce guide.

Données collectées automatiquement

Certaines données utilisateur sont collectées automatiquement par notre SDK, par exemple la première utilisation de l’application, la dernière utilisation de l’application, le nombre total de sessions, le système d’exploitation de l’appareil, etc. Si vous suivez nos guides d’intégration pour déployer nos SDK, vous pourrez tirer parti de cette collecte de données par défaut. Consulter cette liste peut vous aider à éviter de stocker les mêmes informations sur les utilisateurs en double. À l’exception du début et de la fin de session, toutes les autres données suivies automatiquement ne sont pas comptabilisées dans votre consommation de points de donnée.

Consultez notre article Présentation du SDK pour ajouter à la liste d’autorisation les processus qui bloquent la collecte par défaut de certains éléments de données.

Événements personnalisés

Les événements personnalisés sont des actions effectuées par vos utilisateurs ; ils sont particulièrement adaptés au suivi des interactions à forte valeur ajoutée avec votre application. L’enregistrement d’un événement personnalisé peut déclencher un nombre illimité de campagnes de suivi avec des délais configurables, et permet d’utiliser les filtres de segmentation suivants autour de la récence et de la fréquence de cet événement :

Braze enregistre le nombre de fois où ces événements se sont produits ainsi que la dernière fois qu’ils ont été effectués par chaque utilisateur à des fins de segmentation. Sur la page d’analyse Custom Events, vous pouvez visualiser de manière agrégée la fréquence de chaque événement personnalisé, ainsi que par Segment au fil du temps pour une analyse plus détaillée. Cela est particulièrement utile pour observer l’impact de vos Campaigns sur l’activité des événements personnalisés en examinant les lignes grises que Braze superpose sur la série temporelle pour indiquer la dernière fois qu’une Campaign a été envoyée.

Remarque

Les attributs personnalisés incrémentaux peuvent être utilisés pour maintenir un compteur sur une action utilisateur similaire à un événement personnalisé. Cependant, vous ne pourrez pas visualiser les données d’attributs personnalisés sous forme de série temporelle. Les actions utilisateur qui n’ont pas besoin d’être analysées en série temporelle doivent être enregistrées via cette méthode.

Stockage des événements personnalisés

Toutes les données de profil utilisateur (événements personnalisés, attributs personnalisés, données personnalisées) sont conservées tant que ces profils sont actifs.

Propriétés d’événements personnalisés

Grâce aux propriétés d’événements personnalisés, Braze vous permet de définir des propriétés sur les événements personnalisés et les achats. Ces propriétés peuvent ensuite être utilisées pour affiner les conditions de déclenchement, accroître la personnalisation des messages et générer des analyses plus sophistiquées via l’exportation de données brutes. Les valeurs de propriétés peuvent être de type chaîne de caractères, nombre, booléen ou objet temporel. Cependant, les valeurs de propriétés ne peuvent pas être des objets de type tableau.

Par exemple, si une application d’e-commerce souhaitait envoyer un message à un utilisateur lorsqu’il abandonne son panier, elle pourrait également améliorer son audience cible et permettre une personnalisation accrue de la Campaign en ajoutant une propriété d’événement personnalisé correspondant à la cart_value du panier de l’utilisateur.

Les propriétés d’événements personnalisés peuvent également être utilisées pour la personnalisation au sein du modèle de message. Toute Campaign utilisant la livraison par événement avec un événement déclencheur peut exploiter les propriétés d’événements personnalisés de cet événement pour personnaliser le message. Si une application de jeu souhaitait envoyer un message aux utilisateurs ayant terminé un niveau, elle pourrait personnaliser davantage le message avec une propriété indiquant le temps qu’il a fallu aux utilisateurs pour terminer ce niveau. Dans cet exemple, le message est personnalisé pour trois Segments différents à l’aide de la logique conditionnelle. La propriété d’événement personnalisé appelée time_spent peut être incluse dans le message en appelant {{event_properties.${time_spent}}}.

1
2
3
4
5
6
7
{% if {{event_properties.${time_spent}}} < 600 %}
Congratulations on beating that level so fast! Check out our online portal where you can play against top players from around the world!
{% elsif {{event_properties.${time_spent}}} < 1800 %}
Don't forget to visit the town store between levels to upgrade your tools.
{% else %}
Talk to villagers for essential tips on how to beat levels!
{% endif %}

Les propriétés d’événements personnalisés sont conçues pour vous aider à personnaliser vos messages ou à créer des Campaigns granulaires basées sur la livraison par événement. Si vous souhaitez créer des Segments basés sur la récence et la fréquence des propriétés d’événements, contactez votre gestionnaire du succès des clients ou notre équipe d’assistance.

Attributs personnalisés

Les attributs personnalisés sont des outils extrêmement flexibles qui vous permettent de cibler les utilisateurs avec une plus grande précision qu’avec les attributs standard. Les attributs personnalisés sont parfaits pour stocker des informations spécifiques à votre marque concernant vos utilisateurs. Gardez à l’esprit que nous ne stockons pas d’informations de séries temporelles pour les attributs personnalisés, vous n’obtiendrez donc pas de graphiques basés sur ceux-ci comme dans l’exemple précédent pour les événements personnalisés.

Stockage des attributs personnalisés

Toutes les données de profil utilisateur (événements personnalisés, attributs personnalisés, données personnalisées) sont stockées tant que ces profils sont actifs.

Types de données des attributs personnalisés

Les types de données suivants peuvent être stockés en tant qu’attributs personnalisés :

Chaînes de caractères (caractères alphanumériques)

Les attributs de type chaîne de caractères sont utiles pour stocker les saisies utilisateur, comme une marque préférée, un numéro de téléphone ou une dernière chaîne de recherche dans votre application. Les attributs de type chaîne de caractères sont soumis aux contraintes de longueur pour les données personnalisées (479 octets ; environ 479 caractères mono-octet ou environ 160 caractères pour les scripts multi-octets comme le japonais).

Le tableau suivant décrit les options de segmentation disponibles pour les attributs de type chaîne de caractères.

Important

Lors de la segmentation avec le filtre DOES NOT MATCH REGEX, il est nécessaire qu’un attribut personnalisé avec une valeur assignée existe déjà dans le profil de cet utilisateur. Braze suggère d’utiliser la logique « OU » pour vérifier si un attribut personnalisé est vide afin de cibler correctement les utilisateurs.

Conseil

Pour en savoir plus sur l’utilisation de notre filtre d’expressions régulières, consultez cette documentation sur les expressions régulières compatibles Perl (PCRE).
Ressources supplémentaires sur les regex :

• Regex avec Braze
• Débogueur et testeur de regex
• Tutoriel regex

Tableaux

Les attributs de type tableau sont utiles pour stocker des listes d’informations liées à vos utilisateurs. Par exemple, stocker les 100 derniers contenus consultés par un utilisateur dans un tableau permet une segmentation par centres d’intérêt spécifiques.

Les tableaux d’attributs personnalisés sont des ensembles unidimensionnels ; les tableaux multidimensionnels ne sont pas pris en charge. L’ajout d’un élément à un tableau d’attributs personnalisés ajoute l’élément à la fin du tableau, sauf s’il est déjà présent, auquel cas il est déplacé de sa position actuelle vers la fin du tableau. Par exemple, si un tableau ['hotdog','hotdog','hotdog','pizza'] est importé, il apparaîtra dans l’attribut de type tableau sous la forme ['hotdog', 'pizza'] car seules les valeurs uniques sont prises en charge.

Si le tableau contient son nombre maximum d’éléments, le premier élément sera supprimé et le nouvel élément sera ajouté à la fin. Voici un exemple de code illustrant le comportement des tableaux dans le SDK web :

1
2
3
4
5
6
var abUser = appboy.getUser();
// initialize array for this user, assuming max length of favorite_foods is set to 4.
abUser.setCustomUserAttribute('favorite_foods', ['pizza', 'wings', 'pasta']); // => ['pizza', 'wings', 'pasta']
abUser.addToCustomAttributeArray('favorite_foods', 'fries'); // => ['pizza', 'wings', 'pasta', 'fries']
abUser.addToCustomAttributeArray('favorite_foods', 'pizza'); // => ['wings', 'pasta', 'fries', 'pizza']
abUser.addToCustomAttributeArray('favorite_foods', 'ice cream'); // => ['pasta', 'fries', 'pizza', 'ice cream']

Le nombre par défaut et maximum d’éléments dans un tableau est de 500. Vous pouvez modifier le nombre maximum de tableaux dans le tableau de bord de Braze, sous Data Settings > Custom Attributes. Les tableaux dépassant le nombre maximum d’éléments sont tronqués pour contenir le nombre maximum d’éléments.

Remarque

Si un attribut personnalisé de type tableau apparaît sur un profil utilisateur mais n’affiche aucune valeur, vérifiez la Max Length de l’attribut dans Data Settings > Custom Attributes. Une Max Length de 0 empêche les valeurs de s’afficher sur le profil. Pour les étapes de résolution des problèmes, consultez Types de données des attributs personnalisés.

Le tableau suivant décrit les options de segmentation disponibles pour les attributs de type tableau.

Remarque

Nous utilisons les expressions régulières compatibles Perl (PCRE).

Dates

Les attributs de type date sont utiles pour stocker la dernière fois qu’une action spécifique a été effectuée, afin de proposer des messages de réengagement ciblés à vos utilisateurs.

Remarque

La dernière date à laquelle un événement personnalisé ou un événement d’achat s’est produit est automatiquement enregistrée et ne doit pas être enregistrée en double via un attribut personnalisé de type date.

Les filtres de date utilisant des dates relatives (par exemple, il y a plus d’un jour, il y a moins de deux jours) mesurent un jour comme 24 heures. Toute campagne que vous exécutez avec ces filtres inclura tous les utilisateurs par tranches de 24 heures. Par exemple, « dernière utilisation de l’application il y a plus d’un jour » capturera tous les utilisateurs qui « ont utilisé l’application pour la dernière fois il y a plus de 24 heures » à partir du moment exact où la campagne s’exécute. Il en va de même pour les campagnes avec des plages de dates plus longues : cinq jours à partir de l’activation signifient les 120 heures précédentes.

Le tableau suivant décrit les options de segmentation disponibles pour les attributs de type date.

Nombres

Les attributs numériques offrent une grande variété de cas d’usage. Les attributs personnalisés numériques incrémentaux sont utiles pour stocker le nombre de fois qu’une action ou un événement donné s’est produit. Les nombres standard ont toutes sortes d’utilisations, comme l’enregistrement de la pointure, du tour de taille ou du nombre de fois qu’un utilisateur a consulté une fonctionnalité ou une catégorie de produit donnée.

Remarque

Les dépenses ne doivent pas être enregistrées par cette méthode. Elles doivent plutôt être enregistrées via nos méthodes d’achat.

Le tableau suivant décrit les options de segmentation disponibles pour les attributs numériques.

Booléens (vrai/faux)

Les attributs booléens sont utiles pour stocker les statuts d’abonnement et d’autres données binaires simples concernant vos utilisateurs. Les options de saisie que nous fournissons vous permettent de trouver les utilisateurs pour lesquels une variable a été explicitement définie sur une valeur booléenne, ainsi que ceux qui n’ont aucun enregistrement de cet attribut.

Le tableau suivant décrit les options de segmentation disponibles pour les attributs booléens.

Événements d’achat / suivi des revenus

L’utilisation de nos méthodes d’achat pour enregistrer les achats in-app établit la valeur vie client (LTV) pour chaque profil utilisateur individuel. Ces données sont consultables sur notre page de revenus sous forme de graphiques chronologiques.

Le tableau suivant décrit les options de segmentation disponibles pour les événements d’achat.

Remarque

Si vous souhaitez segmenter en fonction du nombre de fois qu’un achat spécifique a été effectué, vous devez également enregistrer cet achat individuellement en tant qu’attribut personnalisé incrémentiel.

Cas d’utilisation : application de taxi/covoiturage

Dans cet exemple, prenons une application de covoiturage qui souhaite déterminer quelles données utilisateur collecter. Les questions et le brainstorming suivants constituent un excellent modèle à suivre pour les équipes marketing et de développement. À la fin de cet exercice, les deux équipes devraient avoir une compréhension claire des événements et attributs personnalisés qu’il est pertinent de collecter pour atteindre leur objectif.

Question n° 1 : Quel est l’objectif ?

Leur objectif est simple : ils veulent que les utilisateurs commandent des trajets en taxi via leur application.

Question n° 2 : Quelles sont les étapes intermédiaires entre l’installation de l’application et cet objectif ?

1. Il faut que les utilisateurs commencent le processus d’inscription et renseignent leurs informations personnelles.
2. Il faut que les utilisateurs confirment leur inscription en entrant un code reçu par SMS dans l’application.
3. Ils doivent essayer de commander un taxi.
4. Pour commander un taxi, il faut que des taxis soient disponibles au moment de leur recherche.

Ces actions peuvent ensuite être associées aux événements personnalisés suivants :

• Inscription commencée
• Inscription terminée
• Appels de taxi réussis
• Appels de taxi échoués

Une fois les événements définis, vous pouvez lancer les campagnes suivantes :

1. Envoyer des messages aux utilisateurs qui ont commencé l’inscription sans déclencher l’événement « Inscription terminée » dans un certain délai.
2. Envoyer des messages de félicitations aux utilisateurs qui ont terminé leur inscription.
3. Envoyer des excuses et un crédit promotionnel aux utilisateurs dont les appels de taxi ont échoué et qui n’ont pas été suivis d’un appel réussi dans un certain délai.
4. Envoyer des promotions aux utilisateurs les plus actifs ayant de nombreux appels de taxi réussis pour les remercier de leur fidélité.

Et bien plus encore !

Question n° 3 : Quelles autres informations pourrions-nous connaître sur nos utilisateurs pour enrichir nos messages ?

• Ont-ils un crédit promotionnel ?
• Quelle note moyenne donnent-ils à leurs chauffeurs ?
• Des codes promotionnels uniques pour l’utilisateur ?

Ces caractéristiques peuvent ensuite être associées aux attributs personnalisés suivants :

• Solde de crédit promotionnel (type décimal)
• Note moyenne du chauffeur (type nombre)
• Code promotionnel unique (type chaîne de caractères)

L’ajout de ces attributs vous permettrait d’envoyer des campagnes aux utilisateurs, par exemple :

1. Rappeler aux utilisateurs qui ne se sont pas connectés depuis sept jours mais qui disposent d’un crédit promotionnel que ce crédit existe et qu’ils devraient revenir sur l’application pour l’utiliser !
2. Envoyer des messages aux utilisateurs qui donnent de mauvaises notes aux chauffeurs pour obtenir un retour direct et comprendre pourquoi ils n’ont pas apprécié leur trajet.
3. Utiliser nos fonctionnalités de modélisation et de personnalisation des messages pour intégrer l’attribut de code promotionnel unique dans les messages adressés aux utilisateurs.

Bonnes pratiques

Bonnes pratiques générales

Utiliser les propriétés d’événement

• Nommez un événement personnalisé de manière à décrire une action effectuée par un utilisateur.
• Faites un usage généreux des propriétés d’événement personnalisées pour représenter les données importantes relatives à un événement.
• Par exemple, plutôt que de capturer un événement personnalisé distinct pour le visionnage de chacun des 50 films différents, il serait plus efficace de capturer simplement le visionnage d’un film comme événement et d’inclure une propriété d’événement contenant le nom du film.

Bonnes pratiques de développement

Définir des ID utilisateur pour chaque utilisateur

Les ID utilisateur doivent être définis pour chacun de vos utilisateurs. Ils doivent être immuables et accessibles lorsqu’un utilisateur ouvre l’application. Nous recommandons fortement de fournir cet identifiant, car il vous permettra de :

• Suivre vos utilisateurs sur différents appareils et plateformes, améliorant ainsi la qualité de vos données comportementales et démographiques.
• Importer des données sur vos utilisateurs à l’aide de notre API de données utilisateur.
• Cibler des utilisateurs spécifiques avec notre API de communication pour les messages généraux et transactionnels.

Les ID utilisateur doivent comporter moins de 512 caractères et doivent être privés et difficiles à obtenir (par exemple, pas une simple adresse e-mail ou un nom d’utilisateur). Si un tel identifiant n’est pas disponible, Braze attribuera un identifiant unique à vos utilisateurs, mais vous ne bénéficierez pas des fonctionnalités listées pour les ID utilisateur. Vous devez éviter de définir des ID utilisateur pour les utilisateurs pour lesquels vous ne disposez pas d’un identifiant unique lié à eux en tant qu’individu. Transmettre un identifiant d’appareil n’offre aucun avantage par rapport au suivi automatique des utilisateurs anonymes que Braze propose par défaut. Voici quelques exemples d’ID utilisateur appropriés et inappropriés.

Bonnes options pour les ID utilisateur :

• Adresse e-mail hachée ou nom d’utilisateur unique
• Identifiant de base de données unique

Ceux-ci ne doivent pas être utilisés comme ID utilisateur :

• ID d’appareil
• Nombre aléatoire ou ID de session
• Tout ID non unique
• Adresse e-mail
• ID utilisateur d’un autre fournisseur tiers

Important

Pour renforcer la sécurité, nous vous recommandons d’activer notre fonctionnalité d’authentification SDK afin d’empêcher l’usurpation d’identité des utilisateurs.

Donner des noms lisibles aux événements et attributs personnalisés

Imaginez que vous êtes un marketeur qui commence à utiliser Braze un an ou deux après le déploiement : lire une liste déroulante remplie de noms comme « usr_no_acct » sans contexte supplémentaire peut être intimidant. Donner à vos événements et attributs des noms identifiables et lisibles facilitera les choses pour tous les utilisateurs de votre plateforme. Tenez compte des bonnes pratiques suivantes :

• Ne commencez pas un événement personnalisé par un caractère numérique. La liste déroulante est triée par ordre alphabétique et commencer par un caractère numérique rend la segmentation par le filtre de votre choix plus difficile.
• Essayez de ne pas utiliser d’abréviations obscures ou de jargon technique lorsque c’est possible.
  • Exemple : usr_ctry peut convenir comme nom de variable pour le pays d’un utilisateur dans un morceau de code, mais l’attribut personnalisé devrait être envoyé à Braze sous une forme comme user_country pour apporter de la clarté à un marketeur utilisant le tableau de bord par la suite.

Ne journaliser les attributs que lorsqu’ils changent

Nous comptabilisons chaque attribut transmis à Braze comme un point de donnée, même si l’attribut transmis contient la même valeur que celle précédemment enregistrée. Ne journaliser les données que lorsqu’elles changent permet d’éviter une utilisation redondante des points de donnée et favorise une expérience plus fluide en évitant les appels API inutiles.

Éviter de générer des noms d’événement de manière programmatique

Si vous créez constamment de nouveaux noms d’événement, il sera impossible de segmenter vos utilisateurs de manière significative. Vous devriez généralement capturer des événements génériques (« A regardé une vidéo » ou « A lu un article ») plutôt que des événements très spécifiques tels que (« A regardé Gangnam Style » ou « A lu l’article : Les 10 meilleurs restaurants pour déjeuner à Midtown Manhattan »). Les données spécifiques relatives à l’événement doivent être incluses en tant que propriété d’événement, et non dans le nom de l’événement.

Limitations et contraintes techniques

Soyez attentif aux limitations et contraintes suivantes lors du déploiement d’événements personnalisés :

Contraintes de longueur

Braze impose une limite de longueur en octets (479 octets) pour les noms d’événements personnalisés, les noms d’attributs personnalisés (clés) et les valeurs de chaîne de caractères des événements personnalisés. Les valeurs dépassant cette limite sont tronquées. Exprimé en caractères, cela correspond à environ 479 caractères mono-octet (par exemple, ASCII), ou environ 160 caractères pour les scripts multi-octets tels que le japonais (en supposant environ 3 octets par caractère en UTF-8). Idéalement, gardez les noms et les valeurs aussi courts que possible pour améliorer les performances réseau et la consommation de batterie de votre application — si possible, limitez-les à 50 caractères.

Contraintes de contenu

Le contenu suivant sera supprimé automatiquement de vos attributs et événements. Veillez à ne pas utiliser les éléments suivants :

• Espaces en début et en fin de chaîne
• Retours à la ligne
• Tous les caractères non numériques dans les numéros de téléphone
  • Exemple : « (732) 178-1038 » sera condensé en « 7321781038 »
• Les caractères non-espace doivent être convertis en espaces
• $ ne doit pas être utilisé comme préfixe pour les événements personnalisés
• Toute valeur d’encodage UTF-8 invalide
  • « My \x80 Field » sera condensé en « My Field »

Clés réservées

Les clés suivantes sont réservées et ne peuvent pas être utilisées comme propriétés d’événement personnalisées :

• time
• product_id
• quantity
• event_name
• price
• currency

Définitions des valeurs

• Les valeurs entières sont sur 64 bits
• Les décimales ont 15 chiffres décimaux par défaut

Analyser un champ de nom générique

Si un seul champ de nom générique existe pour un utilisateur (par exemple, « JohnDoe »), vous pouvez attribuer ce titre entier à l’attribut Prénom de votre utilisateur. De plus, vous pouvez tenter d’extraire à la fois le prénom et le nom de famille de l’utilisateur en utilisant les espaces, mais cette dernière méthode comporte le risque potentiel de mal nommer certains de vos utilisateurs.