Skip to content

Cours d'apprentissage BrazeAttributs personnalisés

Cette page traite des attributs personnalisés, qui regroupent les caractéristiques uniques de vos utilisateurs. Les attributs personnalisés sont particulièrement adaptés pour stocker des informations sur vos utilisateurs ou sur les actions à faible valeur au sein de votre application.

Lorsqu’ils sont stockés dans Braze, les attributs personnalisés peuvent servir à créer des segments d’audience et à personnaliser l’envoi de messages à l’aide de Liquid. Gardez à l’esprit que Braze ne stocke pas d’informations de séries temporelles pour les attributs personnalisés. Vous ne pourrez donc pas obtenir de graphiques basés sur ces attributs, contrairement aux événements personnalisés.

Cas d’usage

Voici quelques cas d’usage courants des attributs personnalisés :

  • Cibler et exclure des audiences en segmentant les utilisateurs selon des caractéristiques telles que le niveau de fidélité, le statut d’abonnement, la langue préférée ou le type de forfait
  • Personnaliser les messages avec Liquid en référençant des attributs tels que le prénom d’un utilisateur, ses points de récompense ou sa catégorie préférée
  • Suivre les étapes du cycle de vie et les états des utilisateurs, comme l’étape d’onboarding, le statut du compte ou la date de fin d’essai
  • Comptabiliser les actions de faible valeur avec des attributs numériques, par exemple en incrémentant un attribut feature_views_count chaque fois qu’un utilisateur consulte une fonctionnalité
  • Enregistrer la dernière occurrence d’actions de faible valeur à l’aide d’attributs temporels, tels que last_support_ticket_at ou last_password_reset_at
  • Stocker les centres d’intérêt et l’historique des utilisateurs sous forme de tableaux, comme les genres préférés ou les contenus récemment consultés, pour un ciblage basé sur les centres d’intérêt
  • Stocker des données de profil plus riches sous forme d’objets ou de tableaux d’objets, tels que des préférences structurées ou plusieurs adresses enregistrées
  • Déclencher des messages basés sur des actions lorsqu’une valeur d’attribut change à l’aide de déclencheurs d’attributs, par exemple en envoyant une notification de montée en niveau lorsque l’attribut rewards_tier d’un utilisateur change

Gérer les attributs personnalisés

Pour créer et gérer des attributs personnalisés dans le tableau de bord, accédez à Data Settings > Custom Attributes.

Quatre attributs personnalisés de type booléen.

La colonne Last updated indique la dernière modification de l’attribut personnalisé, par exemple lorsqu’il a été placé en liste de blocage ou réactivé.

Résolution des problèmes liés aux attributs personnalisés ou événements en double

Si vous voyez deux entrées de données personnalisées avec le même nom visible, l’une des entrées peut contenir un espace invisible au début ou à la fin.

Pour résoudre ce problème :

  1. Accédez à Data Settings > Custom Attributes ou Custom Events, puis localisez les deux entrées qui semblent avoir le même nom.
  2. Vérifiez si l’un des noms contient un espace masqué :
    1. Faites un clic droit sur chaque nom et sélectionnez Inspecter.
    2. Vérifiez la valeur textuelle HTML dans les outils de développement de votre navigateur.
    3. Comparez les valeurs (par exemple, email par rapport à ` email`).
    4. Si nécessaire, consultez Inspecter et modifier les pages et les styles avec Chrome DevTools.
  3. Décidez quel nom doit rester comme clé canonique, et standardisez l’orthographe et la casse exactes.
  4. Si une entrée contient des espaces au début ou à la fin et a été créée directement dans le tableau de bord, cessez d’utiliser cette entrée et passez à la clé canonique :
    • Mettez à jour tous les workflows du tableau de bord, les imports CSV et les runbooks internes pour utiliser la clé canonique.
    • Bloquez les données personnalisées pour l’entrée incorrecte lorsque vous êtes prêt à la retirer.
  5. Vérifiez vos chemins d’ingestion :
    • Les payloads API et SDK suppriment automatiquement les espaces au début et à la fin.
    • Les noms créés dans le tableau de bord ne sont pas automatiquement nettoyés ; une saisie manuelle et une gouvernance sont donc nécessaires.

Depuis cette page, vous pouvez afficher, gérer, créer ou bloquer des attributs personnalisés existants. Sélectionnez le menu à côté d’un attribut personnalisé pour accéder aux actions suivantes :

Blocage

Vous pouvez bloquer des attributs personnalisés individuellement via le menu d’actions, ou sélectionner et bloquer jusqu’à 100 attributs en masse.

Lorsque vous bloquez un attribut personnalisé :

  • Les données futures ne seront plus collectées pour cet attribut.
  • Les données existantes ne seront pas disponibles tant que l’attribut n’est pas débloqué.
  • Cet attribut n’apparaîtra pas dans les filtres ni dans les graphiques.

De plus, si un attribut personnalisé bloqué est actuellement référencé par des filtres ou des déclencheurs dans d’autres zones de Braze, une fenêtre modale d’avertissement apparaîtra pour vous informer que toutes les instances de filtres ou de déclencheurs qui le référencent seront supprimées et archivées.

Pour plus de détails sur le blocage et la suppression de données personnalisées, consultez Bloquer des données personnalisées.

Marquer comme information personnelle identifiable (PII)

Les administrateurs peuvent également créer des attributs personnalisés et les marquer comme PII depuis cette page. Ces attributs ne sont visibles que par les administrateurs et les utilisateurs du tableau de bord disposant de l’autorisation « View Custom Attributes Marked as PII ».

Ajouter des descriptions

Vous pouvez ajouter une description à un attribut personnalisé après sa création si vous disposez de l’autorisation utilisateur Manage Events, Attributes, Purchases. Sélectionnez Edit description pour l’attribut personnalisé et saisissez ce que vous souhaitez, par exemple une note pour votre équipe.

Ajouter des tags

Vous pouvez ajouter des tags à un attribut personnalisé après sa création si vous disposez de l’autorisation utilisateur « Manage Events, Attributes, Purchases ». Les tags peuvent ensuite être utilisés pour filtrer la liste des attributs.

Supprimer des attributs personnalisés

Il existe deux façons de supprimer des attributs personnalisés des profils utilisateur :

Exporter les données

Pour exporter la liste des attributs personnalisés sous forme de fichier CSV, sélectionnez Export all en haut de la page. Le fichier CSV est généré et un lien de téléchargement vous est envoyé par e-mail.

Modifier le type d’attribut personnalisé

Conditions préalables

L’attribut personnalisé ne doit pas être actuellement utilisé dans des Campaigns, Canvas ou Segments actifs. Si vous tentez de modifier le type de données alors que l’attribut est encore référencé, le tableau de bord affiche une erreur et bloque la modification.

Modifier le type de données

  1. Arrêtez toutes les Campaigns ou Canvas actifs qui utilisent l’attribut dans des Segments ou des filtres.
  2. Supprimez l’attribut de tous les filtres de Segment, Campaign et Canvas.
  3. Accédez à Paramètres des données > Attributs personnalisés (ou Événements personnalisés), recherchez l’attribut et mettez-le à jour avec le type de données souhaité.
  4. Mettez à jour les valeurs de l’attribut sur les profils utilisateur existants pour qu’elles correspondent au nouveau type de données (par exemple, en utilisant l’endpoint /users/track).
  5. Réappliquez l’attribut aux Segments, Campaigns et Canvas concernés, puis réactivez les Campaigns ou Canvas arrêtés.

Points importants

  • Les données utilisateur ne sont pas mises à jour rétroactivement. Si un profil utilisateur possédait l’attribut avec l’ancien type de données, cette valeur reste inchangée. Le filtre de segmentation recherche le nouveau type de données, de sorte que les utilisateurs ayant l’ancienne valeur sont exclus des Segments correspondants tant que leur profil n’est pas mis à jour.
  • Les nouvelles données doivent correspondre au nouveau type de données. Après la modification, les appels API ou les événements SDK qui envoient l’ancien type de données pour cet attribut ne seront pas acceptés. Seules les valeurs correspondant au nouveau type de données sont ingérées.
  • Les filtres ne sont pas mis à jour automatiquement. Les Segments et les filtres de Campaign référençant l’attribut modifié ne sont pas mis à jour rétroactivement. Vous devez les supprimer et les ajouter à nouveau après la modification.

Consulter les rapports d’utilisation

Le rapport d’utilisation répertorie tous les Canvas, Campaigns et Segments utilisant un attribut personnalisé spécifique. Cette liste n’inclut pas les utilisations de Liquid.

Vous pouvez consulter jusqu’à 100 rapports d’utilisation à la fois en cochant les cases à côté des attributs personnalisés concernés, puis en sélectionnant Afficher le rapport d’utilisation.

Onglet Valeurs

Lors de la consultation d’un rapport d’utilisation, sélectionnez l’onglet Valeurs pour afficher les principales valeurs des attributs personnalisés sélectionnés, basées sur un échantillon d’environ 250 000 utilisateurs. Notez que les résultats étant échantillonnés à partir d’un sous-ensemble d’utilisateurs, l’échantillon n’inclura pas toutes les valeurs existantes. Cela signifie que l’onglet Valeurs ne doit pas être utilisé pour la résolution des problèmes ou pour des cas d’usage nécessitant l’intégration de données de tous les utilisateurs.

Rapport d'utilisation pour les attributs personnalisés sélectionnés avec un onglet « Valeurs » ouvert montrant un graphique circulaire des valeurs de l'attribut pays, telles que « US » et « PR ».

Définir des attributs personnalisés

Les listes suivantes présentent les méthodes utilisées sur différentes plateformes pour définir des attributs personnalisés.

Développer pour la documentation par plateforme

Stockage des attributs personnalisés

Toutes les données stockées sur le profil utilisateur, y compris les données d’attributs personnalisés, sont conservées indéfiniment tant que chaque profil est actif.

Pour une référence complète de tous les types de données que vous pouvez stocker en tant qu’attributs personnalisés — y compris les booléens, les nombres, les chaînes de caractères, les tableaux, les dates, les objets et les tableaux d’objets — consultez Types de données des attributs personnalisés.

Chaînes vides versus valeurs null

Lors de l’effacement ou de la suppression d’un attribut personnalisé, le comportement diffère selon que vous transmettez une chaîne vide ("") ou null :

Valeur Comportement
"" (chaîne vide) L’attribut est défini sur une valeur vide et reste visible sur le profil utilisateur.
null L’attribut est entièrement supprimé du profil utilisateur.
New Stuff!