Menggunakan atribut pesan time to live (TTL) Amazon SNS untuk notifikasi push seluler

Amazon Simple Notification Service (Amazon SNS) menyediakan dukungan untuk menyetel atribut pesan Time To Live (TTL) untuk pesan notifikasi push seluler. Ini merupakan tambahan dari kemampuan yang ada untuk menyetel TTL dalam badan pesan Amazon SNS untuk layanan notifikasi push seluler yang mendukung hal ini, seperti Amazon Device Messaging (ADM) dan Firebase Cloud Messaging (FCM) saat mengirim ke Android.

Atribut pesan TTL digunakan untuk menentukan metadata kedaluwarsa tentang pesan. Ini memungkinkan Anda untuk menentukan berapa lama layanan notifikasi push, seperti Apple Push Notification Service (APN) atau FCM, harus mengirimkan pesan ke endpoint. Jika karena alasan tertentu (seperti perangkat seluler telah dimatikan) pesan tidak terkirim dalam TTL yang ditentukan, maka pesan akan dihapus dan tidak ada upaya pengiriman lebih lanjut yang akan dilakukan. Untuk menentukan TTL dalam atribut pesan, Anda dapat menggunakan AWS Management Console, kit pengembangan AWS perangkat lunak (SDK), atau API kueri.

Atribut pesan TTL untuk layanan notifikasi push

Berikut ini adalah daftar atribut pesan TTL untuk layanan pemberitahuan push yang dapat Anda gunakan untuk mengatur saat menggunakan AWS SDK atau API kueri:

Layanan notifikasi push	Atribut pesan TTL
Olahpesan Perangkat Amazon (ADM)	AWS.SNS.MOBILE.ADM.TTL
Layanan Notifikasi Push Apple (APN)	AWS.SNS.MOBILE.APNS.TTL
Sandbox Layanan Notifikasi Push Apple (APNS_Sandbox)	AWS.SNS.MOBILE.APNS_SANDBOX.TTL
Baidu Cloud Push (Baidu)	AWS.SNS.MOBILE.BAIDU.TTL
Firebase Cloud Messaging (FCM saat mengirim ke Android)	AWS.SNS.MOBILE.FCM.TTL
Layanan Notifikasi Push Windows (WNS)	AWS.SNS.MOBILE.WNS.TTL

Setiap layanan notifikasi push menangani TTL secara berbeda. Amazon SNS memberikan tampilan abstrak TTL di semua layanan notifikasi push, yang memudahkan untuk menentukan TTL. Saat Anda menggunakan AWS Management Console untuk menentukan TTL (dalam detik), Anda hanya perlu memasukkan nilai TTL sekali dan Amazon SNS kemudian akan menghitung TTL untuk setiap layanan pemberitahuan push yang dipilih saat menerbitkan pesan.

TTL relatif terhadap waktu publikasi. Sebelum menyerahkan pesan notifikasi push ke layanan notifikasi push tertentu, Amazon SNS menghitung waktu diam (waktu antara stempel waktu publikasi dan sesaat sebelum menyerahkan ke layanan notifikasi push) untuk notifikasi push dan meneruskan TTL yang tersisa ke spesifik layanan notifikasi push. Jika TTL lebih pendek dari waktu diam, Amazon SNS tidak akan mencoba untuk memublikasikan.

Jika Anda menentukan TTL untuk pesan notifikasi push, maka nilai TTL harus berupa bilangan bulat positif, kecuali nilai 0 memiliki arti khusus untuk layanan notifikasi push—seperti dengan APN dan FCM (saat mengirim ke Android). Jika nilai TTL diatur ke 0 dan layanan notifikasi push tidak memiliki arti khusus untuk 0, maka Amazon SNS akan menghapus pesan tersebut. Untuk informasi selengkapnya tentang parameter TTL yang disetel ke 0 saat menggunakan APN, lihat Tabel A-3 Pengidentifikasi item untuk notifikasi jarak jauh dalam dokumentasi API Penyedia Biner.

Urutan prioritas untuk menentukan TTL

Prioritas yang digunakan Amazon SNS untuk menentukan TTL untuk pesan notifikasi push didasarkan pada urutan berikut, di mana angka terendah memiliki prioritas tertinggi:

1. TTL atribut pesan

2. TTL isi pesan

3. TTL default layanan notifikasi push (bervariasi per layanan)

4. TTL default Amazon SNS (4 minggu)

Jika Anda menetapkan nilai TTL yang berbeda (satu di atribut pesan dan lainnya di isi pesan) untuk pesan yang sama, maka Amazon SNS akan memodifikasi TTL di isi pesan agar sesuai dengan TTL yang ditentukan dalam atribut pesan.

Menentukan TTL menggunakan AWS Management Console

1. Masuk ke konsol Amazon SNS.

2. Pada panel navigasi, pilih Seluler, Notifikasi push.

3. Pada halaman Notifikasi push seluler, di bagian Aplikasi platform, pilih aplikasi.

4. Pada MyApplicationhalaman, di bagian Endpoints, pilih endpoint aplikasi dan kemudian pilih Publish message.

5. Di bagian Detail pesan, masukkan TTL (jumlah detik yang dimiliki layanan notifikasi push untuk mengirimkan pesan ke endpoint).

6. Pilih Publish message (Publikasikan pesan).