Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
Verwaltung und Pflege von Geräte-Token
Sie können die Zustellbarkeit der Push-Benachrichtigungen Ihrer mobilen Anwendung sicherstellen, indem Sie die folgenden Schritte ausführen:
-
Speichern Sie alle Geräte-Token, den entsprechenden Amazon SNS SNS-Endpunkt ARNs und die Zeitstempel auf Ihrem Anwendungsserver.
-
Entfernen Sie alle veralteten Token und löschen Sie den entsprechenden Amazon SNS SNS-Endpunkt. ARNs
Beim ersten Start Ihrer App erhalten Sie ein Geräte-Token (auch als Registrierungstoken bezeichnet) für das Gerät. Dieses Geräte-Token wird vom Betriebssystem des Geräts geprägt und ist an Ihre FCM-Anwendung gebunden. Sobald Sie dieses Geräte-Token erhalten haben, können Sie es bei Amazon SNS als Plattformendpunkt registrieren. Wir empfehlen Ihnen, das Geräte-Token, den ARN des Amazon SNS SNS-Plattformendpunkts und den Zeitstempel zu speichern, indem Sie sie auf Ihrem Anwendungsserver oder einem anderen persistenten Speicher speichern. Informationen zum Einrichten Ihrer FCM-Anwendung zum Abrufen und Speichern von Gerätetokens finden Sie in der Firebase-Dokumentation von Google unter Registrierungstoken abrufen und speichern
Es ist wichtig, dass Sie Tokens verwalten up-to-date. Die Geräte-Token Ihres Benutzers können sich unter den folgenden Bedingungen ändern:
-
Die mobile Anwendung wird auf einem neuen Gerät wiederhergestellt.
-
Der Benutzer deinstalliert oder aktualisiert die Anwendung.
-
Der Benutzer löscht die Anwendungsdaten.
Wenn sich Ihr Geräte-Token ändert, empfehlen wir Ihnen, den entsprechenden Amazon SNS SNS-Endpunkt mit dem neuen Token zu aktualisieren. Dadurch kann Amazon SNS die Kommunikation mit dem registrierten Gerät fortsetzen. Sie können dies tun, indem Sie den folgenden Pseudocode in Ihrer mobilen Anwendung implementieren. Es beschreibt eine empfohlene Vorgehensweise für die Erstellung und Wartung aktivierter Plattformendpunkte. Dieser Ansatz kann bei jedem Start der mobilen Anwendungen oder als geplante Aufgabe im Hintergrund ausgeführt werden.
Pseudo-Code
Verwenden Sie den folgenden FCM-Pseudocode, um Gerätetokens zu verwalten und zu verwalten.
retrieve the latest token from the mobile OS
if (endpoint arn not stored)
# first time registration
call CreatePlatformEndpoint
store returned endpoint arn
endif
call GetEndpointAttributes on the endpoint arn
if (getting attributes encountered NotFound exception)
#endpoint was deleted
call CreatePlatformEndpoint
store returned endpoint arn
else
if (token in endpoint does not match latest) or
(GetEndpointAttributes shows endpoint as disabled)
call SetEndpointAttributes to set the
latest token and enable the endpoint
endif
endifWeitere Informationen zu den Anforderungen für Token-Updates finden Sie unter Regelmäßiges Aktualisieren von Tokens in der
Erkennung ungültiger Token
Wenn eine Nachricht mit einem ungültigen Geräte-Token an einen FCM v1-Endpunkt gesendet wird, erhält Amazon SNS eine der folgenden Ausnahmen:
-
UNREGISTERED(HTTP 404) — Wenn Amazon SNS diese Ausnahme empfängt, erhalten Sie ein Ereignis mit einem Zustellungsfehler mit dem WertFailureTypevonInvalidPlatformToken, und einFailureMessagedem Endpunkt zugeordnetes Plattform-Token ist ungültig. Amazon SNS deaktiviert Ihren Plattformendpunkt, wenn eine Lieferung mit dieser Ausnahme fehlschlägt. -
INVALID_ARGUMENT(HTTP 400) — Wenn Amazon SNS diese Ausnahme empfängt, bedeutet dies, dass das Geräte-Token oder die Nachrichtennutzlast ungültig ist. Weitere Informationen finden Sie ErrorCodein der Firebase-Dokumentation von Google.
Da Amazon SNS in beiden Fällen zurückgesendet werden INVALID_ARGUMENT kann, gibt Amazon SNS ein of zurückInvalidNotification, und ein FailureType FailureMessage of der Benachrichtigungstext ist ungültig. Wenn Sie diesen Fehler erhalten, überprüfen Sie, ob Ihre Payload korrekt ist. Wenn sie korrekt ist, überprüfen Sie, ob das Geräte-Token korrekt ist up-to-date. Amazon SNS deaktiviert Ihren Plattformendpunkt nicht, wenn eine Lieferung fehlschlägt, mit dieser Ausnahme.
Ein weiterer Fall, in dem ein InvalidPlatformToken Zustellungsfehler auftritt, ist, wenn das registrierte Geräte-Token nicht zu der Anwendung gehört, die versucht, diese Nachricht zu senden. In diesem Fall gibt Google einen SENDER_ID_MISMATCH-Fehler zurück. Amazon SNS deaktiviert Ihren Plattformendpunkt, wenn eine Lieferung mit dieser Ausnahme fehlschlägt.
Alle beobachteten Fehlercodes, die von der FCM v1-API empfangen wurden, stehen Ihnen zur Verfügung, CloudWatch wenn Sie die Versandstatusprotokollierung für Ihre Anwendung einrichten.
Informationen zum Empfang von Zustellungsereignissen für Ihre Anwendung finden Sie unterVerfügbare Anwendungsereignisse.
Veraltete Token entfernen
Token gelten als veraltet, sobald die Nachrichtenzustellung an das Endgerät fehlschlägt. Amazon SNS legt diese veralteten Token als deaktivierte Endpunkte für Ihre Plattformanwendung fest. Wenn Sie auf einem deaktivierten Endpunkt veröffentlichen, gibt Amazon SNS ein EventDeliveryFailure Ereignis mit dem Wert FailureType of zurückEndpointDisabled, und FailureMessage der Endpunkt ist deaktiviert. Informationen zum Empfang von Zustellungsereignissen für Ihre Anwendung finden Sie unterVerfügbare Anwendungsereignisse.
Wenn Sie diesen Fehler von Amazon SNS erhalten, müssen Sie das veraltete Token in Ihrer Plattformanwendung entfernen oder aktualisieren.
