Fehlerbehebung bei Push-Benachrichtigungen

Den Arbeitsablauf von Braze/APNs verstehen

Der Apple Push Notification Service (APNs) ist die Infrastruktur für das Senden von Push-Benachrichtigungen an Anwendungen, die auf den Plattformen von Apple laufen. Hier ist die vereinfachte Struktur, wie Push-Benachrichtigungen für die Geräte Ihrer Nutzer:innen aktiviert werden und wie Braze Push-Benachrichtigungen an sie senden kann:

1. Sie konfigurieren das Push-Zertifikat und das Bereitstellungsprofil
2. Geräte registrieren sich für APNs und versorgen Braze mit Push-Token
3. Sie starten eine Braze-Push-Campaign
4. Braze entfernt ungültige Token

1. Schritt: Konfigurieren des Push-Zertifikats und des Bereitstellungsprofils

Bei der Entwicklung Ihrer App müssen Sie ein SSL-Zertifikat erstellen, um Push-Benachrichtigungen zu aktivieren. Dieses Zertifikat wird in das Bereitstellungsprofil Ihrer App aufgenommen und muss außerdem in das Braze-Dashboard hochgeladen werden. Das Zertifikat ermöglicht es Braze, APNs mitzuteilen, dass wir in Ihrem Namen Push-Benachrichtigungen senden dürfen.

Es gibt zwei Arten von Bereitstellungsprofilen und Zertifikaten: Entwicklung und Verteilung. Um Unklarheiten zu vermeiden, empfehlen wir, nur Verteilungsprofile und -zertifikate zu verwenden. Wenn Sie unterschiedliche Profile und Zertifikate für die Entwicklung und Verteilung verwenden möchten, stellen Sie sicher, dass das in das Dashboard hochgeladene Zertifikat mit dem derzeit verwendeten Bereitstellungsprofil übereinstimmt.

Warnung

Ändern Sie nicht die Push-Zertifikat-Umgebung (Entwicklung oder Produktion). Wenn Sie das Push-Zertifikat in die falsche Umgebung ändern, kann dies dazu führen, dass Ihren Nutzer:innen versehentlich ihr Push-Token entzogen wird, sodass sie nicht mehr per Push erreichbar sind.

2. Schritt: Geräte registrieren sich für APNs und versorgen Braze mit Push-Token

Wenn Nutzer:innen Ihre App öffnen, werden sie aufgefordert, Push-Benachrichtigungen zu akzeptieren. Stimmen sie der Aufforderung zu, generieren die APNs ein Push-Token für das betreffende Gerät. Das Swift SDK sendet das Push-Token für Apps, die die standardmäßige Auto-Flush-Richtlinie verwenden, sofort und asynchron. Nachdem wir ein Push-Token mit einer Nutzer:in verknüpft haben, wird diese im Dashboard auf ihrem Nutzerprofil unter dem Tab Engagement als „Push registriert“ angezeigt und ist berechtigt, Push-Benachrichtigungen von Braze Campaigns zu erhalten.

Hinweis

Ab macOS 13 können Sie auf bestimmten Geräten Push-Benachrichtigungen mithilfe eines Simulators für iOS 16 testen, der unter Xcode 14 läuft. Weitere Einzelheiten finden Sie in den Release Notes zu Xcode 14.

Überlegungen zur Push-Token-Generierung

• Wenn Nutzer:innen Ihre App auf einem anderen Gerät installieren, wird ein weiteres Token erstellt und auf die gleiche Weise erfasst.
• Wenn Nutzer:innen Ihre App neu installieren, wird ein neues Token generiert und an Braze übermittelt. Das ursprüngliche Token kann jedoch weiterhin von APNs und Braze als gültig protokolliert werden.
• Wenn Nutzer:innen Ihre App deinstallieren, wird Braze nicht sofort darüber informiert, und das Token wird weiterhin als gültig angezeigt, bis es von APNs zurückgezogen wird.
• Zu einem bestimmten Zeitpunkt werden APNs alte Token aus dem Verkehr ziehen. Braze hat diesbezüglich keine Kontrolle oder Einblick.

3. Schritt: Starten einer Braze-Push-Campaign

Beim Starten einer Push-Campaign stellt Braze Anfragen an APNs, um Ihre Nachricht zuzustellen. Insbesondere werden die Anfragen für jedes derzeit gültige Push-Token an APNs weitergeleitet, es sei denn, die Option An das neueste Gerät einer Nutzer:in senden ist ausgewählt. Nachdem Braze eine erfolgreiche Antwort von APNs erhalten hat, protokollieren wir eine erfolgreiche Zustellung im Nutzerprofil, auch wenn die Nutzer:in die eigentliche Nachricht aus folgenden Gründen möglicherweise nicht erhalten hat:

• Ihr Gerät ist ausgeschaltet.
• Das Gerät ist nicht mit dem Internet verbunden (WLAN oder Mobilfunk).
• Die App wurde kürzlich deinstalliert.

Braze verwendet das im Dashboard hochgeladene SSL-Push-Zertifikat, um sich zu authentifizieren und zu überprüfen, ob wir Push-Benachrichtigungen an die angegebenen Push-Token senden dürfen. Wenn ein Gerät online ist, sollte die Benachrichtigung kurz nach dem Senden der Campaign empfangen werden. Beachten Sie, dass Braze das standardmäßige APNs-Ablaufdatum für Benachrichtigungen auf 30 Tage festlegt.

4. Schritt: Entfernen ungültiger Token

Wenn APNs uns informiert, dass eines der Push-Token, an das wir eine Nachricht senden wollten, ungültig ist, entfernen wir diese Token aus den Nutzerprofilen, mit denen sie verknüpft waren.

Hinweis

Es ist üblich, dass APNs zunächst einen erfolgreichen Status zurückgeben, selbst wenn ein Token deregistriert wird, da APNs Ereignisse zur Ungültigkeitserklärung von Token nicht sofort melden. APNs verzögert absichtlich die Rückgabe eines 410-Status für ungültige Token nach einem zufälligen Zeitplan, um die Privatsphäre der Nutzer:innen zu schützen und das Tracking von App-Deinstallationen zu verhindern. Sie können weiterhin sicher Benachrichtigungen an ein nicht registriertes Token senden, bis APNs einen 410-Status zurückgibt.

Verwendung der Push-Fehlerprotokolle

Das Nachrichten-Aktivitätsprotokoll bietet Ihnen die Möglichkeit, alle Nachrichten (insbesondere Fehlermeldungen) im Zusammenhang mit Ihren Campaigns und Sendungen zu sehen, einschließlich Push-Benachrichtigungsfehler. Dieses Fehlerprotokoll enthält eine Reihe von Warnungen, die sehr hilfreich sein können, um festzustellen, warum Ihre Campaigns nicht wie erwartet funktionieren. Wenn Sie auf eine Fehlermeldung klicken, werden Sie zur entsprechenden Dokumentation weitergeleitet, die Sie bei der Fehlerbehebung unterstützt.

Zu den häufigen Fehlern, die Ihnen hier angezeigt werden, gehören nutzerspezifische Benachrichtigungen wie „Nicht registrierte Sendung an Push-Token empfangen“.

Darüber hinaus stellt Braze unter dem Tab Engagement ein Push-Changelog für das Nutzerprofil bereit. Dieses Changelog enthält Insights zum Verhalten bei der Push-Registrierung, z. B. Token-Invalidierung, Fehler bei der Push-Registrierung, zu neuen Nutzer:innen verschobene Token usw.

Fehler im Nachrichten-Aktivitätsprotokoll

Nicht registrierte Sendung an Push-Token empfangen

• Stellen Sie sicher, dass das Push-Token, das über die Methode AppDelegate.braze?.notifications.register(deviceToken:) an Braze gesendet wird, gültig ist. Im Nachrichten-Aktivitätsprotokoll können Sie das Push-Token sehen. Es sollte etwa so aussehen wie 6e407a9be8d07f0cdeb9e724733a89445f57a89ec890d63867c482a483506fa6, eine lange Zeichenkette mit einer Mischung aus Buchstaben und Zahlen. Wenn Ihr Push-Token anders aussieht, überprüfen Sie Ihren Code zum Senden der Push-Token an Braze.
• Vergewissern Sie sich, dass das Push-Bereitstellungsprofil mit der Umgebung übereinstimmt, in der Sie testen. Universelle Zertifikate können im Braze-Dashboard so konfiguriert werden, dass sie entweder an die APNs-Entwicklungs- oder die Produktionsumgebung gesendet werden. Die Verwendung eines Entwicklungszertifikats für eine Produktionsanwendung oder eines Produktionszertifikats für eine Entwicklungsanwendung wird nicht funktionieren.
• Überprüfen Sie, ob das Push-Token, das Sie auf Braze hochgeladen haben, mit dem Bereitstellungsprofil übereinstimmt, das Sie zum Erstellen der App verwendet haben, von der Sie das Push-Token gesendet haben.

Geräte-Token nicht für das Thema

APNs gibt DeviceTokenNotForTopic (HTTP-Status 400) zurück, wenn das Push-Token nicht mit dem Thema (Bundle-ID) übereinstimmt, das für Ihre Zugangsdaten konfiguriert ist. Braze kann dies im Nachrichten-Aktivitätsprotokoll oder in den Push-Zustellungsprotokollen als DeviceTokenNotForTopic anzeigen.

So beheben Sie die Nichtübereinstimmung:

1. Bestätigen Sie, dass die Bundle-ID der App mit der App Bundle ID in Braze übereinstimmt (Einstellungen > App Settings > Einstellungen für Push-Benachrichtigungen).
2. Überprüfen Sie, ob das Bereitstellungsprofil, das zum Erstellen der App verwendet wurde, die Push-Funktion für diese Bundle-ID enthält.
3. Bestätigen Sie, dass die auf Braze hochgeladenen Push-Zugangsdaten mit der Umgebung der App übereinstimmen (Entwicklung oder Produktion).
4. Überprüfen Sie bei .p8-Schlüsseln, ob Team ID und Key ID in Braze mit Ihrem Apple-Entwicklerkonto übereinstimmen.
5. Laden Sie einen gültigen .p8-Schlüssel oder ein .p12-Zertifikat erneut hoch, wenn die Zugangsdaten rotiert oder widerrufen wurden.

Bevorzugen Sie nach Möglichkeit .p8-Authentifizierungsschlüssel. Informationen zu Zugangsdatentypen und Dashboard-Statusanzeigen finden Sie unter Zu einem .p8-Authentifizierungsschlüssel migrieren.

BadDeviceToken beim Senden an Push-Token

BadDeviceToken ist ein APNs-Fehlercode und stammt nicht von Braze. Es kann eine Reihe von Gründen dafür geben, dass diese Antwort zurückgegeben wird, darunter:

• Die App hat ein Push-Token empfangen, das für die auf das Dashboard hochgeladenen Zugangsdaten ungültig war.
• Push wurde für diesen Workspace deaktiviert.
• Die Nutzer:in hat Push abbestellt.
• Die App wurde deinstalliert.
• Apple hat das Push-Token erneuert, wodurch das alte Token ungültig wurde.
• Die App wurde für eine Produktionsumgebung erstellt, aber die auf Braze hochgeladenen Push-Zugangsdaten sind für eine Entwicklungsumgebung eingestellt (oder umgekehrt).

Probleme bei der Push-Registrierung

Keine Push-Registrierungsaufforderung

Wenn die Anwendung Sie nicht auffordert, sich für Push-Benachrichtigungen zu registrieren, liegt wahrscheinlich ein Problem mit der Integration der Push-Registrierung vor. Stellen Sie sicher, dass Sie unsere Dokumentation befolgt und unsere Push-Registrierung korrekt integriert haben. Sie können auch Haltepunkte in Ihrem Code setzen, um sicherzustellen, dass der Code für die Push-Registrierung ausgeführt wird.

Keine „push-registrierten“ Nutzer:innen im Dashboard angezeigt (vor dem Senden von Nachrichten)

Stellen Sie sicher, dass Ihre App richtig konfiguriert ist, um Push-Benachrichtigungen zuzulassen. Zu den häufig zu überprüfenden Fehlerpunkten gehören:

• Überprüfen Sie, ob Sie von Ihrer App aufgefordert werden, Push-Benachrichtigungen zuzulassen. Normalerweise erscheint diese Aufforderung beim ersten Öffnen der App, sie kann aber auch so programmiert werden, dass sie an anderen Stellen erscheint. Wenn sie nicht dort erscheint, wo sie sein sollte, liegt das Problem wahrscheinlich bei der Grundkonfiguration der Push-Funktionen Ihrer App.
  • Überprüfen Sie, ob die Schritte für die Push-Integration erfolgreich abgeschlossen wurden.
  • Vergewissern Sie sich, dass das Bereitstellungsprofil Ihrer App Berechtigungen für Push enthält. Stellen Sie sicher, dass Sie alle verfügbaren Bereitstellungsprofile aus Ihrem Apple-Entwicklerkonto abrufen. Um dies zu bestätigen, führen Sie die folgenden Schritte aus:
    1. Navigieren Sie in Xcode zu Preferences > Accounts (oder verwenden Sie die Tastenkombination Command+,).
    2. Wählen Sie die Apple ID, die Sie für Ihr Entwicklerkonto verwenden, und klicken Sie auf View Details.
    3. Klicken Sie auf der nächsten Seite auf Refresh und bestätigen Sie, dass Sie alle verfügbaren Bereitstellungsprofile abrufen.
• Überprüfen Sie, ob die Push-Funktion in Ihrer App korrekt aktiviert ist.
• Stellen Sie sicher, dass das Push-Bereitstellungsprofil mit der Umgebung übereinstimmt, in der Sie testen. Universelle Zertifikate können im Braze-Dashboard so konfiguriert werden, dass sie entweder an die APNs-Entwicklungs- oder die Produktionsumgebung gesendet werden. Die Verwendung eines Entwicklungszertifikats für eine Produktionsanwendung oder eines Produktionszertifikats für eine Entwicklungsanwendung wird nicht funktionieren.
• Überprüfen Sie, ob unsere Methode registerPushToken aufgerufen wird, indem Sie einen Haltepunkt in Ihrem Code setzen.
• Stellen Sie sicher, dass Sie ein Gerät zum Testen verwenden (Push funktioniert nicht auf einem Simulator) und eine gute Netzwerkverbindung haben.

Push-Benachrichtigungen gesendet, aber nicht auf den Geräten der Nutzer:innen angezeigt

„Push-registrierte“ Nutzer:innen werden nach dem Senden von Nachrichten nicht mehr aktiviert

Dies deutet wahrscheinlich darauf hin, dass das Push-Token der Nutzer:in ungültig war. Dafür kann es mehrere Gründe geben:

Dashboard- und App-Zertifikat stimmen nicht überein

Wenn das Push-Zertifikat, das Sie im Dashboard hochgeladen haben, nicht dasselbe ist wie das im Bereitstellungsprofil, mit dem Ihre App erstellt wurde, lehnen die APNs das Token ab. Vergewissern Sie sich, dass Sie das richtige Zertifikat hochgeladen und eine weitere Sitzung in der App abgeschlossen haben, bevor Sie eine weitere Testbenachrichtigung versuchen.

Anwendung wurde deinstalliert

Wenn eine Nutzer:in Ihre Anwendung deinstalliert hat, ist ihr Push-Token ungültig und wird beim nächsten Senden entfernt.

Bereitstellungsprofil neu generieren

Als letzten Ausweg können Sie von vorne beginnen und ein völlig neues Bereitstellungsprofil erstellen, um Konfigurationsfehler zu beheben, die durch die gleichzeitige Arbeit mit mehreren Umgebungen, Profilen und Anwendungen entstehen. Bei der Einrichtung von Push-Benachrichtigungen gibt es viele „bewegliche Teile“. Daher ist es mitunter sinnvoll, noch einmal von vorn zu beginnen. Diese Vorgehensweise ist auch hilfreich, um das Problem einzugrenzen, wenn Sie die Fehlerbehebung fortsetzen müssen.

Nachrichten werden nicht an „push-registrierte“ Nutzer:innen zugestellt

App befindet sich im Vordergrund

Bei iOS-Versionen, die Push nicht über das Framework UserNotifications integrieren, wird die Nachricht nicht angezeigt, wenn sich die App beim Empfang der Push-Nachricht im Vordergrund befindet. Vor dem Senden von Testnachrichten sollten Sie die App auf Ihren Testgeräten in den Hintergrund versetzen.

Testbenachrichtigung falsch geplant

Überprüfen Sie den Zeitplan, den Sie für Ihre Testnachricht festgelegt haben. Wenn sie auf Zustellung in der lokalen Zeitzone oder intelligentes Timing eingestellt ist, haben Sie die Nachricht möglicherweise noch nicht erhalten (oder die App war im Vordergrund, als sie empfangen wurde).

Nutzer:in ist für die zu testende App nicht „push-registriert“

Überprüfen Sie das Nutzerprofil der Nutzer:in, an die Sie eine Testnachricht senden möchten. Unter dem Tab Engagement sollte eine Liste der „pushbaren Apps“ angezeigt werden. Vergewissern Sie sich, dass die App, an die Sie Testnachrichten senden möchten, in dieser Liste enthalten ist. Nutzer:innen werden als „Push registriert“ angezeigt, wenn sie ein Push-Token für eine beliebige App in Ihrem Workspace haben, es könnte sich also um ein falsches Positiv handeln.

Das Folgende deutet auf ein Problem mit der Push-Registrierung hin oder darauf, dass das Token der Nutzer:in von den APNs nach dem Push-Vorgang als ungültig an Braze zurückgegeben wurde:

Nicht protokollierte Push-Klicks

• Stellen Sie sicher, dass Sie die Schritte zur Push-Integration durchgeführt haben.
• Braze verarbeitet keine Push-Benachrichtigungen, die still im Vordergrund empfangen werden (Standardverhalten von Push im Vordergrund vor dem Framework UserNotifications). Das bedeutet, dass Links nicht geöffnet werden und Push-Klicks nicht protokolliert werden. Wenn das Framework UserNotifications noch nicht in Ihrer Anwendung integriert ist, verarbeitet Braze keine Push-Benachrichtigungen, wenn der Anwendungsstatus UIApplicationStateActive lautet. Stellen Sie sicher, dass Ihre App die Aufrufe von Push-Verarbeitungsmethoden nicht verzögert. Andernfalls kann es sein, dass das Swift SDK Push-Benachrichtigungen als stille Push-Ereignisse im Vordergrund behandelt und sie nicht verarbeitet.

Nicht funktionierende Deeplinks

Umfassende Informationen zur Fehlerbehebung für alle Kanäle – einschließlich Universal Links, angepasster Schemata, E-Mail und Drittanbieter wie Branch – finden Sie unter Fehlerbehebung bei Deeplinking.

Weblinks von Push-Klicks werden nicht geöffnet

Links in Push-Benachrichtigungen müssen ATS-konform sein, damit sie in Webansichten geöffnet werden können. Stellen Sie sicher, dass Ihre Weblinks HTTPS verwenden. Weitere Informationen finden Sie unter ATS-Konformität.

Deeplinks von Push-Klicks werden nicht geöffnet

Der Großteil des Codes, der Deeplinks verarbeitet, verarbeitet auch Push-Öffnungen. Stellen Sie zunächst sicher, dass Push-Öffnungen protokolliert werden. Falls nicht, beheben Sie dieses Problem (da die Behebung häufig auch die Link-Verarbeitung korrigiert).

Wenn Öffnungen protokolliert werden, prüfen Sie, ob es sich um ein Problem mit Deeplinks im Allgemeinen oder nur mit Deeplinks bei der Verarbeitung von Push-Klicks handelt. Um dies herauszufinden, testen Sie per Klick auf eine In-App-Nachricht, ob ein Deeplink funktioniert.