Neuen Nutzer-Alias erstellen

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 den Endpunkt „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 Alias-Nutzer:innen mit Attributen, Ereignissen und Käufen zu verknüpfen, und den Endpunkt /users/identify, um die Nutzer:innen mit einer external_id zu identifizieren.

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 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 ob der Alias den betreffenden Nutzer:innen nie hinzugefügt wurde.

Voraussetzungen

Um diesen Endpunkt zu verwenden, benötigen Sie einen API-Schlüssel mit der Berechtigung users.alias.new.

Rate-Limit

Wir wenden ein gemeinsames Rate-Limit von 20.000 Anfragen pro Minute auf diesen Endpunkt an. Dieses Rate-Limit wird mit den Endpunkten /users/delete, /users/identify, /users/merge und /users/alias/update geteilt, wie in API-Rate-Limits dokumentiert.

Anfragetext

1
2
Content-Type: application/json
Authorization: Bearer YOUR_REST_API_KEY

1
2
3
{
  "user_aliases" : (required, array of new user alias object)
}

Anfrageparameter

Anfragetext des Endpunkts mit Spezifikation des neuen Nutzer-Alias-Objekts

1
2
3
4
5
{
  "external_id" : (optional, string),
  "alias_name" : (required, string),
  "alias_label" : (required, string)
}

Beispielanfrage

1
2
3
4
5
6
7
8
9
10
11
12
curl --location --request POST 'https://rest.iad-01.braze.com/users/alias/new' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_REST_API_KEY' \
--data-raw '{
  "user_aliases" :[
    {
      "external_id": "external_identifier",
      "alias_name" : "example_name",
      "alias_label" : "example_label"
    }
  ]
}'

Antwort

Wenn ein Alias übersprungen wird, weil dieselbe Kombination aus alias_label und alias_name bereits für Nutzer:innen existiert, kann der Antworttext trotzdem Erfolg anzeigen. Weitere Details finden Sie unter Wenn Alias-Label und -Name bereits existieren.

1
2
3
4
{
    "aliases_processed": 1,
    "message": "success"
}