View a markdown version of this page

Amazon SNS-Verwaltung von Firebase Cloud Messaging-Endpunkten - Amazon Simple Notification Service
Verwaltung und Wartung von Geräte-TokenUngültige Token werden erkanntVeraltete Token entfernen

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.

Amazon SNS-Verwaltung von Firebase Cloud Messaging-Endpunkten

Verwaltung und Wartung von Geräte-Token

Sie können die Zustellbarkeit der Push-Benachrichtigungen Ihrer mobilen Anwendung sicherstellen, indem Sie die folgenden Schritte ausführen:

  1. Speichern Sie alle Geräte-Token, die entsprechenden Amazon SNS-Endpunkt-ARNs und Zeitstempel auf Ihrem Anwendungsserver.

  2. Entfernen Sie alle veralteten Token und löschen Sie die entsprechenden Amazon 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. Nachdem Sie dieses Geräte-Token erhalten haben, können Sie es bei Amazon SNS als Plattformendpunkt registrieren. Wir empfehlen, dass Sie das Geräte-Token, den ARN des Amazon SNS-Plattformendpunkts und den Zeitstempel 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 unter Abrufen und Speichern von Registrierungstoken in der Firebase-Dokumentation von Google.

Es ist wichtig, dass Sie die Token auf dem neuesten Stand halten. Die Geräte-Token Ihres Benutzers können sich unter den folgenden Bedingungen ändern:

  1. Die mobile Anwendung wird auf einem neuen Gerät wiederhergestellt.

  2. Der Benutzer deinstalliert oder aktualisiert die Anwendung.

  3. Der Benutzer löscht die Anwendungsdaten.

Wenn sich Ihr Geräte-Token ändert, empfehlen wir Ihnen, den entsprechenden Amazon 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 geplanter Job im Hintergrund ausgeführt werden.

Pseudo-Code

Verwenden Sie den folgenden FCM-Pseudocode, um Geräte-Token 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
endif

Weitere Informationen zu den Anforderungen für Token-Updates finden Sie in der Firebase-Dokumentation von Google unter Regelmäßiges Aktualisieren von Tokens.

Ungültige Token werden erkannt

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, bei dem die Zustellung fehlschlägt. Das Plattform-TokenInvalidPlatformToken, das dem Endpunkt zugeordnet ist, ist ungültig. FailureType FailureMessage Amazon SNS deaktiviert Ihren Plattformendpunkt, wenn eine Zustellung aufgrund 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 ErrorCode in der Firebase-Dokumentation von Google.

Da Amazon SNS in beiden Fällen zurückgegeben werden INVALID_ARGUMENT kann, gibt Amazon SNS den Wert FailureType von zurückInvalidNotification, und FailureMessage der Benachrichtigungstext ist ungültig. Wenn Sie diesen Fehler erhalten, überprüfen Sie, ob Ihre Payload korrekt ist. Wenn es korrekt ist, überprüfen Sie, ob das Geräte-Token aktuell ist. Amazon SNS deaktiviert Ihren Plattformendpunkt nicht, wenn eine Lieferung mit dieser Ausnahme fehlschlägt.

Ein weiterer Fall, in dem die InvalidPlatformToken Zustellung fehlschlägt, 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 Zustellung mit dieser Ausnahme fehlschlägt.

Alle beobachteten Fehlercodes, die Sie von der FCM-v1-API erhalten haben, stehen Ihnen zur Verfügung, CloudWatch wenn Sie die Protokollierung des Versandstatus für Ihre Anwendung einrichten.

Informationen zum Empfangen von Lieferereignissen für Ihre Anwendung finden Sie unterVerfügbare Anwendungsereignisse.

Veraltete Token entfernen

Token gelten als veraltet, sobald die Nachrichtenzustellung an das Endpunktgerä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 Symbol „Von“ zurückEndpointDisabled, und ein FailureMessage „Endpunkt ist deaktiviert“. FailureType Informationen zum Empfangen von Übermittlungsereignissen für Ihre Anwendung finden Sie unterVerfügbare Anwendungsereignisse.

Wenn Sie diese Fehlermeldung von Amazon SNS erhalten, müssen Sie das veraltete Token in Ihrer Plattformanwendung entfernen oder aktualisieren.