Skip to content

Standardattribute

Standardattribute sind vordefinierte Felder, die Braze in jedem Nutzerprofil erkennt. Verwenden Sie diese Seite als Kurzreferenz für den Feldnamen, den Datentyp und das erwartete Format jedes Standardattributs.

Standardattribute (manchmal auch Standardattribute oder reservierte Schlüssel genannt) unterscheiden sich von angepassten Attributen, die speziell für Ihr Unternehmen gelten. Wenn Sie Daten mit einem der auf dieser Seite aufgeführten Feldnamen an Braze senden, speichert Braze diese im vordefinierten Profilfeld, anstatt ein neues angepasstes Attribut zu erstellen.

Sie können Standardattribute über eine der folgenden Methoden festlegen:

Bezeichner

Bezeichner teilen Braze mit, welches Nutzerprofil aktualisiert oder erstellt werden soll. Jede API-Anfrage und jede CSV-Zeile muss mindestens einen Bezeichner enthalten. Weitere Informationen zur Auswahl des richtigen Bezeichners finden Sie unter Bezeichner-Auflösung.

Profilfelder

Diese Felder erfassen demografische Daten, Kontaktdaten und Gebietsschemadaten Ihrer Nutzer:innen.

Diese Felder steuern, wie Nutzer:innen Nachrichten über verschiedene Kanäle erhalten. Ihre Aktualisierung wird nicht auf Ihre Datenpunkt-Nutzung angerechnet.

Weitere Informationen zur Einrichtung von Abo-Gruppen finden Sie unter Abo-Gruppen.

Sitzungen und Engagement

Diese Felder erfassen, wann Nutzer:innen Ihre App zum ersten oder letzten Mal verwendet haben. Das SDK zeichnet sie automatisch auf; in der Regel setzen Sie sie nur über die API oder CSV, wenn Sie von einer anderen Plattform migrieren.

Push-Token

Verwenden Sie diese Felder, wenn Sie Push-Token von einer anderen Plattform migrieren. Nach der Integration des Braze SDK werden Push-Token automatisch erfasst. Eine Anleitung zur Migration finden Sie unter Push-Token migrieren.

Social-Profil

Diese Felder speichern Daten aus Social-Network-Integrationen.

API-Beispiel

Die folgende Anfrage setzt Standardattribute für zwei Nutzer:innen über den /users/track-Endpunkt.

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"
        }
      ]
    }
  ]
}

Den vollständigen API-Vertrag finden Sie unter Nutzerattribut-Objekt.

CSV-Beispiel

Die folgende CSV-Datei aktualisiert Standardattribute für zwei Nutzer:innen. Die Spaltenüberschriften müssen exakt mit den Feldnamen in diesem Artikel übereinstimmen. Überschriften, die nicht übereinstimmen (zum Beispiel First_name statt first_name), werden als angepasste Attribute importiert.

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

Einige Standardattribute können nicht über den CSV-Import festgelegt werden. Arrays, Push-Token und verschachtelte Objekte müssen stattdessen über die API oder Cloud Data Ingestion gesendet werden. Die vollständige Liste der CSV-unterstützten Felder und Importschritte finden Sie unter Standardattribute.

Hinweise

Beachten Sie diese Punkte bei der Arbeit mit Standardattributen:

  • Feldnamen sind case-sensitiv. Verwenden Sie immer Kleinbuchstaben. Ein Header oder Schlüssel, der nicht exakt mit einem Standardattributnamen übereinstimmt, wird als angepasstes Attribut behandelt.
  • Die automatische SDK-Erfassung wird unterdrückt, wenn Sie Werte über API oder CSV setzen. Wenn Sie country oder language über API oder CSV setzen, stoppt Braze die automatische Erfassung dieser Felder über das SDK für diese:n Nutzer:in.
  • null entfernt einen Wert. Setzen Sie ein Standardattribut auf null, um es aus dem Profil zu entfernen. Einige Felder, darunter external_id und user_alias, können nach dem Setzen nicht mehr entfernt werden.
  • Leere CSV-Werte überschreiben nicht. Eine leere Zelle in einem CSV-Import behält den bestehenden Wert im Profil bei. Um einen Wert zu löschen, verwenden Sie die API.
  • Zeitzonen sind standardmäßig UTC. Datumsstrings ohne Offset werden als Mitternacht UTC interpretiert und in der Zeitzone Ihres Workspace angezeigt. Um eine Zeitzone anzugeben, fügen Sie einen UTC-Offset an (zum Beispiel 2024-11-10T18:00:00-05:00).
New Stuff!