SNSGestione Amazon degli endpoint Firebase Cloud Messaging - Amazon Simple Notification Service

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

SNSGestione Amazon degli endpoint Firebase Cloud Messaging

Gestione e manutenzione dei token dei dispositivi

Puoi garantire la consegna delle notifiche push della tua applicazione mobile seguendo questi passaggi:

  1. Archivia tutti i token del dispositivo, l'SNSendpoint ARNs Amazon corrispondente e i timestamp sul tuo server delle applicazioni.

  2. Rimuovi tutti i token obsoleti ed elimina l'endpoint Amazon SNS corrispondente. ARNs

All'avvio iniziale dell'app, riceverai un token del dispositivo (noto anche come token di registrazione) per il dispositivo. Questo token del dispositivo viene coniato dal sistema operativo del dispositivo ed è collegato all'applicazione. FCM Una volta ricevuto questo token del dispositivo, puoi registrarlo su Amazon SNS come endpoint della piattaforma. Ti consigliamo di archiviare il token del dispositivo, l'endpoint ARN della SNS piattaforma Amazon e il timestamp salvandoli sul tuo server delle applicazioni o su un altro archivio persistente. Per configurare FCM l'applicazione per recuperare e archiviare i token del dispositivo, consulta Recuperare e archiviare i token di registrazione nella documentazione di Google su Firebase.

È importante mantenere i token. up-to-date I token del dispositivo dell'utente possono cambiare nelle seguenti condizioni:

  1. L'applicazione mobile viene ripristinata su un nuovo dispositivo.

  2. L'utente disinstalla o aggiorna l'applicazione.

  3. L'utente cancella i dati dell'applicazione.

Quando il token del dispositivo cambia, ti consigliamo di aggiornare l'SNSendpoint Amazon corrispondente con il nuovo token. Ciò consente SNS ad Amazon di continuare la comunicazione con il dispositivo registrato. Puoi farlo implementando il seguente pseudo codice all'interno della tua applicazione mobile. Descrive una pratica consigliata per la creazione e la manutenzione degli endpoint della piattaforma abilitati. Questo approccio può essere eseguito ogni volta che le applicazioni mobili vengono avviate o come processo pianificato in background.

Pseudocodice

Utilizza il seguente FCM pseudo codice per gestire e mantenere i token del dispositivo.

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

Per ulteriori informazioni sui requisiti di aggiornamento dei token, consulta Aggiornare i token regolarmente nella documentazione di Google su Firebase.

Rilevamento di token non validi

Quando un messaggio viene inviato a un endpoint FCM v1 con un token di dispositivo non valido, Amazon SNS riceverà una delle seguenti eccezioni:

  • UNREGISTERED(HTTP404) — Quando Amazon SNS riceve questa eccezione, riceverai un evento di errore FailureType di InvalidPlatformToken consegna con un token di piattaforma FailureMessage of e uno di Platform associato all'endpoint non valido. Amazon SNS disabiliterà l'endpoint della tua piattaforma quando una consegna fallisce, con questa eccezione.

  • INVALID_ARGUMENT(HTTP400) — Quando Amazon SNS riceve questa eccezione, significa che il token del dispositivo o il payload del messaggio non sono validi. Per ulteriori informazioni, consulta la documentazione ErrorCodedi Google su Firebase.

Poiché INVALID_ARGUMENT può essere restituito in entrambi i casi, Amazon SNS restituirà un corpo FailureType FailureMessage di InvalidNotification notifica e uno non è valido. Quando ricevi questo errore, verifica che il payload sia corretto. Se è corretto, verifica che il token del dispositivo lo sia up-to-date. Amazon non SNS disattiverà l'endpoint della tua piattaforma quando una consegna fallisce, con questa eccezione.

Un altro caso in cui si verificherà un errore di InvalidPlatformToken consegna è quando il token del dispositivo registrato non appartiene all'applicazione che tenta di inviare il messaggio. In questo caso, Google restituirà un errore SENDER_ID_ MISMATCH. Amazon SNS disabiliterà l'endpoint della tua piattaforma quando una consegna fallisce, con questa eccezione.

Tutti i codici di errore rilevati ricevuti dalla FCM v1 API sono disponibili CloudWatch quando configuri la registrazione dello stato di consegna per la tua applicazione.

Per ricevere gli eventi di consegna per la tua applicazione, consulta. Eventi applicazione disponibili

Rimuovere i token obsoleti

I token vengono considerati obsoleti una volta che il recapito dei messaggi al dispositivo endpoint inizia a fallire. Amazon SNS imposta questi token obsoleti come endpoint disabilitati per l'applicazione della tua piattaforma. Quando pubblichi su un endpoint disabilitato, Amazon SNS restituirà un EventDeliveryFailure evento con FailureType of EndpointDisabled e un FailureMessage endpoint è disabilitato. Per ricevere gli eventi di consegna della tua applicazione, consulta. Eventi applicazione disponibili

Quando ricevi questo errore da AmazonSNS, devi rimuovere o aggiornare il token obsoleto nell'applicazione della tua piattaforma.