Verwaltung Ihrer Push-Abonnentenbasis

In Pushwoosh wird jeder Abonnent durch ein Push-Token identifiziert, eine eindeutige Kennung, die 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 verstehen und wie sie funktionieren

Ein Push-Token ist eine eindeutige, anonyme Kennung, die 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:

1. Wenn die App zum ersten Mal gestartet wird, fordert sie vom Betriebssystem (OS) des Geräts die Erlaubnis an, Push-Benachrichtigungen zu erhalten.

2. 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 Anwendungs-Posteingang 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.

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

4. Pushwoosh speichert das Token sicher für zukünftige Nachrichten.

5. Wenn eine Benachrichtigung ausgelöst wird, verwendet Pushwoosh das gespeicherte Token, um die Nachricht über das entsprechende Zustellungs-Gateway zu leiten.

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

7. Wenn das Push-Token ungültig wird (z. B. durch Deinstallation der App), erkennt Pushwoosh den Zustellungsfehler nach einem weiteren Versand einer Benachrichtigung, wenn das Gateway die Liste der Versandfehler 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	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 wenigen Minuten bis zu mehreren Tagen dauern. Mehr erfahren	Token wird bei der Deinstallation sofort ungültig. Nachfolgende Sendungen geben einen Unregistered-Fehler zurück. Mehr erfahren
Token-Aktualisierung	APNs stellt nach Betriebssystem-Upgrades, Wiederherstellung von Geräte-Backups, Neuinstallation der App 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

Wichtig

Pushwoosh stellt die Gültigkeit eines Tokens nur fest, wenn eine Push-Benachrichtigung nicht zugestellt werden kann. Es prüft den Token-Status nicht proaktiv.

So halten Sie Ihre Abonnentenliste durch Entfernen ungültiger Push-Token sauber

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 Sendungen ausgeschlossen wird.

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

Geräte über die API abmelden

Hilfe von Entwicklern erforderlich

Das Abmelden von Geräten über die API erfordert die Unterstützung Ihres Entwicklungsteams. Bitte teilen Sie diese Anleitung mit ihnen, um den Prozess zu implementieren.

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

So geht’s:

1. Erstellen Sie ein Segment von Benutzern, das Ihren Kriterien entspricht (z. B. abgemeldete, kostenlose Benutzer oder solche, die seit X Tagen inaktiv sind).
2. Exportieren Sie das Segment über das Control Panel oder die exportSegment API-Methode.
3. 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 von Inaktivität in Pushwoosh hilft, 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.

Wichtig

Diese Funktion ist standardmäßig für alle Konten aktiviert, die am oder nach dem 1. Januar 2024 erstellt wurden. Um zu überprüfen, ob sie für Ihr Konto aktiv ist, oder um die Aktivierung anzufordern, kontaktieren Sie bitte den Pushwoosh-Support.

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.

So funktioniert es:

1. 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.
2. 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 die stille Push-Benachrichtigung fehlschlägt, gibt das Gateway einen Fehler zurück.
3. Pushwoosh erkennt den Fehler und entfernt das ungültige Token aus Ihrer Abonnentenliste.

Wichtig

Das Deinstallations-Tracking sendet täglich stille Push-Benachrichtigungen an alle Abonnenten, was die Systemlast erhöhen kann. Stellen Sie sicher, dass Ihre Infrastruktur dieses Volumen unterstützen kann. Die Funktion ist auf unterstützten Plattformen standardmäßig aktiviert. Um sie zu deaktivieren, kontaktieren Sie den Pushwoosh-Support oder Ihren Customer Success Manager.

Einschränkungen des Deinstallations-Trackings

Benachrichtigungs-Gateways garantieren nicht die Zustellung von stillen Push-Benachrichtigungen. 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 den Statistics > Dashboards > Application dashboard in Ihrem Pushwoosh Control Panel. Das App Uninstalls-Diagramm bietet eine Zeitachsenansicht der Deinstallationstrends für Ihre Anwendung.

Können Sie Benutzer nach dem Löschen von Push-Token wiederherstellen?

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

Wenn ein Benutzer Ihre App erneut öffnet:

1. Das Pushwoosh SDK fordert automatisch ein neues Push-Token an.
2. Es registriert dann das Gerät erneut (über registerDevice).
3. Der Benutzer wird wieder ein aktiver Abonnent und erhält zukünftig Push-Benachrichtigungen.