Attributi dell'app mobile Amazon SNS - 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à.

Attributi dell'app mobile Amazon SNS

Amazon Simple Notification Service (Amazon SNS) fornisce supporto per la registrazione dello stato di consegna dei messaggi di notifica push. Dopo aver configurato gli attributi dell'applicazione, le voci di registro verranno inviate a CloudWatch Logs per i messaggi inviati da Amazon SNS agli endpoint mobili. La registrazione dello stato di consegna dei messaggi consente di ottenere informazioni operative più precise, ad esempio:

  • Sapere se un messaggio di notifica push è stato consegnato da Amazon SNS al servizio di notifica push.

  • Identificare la risposta inviata dal servizio di notifica push a Amazon SNS.

  • Determinare il tempo di attesa dei messaggi (il periodo di tempo tra il timestamp di pubblicazione e l'istante immediatamente precedente alla consegna a un servizio di notifica push).

Per configurare gli attributi dell'applicazione per lo stato di consegna dei messaggi, puoi utilizzare i AWS Management Console kit di sviluppo AWS software (SDKs) o l'API di interrogazione.

Configurazione degli attributi dello stato di recapito dei messaggi utilizzando il AWS Management Console

  1. Accedi alla console Amazon SNS.

  2. Nel riquadro di navigazione, scegliere Mobile (Dispositivi mobili), Push notifications (Notifiche push).

  3. Nella sezione Applicazioni della piattaforma, scegli l'applicazione che contiene gli endpoint per i quali desideri ricevere CloudWatch i registri.

  4. Scegli Application Actions (Operazioni applicazione), quindi scegli Delivery status (Stato consegna).

  5. Nella finestra di dialogo Delivery Status (Stato consegna), scegli Create IAM Roles (Crea ruoli IAM).

    Si viene reindirizzati alla console IAM.

  6. Scegli Consenti per consentire ad Amazon SNS l'accesso in scrittura per utilizzare CloudWatch i log per tuo conto.

  7. Ora, tornando alla finestra di dialogo Delivery Status, inserisci un numero nel campo Percentuale di successo su campione (0-100) per indicare la percentuale di messaggi inviati con successo per i quali desideri ricevere i log. CloudWatch

    Nota

    Dopo aver configurato gli attributi dell'applicazione per lo stato di consegna dei messaggi, tutti i recapiti dei messaggi non riusciti generano registri. CloudWatch

  8. Infine scegli Save Configuration (Salva configurazione). Ora sarai in grado di visualizzare e analizzare i CloudWatch registri contenenti lo stato di consegna dei messaggi. Per ulteriori informazioni sull'utilizzo CloudWatch, consulta la CloudWatch documentazione.

Esempi di log sullo stato CloudWatch di consegna dei messaggi di Amazon SNS

Dopo aver configurato gli attributi dello stato di consegna dei messaggi per un endpoint dell'applicazione, verranno CloudWatch generati i log. Di seguito vengono forniti degli esempi di log in formato JSON:

RIUSCITO

{ "status": "SUCCESS", "notification": { "timestamp": "2015-01-26 23:07:39.54", "messageId": "9655abe4-6ed6-5734-89f7-e6a6a42de02a" }, "delivery": { "statusCode": 200, "dwellTimeMs": 65, "token": "Examplei7fFachkJ1xjlqT64RaBkcGHochmf1VQAr9k-IBJtKjp7fedYPzEwT_Pq3Tu0lroqro1cwWJUvgkcPPYcaXCpPWmG3Bqn-wiqIEzp5zZ7y_jsM0PKPxKhddCzx6paEsyay9Zn3D4wNUJb8m6HXrBf9dqaEw", "attempts": 1, "providerResponse": "{\"multicast_id\":5138139752481671853,\"success\":1,\"failure\":0,\"canonical_ids\":0,\"results\":[{\"message_id\":\"0:1422313659698010%d6ba8edff9fd7ecd\"}]}", "destination": "arn:aws:sns:us-east-2:111122223333:endpoint/FCM/FCMPushApp/c23e42de-3699-3639-84dd-65f84474629d" } }

NON RIUSCITO

{ "status": "FAILURE", "notification": { "timestamp": "2015-01-26 23:29:35.678", "messageId": "c3ad79b0-8996-550a-8bfa-24f05989898f" }, "delivery": { "statusCode": 8, "dwellTimeMs": 1451, "token": "examp1e29z6j5c4df46f80189c4c83fjcgf7f6257e98542d2jt3395kj73", "attempts": 1, "providerResponse": "NotificationErrorResponse(command=8, status=InvalidToken, id=1, cause=null)", "destination": "arn:aws:sns:us-east-2:111122223333:endpoint/APNS_SANDBOX/APNSPushApp/986cb8a1-4f6b-34b1-9a1b-d9e9cb553944" } }

Per un elenco dei codici di risposta dei servizi di notifica push, consulta Codici di risposta della piattaforma.

Configurazione degli attributi dello stato di consegna dei messaggi con AWS SDKs

AWS SDKsForniscono APIs in diverse lingue per l'utilizzo degli attributi dello stato di consegna dei messaggi con Amazon SNS.

L'esempio Java seguente mostra come utilizzare l'API SetPlatformApplicationAttributes per configurare attributi di applicazione per lo stato di consegna dei messaggi di notifica push. Puoi utilizzare i seguenti attributi per lo stato di consegna dei messaggi: SuccessFeedbackRoleArn, FailureFeedbackRoleArn e SuccessFeedbackSampleRate. FailureFeedbackRoleArnGli attributi SuccessFeedbackRoleArn and vengono utilizzati per consentire ad Amazon SNS l'accesso in scrittura per utilizzare CloudWatch i log per tuo conto. L'attributo SuccessFeedbackSampleRate consente di specificare la percentuale della frequenza di campionamento (0-100) dei messaggi consegnati. Dopo aver configurato l'FailureFeedbackRoleArnattributo, tutte le consegne di messaggi non riuscite generano log. CloudWatch

SetPlatformApplicationAttributesRequest setPlatformApplicationAttributesRequest = new SetPlatformApplicationAttributesRequest(); Map<String, String> attributes = new HashMap<>(); attributes.put("SuccessFeedbackRoleArn", "arn:aws:iam::111122223333:role/SNS_CWlogs"); attributes.put("FailureFeedbackRoleArn", "arn:aws:iam::111122223333:role/SNS_CWlogs"); attributes.put("SuccessFeedbackSampleRate", "5"); setPlatformApplicationAttributesRequest.withAttributes(attributes); setPlatformApplicationAttributesRequest.setPlatformApplicationArn("arn:aws:sns:us-west-2:111122223333:app/FCM/FCMPushApp"); sns.setPlatformApplicationAttributes(setPlatformApplicationAttributesRequest);

Per ulteriori informazioni su SDK per Java, consulta Nozioni di base su AWS SDK for Java.

Codici di risposta della piattaforma

Di seguito viene fornito un elenco dei collegamenti per i codici di risposta dei servizi di notifica push:

Servizio di notifiche push Codice di risposta
Amazon Device Messaging (ADM) Vedi Formato di risposta nella documentazione ADM.
Servizio di notifica push Apple () APNs Vedi la risposta HTTP/2 APNs in Comunicazione con APNs nella Guida alla programmazione delle notifiche locali e remote.
Firebase Cloud Messaging (FCM) Vedi Codici di risposta a messaggi di errore downstream nella documentazione di Firebase Cloud Messaging.
Servizio di notifica push Microsoft per Windows Phone (MPNS) Vedi Push Notification Service Response Codes for Windows Phone 8 nella documentazione di Windows 8 Development.
Windows Push Notification Services (WNS) Vedi "Codici di risposta" in Intestazioni delle richieste e delle risposte per il servizio di notifica Push (app di Windows Runtime) nella documentazione di sviluppo per Windows 8.