Lebenszyklus von Push-Token
Dieser Artikel beschreibt den Prozess, durch den Nutzer:innen ein Push-Token zugewiesen bekommen, und wie Braze Push-Nachrichten an Ihre Nutzer:innen sendet.
Über Push-Token
Wenn eine App Push-Berechtigungen von einem Gerät anfordert, generiert der Push-Dienstanbieter des Geräts ein Push-Token für diese App. Jede App erhält ihr eigenes eindeutiges, anonymes Push-Token, das das Gerät und die aktuelle App-Instanz beim Senden einer Push-Benachrichtigung identifiziert.
Beachten Sie, dass Push-Token keine statischen Bezeichner sind, die ewig bestehen—sie können aktualisiert werden und sie können ablaufen.
Plattformspezifische Details finden Sie unter Push-Token-Registrierung.
Vordergrund- vs. Hintergrund-Push
Push-Token werden sowohl für Vordergrund- als auch für Hintergrund-Push-Benachrichtigungen verwendet.
| Typ | Opt-in erforderlich? | Beschreibung |
|---|---|---|
| Vordergrund-Push | Ja | Eine Benachrichtigung wird sichtbar angezeigt, während die App im Vordergrund ist. |
| Hintergrund-Push | Nein | Eine Benachrichtigung wird im Hintergrund still zugestellt, ohne angezeigt zu werden. Wird häufig für Funktionen wie Uninstall-Tracking verwendet. |
Wenn Nutzer:innen Push-Benachrichtigungen für Ihre App aktivieren, gelten sie als „push-registriert“, was bedeutet, dass sie mit dem Segmentierungsfilter Foreground Push Enabled for App in Braze angesprochen werden können.
Dies unterscheidet sich vom Segmentierungsfilter Foreground Push Enabled, der Nutzer:innen identifiziert, die Push für mindestens eine Ihrer Apps aktiviert haben – nicht für eine bestimmte App. Weitere Informationen finden Sie unter Segmentierungsfilter.
Mehrere Nutzer:innen auf einem Gerät
Push-Token sind sowohl für das Gerät als auch für die App eindeutig, was bedeutet, dass Push-Token nicht verwendet werden können, um bestimmte Nutzer:innen anzusprechen, wenn mehrere Nutzer:innen dasselbe Gerät verwenden.
Angenommen, Sie haben zwei Nutzer:innen: Charlie und Kim. Wenn Charlie Push-Benachrichtigungen für Ihre App auf seinem Telefon aktiviert hat und Kim Charlies Telefon nutzt, um sich aus Charlies Profil abzumelden und sich in ihr eigenes einzuloggen, wird das Push-Token Kims Profil zugewiesen. Das Push-Token bleibt dann Kims Profil auf diesem Gerät zugewiesen, bis sie sich abmeldet und Charlie sich wieder anmeldet.
Eine App oder Website kann nur ein Push-Abo pro Gerät haben. Wenn sich also Nutzer:innen von einem Gerät oder einer Website abmelden und neue Nutzer:innen sich anmelden, wird das Push-Token den neuen Nutzer:innen zugewiesen. Dies wird im Nutzerprofil im Abschnitt Contact Settings auf dem Tab Engagement angezeigt:
Da es für Push-Anbieter (APNs/FCM) keine Möglichkeit gibt, zwischen mehreren Nutzer:innen auf einem Gerät zu unterscheiden, übergeben wir das Push-Token an die zuletzt angemeldeten Nutzer:innen, um zu bestimmen, welche Nutzer:innen auf dem Gerät für Push angesprochen werden sollen.
Wenn Sie eine Fehlermeldung unter Contact Settings > Push Changelog sehen, finden Sie unter Häufige Push-Fehlermeldungen Erklärungen und nächste Schritte.
Push-Token-Registrierung
Jede Geräteplattform handhabt die Push-Token-Registrierung unterschiedlich. Plattformspezifische Details finden Sie im Folgenden:
Sie müssen ein explizites Opt-in von Nutzer:innen über den nativen Browser-Berechtigungsdialog anfordern. Ein Token wird nach dem Opt-in der Nutzer:innen empfangen. Anders als bei iOS und Android, wo Ihre App die Berechtigungsabfrage jederzeit anzeigen kann, zeigen einige moderne Browser die Abfrage nur an, wenn sie durch eine „Nutzeraktion“ (Mausklick oder Tastendruck) ausgelöst wird. Wenn Ihre Website versucht, die Push-Benachrichtigungsberechtigung beim Laden der Seite anzufordern, wird dies wahrscheinlich vom Browser ignoriert oder unterdrückt.
Wenn Ihre App installiert wird, wird automatisch ein Push-Token für Ihre App generiert—es kann jedoch nur für Hintergrund-Push-Benachrichtigungen verwendet werden, bis die Nutzer:innen explizit zustimmen. Zusätzlich wird die Registrierung je nach Android-Version unterschiedlich gehandhabt:
| Version | Details |
|---|---|
| Android 13 | Die Push-Berechtigung muss von den Nutzer:innen angefordert und gewährt werden. Ihre App kann die Berechtigung manuell anfordern, oder Nutzer:innen werden automatisch aufgefordert, nachdem ein Benachrichtigungskanal erstellt wurde. |
| Android 12 und früher | Alle Nutzer:innen gelten nach ihrer ersten Sitzung als Subscribed. Braze fordert zu diesem Zeitpunkt automatisch ein Push-Token an, wodurch die Nutzer:innen mit einem gültigen Token und dem Standard-Abo-Status Subscribed push-fähig werden. |
iOS generiert nicht automatisch Push-Token für eine App bei der Installation. Zusätzlich wird die Registrierung je nach iOS-Version unterschiedlich gehandhabt:
| Version | Vorläufige Autorisierung? | Details |
|---|---|---|
| iOS 12 | Ja | Wenn Nutzer:innen Push-Benachrichtigungen aktivieren, erhalten Sie eine Standard-Autorisierung, die es Ihnen ermöglicht, Vordergrund-Push-Benachrichtigungen zu senden. Sie können jedoch auch eine vorläufige Autorisierung anfordern, die es Ihnen ermöglicht, stille Hintergrund-Push-Benachrichtigungen direkt an die Mitteilungszentrale zu senden. |
| iOS 11 oder früher | Nein | Alle Nutzer:innen müssen explizit zustimmen, um Push-Benachrichtigungen zu erhalten. Ein Push-Token wird erst nach Erteilung der Berechtigung generiert. |
Push-Abo-Status von Nutzer:innen prüfen
Es gibt zwei Möglichkeiten, den Push-Abo-Status von Nutzer:innen mit Braze zu prüfen:
- Nutzerprofil: Sie können auf einzelne Nutzerprofile über das Braze-Dashboard auf der Seite Nutzersuche zugreifen. Nachdem Sie ein Nutzerprofil gefunden haben (über E-Mail-Adresse, Telefonnummer oder externe Nutzer-ID), können Sie den Tab Engagement auswählen, um den Abo-Status der Nutzer:innen einzusehen und manuell anzupassen.
- REST-API-Export: Sie können einzelne Nutzerprofile im JSON-Format exportieren, indem Sie die Endpunkte Nutzer:innen nach Segment oder Nutzer:innen nach Bezeichner verwenden. Braze gibt ein Push-Token-Objekt zurück, das Push-Aktivierungsinformationen pro Gerät enthält.
Push-Registrierungsstatus prüfen
Auf dem Tab Engagement im Nutzerprofil sehen Sie Push Registered For gefolgt von einem App-Namen. Wenn keine App-Informationen für dieses Gerät vorhanden sind, werden zwei Bindestriche (--) angezeigt. Für jedes Gerät, das den Nutzer:innen gehört, gibt es einen Eintrag.
Wenn dem App-Namen des Geräteeintrags Foreground: vorangestellt ist, ist die App berechtigt, sowohl Vordergrund-Push-Benachrichtigungen (für Nutzer:innen sichtbar) als auch Hintergrund-Push-Benachrichtigungen (für Nutzer:innen nicht sichtbar) auf diesem Gerät zu empfangen.
Wenn dem App-Namen des Geräteeintrags hingegen Background: vorangestellt ist, ist die App nur berechtigt, Hintergrund-Push zu empfangen, und kann keine für Nutzer:innen sichtbaren Benachrichtigungen auf diesem Gerät anzeigen. Dies bedeutet in der Regel, dass die Nutzer:innen Benachrichtigungen für die App auf diesem Gerät deaktiviert haben.
Wenn ein Push-Token auf demselben Gerät zu anderen Nutzer:innen verschoben wird, sind die ersten Nutzer:innen nicht mehr push-registriert.
Push-Token-Verwaltung
In der folgenden Tabelle finden Sie Aktionen, die zu Änderungen oder zur Entfernung von Push-Token aus Nutzerprofilen führen.
| Aktion | Beschreibung |
|---|---|
Methode changeUser() wird aufgerufen |
Die Braze-Methode changeUser() wechselt die Nutzer-ID, der die SDKs Nutzerverhaltens-Daten zuweisen. Diese Methode wird normalerweise aufgerufen, wenn sich Nutzer:innen in einer Anwendung anmelden. Wenn changeUser() mit einer anderen oder neuen Nutzer-ID auf einem bestimmten Gerät aufgerufen wird, wird das Push-Token dieses Geräts zum entsprechenden Braze-Profil mit der zugehörigen Nutzer-ID verschoben. |
| Push-Fehler tritt auf | Einige häufige Push-Fehler, die zur Token-Entfernung führen, sind MismatchSenderId, InvalidRegistration und andere Arten von Push-Bounces. Sehen Sie sich unsere vollständige Liste häufiger Push-Fehler an. |
| Nutzer:in deinstalliert die App | Wenn Nutzer:innen die Anwendung von einem Gerät deinstallieren, entfernt Braze das Push-Token aus dem Profil. |
Wie sieht das im größeren Maßstab aus?
Wenn Nutzer:innen eine neue Anwendung öffnen und über eine Push-Abfrage den Push-Zugriff gewähren, wird ein Aufruf vom Braze SDK an die Push-Anbieter gesendet. Bei diesem Aufruf prüft der Push-Anbieter, ob alles korrekt eingerichtet ist. Wenn ja, wird ein Push-Token an Ihr Gerät übergeben. Wenn dieses Token eintrifft, kommuniziert das SDK dies an Braze. Nachdem Braze das Token vom Push-Anbieter erhalten hat, aktualisieren oder erstellen wir ein neues Nutzerprofil. Diese Nutzer:innen gelten nun als registriert.
Wenn wir eine Campaign starten möchten, erstellen wir eine Campaign in Braze, die einen Push-Payload generiert, der an den Push-Anbieter gesendet wird. Von dort aus liefert der Anbieter den Push-Payload an das Gerät der Nutzer:innen, und das SDK übergibt den Messaging-Status an Braze.
| Registrierungsschritte | Messaging-Schritte |
|---|---|
| 1. Kund:in (Gerät) registriert sich beim Push-Anbieter 2. Anbieter generiert und liefert Push-Token 3. Token an Braze übermitteln |
1. Braze sendet Push-Payload an den Anbieter 2. Anbieter liefert den Push-Payload an das Gerät 3. SDK übergibt Messaging-Statistiken an Braze |
Häufig gestellte Fragen
Was passiert, wenn Nutzer:innen mit Opt-in meine App löschen und erneut herunterladen?
Angenommen, Nutzer:innen aktivieren Push, erhalten einige Push-Nachrichten und löschen dann die App. Dadurch wird die Push-Zustimmung auf Geräteebene entfernt. Ab hier führt der erste Bounce nach der Deinstallation automatisch dazu, dass diese Nutzer:innen von zukünftigen Push-Nachrichten abgemeldet werden. Wenn Nutzer:innen danach die App erneut installieren, aber nicht starten, kann Braze keinen Push an sie senden, da Push-Token für Ihre App nicht erneut gewährt wurden.
Wenn Nutzer:innen den Vordergrund-Push erneut aktivieren, ist außerdem ein Sitzungsstart erforderlich, um diese Informationen in ihrem Nutzerprofil zu aktualisieren und den Empfang von Push-Nachrichten zu ermöglichen.
Wann laufen Push-Token ab?
Leider definieren APNs und FCM dies nicht genau. Push-Token können ablaufen, wenn eine App aktualisiert wird, wenn Nutzer:innen ihre Daten auf ein neues Gerät übertragen oder wenn sie ein Betriebssystem neu installieren. Im Allgemeinen haben wir keinen genauen Einblick, warum Push-Anbieter bestimmte Push-Token ablaufen lassen.
Um dieser Unklarheit Rechnung zu tragen, registrieren und übermitteln unsere SDK-Push-Integrationen Token immer bei Sitzungsstart, um sicherzustellen, dass wir über das aktuellste Token verfügen.