Notifikasi Amazon SNS untuk produk SaaS - AWS Marketplace
Topik Amazon SNS: aws-mp-entitlement-notificationTopik Amazon SNS: aws-mp-subscription-notificationBerlangganan antrian SQS ke topik SNS

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Notifikasi Amazon SNS untuk produk SaaS

Untuk menerima notifikasi, Anda berlangganan topik AWS Marketplace Amazon Simple Notification Service (Amazon SNS) yang diberikan kepada Anda selama pembuatan produk. Topik memberikan pemberitahuan tentang perubahan langganan pelanggan dan hak kontrak untuk produk Anda. Ini memungkinkan Anda mengetahui kapan harus menyediakan dan mencabut akses untuk pelanggan tertentu.

catatan

Selama proses pembuatan produk, Anda akan menerima Nama Sumber Daya Amazon (ARN) yang sebenarnya ke topik SNS. Sebagai contoh: arn:aws:sns:us-east-1:123456789012:aws-mp-subscription-notification-PRODUCTCODE

Topik Amazon SNS berikut tersedia untuk produk perangkat lunak sebagai layanan (SaaS):

  • Topik Amazon SNS: aws-mp-entitlement-notification— Topik ini memberi tahu Anda ketika pembeli membuat kontrak baru, meningkatkannya, memperbaruinya, atau kedaluwarsa. Ini hanya tersedia untuk produk dengan model harga yang mencakup kontrak (juga dikenal sebagai Kontrak SaaS dan Kontrak SaaS dengan Konsumsi (Kelebihan)).

  • Topik Amazon SNS: aws-mp-subscription-notification— Topik ini memberi tahu Anda ketika pembeli berlangganan atau berhenti berlangganan produk dan menyertakan penawaran offer-identifier untuk pribadi dan bendera uji coba gratis untuk uji coba gratis SaaS. Ini tersedia untuk semua model harga, termasuk kontrak dan langganan (juga dikenal sebagai Langganan SaaS, Kontrak SaaS, dan Kontrak SaaS dengan Konsumsi (Kelebihan).

Untuk mempelajari lebih lanjut tentang skenario di mana Anda merespons notifikasi ini, lihat topik berikut:

Topik Amazon SNS: aws-mp-entitlement-notification

Setiap pesan dalam aws-mp-entitlement-notification topik memiliki format berikut.

{
    "action": "<action-name>",
    "customer-identifier": " X01EXAMPLEX",
    "product-code": "n0123EXAMPLEXXXXXXXXXXXX",
}

<action-name>Akan selalu begitu entitlement-updated.

catatan

  • Untuk pesan hak, terlepas dari tindakannya (baru, peningkatan, pembaruan, atau kedaluwarsa), pesannya sama. Panggilan berikutnya GetEntitlement diperlukan untuk menemukan konten pembaruan.

  • Untuk Kontrak SaaS dengan Konsumsi (Kelebihan), penjual diberikan topik SNS. aws-mp-subscription-notification Ini adalah pemberitahuan tambahan yang diterima penjual ketika mereka menambahkan harga berlebih. Ketika penjual memperoleh pelanggan baru, alih-alih hanya mendapatkan entitlement-updated (yang dapat merujuk pada segala jenis tindakan), penjual menerima pesan berlangganan yang menunjukkan bahwa ini adalah pelanggan baru.

  • Untuk future dated agreement (FDA), topik ini dimulai pada tanggal mulai perjanjian (dan bukan tanggal tanda perjanjian). Ini juga dimulai ketika perubahan berikutnya terjadi dalam hak, seperti pembatalan, penggantian, pembaruan, atau kedaluwarsa perjanjian.

Produk dengan harga kontrak (termasuk kontrak dengan pay-as-you-go) harus menanggapi pesan-pesan ini. Untuk informasi selengkapnya tentang cara merespons, lihatSkenario: Pantau perubahan langganan pengguna.

Topik Amazon SNS: aws-mp-subscription-notification

Setiap pesan dalam aws-mp-subscription-notification topik memiliki format berikut.

{
    "action": "<action-name>",
    "customer-identifier": " X01EXAMPLEX",
    "product-code": "n0123EXAMPLEXXXXXXXXXXXX",
    "offer-identifier": "offer-abcexample123",
    "isFreeTrialTermPresent":"true"
}

offer-identifierSatu-satunya muncul di notifikasi jika penawaran itu adalah penawaran pribadi.

isFreeTrialTermPresentProperti menunjukkan apakah langganan pembeli adalah uji coba gratis. Nilai JSON dari properti ini bukan tipe data boolean. Sebaliknya, nilai dikonversi ke tipe data string. Untuk informasi lebih lanjut, lihat uji coba gratis SaaS.

<action-name>Akan bervariasi tergantung pada notifikasi. Tindakan yang mungkin adalah:

  • subscribe-success— subscribe-success Pesan memberi sinyal ketika penjual dapat mulai mengirim catatan pengukuran.

  • subscribe-fail— Jika subscribe-fail pesan dihasilkan, pembayaran mungkin gagal meskipun pembeli telah beralih dari halaman arahan SaaS penjual AWS Marketplace ke penjual. Penjual harus menunggu subscribe-success pesan sebelum mengizinkan konsumsi produk.

  • unsubscribe-pending— Ketika pembeli berhenti berlangganan, unsubscribe-pending pesan dikirim terlebih dahulu. Ini menunjukkan bahwa penjual memiliki waktu terbatas (sekitar satu jam) untuk mendapatkan catatan pengukuran akhir yang dikirim sebelum pembeli dibatalkan sepenuhnya.

  • unsubscribe-success— unsubscribe-success Pesan menandakan selesainya pembatalan, setelah itu tidak ada catatan pengukuran lebih lanjut yang akan diterima.

catatan

  • Jika pembeli berhenti berlangganan dan kemudian segera berhasil berlangganan ulang sebelum unsubscribe-success pesan terakhir dikirim, pesan terakhir tidak akan dikirim dan unsubscribe-success pesan akan dikirim sebagai subscribe-success gantinya.

  • Untuk future dated agreement (FDA), tindakan sukses berlangganan dimulai pada tanggal mulai perjanjian (dan bukan tanggal tanda perjanjian).

Produk dengan harga berlangganan (termasuk kontrak dengan pay-as-you-go) harus menanggapi pesan-pesan ini. Untuk informasi selengkapnya tentang cara merespons, lihat topik berikut:

Berlangganan antrian SQS ke topik SNS

Sebaiknya berlangganan antrian Amazon SQS ke topik SNS yang disediakan. Untuk petunjuk mendetail tentang cara membuat antrean SQS dan berlangganan antrian ke topik, lihat Berlangganan antrian Amazon SQS ke topik Amazon SNS di Panduan Pengembang Layanan Pemberitahuan Sederhana Amazon.

catatan

Anda hanya dapat berlangganan topik AWS Marketplace SNS dari yang Akun AWS digunakan untuk menjual produk. Namun, Anda dapat meneruskan pesan ke akun lain. Untuk informasi selengkapnya, lihat Mengirim pesan Amazon SNS ke antrean Amazon SQS di akun lain di Panduan Pengembang Layanan Pemberitahuan Sederhana Amazon.

Polling antrian SQS untuk pemberitahuan

Setelah Anda berlangganan antrean SQS Anda ke topik SNS, pesan disimpan dalam SQS. Anda harus menentukan layanan yang terus-menerus melakukan polling antrian, mencari pesan, dan menanganinya sesuai dengan itu.