Skip to content

Attributs standard

Les attributs standard sont des champs prédéfinis que Braze reconnaît sur chaque profil utilisateur. Utilisez cette page comme référence rapide pour le nom du champ, le type de données et le format attendu de chaque attribut standard.

Les attributs standard (parfois appelés attributs par défaut ou clés réservées) sont différents des attributs personnalisés, qui sont propres à votre entreprise. Lorsque vous envoyez des données à Braze avec l’un des noms de champ répertoriés sur cette page, Braze les stocke dans le champ de profil prédéfini au lieu de créer un nouvel attribut personnalisé.

Vous pouvez définir les attributs standard via l’une de ces méthodes :

Identifiants

Les identifiants indiquent à Braze quel profil utilisateur mettre à jour ou créer. Chaque requête API et chaque ligne CSV doit inclure au moins un identifiant. Pour plus de détails sur le choix du bon identifiant, consultez Résolution des identifiants.

Champs de profil

Ces champs capturent les données démographiques, de contact et de localisation de vos utilisateurs.

Ces champs gèrent la manière dont un utilisateur reçoit des messages sur les différents canaux. Leur mise à jour ne compte pas dans votre consommation de points de donnée.

Pour plus de détails sur la configuration des groupes d’abonnement, consultez Groupes d’abonnement.

Sessions et engagement

Ces champs capturent la date à laquelle l’utilisateur a interagi pour la première ou la dernière fois avec votre application. Le SDK les enregistre automatiquement ; vous ne les définissez généralement via l’API ou un CSV que lors d’une migration depuis une autre plateforme.

Jetons de notification push

Utilisez ces champs lors de la migration de jetons de notification push depuis une autre plateforme. Après l’intégration du SDK Braze, les jetons de notification push sont capturés automatiquement. Pour des conseils de migration, consultez Migration des jetons de notification push.

Profil social

Ces champs stockent les données provenant des intégrations de réseaux sociaux.

Exemple d’API

La requête suivante définit des attributs standard sur deux utilisateurs via l’endpoint /users/track.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

POST https://YOUR_REST_API_URL/users/track
Content-Type: application/json
Authorization: Bearer YOUR-REST-API-KEY
{
  "attributes": [
    {
      "external_id": "user1",
      "first_name": "Jane",
      "last_name": "Doe",
      "email": "[email protected]",
      "country": "US",
      "language": "en",
      "time_zone": "America/New_York",
      "dob": "1988-02-14",
      "email_subscribe": "opted_in"
    },
    {
      "external_id": "user2",
      "first_name": "Alex",
      "phone": "+14155552671",
      "current_location": {
        "longitude": -73.991443,
        "latitude": 40.753824
      },
      "subscription_groups": [
        {
          "subscription_group_id": "abc-123",
          "subscription_state": "subscribed"
        }
      ]
    }
  ]
}

Pour le contrat API complet, consultez l’objet d’attributs utilisateur.

Exemple CSV

Le CSV suivant met à jour les attributs standard de deux utilisateurs. Les en-têtes de colonnes doivent correspondre exactement aux noms de champs de cet article. Les en-têtes qui ne correspondent pas (par exemple, First_name au lieu de first_name) sont importés en tant qu’attributs personnalisés.

1
2
3

external_id,first_name,last_name,email,country,language,dob,email_subscribe
user1,Jane,Doe,[email protected],US,en,1988-02-14,opted_in
user2,Alex,Smith,[email protected],GB,en,1992-09-30,subscribed

Certains attributs standard ne peuvent pas être définis via un import CSV. Vous devez envoyer les tableaux, les jetons de notification push et les objets imbriqués via l’API ou l’Ingestion de données cloud. Pour la liste complète des champs pris en charge par le CSV et les étapes d’import, consultez Attributs par défaut.

Considérations

Gardez ces points à l’esprit lorsque vous travaillez avec les attributs standard :

  • Les noms de champs sont sensibles à la casse. Utilisez toujours des minuscules. Un en-tête ou une clé qui ne correspond pas exactement au nom d’un attribut standard est traité comme un attribut personnalisé.
  • La capture automatique du SDK est désactivée lorsque vous définissez des valeurs via l’API ou un CSV. Lorsque vous définissez country ou language via l’API ou un CSV, Braze cesse de capturer automatiquement ces champs depuis le SDK pour cet utilisateur.
  • null supprime une valeur. Définir un attribut standard sur null le supprime du profil. Certains champs, notamment external_id et user_alias, ne peuvent pas être supprimés après avoir été définis.
  • Les valeurs vides dans un CSV n’écrasent pas les données existantes. Une cellule vide dans un import CSV conserve la valeur existante sur le profil. Pour effacer une valeur, utilisez l’API.
  • Les fuseaux horaires sont par défaut en UTC. Les chaînes de date sans décalage sont interprétées comme minuit UTC et affichées dans le fuseau horaire de votre espace de travail. Pour spécifier un fuseau horaire, ajoutez un décalage UTC (par exemple, 2024-11-10T18:00:00-05:00).
New Stuff!