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.

Hinweis

Der Push-Abo-Status einer Nutzer:in gilt für das gesamte Kundenprofil, 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.

Wichtig

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 Subscribed oder Opted-In ist.
• 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).
• Segments: 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 Kundenprofil 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.

• android
• swift

1

<bool name="com_braze_optin_when_push_authorized">false</bool>

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. Weitere Informationen finden Sie unter Push-Abo-Status aktualisieren.

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:

• Kundenprofil: 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:

1. Nutzerprofile im Tab Engagement
2. Segmentierung im Segment-Builder
3. 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 Kundenprofil, 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.

^{* 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-Token.}

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 im folgenden Abschnitt beschrieben werden.

Da die Entscheidung der Nutzer:innen endgültig ist und Sie nach einer Ablehnung nicht erneut fragen können, sind Push-Primer-In-App-Nachrichten eine wichtige Strategie, um Ihre Opt-in-Raten zu erhöhen.

Native Push-Berechtigungsaufforderungen des Betriebssystems

Plattform	Screenshot	Beschreibung
iOS		Dies gilt nicht bei der Anforderung einer vorläufigen Push-Berechtigung.
Android		Diese Push-Berechtigung wurde in Android 13 eingeführt. Vor Android 13 war keine Berechtigung zum Senden von Push-Benachrichtigungen erforderlich.
Web

Android

Vor Android 13 war keine Berechtigung zum Senden von Push-Benachrichtigungen erforderlich. Unter Android 12 und darunter gelten alle Nutzer:innen ab ihrer ersten Sitzung als Subscribed, wenn Braze automatisch ein Push-Token anfordert. Zu diesem Zeitpunkt sind die Nutzer:innen Push-fähig 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 angefordert und erteilt werden. Ihre App kann die Berechtigung zu geeigneten Zeitpunkten manuell von den Nutzer:innen anfordern. Falls nicht, werden die Nutzer:innen automatisch aufgefordert, wenn Ihre App einen Benachrichtigungskanal erstellt.

iOS

Ihre App kann vorläufige Push-Benachrichtigungen oder autorisierte Push-Benachrichtigungen anfordern.

Autorisiertes Push erfordert eine explizite Berechtigung der Nutzer:innen, bevor Benachrichtigungen gesendet werden, während vorläufiges Push es Ihnen ermöglicht, Benachrichtigungen lautlos direkt an das Benachrichtigungscenter zu senden, ohne Ton oder Hinweis.

Vorläufige Autorisierung und lautloses Push

Vor iOS 12 (veröffentlicht 2018) mussten alle Nutzer:innen explizit dem Empfang von Push-Benachrichtigungen zustimmen.

Mit iOS 12 führte Apple die vorläufige Autorisierung ein, die es Marken ermöglicht, lautlose Push-Benachrichtigungen an das Benachrichtigungscenter ihrer Nutzer:innen zu senden, bevor diese explizit zustimmen. So haben Sie die Möglichkeit, den Wert Ihrer Nachrichten frühzeitig zu demonstrieren. Weitere Informationen finden Sie unter Vorläufige Autorisierung.

Web

Für Web müssen Sie ein explizites Opt-in der Nutzer:innen über den nativen Berechtigungsdialog des Browsers anfordern.

Anders als bei iOS und Android, wo Ihre App die Berechtigungsaufforderung jederzeit anzeigen kann, zeigen einige moderne Browser die Aufforderung nur an, wenn sie durch eine „Nutzeraktion“ (Mausklick oder Tastatureingabe) 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 dann 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 des Push-Benachrichtigungsversands an Ihre Nutzer:innen entscheidend sind.

1. Vordergrund-Push bietet die Möglichkeit, reguläre sichtbare Push-Benachrichtigungen an den Vordergrund des Geräts der Nutzer:innen zu senden.
2. Hintergrund-Push ist unabhängig davon verfügbar, ob ein bestimmtes Gerät den Empfang von Push-Benachrichtigungen dieser Marke aktiviert 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 besitzt, das mit einer App verknüpft ist, betrachtet Braze die Nutzer:innen als „Push-registriert“ für die jeweilige App. Braze stellt dann einen spezifischen Segmentierungsfilter bereit, Foreground Push Enabled for App, um diese Nutzer:innen zu identifizieren. Dieser Filter identifiziert Nutzer:innen, die für eine App Push-registriert sind, schränkt jedoch nicht ein, welche App eine Nachricht erhält. Um die Zustellung auf bestimmte Apps einzuschränken, verwenden Sie ein Segment, bei dem Apps and websites targeted auf Users from specific apps eingestellt ist. Fügen Sie in einem Canvas dieses Segment den Zustellungsvalidierungen jedes Nachrichtenschritts hinzu.

Hinweis

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 hingegen 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.

Bei einem kleinen Prozentsatz der Nutzer:innen können Verarbeitungsverzögerungen zu einer kurzfristigen Abweichung führen: Eine Nutzer:in hat möglicherweise ein gültiges Vordergrund-Push-Token in ihrem Profil, entspricht aber dennoch nicht dem Filter Foreground Push Enabled. Ihr Profil zeigt möglicherweise kurzzeitig an, dass Vordergrund-Push nicht aktiviert ist, obwohl ein Token vorhanden ist. Dies behebt sich in der Regel, sobald die Verarbeitung abgeschlossen ist.

Mehrere Nutzer:innen auf einem Gerät

Push-Token sind sowohl geräte- als auch app-spezifisch, daher ist es nicht möglich, Push-Token zu verwenden, um mehrere Nutzer:innen zu unterscheiden, die 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 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 zugeordnet, 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 eine Nutzer:in von einem Gerät oder einer Website abmeldet und eine neue Nutzer:in sich einloggt, wird das Push-Token der neuen Nutzer:in zugewiesen. Dies wird im Profil der Nutzer:innen im Abschnitt Contact Settings des Tabs Engagement angezeigt:

Da es für Push-Anbieter (APNs/FCM) keine Möglichkeit gibt, mehrere Nutzer:innen auf einem Gerät zu unterscheiden, übergeben wir das Push-Token an die zuletzt eingeloggte Nutzer:in, um zu bestimmen, welche Nutzer:in auf dem Gerät für Push angesprochen werden soll.

Mehrere Geräte und eine Nutzer:in

Der Push-Abo-Status ist nutzerbasiert und nicht an eine einzelne App gebunden. Der Status des Push-Abos ist der zuletzt gesetzte Wert. Wenn sich also eine Nutzer:in für Push-Benachrichtigungen entschieden hat, lautet ihr Push-Abo-Status Opted-In auf allen berechtigten Geräten. Wenn sich eine Nutzer:in später explizit über Ihre Anwendung oder andere von Ihrer Marke bereitgestellte Methoden von Push-Benachrichtigungen abmeldet, 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.

Hinweis

Informationen zur Überprüfung des Push-Registrierungsstatus finden Sie unter Push-Registrierungsstatus.

Informationen zur Push-Registrierung und zum Changelog finden

Im Dashboard finden Sie Informationen zur Push-Registrierung und zu Push-Changelogs 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 die Kontakteinstellungen und den Push-Changelog für eine:n bestimmte:n Nutzer:in an.

Bei der Überprüfung des Push-Aktivierungsstatus zeigt Push Registered for an, auf welchen Plattformen Braze Vordergrund-Push-Benachrichtigungen an diese:n Nutzer:in senden kann. Wenn auf iOS und Android ein:e Nutzer:in von „Vordergrund-Push aktiviert“ zu „Hintergrund-Push aktiviert“ (remote_notification_enabled) gewechselt hat, wird dies im Push-Changelog als „Push token was updated from foreground push enabled to foreground push disabled“ dokumentiert.

Wenn der/die Nutzer:in als Testnutzer:in hinzugefügt wurde, zeigt das Nutzerprofil unter Entwicklungskonsole > Event-Nutzerprotokoll eine SDK-Anfrage mit remote_notification_enabled als true oder false an. Möglicherweise müssen Sie das Nutzerprofil aktualisieren, um die Änderungen zu sehen, da SDK-Updates das Nutzerprofil mit einer kurzen Verzögerung erreichen.

Segmentierungsfilter für den iOS-Push-Status:

• iOS-Vordergrund- und -Hintergrund-Push deaktiviert: Dem/der Nutzer:in wurde noch keine Push-Anfrage angezeigt.
• iOS-Hintergrund aktiviert: Dem/der Nutzer:in wurde die Push-Anfrage angezeigt und er/sie hat abgelehnt, oder zunächst zugestimmt und Push-Benachrichtigungen später in den Geräteeinstellungen deaktiviert (wird nach einer Sitzung des/der Nutzer:in widergespiegelt).
• iOS-Vordergrund aktiviert: Dem/der Nutzer:in wurde die Push-Anfrage angezeigt und er/sie ist berechtigt, Vordergrund-Push-Benachrichtigungen zu empfangen.

Die Campaign Analytics spiegeln die Push-Statistiken gemäß den weiter oben in diesem Abschnitt beschriebenen Details wider. Sie können auch die Nutzerprofile herunterladen, die in die Campaign oder das Canvas eingetreten sind, um Nutzerprofile abzugleichen.

Andere plattformspezifische Szenarien

• web
• android
• ios

Wenn Nutzer:innen die native Push-Berechtigungsabfrage akzeptieren, wird ihr Abo-Status auf opted in geändert.

Um Abos zu verwalten, können Sie die Nutzermethode setPushNotificationSubscriptionType verwenden, um eine Einstellungsseite auf Ihrer Website zu erstellen. Anschließend können Sie Nutzer:innen im Dashboard nach Opt-out-Status filtern.

Wenn Nutzer:innen Benachrichtigungen in ihrem Browser deaktivieren, wird die nächste an sie gesendete Push-Benachrichtigung bouncen, und Braze aktualisiert das Push-Token entsprechend. Dies wird verwendet, um die Berechtigung für die Push-fähigen Filter zu verwalten (Background or Foreground Push Enabled, Foreground Push Enabled und Foreground Push Enabled for App). Der im Nutzerprofil festgelegte Abo-Status ist eine Einstellung auf Nutzerebene 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:r Nutzer:in auf demselben Gerät anmelden oder die Website längere Zeit nicht 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 vorkommen, wenn Nutzer:innen die Website nicht erneut besuchen oder der Browser das Token ungültig macht. Es kann auch periodisch auftreten (häufig alle paar Monate), abhängig vom Browser. Wenn Nutzer:innen die Website erneut besuchen und ihr Browser weiterhin auf „Erlauben“ gesetzt ist, erfasst Braze automatisch ein neues Token für das Gerät. Dies setzt voraus, dass die disablePushTokenMaintenance-Initialisierungsoption bei der SDK-Initialisierung nicht verwendet wird.

Hinweis

Web-Plattformen unterstützen keine Hintergrund- oder stillen Push-Benachrichtigungen.

Wenn Nutzer:innen mit aktiviertem Vordergrund-Push die Push-Funktion 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 Segmentierungsfilter Foreground Push Enabled (sofern keine anderen Apps im Nutzerprofil ein gültiges Vordergrund-Push-Token haben) geben false zurück.

Da in diesem Szenario weiterhin ein Hintergrund-Push-Token vorhanden ist, können Sie mit dem Segmentierungsfilter Background or Foreground Push Enabled = true weiterhin Hintergrund-Push-Benachrichtigungen (stille Push-Benachrichtigungen) senden.

Für Android betrachtet Braze Nutzer:innen als Push-deaktiviert, wenn:

• Sie die App von ihrem Gerät deinstallieren.
• Eine Push-Nachricht aufgrund eines Bounce nicht zugestellt werden kann. Dies wird häufig durch eine Deinstallation verursacht, kann aber auch durch App-Updates, neue Push-Token-Versionen oder Formatänderungen bedingt sein.
• Die Push-Registrierung bei Firebase Cloud Messaging fehlschlägt (manchmal verursacht durch schlechte Netzwerkverbindungen oder einen Fehler bei der Verbindung zu FCM oder beim Empfang eines gültigen Tokens).
• Nutzer:innen Push-Benachrichtigungen für die App in ihren Geräteeinstellungen blockieren und anschließend eine Sitzung protokollieren.

Hinweis

Sie können eine Android-Push-Benachrichtigung nur abfangen, wenn die App im Vordergrund oder im Hintergrund (aber noch aktiv) ist. Sie können keine Benachrichtigungen 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-Benachrichtigungen senden, wenn Sie Remote-Benachrichtigungen in Xcode aktiviert haben und Ihre App registerForRemoteNotifications() aufruft.

Wenn Ihre App vorläufig autorisiert ist oder Nutzer:innen sich für Push entschieden haben, erhalten sie ein Vordergrund-Push-Token, mit dem Sie ihnen alle Arten von Push senden können. In Braze gelten Nutzer:innen unter iOS, die Vordergrund-Push aktiviert haben, als Push-fähig – entweder explizit (auf App-Ebene) oder vorläufig (auf Geräteebene).

Wenn Nutzer:innen den Empfang von Push-Benachrichtigungen auf Betriebssystemebene ablehnen, bleibt ihr Push-Abo-Status Subscribed, und in ihrem Profil wird nicht angezeigt, dass ein Vordergrund-Push-Token registriert wurde.

Wenn Nutzer:innen, die zunächst auf Betriebssystemebene zugestimmt haben, Push-Benachrichtigungen in ihren Betriebssystemeinstellungen deaktivieren, geschieht zu Beginn der nächsten Sitzung 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 Segmentierungsfilter Foreground Push Enabled (sofern keine anderen Apps im Nutzerprofil ein gültiges Vordergrund-Push-Token haben) geben false zurück.

Da in diesem Szenario weiterhin ein Hintergrund-Push-Token vorhanden ist, können Sie mit dem Segmentierungsfilter Background or Foreground Push Enabled = true weiterhin Hintergrund-Push-Benachrichtigungen (stille Push-Benachrichtigungen) senden.

Hinweis

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

Ausführliche Anleitungen zur Optimierung Ihrer Push-Nutzung bei Braze finden Sie in unserem speziellen Artikel zu Best Practices für Push.