Verwaltung Ihrer Push-Abonnentenbasis

In Pushwoosh wird jeder Abonnent durch ein Push-Token identifiziert, einen eindeutigen Identifikator, der die Zustellung von Nachrichten an ein bestimmtes Gerät ermöglicht. Dieser Beitrag behandelt, wie Push-Token funktionieren und wie Sie nur gültige Token in Ihrer Abonnentenbasis behalten.

Push-Token und ihre Funktionsweise verstehen

Ein Push-Token ist ein eindeutiger, anonymer Identifikator, der einer bestimmten App-Instanz auf einem Gerät von ihrem Push-Dienstanbieter zugewiesen wird:

Apple Push Notification Service (APNs) für iOS-Geräte
Firebase Cloud Messaging (FCM) für Android-Geräte

Dieses Token stellt sicher, dass Push-Benachrichtigungen an die richtige App auf dem Gerät des Benutzers zugestellt werden.

In Pushwoosh umfasst der Lebenszyklus eines Push-Tokens diese wichtigen Phasen:

Wenn die App zum ersten Mal gestartet wird, fordert sie vom Betriebssystem (OS) des Geräts die Erlaubnis an, Push-Benachrichtigungen zu erhalten.
Der Push-Dienst der Anwendung (z. B. APNs für iOS, FCM für Android) generiert ein eindeutiges Push-Token für diese App-Instanz. Standardmäßig sammelt und speichert das Pushwoosh SDK dieses Token, auch wenn der Benutzer die Berechtigung zur Anzeige von Benachrichtigungen nicht erteilt hat. Push-Nachrichten werden diesen Benutzern nicht angezeigt, aber das Token kann weiterhin verwendet werden, um Nachrichten an ihren Anwendungsposteingang zu senden, einen weiteren Nachrichtenkanal in Pushwoosh.

Sie können das SDK jedoch so konfigurieren, dass Token nur von Benutzern gesammelt werden, die die Erlaubnis erteilt haben.
Die App verwendet das Pushwoosh SDK, um dieses Token zusammen mit Gerätedaten (einschließlich einer Hardware-ID oder HWID) über den API-Endpunkt /registerDevice an die Pushwoosh-Datenbank zu senden.
Pushwoosh speichert das Token sicher für zukünftige Nachrichten.
Wenn eine Benachrichtigung ausgelöst wird, verwendet Pushwoosh das gespeicherte Token, um die Nachricht über das entsprechende Zustellungs-Gateway zu leiten.
Das ausgewählte Gateway stellt die Nachricht an das Gerät zu, und das Betriebssystem zeigt sie basierend auf den System- und App-Benachrichtigungseinstellungen an.
Wenn das Push-Token ungültig wird (z. B. durch Deinstallation der App), erkennt Pushwoosh den Zustellungsfehler nach einem weiteren Benachrichtigungsversand, wenn das Gateway die Liste der Sendefehler zurückgibt, einschließlich abgelaufener/ungültiger/usw. Token. Dann markiert Pushwoosh das Token als inaktiv und löscht es aus der Datenbank. Wenn die App auf demselben Gerät neu installiert wird, wird ein neues Token ausgestellt.

Häufige Gründe, warum Push-Token ungültig werden

Obwohl der Apple Push Notification Service (APNs) und Firebase Cloud Messaging (FCM) keine vollständige Transparenz über die Richtlinien zum Lebenszyklus von Token bieten oder eine proaktive Token-Validierung ermöglichen, gibt es bekannte Szenarien, in denen Push-Token ungültig werden oder ablaufen können.

Ursache	APNs (iOS)	FCM (Android)
App-Deinstallation	Das Token wird nach der Deinstallation der App ungültig. APNs gibt schließlich einen `410 Unregistered`-Fehler zurück. Apple gibt nicht an, wann die Invalidierung erfolgt; es kann von einigen Minuten bis zu mehreren Tagen dauern. Mehr erfahren	Das Token wird bei der Deinstallation sofort ungültig. Nachfolgende Sendevorgänge geben einen `Unregistered`-Fehler zurück. Mehr erfahren
Token-Aktualisierung	APNs gibt nach Betriebssystem-Upgrades, Geräte-Backup/-Wiederherstellung, App-Neuinstallation oder Betriebssystem-Updates ein neues Token aus. Mehr erfahren	Gleiches Verhalten wie bei APNs. Wird auch durch das Löschen von App-Daten oder die Wiederherstellung des Geräts ausgelöst. Mehr erfahren
Token-Inaktivität	Kein dokumentiertes Ablaufen aufgrund von Inaktivität. Mehr erfahren	Token, die länger als 270 Tage inaktiv sind, gelten als veraltet/abgelaufen. FCM markiert sie als ungültig. Mehr erfahren

So halten Sie Ihre Abonnentenliste sauber, indem Sie ungültige Push-Token entfernen

Um Ihre Push-Abonnentenliste sauber zu halten, überprüfen Sie regelmäßig die Zustellungsstatistiken, entfernen Sie ungültige Token und stellen Sie sicher, dass Ihre App und Ihr Backend immer die neuesten Token-Daten haben.

Pushwoosh bietet mehrere Möglichkeiten, Ihnen dabei zu helfen:

Senden Sie regelmäßig Push-Benachrichtigungen an Ihre gesamte Abonnentenbasis

Senden Sie regelmäßig Push-Nachrichten an Ihre gesamte Abonnentenbasis. Dies hilft Pushwoosh, ungültige Token zu identifizieren. Wenn eine Nachricht nicht zugestellt werden kann, typischerweise aufgrund eines ungültigen Tokens, gibt das Push-Gateway einen Fehler zurück. Das SDK erfasst diese Antwort und entfernt das ungültige Token automatisch, um sicherzustellen, dass es von zukünftigen Sendevorgängen ausgeschlossen wird.

Wichtig: Die Gültigkeit des Tokens wird nur überprüft, wenn ein Push gesendet wird. Pushwoosh führt keine Hintergrundprüfungen zur Gültigkeit von Token durch.

Geräte über die API abmelden

Sie können die Device-API-Methode /bulkUnregisterDevice verwenden, um Push-Token aus Ihrer Abonnentenbasis zu entfernen, zum Beispiel, wenn Benutzer sich abmelden oder nicht mehr aktiv sind.

So geht’s:

Erstellen Sie ein Segment von Benutzern, die Ihren Kriterien entsprechen (z. B. abgemeldete, kostenlose Benutzer oder solche, die seit X Tagen inaktiv sind).
Exportieren Sie das Segment über das Control Panel oder die API-Methode exportSegment.
Rufen Sie /bulkUnregisterDevice auf, um die Push-Token für die Geräte in diesem Segment zu löschen.

Inaktive Token nach 90 Tagen automatisch mit Autovalidierung entfernen

Der automatische Algorithmus zur Bereinigung bei Inaktivität in Pushwoosh hilft Ihnen, Ihre Abonnentenliste sauber zu halten, indem er Push-Token von Benutzern entfernt, die seit 90 Tagen nicht mehr aktiv waren.

Er funktioniert, indem er verfolgt, wann Benutzer Ihre App zuletzt geöffnet haben, unter Verwendung des standardmäßigen Last Application Open-Tags. Wenn ein Benutzer die App 90 Tage oder länger nicht geöffnet hat, wird sein Push-Token als inaktiv markiert und aus Ihrer Abonnentenbasis entfernt.

Deinstallations-Tracking verwenden

Das Deinstallations-Tracking hält Ihre Push-Abonnentenliste genau, indem es erkennt, wenn Benutzer Ihre App deinstallieren. Dies ermöglicht es Pushwoosh, ungültige Token automatisch zu entfernen.

Hinweis: Das Deinstallations-Tracking wird nur auf iOS und Android unterstützt.

Es funktioniert wie folgt:

Pushwoosh sendet einmal pro Tag eine stille Push-Benachrichtigung an alle abonnierten Geräte. Diese stillen Benachrichtigungen sind für Benutzer unsichtbar, ohne Alarme, Töne oder Badges.
Jedes Gerät hat ein eindeutiges Push-Token, das von einem Benachrichtigungs-Gateway bereitgestellt wird. Wenn die App deinstalliert wurde, wird das Token ungültig. Wenn der stille Push fehlschlägt, gibt das Gateway einen Fehler zurück.
Pushwoosh erkennt den Fehler und entfernt das ungültige Token aus Ihrer Abonnentenliste.

Einschränkungen des Deinstallations-Trackings

Benachrichtigungs-Gateways garantieren nicht die Zustellung von stillen Pushes. Diese Nachrichten können vom Gateway depriorisiert oder verworfen werden, was die Genauigkeit der Deinstallationserkennung verzögern oder einschränken kann. Mehr erfahren

Deinstallationsdaten anzeigen

Um die Deinstallationsaktivität zu überwachen, navigieren Sie zu Statistiken > Dashboards > Anwendungs-Dashboard in Ihrem Pushwoosh Control Panel. Das Diagramm App-Deinstallationen bietet eine Zeitachsenansicht der Deinstallationstrends für Ihre Anwendung.

Können Sie Benutzer nach dem Löschen eines Push-Tokens wiederherstellen?

Das Löschen eines Push-Tokens mit einer der unterstützten Methoden ist leicht umkehrbar.

Wenn ein Benutzer Ihre App erneut öffnet:

Das Pushwoosh SDK fordert automatisch ein neues Push-Token an.
Es registriert das Gerät dann erneut (über registerDevice).
Der Benutzer wird wieder zu einem aktiven Abonnenten und erhält zukünftig Push-Benachrichtigungen.