Passer au contenu

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 :

  1. Dans le tableau de bord de Braze, accédez à Paramètres des données > Comptes.
  2. 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 :

  1. Accédez à Audience > Filtres calculés.
  2. Sélectionnez Créer un filtre, puis Filtres d’objets de données.
  3. 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 :

  1. Accédez au générateur de segments.
  2. Ajoutez votre filtre calculé préconfiguré pour les critères de compte.
  3. Ajoutez des filtres d’attributs utilisateur supplémentaires, si nécessaire.
  4. Enregistrez votre segment.

Par exemple :

  • Filtre calculé : le champ industry du compte est exactement healthcare
  • Filtre d’attribut utilisateur : days_since_last_login est 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.

{% 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.

New Stuff!