Skip to content

Event-Objekt

Dieser Artikel erläutert die verschiedenen Komponenten eines Event-Objekts, wie Sie dieses Objekt verwenden können und Beispiele, an denen Sie sich orientieren können.

Was ist ein Event-Objekt?

Ein Event-Objekt ist ein Objekt, das über die API übergeben wird, wenn ein bestimmtes Event auftritt. Event-Objekte befinden sich in einem Events-Array. Jedes Event-Objekt im Events-Array repräsentiert ein einzelnes Vorkommen eines angepassten Events durch eine:n bestimmte:n Nutzer:in zum angegebenen Zeitwert. Das Event-Objekt verfügt über viele verschiedene Felder, mit denen Sie Anpassungen vornehmen können, indem Sie Event-Eigenschaften in Nachrichten, der Datenerfassung und der Personalisierung festlegen und verwenden.

Informationen zur Einrichtung angepasster Events für eine bestimmte Plattform finden Sie im Plattform-Integrationsleitfaden im Entwickler:innen-Leitfaden. Lesen Sie den entsprechenden Artikel basierend auf Ihrer Plattform:

Objektkörper

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

{
  // One of "external_id" or "user_alias" or "braze_id" or "email" or "phone" is required
  "external_id" : (optional, string) External user ID,
  "user_alias" : (optional, User Alias Object) User alias object,
  "braze_id" : (optional, string) Braze user identifier,
  "email": (optional, string) User email address,
  "phone": (optional, string) User phone number,
  "app_id" : (optional, string) see App Identifier,
  "name" : (required, string) the name of the event,
  "time" : (required, datetime as string in ISO 8601 or in `yyyy-MM-dd'T'HH:mm:ss:SSSZ` format),
  "properties" : (optional, Properties Object) properties of the event
  // Setting this flag to true will put the API in "Update Only" mode.
  // When using a "user_alias", "Update Only" mode is always true.
  "_update_existing_only" : (optional, boolean)
  // See following notes regarding anonymous push token imports
}

Nur vorhandene Profile aktualisieren

Um nur vorhandene Nutzerprofile in Braze zu aktualisieren, sollten Sie den Schlüssel _update_existing_only mit dem Wert true im Body Ihrer Anfrage übergeben. Wenn dieser Wert weggelassen wird, erstellt Braze ein neues Nutzerprofil, falls die external_id noch nicht existiert.

Event-Eigenschaften-Objekt

Angepasste Events und Käufe können Event-Eigenschaften haben. Die „properties“-Werte sollten ein Objekt sein, bei dem die Schlüssel die Eigenschaftsnamen und die Werte die Eigenschaftswerte sind. Eigenschaftsnamen müssen nicht-leere Strings mit maximal 255 Zeichen sein und dürfen kein vorangestelltes Dollarzeichen ($) enthalten.

Eigenschaftswerte können einen der folgenden Datentypen haben:

Datentyp Beschreibung
Zahlen Als Ganzzahlen oder Gleitkommazahlen
Boolesche Werte true oder false
Datums-/Zeitwerte Müssen als Strings im ISO-8601-Format oder in einem der folgenden Formate vorliegen:
- yyyy-MM-ddTHH:mm:ss:SSSZ
- yyyy-MM-ddTHH:mm:ss
- yyyy-MM-dd HH:mm:ss
- yyyy-MM-dd
- MM/dd/yyyy
- ddd MM dd HH:mm:ss.TZD YYYY

Innerhalb von Arrays nicht unterstützt.

Hinweis: „T“ ist ein Zeitbezeichner, kein Platzhalter, und sollte nicht geändert oder entfernt werden.

Zeitattribute ohne Zeitzone werden standardmäßig auf Mitternacht UTC gesetzt (und im Dashboard als Äquivalent von Mitternacht UTC in der Zeitzone des Unternehmens formatiert).

Events mit Zeitstempeln in der Zukunft werden standardmäßig auf die aktuelle Zeit gesetzt.
Strings 255 Zeichen oder weniger.
Arrays Arrays dürfen keine Datums-/Zeitwerte enthalten.
Objekte Objekte werden als Strings aufgenommen.

Event-Eigenschaften-Objekte, die Array- oder Objektwerte enthalten, können eine Event-Eigenschaften-Payload von bis zu 100 KB haben.

Reservierte Schlüssel

Die folgenden Schlüssel sind reserviert und können nicht als angepasste Event-Eigenschaften verwendet werden:

  • time
  • event_name

Persistenz von Event-Eigenschaften

Event-Eigenschaften sind für die Filterung und Liquid-Personalisierung in Nachrichten konzipiert, die durch ihre übergeordneten Events ausgelöst werden. Standardmäßig werden sie nicht im Braze-Nutzerprofil gespeichert. Um Event-Eigenschaftswerte in der Segmentierung zu verwenden, lesen Sie den Abschnitt Angepasste Events, der die verschiedenen Ansätze zur langfristigen Speicherung von Event-Eigenschaftswerten beschreibt.

Beispielanfrage für Events

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

POST https://YOUR_REST_API_URL/users/track
Content-Type: application/json
Authorization: Bearer YOUR-REST-API-KEY
{
  "events" : [
    {
      "external_id" : "user1",
      "app_id" : "your-app-id",
      "name" : "watched_trailer",
      "time" : "2013-07-16T19:20:30+01:00"
    },
    {
      "external_id" : "user1",
      "app_id" : "your-app-id",
      "name" : "rented_movie",
      "time" : "2013-07-16T19:20:45+01:00",
      "properties": {
        "movie": "The Sad Egg",
        "director": "Alex Smith"
      }
    },
    {
      "user_alias" : { "alias_name" : "device123", "alias_label" : "my_device_identifier"},
      "app_id" : "your-app-id",
      "name" : "watched_trailer",
      "time" : "2013-07-16T19:20:50+01:00"
    }
  ]
}

Event-Objekte

Anhand des bereitgestellten Beispiels können wir sehen, dass jemand kürzlich einen Trailer angesehen und dann einen Film ausgeliehen hat. Obwohl wir nicht in eine Campaign gehen und die Nutzer:innen anhand dieser Eigenschaften segmentieren können, können wir diese Eigenschaften strategisch nutzen, indem wir sie in Form einer Quittung verwenden, um über einen Kanal mithilfe von Liquid eine angepasste Nachricht zu senden. Zum Beispiel: „Hallo Alex, vielen Dank, dass du The Sad Egg von Alex Smith ausgeliehen hast. Hier sind einige empfohlene Filme basierend auf deiner Ausleihe…“
New Stuff!