Push-Aktivierung und Push-Abo
Dieser Referenzartikel behandelt die Konzepte der Push-Aktivierung und der Push-Abo-Status in Braze, einschließlich der grundlegenden Verhaltensunterschiede zwischen iOS, Android und Web.
Push-Abo-Status
Ein „Push-Abo-Status“ in Braze identifiziert die globale Präferenz einer Nutzer:in für den Empfang von Push-Benachrichtigungen. Da der Abo-Status nutzerbasiert ist, ist er nicht auf eine bestimmte App begrenzt. Abo-Status werden zu hilfreichen Kennzeichnungen, wenn Sie entscheiden, welche Nutzer:innen Sie für Push-Benachrichtigungen ansprechen möchten.

Der Push-Abo-Status einer Nutzer:in gilt für das gesamte Nutzerprofil, das alle Geräte der Nutzer:in umfasst.
Die folgenden Abo-Statusoptionen sind verfügbar: Subscribed, Opted-In und Unsubscribed.
Standardmäßig muss der Push-Abo-Status Ihrer Nutzer:innen entweder Subscribed oder Opted-In sein und sie müssen Push-Benachrichtigungen im Vordergrund aktiviert haben, damit sie Ihre Nachrichten per Push erhalten können. Sie können diese Einstellung bei Bedarf beim Verfassen einer Nachricht außer Kraft setzen.
| Einwilligungsstatus | Beschreibung |
|---|---|
Subscribed |
Standard-Push-Abo-Status, wenn ein Nutzerprofil in Braze erstellt wird. |
Opted-In |
Eine Nutzer:in hat sich ausdrücklich für den Erhalt von Push-Benachrichtigungen entschieden. Braze setzt den Opt-in-Status einer Nutzer:in automatisch auf Opted-In, wenn die Nutzer:in eine Push-Aufforderung auf Betriebssystemebene akzeptiert.Dies gilt nicht für Nutzer:innen von Android 12 oder darunter. |
Unsubscribed |
Eine Nutzer:in hat sich über Ihre Anwendung oder andere von Ihrer Marke angebotene Methoden explizit von Push abgemeldet. Standardmäßig richten sich Braze-Push-Campaigns nur an Nutzer:innen, die für Push Subscribed oder Opted-in sind. |

Braze ändert den Push-Abo-Status einer Nutzer:in nicht automatisch in Unsubscribed. Beachten Sie, dass wenn der Push-Abo-Status einer Nutzer:in Unsubscribed ist, der Filter Foreground Push Enabled der Nutzer:in in der Segmentierung false ist.
Push-Registrierung und erreichbare Nutzer:innen
Der Push-Abo-Status spiegelt die Präferenz einer Nutzer:in wider, aber ob sie im Dashboard als erreichbar für Push gezählt wird, hängt auch von der Push-Registrierung ab – also davon, ob ein gültiges Vordergrund-Push-Token in ihrem Profil vorhanden ist. Informationen dazu, wie Braze kanalspezifische Zählungen berechnet, finden Sie unter Segmentgröße messen.
- Push-Campaigns und Canvases: Nutzer:innen, die nicht für Push registriert sind, werden in den Zielgruppenstatistiken nicht unter Erreichbare Nutzer:innen für Android-Push oder iOS-Push aufgeführt, selbst wenn ihr Push-Abo-Status
SubscribedoderOpted-Inist. - Andere Kanäle: Dieselben Nutzer:innen können weiterhin als erreichbar für andere Kanäle gezählt werden, für die sie qualifiziert sind (zum Beispiel E-Mail oder In-App-Nachrichten).
- Segmente: Die Segment-Zugehörigkeit richtet sich nach Ihren Filtern. Nutzer:innen ohne Push-Registrierung bleiben im Segment, es sei denn, ein Filter schließt sie aus (zum Beispiel Foreground Push Enabled). Die Gesamtzahl der Segment-Mitglieder kann höher sein als die Summe der Nutzer:innen, die in den Push-spezifischen Zeilen Erreichbare Nutzer:innen angezeigt werden.
Ein Nutzerprofil kann den Push-Abo-Status Subscribed anzeigen, obwohl kein Push-Token zugewiesen ist. Diese Nutzer:innen werden erst dann unter Erreichbare Nutzer:innen für Android-Push oder iOS-Push gezählt, wenn Braze ein gültiges Token erfasst.
Filterdefinitionen finden Sie unter Segmentierungsfilter.
Push-Abo-Status aktualisieren
Im Folgenden finden Sie die verschiedenen Möglichkeiten, den Push-Abo-Status einer Nutzer:in zu aktualisieren:
Automatisches Opt-in (Standard)
Standardmäßig setzt Braze den Push-Abo-Status einer Nutzer:in auf Opted-In, wenn sie zum ersten Mal Push-Benachrichtigungen für Ihre App autorisiert. Braze tut dies auch, wenn eine Nutzer:in die Push-Berechtigungen in den Systemeinstellungen wieder aktiviert, nachdem sie diese zuvor deaktiviert hatte.
Um dieses Standardverhalten zu deaktivieren, fügen Sie die folgende Eigenschaft in die Datei braze.xml Ihres Android Studio-Projekts ein:
1
<bool name="com_braze_optin_when_push_authorized">false</bool>
Bei iOS zeigt eine Neuinstallation den Push-Abo-Status in der Regel als Subscribed an, bis die Nutzer:in Benachrichtigungen erlaubt. Nachdem die Nutzer:in Erlauben in der Betriebssystem-Aufforderung ausgewählt hat, setzt Braze den Status auf Opted-In, wenn das automatische Opt-in aktiviert ist. Wenn die Nutzer:in Nicht erlauben auswählt und Push später in den iOS-Einstellungen aktiviert, wird der Status aktualisiert, nachdem die Nutzer:in eine Sitzung protokolliert – nicht in dem Moment, in dem sie die Einstellungen ändert.
Ab Braze Swift SDK Version 7.5.0 können Sie dieses Verhalten deaktivieren oder weiter anpassen, indem Sie die Konfiguration optInWhenPushAuthorized zur Datei AppDelegate.swift Ihres Xcode-Projekts hinzufügen:
1
2
3
4
configuration.optInWhenPushAuthorized = false // disables the default behavior
let braze = Braze(configuration: configuration)
AppDelegate.braze = braze
SDK-Integration
Sie können den Abo-Status einer Nutzer:in mit dem Braze SDK über die Methode setPushNotificationSubscriptionType auf Web, Android oder iOS aktualisieren. Sie können diese Methode zum Beispiel verwenden, um eine Einstellungsseite in Ihrer App zu erstellen, auf der Nutzer:innen Push-Benachrichtigungen manuell aktivieren oder deaktivieren können.
REST API
Sie können den Abo-Status einer Nutzer:in mit der Braze REST API aktualisieren, indem Sie den /users/track-Endpunkt verwenden, um das push_subscribe-Attribut zu aktualisieren.
Unterschiede zwischen Push-Aktivierung und Push-Abo-Status
Push-Aktivierung bezieht sich darauf, ob eine Nutzer:in auf Betriebssystem- oder Browserebene die Berechtigung erteilt hat, Benachrichtigungen auf einem bestimmten Gerät zu empfangen. Der Push-Abo-Status ist eine Einstellung auf Braze-Ebene, die die globale Präferenz einer Nutzer:in für den Empfang von Push-Benachrichtigungen über ihr gesamtes Profil hinweg darstellt.
Wenn das automatische Opt-in aktiviert ist (Standard), aktualisiert Braze den Push-Abo-Status einer Nutzer:in auf Opted-In, wenn sie Push-Benachrichtigungen für Ihre App autorisiert oder die Berechtigungen in den Systemeinstellungen wieder aktiviert (zum Beispiel unter iOS, Android 13+ und unterstützten Webbrowsern). Andernfalls bleibt der Push-Abo-Status der Nutzer:in Subscribed, bis Sie ihn explizit über eine SDK-Methode oder einen REST-API-Aufruf ändern.
Braze ändert den Push-Abo-Status einer Nutzer:in nicht automatisch in Unsubscribed, wenn sie sich auf Betriebssystem-, Browser- oder App-Ebene von Benachrichtigungen abmeldet. Um den Push-Abo-Status einer Nutzer:in zu aktualisieren, müssen Sie ihn in Braze aktualisieren. Wenn eine Nutzer:in beispielsweise Push über ein In-App-Präferenzzentrum deaktiviert, aktualisieren Sie den Push-Abo-Status in Braze auf Unsubscribed. Braze aktualisiert Nutzerprofile nicht basierend auf Ihrem Präferenzzentrum. Um Abo-Status mit den In-App-Präferenzen einer Nutzer:in abzugleichen, rufen Sie die entsprechenden Methoden über das SDK (iOS oder Android) oder die REST API auf.
Importierte Push-Token (iOS)
Wenn Sie iOS-Push-Token importieren mit push_token_import, ist der Push-Abo-Status der Nutzer:in in der Regel Subscribed, bis sie eine Sitzung in Ihrer Braze-integrierten App protokolliert. Nach der ersten Sitzung kann Braze den Status auf Opted-In aktualisieren, wenn das automatische Opt-in greift (zum Beispiel wenn die Nutzer:in Push unter iOS autorisiert und optInWhenPushAuthorized aktiviert ist).
Überprüfen Sie die Kontakteinstellungen im Profil der Nutzer:in nach dem Import und erneut nach der ersten In-App-Sitzung der Nutzer:in, um den erwarteten Status zu bestätigen.
Push-Abo-Status prüfen

Sie können den Push-Abo-Status einer Nutzer:in mit Braze auf eine der folgenden Arten überprüfen:
- Nutzerprofil: Sie können über das Braze-Dashboard auf der Seite Nutzersuche auf einzelne Nutzerprofile zugreifen. Nachdem Sie das Profil einer Nutzer:in 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:in anzuzeigen und manuell anzupassen.
- REST-API-Export: Mit den Endpunkten Nutzer:innen nach Segment oder Nutzer:innen nach Bezeichner können Sie einzelne Nutzerprofile im JSON-Format exportieren. Braze gibt ein Push-Token-Objekt zurück, das Push-Enablement-Informationen pro Gerät enthält.
Wo Push-Registrierung und -Status angezeigt werden
Sie können den Push-Abo-Status, die Registrierung und die Aktivierung an drei Hauptstellen in Braze überprüfen:
- Nutzerprofile im Tab Engagement
- Segmentierung im Segment-Builder
- Campaign- und Canvas-Analytics auf der Analytics-Seite jeder Nachricht
Nutzerprofile und Push-Änderungsprotokoll
Im Profil von Nutzer:innen (Nutzer:innen suchen > Nutzer:in auswählen > Tab Engagement) listet Contact Settings den Push-Abo-Status auf, Push Registered For (welche Apps und Plattformen Braze zum Senden von Vordergrund-Push an dieses Profil verwenden kann) und das Push-Änderungsprotokoll für Token-Verschiebungen, Fehler und Registrierungsupdates. Informationen zum Lesen von Push Registered For und zur Vordergrund- vs. Hintergrund-Autorisierung finden Sie unter Push-Registrierungsstatus überprüfen.
Unter iOS und Android kann das Push-Änderungsprotokoll einen Eintrag wie „Push token was updated from foreground push enabled to foreground push disabled“ enthalten, wenn ein Gerät von der Vordergrund-Push-Autorisierung zur reinen Hintergrund-Autorisierung wechselt (z. B. nachdem Nutzer:innen Benachrichtigungen in den Systemeinstellungen deaktiviert haben und das SDK die Änderung meldet).
Nachdem Sie neue SDK-Daten erwarten (z. B. direkt nach einer Testsitzung), wählen Sie Refresh im Nutzerprofil, wenn die Werte veraltet erscheinen. Es kann eine kurze Verzögerung zwischen dem Senden der SDK-Daten und der Aktualisierung des Profils mit der neuesten Push-Registrierung geben.
Für Nutzer:innen, die Sie einer internen Gruppe hinzufügen, wählen Sie Record User Events for group members in den Internal Group Settings für diese Gruppe, damit SDK-Anfragen im Protokoll erscheinen. Öffnen Sie dann das Event-Nutzerprotokoll unter Einstellungen > Event User Log, suchen Sie die SDK-Anfragen der Nutzer:innen und erweitern Sie den Roh-Payload. Sie können Felder wie remote_notification_enabled überprüfen, um zu validieren, ob das Gerät Remote-Benachrichtigungen als aktiviert oder deaktiviert meldet.
Segmentierung und Push-Filter
Im Segment-Builder verwenden Sie Filter wie Foreground Push Enabled, Foreground Push Enabled for App, Background or Foreground Push Enabled und Push-Abo-Filter, um Nutzer:innen nach Präferenz und Autorisierung auf Geräteebene anzusprechen oder zu prüfen. Unter iOS hängt es davon ab, ob Nutzer:innen die Betriebssystem-Aufforderung abgeschlossen, Einstellungen geändert oder provisorische Autorisierung verwenden, wie diese Filter für bestimmte Nutzer:innen gelesen werden; siehe iOS-Nutzer:innenaktionen und Push-Status und Weitere plattformspezifische Szenarien.
Campaign- und Canvas-Analytics
Auf der Analytics-Seite einer Push-Campaign oder eines Canvas spiegeln Metriken wie Gesendet, Bounces und Öffnungen die Zustellung und das Engagement für diesen Versand wider. Um diese Zahlen mit einzelnen Profilen abzugleichen, exportieren Sie Empfänger:innen aus Campaign Details oder Canvas Details über User Data (CSV). Schritte und Berechtigungen finden Sie unter Campaign-Daten exportieren und Canvas-Daten exportieren. Wenn die Zahlen zwischen Analytics und einem Export nicht übereinstimmen, siehe Campaign- und Canvas-Analytics in der Export-Fehlerbehebung.
iOS-Nutzer:innenaktionen und Push-Status
Die folgende Tabelle zeigt, wie verschiedene Nutzer:innenaktionen die iOS-Push-Aktivierung, die Vordergrund- oder Hintergrund-Push-Registrierung und den Push-Abo-Status in Braze beeinflussen. Wenn Nutzer:innen Ihre App installieren und ihre erste Sitzung starten, ist ihr Status in der Regel wie in der ersten Zeile dargestellt. Jede nachfolgende Aktion kann einige dieser Werte aktualisieren, andere jedoch nicht.
| Nutzer:innenaktion | Foreground Push Enabled |
Foreground Push Enabled for App |
Push-Registrierungstyp | Push-Abo-Status |
|---|---|---|---|---|
| Nutzer:in installiert die App und protokolliert eine Sitzung | false* |
Nicht aktualisiert | Hintergrund | Subscribed |
| Nutzer:in erhält die native iOS-Push-Abfrage und wählt Allow | true |
true |
Vordergrund | Opted-In** |
| Nutzer:in erhält die native iOS-Push-Abfrage und wählt Don’t Allow | false |
Nicht aktualisiert | Hintergrund | Nicht aktualisiert |
| Nutzer:in aktiviert Push in den Geräteeinstellungen und protokolliert eine Sitzung | true |
true |
Vordergrund | Opted-In** |
| Nutzer:in deaktiviert Push in den Geräteeinstellungen und protokolliert eine Sitzung | false |
false |
Hintergrund | Nicht aktualisiert |
| Nutzer:in löscht die App | Nicht aktualisiert | Aktualisiert, wenn Push-Token zurückgezogen wird | Aktualisiert, wenn Push-Token zurückgezogen wird | Nicht aktualisiert |
* Wenn die App kein provisorisches Push verwendet, ist Foreground Push Enabled false, bis Nutzer:innen Push-Benachrichtigungen erlauben. Wenn die App provisorisches Push verwendet, ist Foreground Push Enabled zu Beginn der ersten Sitzung true. Weitere Informationen finden Sie unter Provisorische Autorisierung und stilles Push.
** Ab Braze Swift SDK Version 7.5.0 steuert die Konfigurationseigenschaft optInWhenPushAuthorized, ob der Push-Abo-Status automatisch auf Opted-In gesetzt wird, wenn die Push-Berechtigung autorisiert wird. Weitere Informationen finden Sie unter Push-Abo-Status aktualisieren.
Push-Berechtigung
Alle Push-fähigen Plattformen – iOS, Web und Android – erfordern ein explizites Opt-in über eine Systemaufforderung auf Betriebssystemebene, mit einigen geringfügigen Unterschieden, die unten beschrieben werden.
Da die Entscheidung der Nutzer:innen endgültig ist und Sie nach einer Ablehnung nicht erneut fragen können, ist die Verwendung von Push-Primer-In-App-Nachrichten eine wichtige Strategie zur Steigerung Ihrer Opt-in-Raten.
Native Push-Berechtigungsaufforderungen des Betriebssystems
| Plattform | Screenshot | Beschreibung |
|---|---|---|
| iOS | ![]() |
Dies gilt nicht bei der Anforderung einer provisorischen Push-Berechtigung. |
| Android | ![]() |
Diese Push-Berechtigung wurde in Android 13 eingeführt. Vor Android 13 war keine Berechtigung zum Senden von Push erforderlich. |
| Web | ![]() |
Android
Vor Android 13 war keine Berechtigung zum Senden von Push-Benachrichtigungen erforderlich. Unter Android 12 und niedriger werden alle Nutzer:innen bei ihrer ersten Sitzung als Subscribed betrachtet, wenn Braze automatisch ein Push-Token anfordert. Zu diesem Zeitpunkt sind die Nutzer:innen Push-aktiviert mit einem gültigen Push-Token für dieses Gerät und einem Standard-Abo-Status von Subscribed.
Ab Android 13 muss die Push-Berechtigung von den Nutzer:innen angefragt und erteilt werden. Ihre App kann die Berechtigung manuell zu geeigneten Zeitpunkten anfordern. Falls nicht, werden die Nutzer:innen automatisch aufgefordert, wenn Ihre App einen Benachrichtigungskanal erstellt.
iOS

Ihre App kann provisorisches Push oder autorisiertes Push anfordern.
Autorisiertes Push erfordert eine explizite Genehmigung der Nutzer:innen, bevor Benachrichtigungen gesendet werden, während provisorisches Push es Ihnen ermöglicht, Benachrichtigungen still direkt an das Benachrichtigungscenter zu senden, ohne Ton oder Hinweis.
Provisorische Autorisierung und stilles Push
Vor iOS 12 (veröffentlicht 2018) mussten alle Nutzer:innen explizit dem Empfang von Push-Benachrichtigungen zustimmen.
In iOS 12 führte Apple die provisorische Autorisierung ein, die es Marken ermöglicht, stille Push-Benachrichtigungen an das Benachrichtigungscenter ihrer Nutzer:innen zu senden, bevor diese explizit zustimmen, und Ihnen so die Möglichkeit gibt, den Wert Ihrer Nachrichten frühzeitig zu demonstrieren. Weitere Informationen finden Sie unter Provisorische Autorisierung.
Web
Für Web müssen Sie ein explizites Opt-in der Nutzer:innen über den nativen Browser-Berechtigungsdialog anfordern.
Im Gegensatz zu iOS und Android, bei denen Ihre App die Berechtigungsaufforderung jederzeit anzeigen kann, zeigen einige moderne Browser die Aufforderung nur an, wenn sie durch eine „Nutzer:innengeste“ (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.
Daher sollten Sie die Berechtigung nur anfordern, wenn Nutzer:innen irgendwo auf Ihrer Website klicken, und nicht zufällig beim Laden einer Seite.
Push-Token
Push-Token sind eindeutige anonyme Bezeichner, die vom Gerät der Nutzer:innen generiert und an Braze gesendet werden, um zu identifizieren, wohin die Benachrichtigung der jeweiligen Empfänger:innen gesendet werden soll.
Es gibt zwei Arten, wie ein Push-Token klassifiziert werden kann, die für das Verständnis, wie eine Push-Benachrichtigung an Ihre Nutzer:innen gesendet werden kann, wesentlich sind.
- Vordergrund-Push bietet die Möglichkeit, reguläre sichtbare Push-Benachrichtigungen an den Vordergrund des Geräts der Nutzer:innen zu senden.
- Hintergrund-Push ist unabhängig davon verfügbar, ob ein bestimmtes Gerät dem Empfang von Push-Benachrichtigungen dieser Marke zugestimmt hat. Hintergrund-Push ermöglicht es Marken, stille Push-Benachrichtigungen – Benachrichtigungen, die absichtlich nicht angezeigt werden – an Geräte zu senden, um wichtige Funktionen wie Uninstall-Tracking zu unterstützen.
Wenn ein Nutzerprofil ein gültiges Vordergrund-Push-Token hat, das mit einer App verknüpft ist, betrachtet Braze die Nutzer:innen als „Push-registriert“ für die jeweilige App. Braze bietet dann einen spezifischen Segmentierungsfilter, Foreground Push Enabled for App,, um diese Nutzer:innen zu identifizieren.

Der Filter Foreground Push Enabled for App berücksichtigt nur das Vorhandensein eines gültigen Vordergrund- und Hintergrund-Push-Tokens für die jeweilige App. Der allgemeinere Filter Foreground Push Enabled segmentiert jedoch Nutzer:innen, die Push-Benachrichtigungen für beliebige Apps in Ihrem Workspace explizit aktiviert haben. Diese Zählung umfasst nur Vordergrund-Push und schließt Nutzer:innen aus, die sich abgemeldet haben. Weitere Informationen zu diesen und anderen Filtern finden Sie unter Segmentierungsfilter.
Mehrere Nutzer:innen auf einem Gerät
Push-Token sind sowohl geräte- als auch app-spezifisch, sodass es nicht möglich ist, Push-Token zur Unterscheidung mehrerer Nutzer:innen zu verwenden, die dasselbe Gerät nutzen.
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 verwendet, um sich aus Charlies Profil abzumelden und sich in ihr eigenes einzuloggen, wird das Push-Token Kims Profil zugewiesen. Das Push-Token bleibt dann auf diesem Gerät Kims Profil zugewiesen, bis sie sich abmeldet und Charlie sich wieder einloggt.
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 einloggen, wird das Push-Token den neuen Nutzer:innen zugewiesen. Dies wird im Nutzerprofil im Abschnitt Contact Settings des Tabs 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 eingeloggten Nutzer:innen, um zu bestimmen, welche Nutzer:innen auf dem Gerät für Push angesprochen werden sollen.
Mehrere Geräte und ein:e Nutzer:in
Der Push-Abo-Status ist nutzer:innenbasiert und nicht spezifisch für eine einzelne App. Der Status des Push-Abos ist der zuletzt gesetzte Wert. Wenn Nutzer:innen also Push-Benachrichtigungen zugestimmt haben, ist ihr Push-Abo-Status auf allen berechtigten Geräten Opted-In. Wenn Nutzer:innen sich später explizit über Ihre Anwendung oder andere von Ihrer Marke bereitgestellte Methoden von Push-Benachrichtigungen abmelden, wird ihr Push-Abo-Status auf Unsubscribed aktualisiert und keine Push-registrierten Geräte können Push-Benachrichtigungen empfangen.
Filter „Foreground Push Enabled“
Foreground Push Enabled ist ein Segmentierungsfilter in Braze, der es Marketern ermöglicht, einfach Nutzer:innen zu identifizieren, die Braze das Senden von Push-Benachrichtigungen erlauben, sowie Nutzer:innen, die keine Präferenz geäußert haben, keine Push-Benachrichtigungen zu erhalten.
Der Filter Foreground Push Enabled berücksichtigt Folgendes:
- Die Fähigkeit von Braze, eine Push-Benachrichtigung zu senden (Vordergrund-Push-Token)
- Die allgemeine Präferenz der Nutzer:innen, Push auf einem ihrer Geräte zu empfangen (Push-Abo-Status)

Nutzer:innen gelten als „Push-aktiviert“ oder „Push-registriert“, wenn sie ein aktives Vordergrund-Push-Token für eine App in Ihrem Workspace haben, was bedeutet, dass der Push-Aktivierungsstatus app-spezifisch ist.

Informationen zur Überprüfung des Push-Registrierungsstatus finden Sie unter Push-Registrierungsstatus.
Informationen zur Push-Registrierung und zum Änderungsprotokoll finden
Im Dashboard finden Sie Informationen zur Push-Registrierung und zu Push-Änderungsprotokollen unter:
- Segmentierung – Filtern Sie nach Abo-Status, Aktivierungsstatus sowie Vordergrund- und Hintergrund-Aktivierungsstatus der Nutzer:innen.
- Campaign Analytics – Zeigen Sie Push-Statistiken und Feedback für eine einzelne Campaign oder ein einzelnes Canvas an.
- Nutzerprofil (Tab „Engagement“) – Zeigen Sie Contact Settings und das Push-Änderungsprotokoll für bestimmte Nutzer:innen an.
Bei der Überprüfung des Push-Aktivierungsstatus zeigt Push Registered for an, für welche Plattformen Braze Vordergrund-Push an diese Nutzer:innen senden kann. Unter iOS und Android wird, wenn Nutzer:innen von Vordergrund-Push-aktiviert zu Hintergrund-Push-aktiviert (remote_notification_enabled) wechseln, dies im Push-Änderungsprotokoll als „Push token was updated from foreground push enabled to foreground push disabled“ dokumentiert.
Wenn Nutzer:innen als Testnutzer:innen hinzugefügt werden, zeigt das Nutzerprofil unter Entwicklungskonsole > Event User Log eine SDK-Anfrage mit remote_notification_enabled als true oder false an. Möglicherweise müssen Sie das Nutzerprofil aktualisieren, um die Updates zu sehen, da es eine kurze Verzögerung gibt, bis SDK-Updates das Nutzerprofil erreichen.
Segmentierungsfilter für den iOS-Push-Status:
- iOS Vordergrund- und Hintergrund-Push deaktiviert: Die Nutzer:innen haben noch keine Push-Aufforderung erhalten.
- iOS Hintergrund aktiviert: Die Nutzer:innen haben die Push-Aufforderung erhalten und abgelehnt, oder zugestimmt und später Push-Benachrichtigungen in ihren Geräteeinstellungen deaktiviert (wird nach einer Sitzung der Nutzer:innen aktualisiert).
- iOS Vordergrund aktiviert: Die Nutzer:innen haben die Push-Aufforderung erhalten und sind berechtigt, Vordergrund-Push zu empfangen.
Campaign Analytics spiegeln die Push-Statistiken entsprechend den oben genannten Details wider. Sie können auch die Nutzerprofile herunterladen, die in die Campaign oder das Canvas eingetreten sind, um Nutzerprofile abzugleichen.
Weitere plattformspezifische Szenarien
Wenn Nutzer:innen die native Push-Berechtigungsaufforderung akzeptieren, wird ihr Abo-Status auf opted in geändert.
Um Abos zu verwalten, können Sie die Nutzer:innenmethode setPushNotificationSubscriptionType verwenden, um eine Einstellungsseite für Präferenzen auf Ihrer Website zu erstellen, nach der Sie Nutzer:innen nach Opt-out-Status im Dashboard filtern können.
Wenn Nutzer:innen Benachrichtigungen in ihrem Browser deaktivieren, wird die nächste an diese Nutzer:innen gesendete Push-Benachrichtigung bouncen, und Braze wird das Push-Token der Nutzer:innen entsprechend aktualisieren. Dies wird verwendet, um die Berechtigung für die Push-aktivierten Filter (Background or Foreground Push Enabled, Foreground Push Enabled und Foreground Push Enabled for App) zu verwalten. Der im Nutzerprofil gesetzte Abo-Status ist eine Einstellung auf Nutzer:innenebene und ändert sich nicht, wenn ein Push bounct.
410 Web-Push-Token-Fehler {#410-web-push-token-errors}
Wenn Sie einen 410: Gone-Fehler erhalten, kann dies auftreten, wenn Nutzer:innen Web-Push-Benachrichtigungen über die Browsereinstellungen in ihrem Betriebssystem deaktivieren, sich als andere Nutzer:innen auf demselben Gerät einloggen oder die Website seit einiger Zeit nicht mehr besucht haben.
Wenn Sie einen 410: Endpoint Not Valid-Fehler erhalten, kann dies bedeuten, dass das Web-Push-Token (im Wesentlichen die URL) abgelaufen ist. Dies kann auftreten, wenn Nutzer:innen die Website nie wieder besuchen oder der Browser das Token ungültig macht. Es kann auch periodisch auftreten (oft alle paar Monate), abhängig vom Browser. Wenn Nutzer:innen die Website erneut besuchen und ihr Browser weiterhin auf „Allow“ eingestellt ist, erfasst Braze automatisch ein neues Token für das Gerät. Dies setzt voraus, dass die disablePushTokenMaintenance-Initialisierungsoption während der SDK-Initialisierung nicht verwendet wird.

Web-Plattformen erlauben kein Hintergrund- oder stilles Push.
Wenn Push-aktivierte Nutzer:innen Push in ihren Betriebssystemeinstellungen deaktivieren, geschieht zu Beginn der nächsten Sitzung Folgendes:
- Braze markiert sie als Vordergrund-Push-deaktiviert und versucht nicht mehr, ihnen Push-Nachrichten zu senden.
- Der Filter
Foreground Push Enabled for App (Android)und der SegmentierungsfilterForeground Push Enabled(vorausgesetzt, keine anderen Apps im Nutzerprofil haben ein gültiges Vordergrund-Push-Token) gebenfalsezurück.
In diesem Szenario können Sie, da ein Hintergrund-Push-Token weiterhin existiert, weiterhin Hintergrund-(stille) Push-Benachrichtigungen mit dem Segmentierungsfilter Background or Foreground Push Enabled = true senden.
Für Android betrachtet Braze Nutzer:innen als Push-deaktiviert, wenn:
- Nutzer:innen die App von ihrem Gerät deinstallieren.
- Eine Push-Nachricht aufgrund eines Bounces nicht zugestellt werden kann. Dies wird häufig durch eine Deinstallation verursacht, kann aber auch durch App-Updates, eine neue Push-Token-Version oder ein neues Format bedingt sein.
- Die Push-Registrierung bei Firebase Cloud Messaging fehlschlägt (manchmal verursacht durch schlechte Netzwerkverbindungen oder einen Fehler bei der Verbindung zu oder von FCM, um ein gültiges Token zurückzugeben).
- Nutzer:innen Push-Benachrichtigungen für die App in ihren Geräteeinstellungen blockieren und anschließend eine Sitzung protokollieren.

Sie können eine Android-Push-Benachrichtigung nur abfangen, wenn die App im Vordergrund oder Hintergrund läuft (aber noch aktiv ist). Sie können Benachrichtigungen nicht abfangen, wenn die App beendet oder vollständig geschlossen wurde.
Unabhängig davon, ob Nutzer:innen die Vordergrund-Push-Opt-in-Aufforderung akzeptieren, können Sie weiterhin Hintergrund-Push senden, wenn Sie Remote-Benachrichtigungen in Xcode aktiviert haben und Ihre App registerForRemoteNotifications() aufruft.
Wenn Ihre App provisorisch autorisiert ist oder die Nutzer:innen Push zugestimmt haben, erhalten sie ein Vordergrund-Push-Token, mit dem Sie ihnen alle Arten von Push senden können. Innerhalb von Braze betrachten wir Nutzer:innen unter iOS, die Vordergrund-Push-aktiviert sind, als Push-aktiviert, entweder explizit (auf App-Ebene) oder provisorisch (auf Geräteebene).
Wenn Nutzer:innen den Empfang von Push-Benachrichtigungen auf Betriebssystemebene ablehnen, ist ihr Push-Abo-Status Subscribed, und ihr Profil zeigt nicht an, dass ein Vordergrund-Push-Token registriert wurde.
In dem Szenario, dass Nutzer:innen, die zunächst auf Betriebssystemebene zugestimmt haben, Push-Benachrichtigungen in ihren Betriebssystemeinstellungen deaktivieren, geschieht beim nächsten Sitzungsstart Folgendes:
- Braze markiert sie als Vordergrund-Push-deaktiviert und versucht nicht mehr, Push-Nachrichten zu senden.
- Der Filter
Foreground Push Enabled for App (iOS)und der SegmentierungsfilterForeground Push Enabled(vorausgesetzt, keine anderen Apps im Nutzerprofil haben ein gültiges Vordergrund-Push-Token) gebenfalsezurück.
In diesem Szenario können Sie, da ein Hintergrund-Push-Token weiterhin existiert, weiterhin Hintergrund-(stille) Push-Benachrichtigungen mit dem Segmentierungsfilter Background or Foreground Push Enabled = true senden.

iOS erlaubt es Apps nicht, eine Push-Benachrichtigung abzufangen, bevor sie angezeigt wird. Das bedeutet, dass Apps (und Braze) keine Kontrolle darüber haben, ob die Benachrichtigung angezeigt oder ausgeblendet wird. Nutzer:innen können Push-Benachrichtigungen für eine App in den Geräteeinstellungen deaktivieren, aber dies wird vom Betriebssystem gesteuert.
Best Practices
Detaillierte Anleitungen zur Optimierung Ihrer Push-Nutzung bei Braze finden Sie in unserem speziellen Artikel zu Push-Best-Practices.


