Objets de compte
Utilisez les objets de compte pour segmenter et personnaliser vos communications grâce aux données de compte.
Avec les objets de compte, vous pouvez :
- Créer des Segments à partir de critères de compte
- Personnaliser les messages avec des attributs de compte grâce à Liquid
- Gérer les enregistrements de compte depuis un seul endroit
Les objets de compte sont des modèles de données au niveau de l’espace de travail, reliés aux profils utilisateur. Un enregistrement de compte correspond à un compte précis et aux données de champs qui lui sont associées. Utilisez les objets de compte lorsque le contexte du compte, comme les attributs de l’entreprise, vous aide à cibler et à personnaliser vos communications. Vous pouvez également modéliser des hiérarchies de comptes (comme des comptes parents et enfants) et associer un même profil utilisateur à plusieurs comptes.
Pourquoi utiliser les objets de compte ?
Certains cas d’usage nécessitent un contexte au niveau du compte, même lorsque vos Campaigns et Canvas sont envoyés à des utilisateurs individuels.
Les objets de compte vous permettent de stocker les données de compte une seule fois et de les réutiliser pour la segmentation et la personnalisation dans l’ensemble de Braze.
Vous pouvez ainsi :
- Segmenter selon les attributs de compte
- Personnaliser les messages avec un contexte de compte partagé (comme le nom de l’entreprise ou le secteur d’activité)
- Modéliser les relations entre les comptes et associer un profil utilisateur à plusieurs comptes
Cette approche vous évite de dupliquer les mêmes attributs de compte dans de nombreux profils utilisateurs.
Conditions préalables
Avant de commencer :
- Votre espace de travail doit être provisionné pour Accounts. Bien qu’Accounts soit disponible pour tous, vous devez en demander le provisionnement avant de pouvoir l’utiliser dans le tableau de bord ou via les endpoints Data Objects. Pour connaître la marche à suivre, consultez l’étape 1 : Activer Accounts.
- Vous devez déjà avoir des utilisateurs dans Braze.
Modèle de données des comptes
Chaque compte nécessite un identifiant (id) et un nom (name).
Les champs de compte présentés dans cette section définissent le schéma de l’objet Compte. Ces champs s’appliquent à chaque enregistrement de compte individuel que vous stockez dans Braze.
Braze inclut par défaut des objets de compte dotés de champs standard. Vous pouvez ajouter et supprimer des champs personnalisés selon votre cas d’usage. Les noms de champs id, object_id et display_name sont réservés : vous ne pouvez donc pas les utiliser comme noms de champs personnalisés.
| Nom du champ | Type de champ | Obligatoire | Description |
|---|---|---|---|
id |
chaîne de caractères | Oui | L’ID du compte dans votre système (par exemple, l’ID CRM). Doit être unique dans votre espace de travail. |
name |
chaîne de caractères | Oui | Nom du compte. |
type |
chaîne de caractères | Non | Type de compte, par exemple client, partenaire ou revendeur. |
annual_revenue |
nombre | Non | Chiffre d’affaires annuel du compte. |
industry |
chaîne de caractères | Non | Secteur d’activité du compte. |
number_of_employees |
nombre | Non | Nombre d’employés. |
address |
chaîne de caractères | Non | Adresse postale. |
city |
chaîne de caractères | Non | Ville. |
state |
chaîne de caractères | Non | État ou province. |
postal_code |
chaîne de caractères | Non | Code postal. |
country |
chaîne de caractères | Non | Pays. |
notes |
chaîne de caractères | Non | Remarques supplémentaires. |
website |
chaîne de caractères | Non | URL du site web. |
main_phone |
chaîne de caractères | Non | Numéro de téléphone principal. |
created_date |
heure | Non | Horodatage de création du compte. |
sic_code |
chaîne de caractères | Non | Code de classification standard des industries (SIC). |
| Champs personnalisés | personnalisé | Non | Champs que vous définissez et gérez. |
Options d’intégration de données
Vous pouvez gérer les enregistrements de comptes via :
- Les endpoints de l’API REST pour les enregistrements de comptes
- La modification directe dans le navigateur, sous Paramètres des données > Comptes, pour les enregistrements individuels
Commencer
Étape 1 : Activer les comptes
La fonctionnalité Comptes s’active au niveau de l’entreprise. Pour demander son provisionnement :
- Dans le tableau de bord de Braze, accédez à Paramètres des données > Comptes.
- Remplissez le questionnaire.
Une fois envoyé, votre questionnaire est transmis à Braze pour examen. Vous devriez recevoir une réponse sous une semaine. Les cas d’usage à grande échelle peuvent demander plus de temps.
Une fois le provisionnement terminé, accédez à Paramètres des données > Comptes et suivez le processus d’initialisation unique si vous y êtes invité.
Étape 2 : Ajouter des enregistrements de comptes
Ajoutez ou mettez à jour des enregistrements de comptes via la REST API ou par modification directe dans le navigateur.
Étape 3 : Créer un filtre calculé pour les critères de compte
Avant de segmenter à partir des données de compte, créez un filtre calculé qui définit vos critères de compte :
- Accédez à Audience > Filtres calculés.
- Sélectionnez Créer un filtre, puis Filtres d’objets de données.
- Définissez vos critères de compte.
Pour plus de détails, consultez la section Filtres calculés.
Étape 4 : Utiliser le filtre calculé dans le générateur de Segments
Dans le générateur de Segments, sélectionnez le filtre calculé que vous avez créé, puis ajoutez les filtres d’attributs utilisateur supplémentaires nécessaires au ciblage de votre Campaign ou de votre Canvas.
Limites
Accounts inclut les limites par défaut suivantes, adaptées à la plupart des cas d’usage :
| Ressource | Limite par défaut |
|---|---|
| Enregistrements de compte par entreprise | 50 000 |
| Champs par type de compte | 500 |
| Champs par type de relation | 25 |
| Objets de compte par utilisateur | 1 000 |
| Utilisateurs par objet de compte | 10 000 |
| Objets associés par objet de compte | 1 000 |
Il s’agit de capacités de départ. Si vous avez besoin de plus d’enregistrements de compte ou d’une limite plus élevée, contactez votre équipe de compte Braze pour demander une augmentation.
Pour connaître les codes d’erreur liés aux limites et savoir ce qui se passe lorsqu’une requête API dépasse une limite, consultez la section Limites du produit.
Créer des segments basés sur les comptes
Une fois vos enregistrements de comptes et votre filtre calculé prêts :
- Accédez au générateur de segments.
- Ajoutez votre filtre calculé préconfiguré pour les critères de compte.
- Ajoutez des filtres d’attributs utilisateur supplémentaires, si nécessaire.
- Enregistrez votre segment.
Par exemple :
- Filtre calculé : le champ
industrydu compte est exactementhealthcare - Filtre d’attribut utilisateur :
days_since_last_loginest inférieur à30
Personnaliser avec Liquid
Utilisez l’étiquette Liquid {% data_object account %} pour charger les données de compte de l’utilisateur dans le tableau data_objects.

Lorsque vous utilisez Aperçu et test, choisissez un Segment qui inclut des données de compte afin que la personnalisation puisse se résoudre correctement.
{% data_object account %}
Hi {{${first_name}}},
We'd love to invite you and your peers at {{ data_objects[0].name }}.
Pour itérer sur tous les comptes correspondants :
{% data_object account %}
{% for acct in data_objects %}
- {{ acct.name }}
{% endfor %}
Principes de base de l’API
Vous pouvez utiliser la REST API pour gérer les enregistrements de compte.
Pour plus de détails sur les endpoints, consultez Endpoints Data Objects.
Pour en savoir plus sur l’authentification et les principes de base des endpoints REST, consultez l’aperçu de l’API de Braze.
Foire aux questions
Puis-je ajouter des champs personnalisés aux comptes ?
Oui. Vous pouvez définir et gérer des champs de compte personnalisés dans votre espace de travail. Pour connaître les exigences relatives aux champs, consultez la section Modèle de données des comptes.
Les comptes sont-ils une option payante ?
Non. Les comptes ne sont pas une option payante et sont disponibles avec toutes les offres. Votre espace de travail doit cependant être provisionné avant que vous puissiez les utiliser. Pour connaître la marche à suivre, consultez la section Étape 1 : Activer les comptes.