Skip to content

Fehlerbehebung für Push

Verwenden Sie diese Seite, um Probleme mit dem Push-Messaging-Kanal zu beheben.

Fehlende Push-Benachrichtigungen

Haben Sie Probleme mit der Zustellung von Push-Benachrichtigungen? Es gibt eine Reihe von Schritten, die Sie zur Fehlerbehebung unternehmen können, indem Sie Folgendes überprüfen:

Push-Abo-Status

Push-Benachrichtigungen können nur an abonnierte oder angemeldete Nutzer:innen gesendet werden. Überprüfen Sie Ihr Nutzerprofil im Tab Engagement im Abschnitt Nutzerprofil, um zu bestätigen, dass Sie aktiv für Push im Workspace registriert sind, den Sie testen. Wenn Sie für mehrere Apps registriert sind, finden Sie diese im Feld Push Registered For:

Für Push registriert

Sie können die Nutzerprofile auch über die Braze-Export-Endpunkte exportieren:

Beide Endpunkte geben ein Push-Token-Objekt zurück, das Informationen zur Push-Aktivierung pro Gerät enthält.

Segment

Stellen Sie sicher, dass Sie in das Segment fallen, das Sie ansprechen (wenn es sich um eine Live-Campaign und nicht um einen Test handelt). Im Nutzerprofil sehen Sie eine Liste der Segmente, in denen sich die Nutzer:innen aktuell befinden. Beachten Sie, dass dies eine sich ständig ändernde Variable ist, da die Segmentierung in Echtzeit aktualisiert wird.

Liste der Segmente

Sie können auch bestätigen, dass die Nutzer:innen Teil des Segments sind, indem Sie beim Erstellen eines Segments die Nutzersuche verwenden. Die Nutzersuche akzeptiert nur external_id oder braze_id – keine E-Mail-Adressen oder Telefonnummern. Um nach E-Mail, Telefon, Push-Token oder Nutzer-Alias zu suchen, verwenden Sie Nutzer:innen suchen.

Abschnitt „Nutzersuche“ mit einem Suchfeld.

Obergrenzen für Push-Benachrichtigungen

Überprüfen Sie die globalen Frequency-Capping-Regeln. Es ist möglich, dass Sie die Push-Benachrichtigung nicht erhalten haben, weil in Ihrem Workspace globales Frequency-Capping aktiv ist und Sie Ihre Push-Benachrichtigungs-Obergrenze für den angegebenen Zeitraum bereits erreicht haben.

Sie können dies überprüfen, indem Sie das globale Frequency-Capping im Dashboard prüfen. Wenn die Campaign so eingestellt ist, dass sie die Frequency-Capping-Regeln einhält, wird eine Anzahl von Nutzer:innen angezeigt, die von diesen Einstellungen betroffen sind.

Campaign-Details

Rate-Limits

Wenn Sie ein Rate-Limit für Ihre Campaign oder Ihren Canvas festgelegt haben, kann es sein, dass Sie aufgrund der Überschreitung dieses Limits keine Nachrichten erhalten. Weitere Informationen finden Sie unter Rate-Limiting.

Kontrollgruppen-Status

Wenn es sich um eine Einkanal-Campaign oder einen Canvas mit einer Kontrollgruppe handelt, ist es möglich, dass Sie in die Kontrollgruppe fallen.

  1. Überprüfen Sie die Variantenverteilung, um festzustellen, ob es eine Kontrollgruppe gibt.
  2. Falls ja, erstellen Sie ein Segment, das nach In Campaign-Kontrollgruppe filtert, und exportieren Sie das Segment, um zu prüfen, ob Ihre Nutzer-ID auf dieser Liste steht.

Gültiges Push-Token

Ein Push-Token ist ein Bezeichner, den Absender verwenden, um bestimmte Geräte mit einer Push-Benachrichtigung anzusprechen. Wenn das Gerät kein gültiges Push-Token hat, gibt es keine Möglichkeit, eine Push-Benachrichtigung an dieses Gerät zu senden.

Art der Push-Benachrichtigung

Überprüfen Sie, ob Sie die richtige Art von Push-Benachrichtigung verwenden. Wenn Sie beispielsweise ein FireTV ansprechen möchten, würden Sie eine Kindle-Push-Benachrichtigung verwenden, nicht eine Android-Push-Campaign. Ebenso sollten Sie für Android eine Android-Push-Benachrichtigung verwenden und nicht eine iOS-Push-Campaign. Lesen Sie die folgenden Artikel für weitere Informationen zum Verständnis des Braze-Workflows für:

Aktuelle App

Stellen Sie beim Testen von Push-Sendungen mit internen Nutzer:innen sicher, dass die Person, die die Push-Benachrichtigung erhalten soll, aktuell in der entsprechenden App angemeldet ist. Dies kann dazu führen, dass Nutzer:innen entweder keine Push-Benachrichtigung erhalten oder eine Push-Benachrichtigung erhalten, für die sie Ihrer Meinung nach nicht segmentiert sind.

Fehler: MismatchSenderID

MismatchSenderID weist auf einen Authentifizierungsfehler bei Firebase Cloud Messaging (FCM) hin. Bestätigen Sie, dass Ihre Firebase-Sender-ID und Ihr FCM-API-Schlüssel korrekt sind.

So finden Sie den richtigen Firebase-Server-Key und ersetzen ihn:

  1. Gehen Sie zur Firebase-Konsole für Ihre App.
  2. Wählen Sie unter Project Overview die Option Project Settings.
  3. Überprüfen Sie im Tab Cloud Messaging, ob die Sender-ID unter den API-Schlüsseln mit der in Braze übereinstimmt (unter Settings > App Settings > Cloud Messaging API Key).
  1. Kopieren Sie den Server Key unter Project credentials.
  2. Gehen Sie in Braze zu Settings > App Settings, wählen Sie Ihre App aus und fügen Sie den Server-Key in das Feld Cloud Messaging API Key ein (und ersetzen Sie den veralteten Schlüssel).
  3. Wählen Sie Save.
  4. Senden Sie zur Überprüfung eine Test-Push-Benachrichtigung an ein Gerät, bevor und nachdem Sie den API-Schlüssel geändert haben, ohne die Anwendung zu öffnen. So wird bestätigt, dass Nutzer:innen weiterhin Push-Benachrichtigungen erhalten, ohne dass eine neue Push-Registrierungs-ID (Push-Token) generiert werden muss.

Fehlerbehebungsszenarien

Verzögerte Push-Benachrichtigungen

Ihre Push-Benachrichtigungen können aus folgenden Gründen verzögert werden:

  • Eine schwache Datenverbindung auf dem Gerät
  • Angepasster Code in der App, der Braze-Push-Benachrichtigungen unterdrücken kann
  • Nutzereinstellungen für Push-Benachrichtigungen in den Geräteeinstellungen
  • Nachrichtenpriorität der Push-Benachrichtigung bei der Erstellung in der Campaign oder im Canvas
  • Verkehrsverzögerungen oder Probleme bei den Push-Dienstanbietern (FCM und APNs)

Push-Benachrichtigungen werden langsamer als erwartet gesendet

Stellen Sie sicher, dass Ihr Push-Benachrichtigungs-Setup diesen Best Practices folgt:

  • Wenn Sie an große Zielgruppen senden, ohne den Push-Aktivierungsstatus zu berücksichtigen, kann dies zu einer langsameren Sendegeschwindigkeit führen. Erwägen Sie stattdessen, nur an Push-aktivierte Nutzer:innen zu senden, um die Größe Ihrer Zielgruppe zu reduzieren.
  • Versuchen Sie nach Möglichkeit, Ihre Campaigns im Voraus zu planen, anstatt sie sofort zu senden.
  • Wenn Sie eine größere Anzahl von Nutzer:innen mit Push-Benachrichtigungen in einem Canvas ansprechen, können Sie davon ausgehen, dass nachfolgende Nachrichtenschritte im Canvas andere Verarbeitungszeiten erfordern als eine Campaign, die sofort an Nutzer:innen sendet. In diesem Fall würden Campaigns in der Regel schneller fertig senden als ein Canvas, da der erste „Schritt“ eines Canvas darin besteht, zu prüfen, ob Nutzer:innen für die spezifische User-Journey qualifiziert sind.

Tippen auf eine Push-Benachrichtigung öffnet die App nicht

Wenn das Tippen auf eine Push-Benachrichtigung Ihre App nicht öffnet, überprüfen Sie je nach Plattform Folgendes.

Android

  1. Klickverhalten überprüfen: Bestätigen Sie, dass die Campaign so konfiguriert ist, dass die App beim Klicken geöffnet wird.
  2. Deeplink-Behandlung prüfen: Überprüfen Sie in Ihrer braze.xml-Datei, ob com_braze_handle_push_deep_links_automatically auf true oder false gesetzt ist.
    • Wenn auf true gesetzt, behandelt das Braze SDK Deeplinks direkt und die App sollte wie erwartet geöffnet werden.
    • Wenn auf false gesetzt, benötigt Ihre App einen Broadcast-Receiver, der Push-Empfangs- und Öffnungs-Intents abhört und verarbeitet. Überprüfen Sie, ob dieser Receiver korrekt implementiert ist.
  3. Ausführliche Logs erfassen: Aktivieren Sie ausführliches Logging, reproduzieren Sie das Problem und stellen Sie die Logs zusammen mit Ihrer braze.xml und AndroidManifest.xml dem Braze-Support zur Verfügung.

iOS

  1. Klickverhalten überprüfen: Bestätigen Sie, dass die Campaign so konfiguriert ist, dass die App beim Klicken geöffnet wird.
  2. Push-Integration prüfen: Deeplinking von einer Push-Benachrichtigung in die App wird automatisch durch die Braze Standard-Push-Integration behandelt. Bestätigen Sie, dass die Integration korrekt implementiert ist, einschließlich aller angepassten Delegate-Behandlungen.
  3. Ausführliche Logs erfassen: Aktivieren Sie ausführliches Logging, reproduzieren Sie das Problem und stellen Sie die Logs dem Braze-Support zur Verfügung.

Push-Klicks öffnen unerwartet in der App

Wenn Links in Push-Benachrichtigungen unerwartet in Ihrer App statt in Ihrem Webbrowser geöffnet werden, liegt möglicherweise ein Problem mit Ihrer Campaign-Konfiguration oder SDK-Implementierung vor. Folgen Sie diesen Schritten zur Hilfe.

Klickverhalten überprüfen

Überprüfen Sie in Ihrer Campaign oder Ihrem Canvas-Schritt, ob Open web URL inside mobile app nicht ausgewählt ist. Falls doch, deaktivieren Sie die Auswahl und starten Sie erneut.

Feld „Klickverhalten“ bei der Konfiguration einer Push-Benachrichtigung, eingestellt auf „Open web URL“ mit deaktiviertem „Open web URL inside mobile app“.

Die Standardinteraktion für das Klickverhalten „Open web URL“ unterscheidet sich je nach SDK-Version. Für SDK-Versionen iOS 2.29.0 und Android 2.0.0 und höher ist diese Option standardmäßig ausgewählt und Web-URLs werden in einer Webansicht innerhalb der App geöffnet. Vor diesen Versionen ist diese Option standardmäßig deaktiviert und Web-URLs werden im Standard-Webbrowser des Geräts geöffnet.

Wenn dies nicht das Problem ist, liegt möglicherweise ein Problem mit Ihrer Push-Implementierung vor.

Push-Integration erneut prüfen

Wenn Links in Ihren Push-Benachrichtigungen unerwartet in der App geöffnet werden, kann dies an Problemen mit Ihrer Push-Benachrichtigungs-Integration oder Anpassungseinstellungen liegen. Folgen Sie diesen Schritten zur Fehlerbehebung:

  1. Push-Delegate-Implementierung überprüfen: Stellen Sie sicher, dass der Braze-Push-Delegate korrekt implementiert ist. Detaillierte Anweisungen finden Sie im Integrationsleitfaden für Push-Benachrichtigungen für Ihre Plattform.
  2. Angepasste Link-Behandlung prüfen: Überprüfen Sie, ob die App eine angepasste Behandlung für alle https://-Links enthält. Angepasste Konfigurationen können Standardverhalten überschreiben. Arbeiten Sie mit Ihrem Entwicklungsteam zusammen, um diese Einstellungen bei Bedarf zu überprüfen und anzupassen.
  3. iOS-Push-Registrierung überprüfen: Für iOS lesen Sie Schritt 1 des Push-Integrationsleitfadens zur Registrierung von Push-Benachrichtigungen bei APNs erneut. Stellen Sie sicher, dass Ihr Delegate-Objekt synchron zugewiesen wird, bevor die App den Start abschließt. Dieser Schritt sollte in der Methode application:didFinishLaunchingWithOptions: abgeschlossen werden.
  4. Integration testen: Testen Sie nach den Anpassungen das Push-Benachrichtigungsverhalten sowohl auf iOS- als auch auf Android-Geräten, um zu bestätigen, dass das Problem behoben ist.

Wenn Deeplinks funktionieren, wenn die App nicht läuft oder wenn der Link direkt verwendet wird, aber nicht, wenn die Anwendung bereits im Hintergrund läuft, hängt das Problem möglicherweise damit zusammen, wie die App den Link verarbeitet. Überprüfen Sie, ob Sie Drittanbieter-Bibliotheken verwenden, die Method-Swizzling nutzen. Wir empfehlen, Swizzling zu deaktivieren, da es Probleme mit Deeplink-Implementierungen verursachen kann.

Zu einem .p8-Authentifizierungsschlüssel migrieren

Apple .p8-Authentifizierungsschlüssel sind der erforderliche Ansatz für APNs-Push in Braze. Im Gegensatz zu älteren Zertifikatsdateitypen laufen .p8-Schlüssel nicht ab und unterstützen alle Ihre Apps unter einem einzigen Schlüssel, wodurch jährliche Zertifikatserneuerungen entfallen und das Risiko von Push-Zustellungsfehlern reduziert wird.

Wenn Sie derzeit ein .p12- oder .pem-Zertifikat verwenden, migrieren Sie so bald wie möglich zu einem .p8-Schlüssel. Anweisungen zum Erstellen und Hochladen eines .p8-Schlüssels finden Sie unter APNs-Push-Zertifikat hochladen. Apples Anleitung zum Generieren eines .p8-Schlüssels aus Ihrem Entwicklerkonto finden Sie unter Mit APNs über Authentifizierungstoken kommunizieren.

.p8-Schlüssel im Vergleich zu .p12-Zertifikaten

Zugangsdaten Ablauf Dashboard-Statusanzeige
.p8-Authentifizierungsschlüssel Läuft nicht ab Keine grüne Statusanzeige (dies ist erwartet)
.p12-Push-Zertifikat Läuft jährlich ab Grüne Anzeige, wenn das Zertifikat gültig ist

Wenn Sie ein .p12-Zertifikat durch einen .p8-Schlüssel ersetzen (oder neue Zugangsdaten hochladen), kann die Push-Zustellung kurzzeitig pausieren, während Braze die Änderung verarbeitet. Planen Sie Updates nach Möglichkeit während eines Wartungsfensters.

Bestätigen Sie unter Settings > App Settings > Push Notification Settings, dass App Bundle ID, Team ID und Key ID (für .p8-Schlüssel) mit den Werten in Ihrem Apple-Entwicklerkonto übereinstimmen. Mehrere Braze-Workspaces können dieselben Apple-Push-Zugangsdaten verwenden, wenn die iOS-App-Bundle-ID identisch ist; die Zugangsdaten-Umgebung (Entwicklung versus Produktion) muss mit der Art übereinstimmen, wie die App erstellt wurde.

Apps mit Braze Swift SDK 10.0.0 oder höher können Dynamic APNs gateway management verwenden, das Token automatisch an die richtige APNs-Umgebung weiterleitet.

Web-Push-Benachrichtigungen verhalten sich nicht wie erwartet

Wenn Sie Probleme mit Push-Benachrichtigungen in Ihrem Browser haben, müssen Sie möglicherweise die Benachrichtigungsberechtigungen Ihrer Website zurücksetzen und den Speicher Ihrer Website löschen. Folgen Sie diesen Schritten zur Hilfe.

Chrome auf dem Desktop zurücksetzen

  1. Wählen Sie neben Ihrer URL im Chrome-Browser das Schieberegler-Symbol View Site Information aus.
  2. Wählen Sie unter Notifications die Option Reset permission.
  3. Öffnen Sie die Chrome DevTools. Die folgenden Tastenkombinationen gelten je nach Betriebssystem.
Betriebssystem Tastenkombinationen
Mac Fn + F12
Ctrl + Shift + I
Windows F12
Ctrl + Shift + I
  1. Navigieren Sie in den DevTools zum Tab Application.
  2. Wählen Sie in der Seitenleiste Storage aus.
  3. Wählen Sie Clear site data.
  4. Chrome fordert Sie auf, die Seite neu zu laden, um Ihre aktualisierten Einstellungen anzuwenden. Wählen Sie Reload.

Ihre Push-Berechtigungen sind jetzt zurückgesetzt. Öffnen Sie einen neuen Tab zu Ihrer Website und probieren Sie es aus.

Chrome auf Android zurücksetzen

Wenn Sie eine Benachrichtigung von Ihrer Website in Ihrer Android-Benachrichtigungsleiste sehen:

  1. Tippen Sie in der Push-Benachrichtigung auf Einstellungen und wählen Sie Site settings.
  2. Tippen Sie unter Site settings auf Clear & Reset.

Wenn Sie keine Benachrichtigung von Ihrer Website geöffnet haben:

  1. Öffnen Sie Chrome auf Android.
  2. Tippen Sie auf das Menü .
  3. Gehen Sie zu Settings > Site Settings > Notifications.
  4. Überprüfen Sie, ob Benachrichtigungen auf Ask before sending (recommended) eingestellt sind.
  5. Suchen Sie Ihre Website in der Liste.
  6. Wählen Sie den Eintrag aus und tippen Sie auf Clear and Reset.

Ihre Push-Berechtigungen sind jetzt zurückgesetzt. Öffnen Sie einen neuen Tab zu Ihrer Website und probieren Sie es aus.

Firefox auf dem Desktop zurücksetzen

  1. Wählen Sie neben Ihrer Website-URL oder aus.
  2. Wählen Sie unter Permissions neben Receive Notifications das Symbol Berechtigung löschen, um die Benachrichtigungsberechtigungen zu löschen.
  3. Wählen Sie im selben Menü Clear Cookies and Site Data.
  4. Wählen Sie im Bestätigungsdialog OK.

Ihre Push-Berechtigungen sind jetzt zurückgesetzt. Öffnen Sie einen neuen Tab zu Ihrer Website und probieren Sie es aus.

Firefox auf Android zurücksetzen

Um Push-Berechtigungen auf Android zurückzusetzen, lesen Sie diesen Mozilla-Support-Artikel.

Safari auf macOS zurücksetzen

  1. Öffnen Sie Safari.
  2. Gehen Sie in der Menüleiste auf dem Mac zu Safari > Settings > Websites > Notifications.
  3. Wählen Sie Ihre Website aus der Liste aus.
  4. Wählen Sie Remove, um die Benachrichtigungsberechtigungen für die Website zu löschen.
  5. Gehen Sie dann zu Privacy > Manage Website Data.
  6. Wählen Sie Ihre Website aus der Liste aus.
  7. Wählen Sie Remove oder, um alle Website-Daten zu entfernen, wählen Sie Remove All.
  8. Wählen Sie Done.

Ihre Push-Berechtigungen sind jetzt zurückgesetzt. Öffnen Sie einen neuen Tab zu Ihrer Website und probieren Sie es aus.

Push-Fehlermeldungen

Detaillierte Informationen zu häufigen Push-Fehlermeldungen (wie DEVICE_UNREGISTERED, Unregistered, NotRegistered und andere) finden Sie unter Häufige Push-Fehlermeldungen.

Benötigen Sie weitere Hilfe? Eröffnen Sie ein Support-Ticket.
New Stuff!