Neuen Nutzer-Alias erstellen
/users/alias/new
Verwenden Sie diesen Endpunkt, um neue Nutzer-Aliase für bestehende identifizierte Nutzer:innen hinzuzufügen oder um neue nicht identifizierte Nutzer:innen zu erstellen.
Pro Anfrage können bis zu 50 Nutzer-Aliase angegeben werden.
Um einen Nutzer-Alias für bestehende Nutzer:innen hinzuzufügen, muss eine external_id im neuen Nutzer-Alias-Objekt enthalten sein. Wenn die external_id im Objekt vorhanden ist, es aber keine Nutzer:innen mit dieser external_id gibt, wird der Alias keinen Nutzer:innen hinzugefügt. Wenn keine external_id vorhanden ist, werden Nutzer:innen trotzdem erstellt, müssen aber später identifiziert werden. Dazu können Sie „Nutzer:innen identifizieren“ und den Endpunkt users/identify verwenden.
Um neue Nutzer:innen zu erstellen, die nur über einen Alias verfügen, muss die external_id im neuen Nutzer-Alias-Objekt weggelassen werden. Nachdem die Nutzer:innen erstellt wurden, verwenden Sie den Endpunkt /users/track, um die reinen Alias-Nutzer:innen mit Attributen, Events und Käufen zu verknüpfen, und den Endpunkt /users/identify, um die Nutzer:innen mit einer external_id zu identifizieren.
Sie können API-getriggerte Campaigns über user_alias an Nutzer:innen senden, indem Sie den Endpunkt /campaigns/trigger/send verwenden.
Wenn alias_label und alias_name bereits existieren
Die Kombination aus alias_label und alias_name muss in Ihrer Nutzerbasis eindeutig sein. Weitere Informationen finden Sie unter Nutzer-Aliase.
Wenn Sie eine Anfrage senden, bei der das Paar aus alias_label und alias_name bereits für beliebige Nutzer:innen existiert (ob bei denselben oder anderen Nutzer:innen), gibt der Endpunkt trotzdem eine erfolgreiche Antwort zurück (z. B. "aliases_processed": 1, "message": "success"). In diesem Fall wird den Nutzer:innen in der Anfrage kein neuer Alias hinzugefügt. Da das Paar aus alias_label und alias_name bereits verwendet wird, nimmt die Anfrage keine Änderungen vor, und es kann so aussehen, als sei der Alias den betreffenden Nutzer:innen nie hinzugefügt worden.
Fehlerbehebung
Warum werden meine Attribute nicht aktualisiert, nachdem ich mit diesem Endpunkt einen Nutzer-Alias erstellt habe?
Das passiert in der Regel, wenn auf /users/alias/new eine separate /users/track-Anfrage folgt, die Attribute über den Alias aktualisieren soll. Die Track-Anfrage kann verarbeitet werden, bevor Braze das neue Paar aus alias_label und alias_name zuverlässig einem Profil zuordnen kann. Dadurch landen die Attribute nicht bei den erwarteten Nutzer:innen.
Empfohlene Vorgehensweise: Verwenden Sie einen einzigen /users/track-Aufruf nur dann, wenn Sie ein reines Alias-Profil erstellen oder ein Profil über einen bereits existierenden Alias aktualisieren möchten. Fügen Sie im Array attributes den user_alias und Ihre Profilfelder in dasselbe Nutzerattribut-Objekt ein, damit Braze die Nutzer:innen in einem Schritt auflöst und das Update anwendet.
Setzen Sie _update_existing_only auf false, wenn Sie aus diesem Objekt eventuell ein reines Alias-Profil erstellen müssen. Wenn Sie den Wert bei Verwendung von user_alias weglassen, verwendet Braze standardmäßig das reine Update-Verhalten und erstellt kein reines Alias-Profil. Wenn der Alias in Ihrem Workspace bereits bei Nutzer:innen existiert, aktualisiert dieselbe Anfrage dieses Profil mit Ihren neuen Attributen.
Mit /users/track können Sie bestehenden Nutzer:innen, die über external_id identifiziert sind, keinen neuen Alias hinzufügen. In einem Nutzerattribut-Objekt schließen sich external_id und user_alias gegenseitig aus. Um identifizierten Nutzer:innen einen Alias hinzuzufügen, rufen Sie zuerst /users/alias/new auf. Nachdem der Alias verknüpft wurde, können Sie dieses Profil mit /users/track über die external_id oder über den bestehenden Alias aktualisieren.
Der folgende /users/track-Body erstellt beispielsweise ein reines Alias-Profil, wenn der Alias noch nicht existiert, oder aktualisiert das bestehende Profil, das diesen Alias bereits besitzt:
{
"attributes": [
{
"user_alias": {
"alias_name": "[email protected]",
"alias_label": "email"
},
"_update_existing_only": false,
"string_attribute": "test_alias_only_update"
}
]
}
Sie können das OpenAPI-Dokument herunterladen und damit Schemas validieren. Wie das geht, erfahren Sie unter OpenAPI-Schemas zur Validierung von Anfragen verwenden.