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 CSV-Zeile muss mindestens einen Bezeichner enthalten. Einzelheiten zur Auswahl des richtigen Bezeichners finden Sie unter Bezeichner-Auflösung.

Profilfelder

Diese Felder erfassen demografische, Kontakt- und Standortdaten Ihrer Nutzer:innen.

Diese Felder steuern, wie Nutzer:innen Nachrichten über verschiedene Kanäle erhalten. Das Aktualisieren dieser Felder zählt nicht zur Datenpunkt-Nutzung.

Einzelheiten zur Einrichtung von Abo-Gruppen finden Sie unter Abo-Gruppen.

Sitzungen und Engagement

Diese Felder erfassen, wann Nutzer:innen zum ersten oder letzten Mal mit Ihrer App interagiert haben. Das SDK zeichnet sie automatisch auf; Sie legen sie in der Regel nur über API oder CSV fest, 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 Migrationsanleitung finden Sie unter Push-Token migrieren.

Social-Media-Profil

Diese Felder speichern Daten aus Social-Media-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": "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"
        }
      ]
    }
  ]
}

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

CSV-Beispiel

Die folgende CSV-Datei aktualisiert Standardattribute für zwei Nutzer:innen. 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 CSV-Import festgelegt werden. Arrays, Push-Token und verschachtelte Objekte müssen stattdessen über die API oder Cloud-Datenaufnahme gesendet werden. Die vollständige Liste der CSV-unterstützten Felder und Importschritte finden Sie unter Standardattribute.

Hinweise

Beachten Sie die folgenden Punkte bei der Arbeit mit Standardattributen:

  • Feldnamen sind case-sensitiv. Verwenden Sie immer Kleinbuchstaben. Eine Überschrift oder ein 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 festlegen. Wenn Sie country oder language über API oder CSV festlegen, stoppt Braze die automatische Erfassung dieser Felder durch 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 Festlegen nicht 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 hinzu (zum Beispiel 2024-11-10T18:00:00-05:00).
New Stuff!