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.
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 Kundenprofil 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 in den folgenden Abschnitten:
Sie müssen über den nativen Browser-Berechtigungsdialog eine ausdrückliche Zustimmung der Nutzer:innen einholen. Ein Token wird erst nach dem Opt-in der Nutzer:innen ausgestellt. Im Gegensatz zu iOS und Android, die Ihrer App erlauben, die Berechtigungsaufforderung jederzeit anzuzeigen, zeigen einige moderne Browser die Aufforderung nur an, wenn sie durch eine „Nutzergeste“ (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 – dieser kann jedoch nur für Hintergrund-Push-Benachrichtigungen verwendet werden, bis die Nutzer:innen ausdrücklich zugestimmt haben. Darüber hinaus wird die Registrierung je nach Android-Version unterschiedlich gehandhabt:
| Version | Details |
|---|---|
| Android 13 | Die Push-Berechtigung muss von den Nutzer:innen angefordert und erteilt werden. Ihre App kann die Berechtigung manuell anfordern, oder die Nutzer:innen werden automatisch aufgefordert, nachdem ein Benachrichtigungskanal erstellt wurde. |
| Android 12 und älter | Alle Nutzer:innen gelten nach ihrer ersten Sitzung als Subscribed. Braze fordert zu diesem Zeitpunkt automatisch ein Push-Token an, wodurch die Nutzer:innen push-fähig werden – mit einem gültigen Token und dem Standard-Abonnementstatus Subscribed. |
iOS generiert beim Installieren einer App nicht automatisch Push-Token. Darüber hinaus wird die Registrierung je nach iOS-Version unterschiedlich gehandhabt:
| Version | Provisorische Autorisierung? | Details |
|---|---|---|
| iOS 12 | Ja | Wenn Nutzer:innen sich für Push-Benachrichtigungen entscheiden, erhalten Sie eine Standardautorisierung, die es Ihnen ermöglicht, Vordergrund-Push-Benachrichtigungen zu senden. Sie können jedoch auch eine provisorische Autorisierung anfordern, die Ihnen erlaubt, stille Hintergrund-Push-Benachrichtigungen direkt an die Mitteilungszentrale zu senden. |
| iOS 11 oder älter | Nein | Alle Nutzer:innen müssen ausdrücklich zustimmen, um Push-Benachrichtigungen zu erhalten. Ein Push-Token wird erst nach Erteilung der Berechtigung generiert. |
Braze geht davon aus, dass importierte Push-Token gültige Vordergrund-Push-Token für Ihre App und Umgebung sind.
Beim Import von iOS-Token speichert Braze kein Apple Push Notification service (APNs)-Gateway (development oder production) für diese. Braze sendet an diese Token über das konfigurierte Gateway Ihrer App. Wenn ein Token für die andere Umgebung generiert wurde, lehnt APNs es mit BadDeviceToken ab und der Versand führt zu einem Bounce.
Braze speichert ein Gateway für das Token nur, wenn das SDK später dasselbe Token registriert und ein Gateway meldet.
Push-Abonnementstatus von Nutzer:innen überprüfen
Es gibt zwei Möglichkeiten, den Push-Abonnementstatus einer Nutzerin oder eines Nutzers in Braze zu überprüfen:
- Nutzerprofil: Sie können auf der Seite Nutzersuche im Braze-Dashboard auf einzelne Nutzerprofile 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 Abonnementstatus einer Nutzerin oder eines Nutzers 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 überprüfen
Auf dem Tab Engagement im Nutzerprofil sehen Sie Push Registered For gefolgt von einem App-Namen. Falls keine App-Informationen für dieses Gerät vorhanden sind, werden zwei Bindestriche (--) angezeigt. Für jedes Gerät, das der Nutzerin oder dem Nutzer gehört, gibt es einen Eintrag.
Wenn dem App-Namen des Geräteeintrags Foreground: vorangestellt ist, ist die App berechtigt, auf diesem Gerät sowohl Vordergrund-Push-Benachrichtigungen (für die Nutzer:innen sichtbar) als auch Hintergrund-Push-Benachrichtigungen (nicht sichtbar) zu empfangen.
Wenn dem App-Namen des Geräteeintrags hingegen Background: vorangestellt ist, ist die App nur berechtigt, Hintergrund-Push zu empfangen und kann auf diesem Gerät keine für Nutzer:innen sichtbaren Benachrichtigungen anzeigen. Dies bedeutet in der Regel, dass die Nutzer:innen die Benachrichtigungen für die App auf diesem Gerät deaktiviert haben.
Wenn ein Push-Token auf demselben Gerät zu einer anderen Nutzerin oder einem anderen Nutzer verschoben wird, ist die erste Person nicht mehr für 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 |
|---|---|
Aufruf der Methode changeUser() |
Die Braze-Methode changeUser() wechselt die Nutzer-ID, der die SDKs Nutzerverhaltensdaten zuordnen. Diese Methode wird in der Regel aufgerufen, wenn sich Nutzer:innen in einer App anmelden. Wenn changeUser() mit einer anderen oder neuen Nutzer-ID auf einem bestimmten Gerät aufgerufen wird, wird das Push-Token dieses Geräts auf das entsprechende Braze-Profil mit der zugehörigen Nutzer-ID verschoben. |
| Push-Fehler tritt auf | Einige häufige Push-Fehler, die zur Entfernung von Token führen, sind MismatchSenderId, InvalidRegistration und andere Arten von Push-Bounces. Sehen Sie sich unsere vollständige Liste der häufigen Push-Fehlercodes an. |
| Nutzer:in deinstalliert die App | Wenn Nutzer:innen die App von einem Gerät deinstallieren, entfernt Braze das Push-Token aus dem Profil. |
Wie sieht das im größeren Zusammenhang aus?
Wenn Nutzer:innen eine neue App öffnen und über eine Push-Aufforderung den Push-Zugriff gewähren, wird ein Aufruf vom Braze SDK an den Push-Anbieter gesendet. Bei diesem Aufruf prüft der Push-Anbieter, ob alles korrekt eingerichtet ist. Wenn ja, wird ein Push-Token an das Gerät übergeben. Sobald dieses Token eintrifft, kommuniziert das SDK dies an Braze. Nachdem Braze das Token vom Push-Anbieter erhalten hat, wird ein neues Nutzerprofil erstellt oder ein bestehendes aktualisiert. Diese Nutzer:innen gelten dann als registriert.
Wenn eine Campaign gestartet werden soll, wird in Braze eine Campaign erstellt, die einen Push-Payload generiert und an den Push-Anbieter sendet. Von dort aus liefert der Anbieter den Push-Payload an das Gerät der Nutzer:innen, und das SDK übermittelt 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 übermittelt Messaging-Statistiken an Braze |
Häufig gestellte Fragen
Was passiert, wenn ein:e Nutzer:in mit Opt-in meine App löscht und anschließend erneut herunterlädt?
Angenommen, ein:e Nutzer:in hat ein Push-Opt-in erteilt, erhält einige Push-Nachrichten und löscht dann die App. Dadurch wird die Push-Einwilligung auf Geräteebene entfernt. Ab diesem Zeitpunkt führt der erste gebouncte Push nach der Deinstallation automatisch dazu, dass diese:r Nutzer:in für zukünftige Push-Nachrichten abgemeldet wird. Wenn ein:e Nutzer:in danach die App erneut installiert, aber nicht öffnet, kann Braze keinen Push an diese:n Nutzer:in senden, da die Push-Token für Ihre App nicht erneut vergeben wurden.
Wenn ein:e Nutzer:in darüber hinaus Push-Benachrichtigungen im Vordergrund wieder aktiviert, wird ein Sitzungsstart benötigt, um diese Informationen im Nutzerprofil zu aktualisieren und den Empfang von Push-Nachrichten wieder zu ermöglichen.
Wann laufen Push-Token ab?
Leider definieren APNs und FCM dies nicht wirklich. 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. In den meisten Fällen haben wir keinen wirklichen Insight darüber, warum Push-Anbieter bestimmte Push-Token ablaufen lassen.
Um dieser Mehrdeutigkeit Rechnung zu tragen, registrieren und aktualisieren unsere SDK-Push-Integrationen Token immer beim Sitzungsstart, um sicherzustellen, dass wir über das aktuellste Token verfügen.