Skip to content

Nutzer-IDs festlegen

Erfahren Sie, wie Sie Nutzer-IDs über das Braze SDK festlegen. Dabei handelt es sich um eindeutige Bezeichner, mit denen Sie Nutzer:innen geräte- und plattformübergreifend tracken, ihre Daten über die Nutzerdaten-API importieren und gezielte Nachrichten über die Messaging-API versenden können. Wenn Sie einer Nutzer:in keine eindeutige ID zuweisen, weist Braze stattdessen eine anonyme ID zu. Solange Sie dies nicht tun, können Sie diese Features jedoch nicht nutzen.

Über anonyme Nutzer:innen

Nachdem Sie das Braze SDK integriert haben, werden Nutzer:innen, die Ihre App zum ersten Mal starten, als “anonym” betrachtet, bis Sie die Methode changeUser aufrufen und ihnen eine external_id zuweisen. Einmal zugewiesen, können Sie sie nicht wieder anonymisieren. Wenn sie jedoch Ihre App deinstallieren und neu installieren, werden sie wieder anonym, bis changeUser aufgerufen wird.

Wenn ein zuvor identifizierter Nutzer eine Sitzung auf einem neuen Gerät beginnt, werden alle seine anonymen Aktivitäten automatisch mit seinem bestehenden Profil synchronisiert, nachdem Sie changeUser auf diesem Gerät über seinen external_id aufgerufen haben. Dazu gehören alle Attribute, Ereignisse oder Verläufe, die während der Sitzung auf dem neuen Gerät gesammelt wurden.

Anonymes Nutzer-Tracking verhindern

Wenn Ihr Anwendungsfall erfordert, dass keine Daten erfasst werden, bevor eine Nutzer:in identifiziert wurde, können Sie die Initialisierung des Braze SDK verzögern, bis sich die Nutzer:in anmeldet und eine external_id verfügbar ist. Setzen Sie in Ihrem Code ein Flag, das auf true wechselt, wenn sich die Nutzer:in anmeldet, und initialisieren Sie das SDK erst, wenn dieses Flag gesetzt ist.

Nutzer-ID festlegen

Um eine Nutzer-ID festzulegen, rufen Sie die Methode changeUser() auf, nachdem sich die Nutzer:in das erste Mal angemeldet hat. IDs sollten eindeutig sein und unseren Best Practices für die Namensgebung entsprechen.

Wenn Sie stattdessen einen eindeutigen Bezeichner hashen, stellen Sie sicher, dass Sie die Eingabe Ihrer Hashing-Funktion normalisieren. Wenn Sie zum Beispiel eine E-Mail-Adresse hashen, entfernen Sie alle führenden und nachfolgenden Leerzeichen und berücksichtigen Sie die Lokalisierung.

Für eine Standard-Web-SDK-Implementierung können Sie die folgende Methode verwenden:

1

braze.changeUser(YOUR_USER_ID_STRING);

Wenn Sie stattdessen den Google Tag Manager verwenden möchten, können Sie den Tag-Typ Change User verwenden, um die changeUser-Methode aufzurufen. Verwenden Sie ihn immer dann, wenn sich eine Nutzer:in anmeldet oder anderweitig mit dem eindeutigen external_id-Bezeichner identifiziert wird.

Achten Sie darauf, die eindeutige ID der aktuellen Nutzer:in in das Feld External User ID einzugeben, das in der Regel mit einer von Ihrer Website gesendeten Datenschichtvariablen gefüllt wird.

Ein Dialogfeld mit den Konfigurationseinstellungen für Braze Action Tags. Die enthaltenen Einstellungen sind „tag type“ und „external user ID“.

1

Braze.getInstance(context).changeUser(YOUR_USER_ID_STRING);

1

Braze.getInstance(context).changeUser(YOUR_USER_ID_STRING)

1

AppDelegate.braze?.changeUser(userId: "YOUR_USER_ID")

1

[AppDelegate.braze changeUser:@"YOUR_USER_ID_STRING"];

1

BrazePlugin.changeUser("YOUR_USER_ID");

1

m.Braze.setUserId(YOUR_USER_ID_STRING)

1

AppboyBinding.ChangeUser("YOUR_USER_ID_STRING");

1

Braze.changeUser("YOUR_USER_ID_STRING");

Funktionsweise von changeUser()

Wenn Sie changeUser() aufrufen, gelten die folgenden Verhaltensweisen:

  • Der Aufruf von changeUser() mit derselben Nutzer-ID, die bereits gesetzt ist, hat keine Auswirkung auf die Sitzungsanzahl.
  • Der Aufruf von changeUser() mit einer anderen Nutzer-ID beendet automatisch die aktuelle Sitzung und startet eine neue.
  • Wenn eine anonyme Nutzer:in changeUser() mit einer neuen Nutzer-ID aufruft (die in Braze noch nicht existiert), werden die Daten des anonymen Profils in das neue identifizierte Profil zusammengeführt.
  • Wenn eine anonyme Nutzer:in changeUser() mit einer bestehenden Nutzer-ID aufruft, werden die Daten des anonymen Profils nicht in das identifizierte Profil zusammengeführt.

Nutzer-Aliasse

Funktionsweise

Obwohl anonyme Nutzer:innen nicht über external_ids verfügen, können Sie ihnen stattdessen einen Nutzer-Alias zuweisen. Sie sollten einen Nutzer-Alias zuweisen, wenn Sie dem Nutzer:in andere Bezeichner hinzufügen möchten, aber nicht wissen, wie sein external_id lautet (z.B. weil er nicht angemeldet ist). Mit User-Aliasing können Sie auch Nutzer:in:

  • Verwenden Sie die Braze API, um Ereignisse und Attribute zu protokollieren, die anonymen Nutzer:innen zugeordnet sind.
  • Verwenden Sie den Segmentierungsfilter Externe ID ist leer, um anonyme Nutzer:innen in Ihrem Messaging zu targetieren.

Nutzer-Alias einrichten

Ein Nutzer-Alias besteht aus zwei Teilen: einem Namen und einem Label. Der Name referenziert den Bezeichner selbst, während das Label auf den Typ des Bezeichners verweist, zu dem er gehört. Wenn Sie z. B. eine Nutzer:in in einer Kund:innen-Support-Plattform eines Drittanbieters mit der externen ID 987654 haben, können Sie in Braze einen Alias mit dem Namen 987654 und dem Label support_id zuweisen, damit Sie die Nutzer:in plattformübergreifend tracken können.

1

braze.getUser().addAlias(ALIAS_NAME, ALIAS_LABEL);

1

Braze.getInstance(context).getCurrentUser().addAlias(ALIAS_NAME, ALIAS_LABEL);

1

Braze.getInstance(context).currentUser?.addAlias(ALIAS_NAME, ALIAS_LABEL)

1

Appboy.sharedInstance()?.user.addAlias(ALIAS_NAME, ALIAS_LABEL)

1

 [[Appboy sharedInstance].user addAlias:ALIAS_NAME withLabel:ALIAS_LABEL];

1
2
3
4

{
  "alias_name" : (required, string),
  "alias_label" : (required, string)
}

1

Braze.addAlias("ALIAS_NAME", "ALIAS_LABEL");

Best Practices für die ID-Benennung

Wir empfehlen Ihnen, Nutzer-IDs nach dem UUID-Standard (Universally Unique Identifier) zu erstellen, d. h. es handelt sich um 128-Bit-Strings, die zufällig und gut verteilt sind.

Alternativ können Sie einen vorhandenen eindeutigen Bezeichner (z. B. einen Namen oder eine E-Mail-Adresse) hashen, um Ihre Nutzer-IDs zu generieren. Wenn Sie dies tun, stellen Sie sicher, dass Sie eine SDK-Authentifizierung implementieren, damit Sie einen Identitätswechsel verhindern können.

Es ist zwar wichtig, dass Sie Ihre Nutzer-IDs von Anfang an richtig benennen, aber Sie können sie in Zukunft jederzeit mit dem /users/external_ids/rename-Endpunkt umbenennen.
New Stuff!