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 utilisé votre application pour la première ou la dernière fois. Le SDK les enregistre automatiquement ; vous ne les définissez généralement via l’API ou un fichier CSV que lors d’une migration depuis une autre plateforme.

Jetons push

Utilisez ces champs lors de la migration de jetons push depuis une autre plateforme. Après avoir intégré le SDK Braze, les jetons push sont capturés automatiquement. Pour des conseils sur la migration, consultez Migration des jetons 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": "Alex",
      "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 Attributs utilisateur.

Exemple CSV

Le CSV suivant met à jour les attributs standard pour 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 l’importation 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 CSV et les étapes d’importation, consultez Attributs par défaut.

Considérations

Gardez ces points à l’esprit lorsque vous travaillez avec des 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 par le SDK est désactivée lorsque vous définissez des valeurs via l’API ou un fichier CSV. Lorsque vous définissez country ou language via l’API ou un fichier CSV, Braze cesse de capturer automatiquement ces champs depuis le SDK pour cet utilisateur.
  • null supprime une valeur. Définissez un attribut standard sur null pour le supprimer du profil. Certains champs, notamment external_id et user_alias, ne peuvent pas être supprimés une fois définis.
  • Les valeurs vides dans un fichier CSV n’écrasent pas les données existantes. Une cellule vide lors d’un import CSV conserve la valeur existante sur le profil. Pour effacer une valeur, utilisez l’API.
  • Le fuseau horaire par défaut est UTC. Les chaînes de date sans décalage horaire 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!