Das AppboyKit (auch bekannt als Objective-C SDK) wird nicht mehr unterstützt und wurde durch das Swift SDK. ] ersetzt. Es wird keine neuen Features, Fehlerbehebungen, Sicherheitsupdates oder technischen Support mehr erhalten - Messaging und Analytics werden jedoch weiterhin wie gewohnt funktionieren. Weitere Informationen finden Sie unter Einführung in das neue Braze Swift SDK.
Benutzer-IDs für iOS festlegen
Für jeden Ihrer Benutzer sollten Benutzer-IDs festgelegt werden. Diese sollten unveränderlich und zugänglich sein, wenn ein Benutzer die App öffnet. Die richtige Benennung Ihrer Benutzer-IDs von Anfang an ist einer der wichtigsten Schritte bei der Einrichtung von Benutzer-IDs. Wir empfehlen dringend die Verwendung des Braze-Standards für UUIDs und GUIDs (siehe unten). Wir empfehlen Ihnen außerdem dringend, diese Kennung anzugeben, da Sie damit die Möglichkeit haben:
- Verfolgen Sie Ihre Nutzer geräte- und plattformübergreifend und verbessern Sie so die Qualität Ihrer verhaltensbezogenen und demografischen Daten.
- Importieren Sie Daten über Ihre Benutzer mit unserer Benutzerdaten-API.
- Richten Sie sich mit unserer Messaging-API für allgemeine und transaktionsbezogene Nachrichten an bestimmte Nutzer.
Wenn eine solche Kennung nicht verfügbar ist, weist Braze Ihren Benutzern eine eindeutige Kennung zu, aber Ihnen fehlen dann die für Benutzer-IDs aufgeführten Möglichkeiten. Sie sollten es vermeiden, Benutzer-IDs für Benutzer festzulegen, für die Sie keinen eindeutigen Bezeichner haben, die mit ihnen als Individuum verbunden ist. Die Übergabe eines Gerätebezeichners bietet keinen Vorteil gegenüber der automatischen anonymen Benutzerverfolgung, die Braze standardmäßig anbietet.
Wenn Sie einen identifizierbaren Wert als Nutzer:innen-ID verwenden möchten, empfehlen wir Ihnen, zur zusätzlichen Sicherheit unser SDK-Authentifizierungs-Feature hinzuzufügen, um Identitätswechsel zu verhindern.
Vorgeschlagene Namenskonvention für Nutzer:in
Wir bei Braze empfehlen dringend, Nutzer-IDs, die auch als externe IDs bezeichnet werden, in einem UUIDs- und GUIDs-Format zu benennen. UUIDs und GUIDs sind universell eindeutige Bezeichner, die aus einer 128-Bit-Zahl bestehen und zur Identifizierung von Informationen in Computersystemen verwendet werden. Das bedeutet, dass diese UUIDs lang, zufällig und gut verteilt sind. Wenn Sie eine andere Methode wählen, um Ihre Nutzer-IDs zu benennen, müssen diese ebenfalls lang, zufällig und gut verteilt sein. Beachten Sie bitte auch, dass bei Nutzer-IDs zwischen Groß- und Kleinschreibung unterschieden wird. Zum Beispiel ist „Abcdef“ ein:e andere Nutzer:in als „abcdef“.
Wenn Sie feststellen, dass Ihre Nutzer-IDs Namen, E-Mail-Adressen, Zeitstempel oder Inkrementoren enthalten, empfehlen wir Ihnen, eine neue, sicherere Benennungsmethode zu verwenden, damit Ihre Nutzer-IDs nicht so leicht zu erraten sind oder ein Identitätswechsel möglich wird. Wenn Sie dies in Ihre Nutzer-IDs aufnehmen möchten, empfehlen wir Ihnen dringend, unser SDK-Authentifizierungs-Feature hinzuzufügen, um einen Identitätswechsel zu verhindern.
Die Weitergabe dieser Informationen an Dritte kann es Personen außerhalb Ihres Unternehmens ermöglichen, Informationen über die Struktur Ihrer Nutzer-IDs zu erhalten, wodurch Ihr Unternehmen für potenziell böswillige Updates oder die Entfernung von Informationen anfällig wird. Die Wahl der richtigen Namenskonvention von Anfang an ist einer der wichtigsten Schritte bei der Einrichtung von Nutzer-IDs. Eine Migration ist jedoch über unseren Endpunkt für die externe ID-Migration möglich.
| Benennung von Nutzer-IDs | |
|---|---|
| Empfohlen | Nicht empfohlen |
| 123e4567-e89b-12d3-a456-836199333115 | JonDoe829525552 |
| 8c0b3728-7fa7-4c68-a32e-12de1d3ed2d5 | [email protected] |
| f0a9b506-3c5b-4d86-b16a-94fc4fc3f7b0 | CompanyName-1-2-19 |
| 2d9e96a1-8f15-4eaf-bf7b-eb8c34e25962 | jon-doe-1-2-19 |
Zuweisung einer Nutzer:in ID
Sobald der Nutzer identifiziert ist (in der Regel nach dem Einloggen), sollten Sie den folgenden Aufruf tätigen, um die Nutzer-ID festzulegen:
1
[[Appboy sharedInstance] changeUser:@"YOUR_USER_ID_STRING"];
1
Appboy.sharedInstance()?.changeUser("YOUR_USER_ID")
Rufen Sie changeUser() nicht auf, wenn sich ein Nutzer abmeldet. changeUser() darf nur beim Anmelden aufgerufen werden. Wenn Sie changeUser() auf einen statischen Standardwert setzen, werden ALLE Benutzeraktivitäten mit diesem “Standardnutzer” verknüpft, bis eine erneute Anmeldung erfolgt.
Stellen Sie sicher, dass Sie diese Methode im Haupt-Thread Ihrer Anwendung aufrufen. Der asynchrone Aufruf der Methode kann zu undefiniertem Verhalten führen.
Außerdem empfehlen wir, die ID nicht zu ändern, wenn sich ein Nutzer:innen abmeldet, da Sie dann den zuvor angemeldeten Nutzer:innen nicht mit erneuten Interaktionen ansprechen können. Wenn Sie mit mehreren Nutzern auf demselben Gerät rechnen, aber nur einen von ihnen ansprechen möchten, wenn sich Ihre App im abgemeldeten Zustand befindet, empfehlen wir Ihnen, die ID des Nutzers, den Sie ansprechen möchten, während Sie abgemeldet sind, separat zu verfolgen und im Rahmen des Abmeldevorgangs Ihrer App wieder zu dieser ID zu wechseln.
Best Practices und Hinweise zur Integration von Nutzer:in
Automatische Speicherung des anonymen Nutzerverlaufs
| Identifizierungskontext | Speicherverhalten |
|---|---|
| Nutzer:in wurde zuvor nicht identifiziert | Der anonyme Verlauf wird bei der Identifizierung mit dem Nutzerprofil zusammengeführt. |
| Nutzer:in wurde zuvor in der App oder über die API identifiziert | Der anonyme Verlauf wird bei der Identifizierung nicht mit dem Nutzerprofil zusammengeführt. |
Unter Identifizierte Nutzerprofile finden Sie weitere Informationen darüber, was passiert, wenn Sie anonyme Nutzer:innen identifizieren.
Zusätzliche Hinweise und Best Practices
Beachten Sie Folgendes:
- Wenn Ihre App von mehreren Personen genutzt wird, können Sie jeder/jedem Nutzer:in einen eindeutigen Bezeichner zuweisen, um sie/ihn zu verfolgen.
- Nachdem eine Nutzer-ID festgelegt wurde, können Sie diese:n Nutzer:in nicht mehr in ein anonymes Profil zurückversetzen.
- Ändern Sie die Nutzer-ID nicht, wenn sich ein:e Nutzer:in abmeldet, da dies das Gerät vom Nutzerprofil trennen kann.
- Infolgedessen können Sie die zuvor abgemeldeten Nutzer:innen nicht mit Nachrichten zur erneuten Interaktion ansprechen. Wenn Sie mit mehreren Nutzer:innen auf demselben Gerät rechnen, aber nur eine:n von ihnen ansprechen möchten, wenn sich Ihre App im abgemeldeten Zustand befindet, empfehlen wir Ihnen, die Nutzer-ID, die Sie ansprechen möchten, während der Abmeldung separat zu verfolgen und im Rahmen des Abmeldevorgangs Ihrer App wieder zu dieser Nutzer-ID zu wechseln. Standardmäßig erhält nur der/die zuletzt angemeldete Nutzer:in Push-Benachrichtigungen von Ihrer App.
- Der Wechsel von einem/einer identifizierten Nutzer:in zu einem/einer anderen ist ein relativ kostspieliger Vorgang.
- Wenn Sie den Nutzerwechsel anfordern, wird die aktuelle Sitzung für den/die vorherige:n Nutzer:in automatisch geschlossen und eine neue Sitzung gestartet. Braze stellt automatisch eine Datenaktualisierungsanfrage für In-App-Nachrichten und andere Braze-Ressourcen für den/die neue:n Nutzer:in.
Wenn Sie sich dafür entscheiden, einen Hash eines eindeutigen Bezeichners als Ihre Nutzer-ID zu verwenden, stellen Sie sicher, dass Sie die Eingabe für Ihre Hash-Funktion normalisieren. Wenn Sie z. B. einen Hash einer E-Mail-Adresse verwenden, sollten Sie sicherstellen, dass Sie führende und abschließende Leerzeichen aus der Eingabe entfernen und die Lokalisierung berücksichtigen.
User:innen Aliasing
Ein Benutzer-Alias dient als alternativer eindeutiger Benutzeridentifikator. Sie können Aliasnamen verwenden, um Benutzer anhand anderer Dimensionen als Ihrer Haupt-Benutzer-ID zu identifizieren:
- Legen Sie eine einheitliche Kennung für die Analyse fest, die einen bestimmten Benutzer sowohl vor als auch nach der Anmeldung bei einer mobilen App oder Website verfolgt.
- Fügen Sie die von einem Drittanbieter verwendeten Bezeichner zu Ihren Unternehmensnutzer:innen hinzu, um Ihre Daten extern leichter abgleichen zu können.
Jeder Alias besteht aus zwei Teilen: einem Namen für den Bezeichner selbst und einer Bezeichnung, die den Typ des Alias angibt. Benutzer können mehrere Aliasnamen mit unterschiedlichen Bezeichnungen haben, aber nur einen Namen pro Bezeichnung.
Weitere Informationen zum Einrichten von Benutzer-Aliasnamen für ein Benutzerprofil finden Sie unter Benutzer-Aliasnamen.
1
[[Appboy sharedInstance].user addAlias:ALIAS_NAME withLabel:ALIAS_LABEL];
1
Appboy.sharedInstance()?.user.addAlias(ALIAS_NAME, ALIAS_LABEL)