Atribut aplikasi seluler

Amazon Simple Notification Service (Amazon SNS) menyediakan dukungan untuk mencatat status pengiriman pesan notifikasi push. Setelah Anda mengonfigurasi atribut aplikasi, entri log akan dikirim ke CloudWatch Logs untuk pesan yang dikirim dari Amazon SNS ke endpoint seluler. Mencatat status pengiriman pesan membantu memberikan wawasan operasional yang lebih baik, seperti berikut ini:

• Mengetahui apakah pesan notifikasi push dikirim dari Amazon SNS ke layanan notifikasi push.

• Mengidentifikasi respons yang dikirim dari layanan notifikasi push ke Amazon SNS.

• Tentukan waktu tunggu pesan (waktu antara stempel waktu publikasi dan sesaat sebelum diserahkan ke layanan notifikasi push).

Untuk mengonfigurasi atribut aplikasi untuk status pengiriman pesan, Anda dapat menggunakan AWS Management Console, perangkat pengembangan perangkat lunak (SDK) AWS, atau API kueri.

Mengonfigurasi atribut status pengiriman pesan menggunakan AWS Management Console

1. Masuk ke konsol Amazon SNS.

2. Pada panel navigasi, arahkan ke Seluler, lalu pilih Notifikasi push.

3. Dari bagian Aplikasi platform, pilih aplikasi yang berisi endpoint yang Anda inginkan untuk menerima CloudWatch Logs.

4. Pilih Tindakan Aplikasi lalu pilih Status Pengiriman.

5. Pada kotak dialog Status Pengiriman, pilih Buat Peran IAM.

   Anda kemudian akan diarahkan ke konsol IAM.

6. Pilih Izinkan untuk memberikan akses tulis Amazon SNS untuk menggunakan CloudWatch Logs atas nama Anda.

7. Sekarang, kembali ke kotak dialog Status Pengiriman, masukkan angka di bidang Persentase Sukses untuk Sampel (0-100) untuk persentase pesan yang berhasil dikirim yang ingin Anda menerima CloudWatch Logs.

   catatan

   Setelah Anda mengonfigurasi atribut aplikasi untuk status pengiriman pesan, semua pengiriman pesan yang gagal menghasilkan CloudWatch Logs.

8. Terakhir, pilih Simpan Konfigurasi. Anda sekarang dapat melihat dan menguraikan CloudWatch Logs yang berisi status pengiriman pesan. Untuk informasi selengkapnya tentang menggunakan CloudWatch, lihat Dokumentasi CloudWatch.

Status pengiriman pesan Amazon SNS contoh log CloudWatch

Setelah Anda mengonfigurasi atribut status pengiriman pesan untuk endpoint aplikasi, CloudWatch Logs akan dibuat. Contoh log, dalam format JSON, ditampilkan sebagai berikut:

KEBERHASILAN

{
  "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"
  }
}

KEGAGALAN

{
  "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"
  }
}

Untuk daftar kode respons layanan notifikasi push, lihat Kode respons platform.

Mengonfigurasi atribut status pengiriman pesan dengan AWS SDK

AWS SDK menyediakan API dalam beberapa bahasa untuk menggunakan atribut status pengiriman pesan dengan Amazon SNS.

Contoh Java berikut menunjukkan cara menggunakan API SetPlatformApplicationAttributes untuk mengonfigurasi atribut aplikasi untuk status pengiriman pesan dari pesan notifikasi push. Anda dapat menggunakan atribut berikut untuk status pengiriman pesan: SuccessFeedbackRoleArn, FailureFeedbackRoleArn, dan SuccessFeedbackSampleRate. Atribut SuccessFeedbackRoleArn dan FailureFeedbackRoleArn digunakan untuk memberikan akses tulis Amazon SNS untuk menggunakan CloudWatch Logs atas nama Anda. Atribut SuccessFeedbackSampleRate adalah untuk menentukan persentase tingkat sampel (0-100) dari pesan yang berhasil terkirim. Setelah Anda mengonfigurasi atribut FailureFeedbackRoleArn, maka semua pengiriman pesan yang gagal menghasilkan CloudWatch Logs.

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);

Untuk informasi selengkapnya tentang SDK for Java, lihat Memulai dengan AWS SDK for Java.

Kode respons platform

Berikut ini adalah daftar tautan untuk kode respons layanan notifikasi push:

Layanan notifikasi push	Kode respons
Olahpesan Perangkat Amazon (ADM)	Lihat Format Respons dalam dokumentasi ADM.
Layanan Notifikasi Push Apple (APN)	Lihat Respons HTTP/2 dari APN dalam Berkomunikasi dengan APN di Panduan Pemrograman Notifikasi Lokal dan Jarak Jauh.
Firebase Cloud Messaging (FCM)	Lihat Kode Respons Kesalahan Pesan Hilir di dokumentasi Firebase Cloud Messaging.
Layanan Notifikasi Push Microsoft untuk Ponsel Windows (MPNS)	Lihat Kode Respons Layanan Notifikasi Push untuk Ponsel Windows 8 dalam dokumentasi Pengembangan Windows 8.
Layanan Notifikasi Push Windows (WNS)	Lihat "Kode respons" di Permintaan Layanan Notifikasi Push dan Header Respons (Aplikasi Windows Runtime) di dokumentasi Pengembangan Windows 8.