Nutzer:innen erstellen und aktualisieren (synchron)
Verwenden Sie diesen Endpunkt, um angepasste Events und Käufe aufzuzeichnen und Nutzerprofilattribute synchron zu aktualisieren. Dieser Endpunkt funktioniert ähnlich wie der Endpunkt
/users/track, der Nutzerprofile asynchron aktualisiert.
Dieser Endpunkt befindet sich derzeit in einer eingeschränkten Beta-Phase. Obwohl wir derzeit keine neuen Kund:innen zur Beta hinzufügen, informieren Sie bitte Ihren Braze Account Manager, wenn Sie der Meinung sind, dass dieses Feature für Ihre Braze-Integration nützlich sein könnte.
Synchrone und asynchrone API-Aufrufe
Bei einem asynchronen Aufruf gibt die API den Statuscode 201 zurück, der anzeigt, dass Ihre Anfrage erfolgreich empfangen, verstanden und akzeptiert wurde. Dies bedeutet jedoch nicht, dass Ihre Anfrage vollständig abgeschlossen wurde.
Bei einem synchronen Aufruf gibt die API den Statuscode 201 zurück, der anzeigt, dass Ihre Anfrage erfolgreich empfangen, verstanden, akzeptiert und abgeschlossen wurde. Die Antwort auf den Aufruf zeigt ausgewählte Felder des Nutzerprofils als Ergebnis der Operation an.
Dieser Endpunkt hat ein niedrigeres Rate-Limit als der Endpunkt /users/track (siehe Rate-Limit). Jede /users/track/sync-Anfrage kann nur ein Event-Objekt, ein Attribut-Objekt oder ein Kauf-Objekt enthalten. Dieser Endpunkt sollte für Nutzerprofil-Updates reserviert sein, bei denen ein synchroner Aufruf erforderlich ist. Für eine stabile Implementierung empfehlen wir, /users/track/sync und /users/track gemeinsam zu verwenden.
Wenn Sie beispielsweise innerhalb eines kurzen Zeitraums aufeinanderfolgende Anfragen für dieselbe:n Nutzer:in senden, sind Race-Conditions mit dem asynchronen Endpunkt /users/track möglich. Mit dem Endpunkt /users/track/sync können Sie diese Anfragen jedoch nacheinander senden, jeweils nach Erhalt einer 2XX-Antwort.
Häufig gestellte Fragen
Sollte ich den asynchronen oder den synchronen Endpunkt verwenden?
Für die meisten Profil-Updates eignet sich der Endpunkt /users/track am besten, da er ein höheres Rate-Limit und die Flexibilität bietet, Anfragen gebündelt zu senden. Der Endpunkt /users/track/sync ist jedoch nützlich, wenn bei Ihnen Race-Conditions aufgrund schneller, aufeinanderfolgender Anfragen für dieselbe:n Nutzer:in auftreten.
Unterscheidet sich die Antwortzeit vom Endpunkt /users/track?
Bei einem synchronen Aufruf wartet die API, bis Braze die Anfrage abgeschlossen hat, bevor eine Antwort zurückgegeben wird. Infolgedessen dauern synchrone Anfragen im Durchschnitt länger als asynchrone Anfragen an /users/track. Bei den meisten Anfragen können Sie innerhalb weniger Sekunden mit einer Antwort rechnen.
Kann ich mehrere Anfragen gleichzeitig senden?
Ja, solange die Anfragen für verschiedene Nutzer:innen bestimmt sind oder jede Anfrage unterschiedliche Attribute, Events oder Käufe für eine:n Nutzer:in aktualisiert.
Wenn Sie mehrere Anfragen für eine:n Nutzer:in für dasselbe Attribut, Event oder denselben Kauf senden, empfiehlt Braze, zwischen den einzelnen Anfragen auf eine erfolgreiche Antwort zu warten, um Race-Conditions zu vermeiden.
Wenn Sie trotzdem einen inkonsistenten Profilstatus feststellen, wenn Sie /users/track für dieselbe:n Nutzer:in in schneller Folge aufrufen, stellen Sie diese Updates auf /users/track/sync um und senden Sie jeweils nur eine Anfrage. Warten Sie dabei auf jede 2XX-Antwort, bevor Sie die nächste senden. Diese Reihenfolge ist der unterstützte Weg, um Read-after-Write-Race-Conditions bei engen Schleifen oder parallelen Workern zu vermeiden.
Warum stimmt der Antwortwert nicht mit dem in meiner ursprünglichen Anfrage überein?
Obwohl Ihre Anfrage abgeschlossen wurde, ist es möglich, dass der Wert Ihres angepassten Attributs nicht aktualisiert wurde. Dies kann passieren, wenn Ihr Update des angepassten Attributs die maximale Zeichenanzahl oder die Array-Grenzen überschreitet oder wenn der:die Nutzer:in nicht in Braze existiert und Sie _update_existing_only = true gesetzt haben.
In diesen Fällen sollten Sie die Antwort als Hinweis darauf betrachten, dass Ihre Anfrage zwar abgeschlossen, das gewünschte Update jedoch nicht durchgeführt wurde. Prüfen Sie die unter Warum stimmt der Antwortwert nicht mit dem in meiner ursprünglichen Anfrage überein? aufgeführten Gründe, um die Ursache zu ermitteln.
Sie können das OpenAPI-Dokument herunterladen und damit Schemas validieren. Wie das geht, erfahren Sie unter OpenAPI-Schemas für die Validierung von Anfragen verwenden.