Zum Inhalt springen

Diese Seite wurde automatisch übersetzt und kann Ungenauigkeiten enthalten. Um einen Übersetzungsfehler zu melden, nutzen Sie das Feedback unten im Inhaltsverzeichnis rechts auf der Seite.

Kauf-Objekt

In diesem Artikel werden die verschiedenen Komponenten eines Kauf-Objekts, die richtige Verwendung, Best Practices und Beispiele erläutert.

Wichtig

Das bisherige Kauf-Event befindet sich im Wartungsmodus. Bestehende Braze-Kund:innen können bisherige Kauf-Events weiterhin verwenden. Sie funktionieren weiterhin wie erwartet, aber neue Funktionen werden künftig auf Basis der empfohlenen E-Commerce-Events entwickelt. Braze wird Sie rechtzeitig informieren, bevor ein Einstellungsdatum festgelegt wird. Neue Braze-Kund:innen sollten empfohlene E-Commerce-Events verwenden, da bisherige Kauf-Events nicht mehr verfügbar sein werden.

Was ist ein Kauf-Objekt?

Ein Kauf-Objekt ist ein Objekt, das über die API übergeben wird, wenn ein Kauf getätigt wurde. Jedes Kauf-Objekt befindet sich in einem Kauf-Array. Jedes Objekt steht dabei für einen einzelnen Kauf einer bestimmten Nutzer:in zu einem bestimmten Zeitpunkt. Das Kauf-Objekt enthält viele verschiedene Felder. Damit kann das Braze-Backend diese Informationen speichern und für Anpassung, Datenerfassung und Personalisierung nutzen.

Objektkörper

{
  // 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,
  // See the following product_id naming conventions for clarification.
  "product_id" : (required, string) identifier for the purchase, for example, Product Name or Product Category,
  "currency" : (required, string) ISO 4217 Alphabetic Currency Code,
  //Revenue from a purchase object is calculated as the product of quantity and price.
  "price" : (required, float) value in the base currency unit (for example, Dollars for USD, Yen for JPY),
  "quantity" : (optional, integer) the quantity purchased (defaults to 1, must be <= 100 -- currently, Braze treats a quantity _X_ as _X_ separate purchases with quantity 1),
  "time" : (required, datetime as string in ISO 8601) Time of purchase,
  // See the following purchase object explanation for clarification.
  "properties" : (optional, Properties Object) properties of the event,
  // Setting this flag to true puts the API in "Update Only" mode.
  // When using a "user_alias", "Update Only" mode is always true.
  "_update_existing_only" : (optional, boolean)
}

Hinweis

Bei Käufen mit Zeitstempeln in der Zukunft wird standardmäßig die aktuelle Zeit verwendet. So wird sichergestellt, dass Kauf-Events mit korrektem Zeitpunkt erfasst werden.

Hinweis

Einige Bezeichnerpaare können nicht zusammen verwendet werden. Wenn sowohl email als auch phone angegeben sind, hat email Vorrang. Ausführliche Informationen finden Sie unter Auflösung von Bezeichnern.

Kauf-Produkt-ID

Innerhalb des Kauf-Objekts ist die product_id ein Bezeichner für den Kauf (zum Beispiel Product Name oder Product Category):

Braze erlaubt es Ihnen, bis zu 5.000 product_ids im Dashboard zu speichern.
Die product_id kann bis zu 255 Zeichen lang sein.

Namenskonventionen

Braze bietet einige allgemeine Namenskonventionen für die product_id des Kauf-Objekts. Bei der Wahl der product_id empfiehlt Braze, einfache Namen wie den Produktnamen oder die Produktkategorie (statt SKUs) zu verwenden, um alle protokollierten Artikel nach dieser product_id zu gruppieren.

So lassen sich Produkte für die Segmentierung und das Triggern leichter identifizieren.

Käufe auf Bestellebene protokollieren

Wenn Sie Käufe auf Bestellebene statt auf Produktebene protokollieren möchten, können Sie den Bestellnamen oder die Bestellkategorie als product_id verwenden (zum Beispiel Online Order oder Completed Order).

So protokollieren Sie beispielsweise Käufe auf Bestellebene im Web SDK:

POST https://YOUR_REST_API_URL/users/track
Content-Type: application/json
Authorization: Bearer YOUR-REST-API-KEY
{
  "purchases" : [
    {
      "external_id" : "user1",
      "app_id" : "11ae5b4b-2445-4440-a04f-bf537764c9ad",
      "product_id" : "Completed Order",
      "currency" : "USD",
      "price" : 219.98,
      "time" : "2013-07-16T19:20:30+01:00",
      "properties" : {
        "products" : [ { "name": "Monitor", "category": "Gaming", "product_amount": 19.99, },
        { "name": "Gaming Keyboard", "category": "Gaming ", "product_amount": 199.99, }
        ]
      }
    }
  ]
}

Kauf-Eigenschaften-Objekt

Kauf-Eigenschaften sind für das Filtern und die Liquid-Personalisierung in Nachrichten gedacht, die durch das jeweils übergeordnete Kauf-Event getriggert werden. Standardmäßig werden sie nicht im Braze-Nutzerprofil gespeichert. Wenn Sie Werte von Kauf-Eigenschaften für die Segmentierung nutzen möchten, lesen Sie den Abschnitt Segmentierung nach Event-Eigenschaften. Damit werden die Werte für ein Lookback-Fenster von bis zu 30 Tagen im Nutzerprofil gespeichert.

The properties values must be an object up to 50 KB where the keys are the property names and the values are the property values. Property names must be strings, 255 characters or fewer, with no leading dollar signs ($).

Property values can be any of the following data types:

Data type	Description
Number	Integer or float
Boolean	Value `true` or `false`
Datetime	String in ISO 8601 or `yyyy-MM-dd'T'HH:mm:ss:SSSZ` format. Not supported within arrays.
String	255 characters or fewer
Array	Supported; datetimes are not supported within arrays.
Object	Ingested as strings (not nested objects). For nested data, use a string value (for example, JSON serialized).

The following keys are reserved and cannot be used as property names: time, product_id, quantity, event_name, price, and currency. Using a reserved key in the properties object returns the error “Invalid ‘properties’ field”.

Eine konsolidierte Referenz der Datentypen für angepasste Attribute, Event-Eigenschaften und Kataloge finden Sie unter Datentypen.

Kauf-Eigenschaften

Kauf-Eigenschaften können zum Triggern von Nachrichten und zur Personalisierung mit Liquid verwendet werden. Außerdem ist eine Segmentierung auf der Grundlage dieser Eigenschaften möglich.

Hinweis

When you view segmentable purchase properties in Data Settings > Products, the list displays property keys (names such as “color” or “brand”), not the actual property values (such as “red” or “Nike”).

Namenskonventionen

Bitte beachten Sie, dass dieses Feature pro Produkt und nicht pro Kauf aktiviert wird. Wenn Sie z. B. ein großes Volumen an unterschiedlichen Produkten haben, die aber alle die gleichen Eigenschaften haben, ist eine Segmentierung möglicherweise eher unnötig.

In diesem Fall empfehlen wir, bei der Festlegung der Datenstrukturen Produktnamen auf „Gruppenebene“ anstelle von Bezeichnern auf Transaktionsebene zu verwenden. Zum Beispiel sollte ein Zugunternehmen Produkte für „Einzelfahrt“, „Hin- und Rückfahrt“, „Multi-City“ haben und nicht für bestimmte Transaktionen wie „Transaktion 123“ oder „Transaktion 046“. Ein weiteres Beispiel: Für das Kauf-Event „Essen“ sollten Sie die Eigenschaften „Kuchen“ und „Sandwich“ festlegen.

Wichtig

Beachten Sie, dass Produkte über die Braze REST API hinzugefügt werden können. Wenn Sie beispielsweise einen Aufruf an den /users/track-Endpunkt senden und eine neue Kauf-ID hinzufügen, erstellt Braze automatisch ein Produkt im Bereich Dateneinstellungen > Produkte des Dashboards.

Beispiel für ein Kauf-Objekt

POST https://YOUR_REST_API_URL/users/track
Content-Type: application/json
Authorization: Bearer YOUR-REST-API-KEY
{
  "purchases" : [
    {
      "external_id" : "user1",
      "app_id" : "11ae5b4b-2445-4440-a04f-bf537764c9ad",
      "product_id" : "backpack",
      "currency" : "USD",
      "price" : 40.00,
      "time" : "2013-07-16T19:20:30+01:00",
      "properties" : {
        "color" : "red",
        "monogram" : "ABC",
        "checkout_duration" : 180,
        "size" : "Large",
        "brand" : "Backpack Locker"
      }
    },
    {
      "external_id" : "user1",
      "app_id" : "11ae5b4b-2445-4440-a04f-bf537764c9ad",
      "product_id" : "pencil",
      "currency" : "USD",
      "price" : 2.00,
      "time" : "2013-07-17T19:20:20+01:00",
      "properties" : {
        "number" : 2,
        "sharpened" : true
      }
    },
    {
      "user_alias" : { "alias_name" : "device123", "alias_label" : "my_device_identifier"},
      "app_id" : "11ae5b4b-2445-4440-a04f-bf537764c9ad",
      "product_id" : "pen",
      "currency" : "USD",
      "price" : 2.50,
      "time" : "2013-07-17T19:20:20+01:00",
      "properties" : {
        "color" : "blue",
      }
    }
  ]
}

Kauf-Objekte, Event-Objekte und Webhooks

Anhand des angegebenen Beispiels können wir sehen, dass jemand einen Rucksack mit den Eigenschaften Farbe, Monogramm, Kassendauer, Größe und Marke gekauft hat. Wir können dann Segmente mit diesen Eigenschaften erstellen, indem wir Kauf-Event-Eigenschaften verwenden, oder angepasste Nachrichten über einen Kanal mit Liquid senden. Zum Beispiel: „Hallo Ann F., vielen Dank für den Kauf dieses roten, mittelgroßen Rucksacks für 40,00 $! Danke für Ihren Einkauf bei Backpack Locker!“

Wenn Sie Eigenschaften zur Segmentierung speichern und tracken möchten, müssen Sie diese als angepasste Attribute einrichten. Dies kann mithilfe von Segmenterweiterungen geschehen, mit denen Sie Nutzer:innen auf der Grundlage von angepassten Events oder Kaufverhalten ansprechen können, die für die Lifetime des jeweiligen Nutzerprofils gespeichert werden.

New Stuff!