SNSPemberitahuan Amazon untuk produk SaaS - AWS Marketplace
SNSTopik Amazon: aws-mp-entitlement-notificationSNSTopik Amazon: aws-mp-subscription-notificationBerlangganan SQS antrian ke topik SNS

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

SNSPemberitahuan Amazon untuk produk SaaS

Untuk menerima pemberitahuan, Anda berlangganan topik Amazon Simple Notification Service (AmazonSNS) yang AWS Marketplace 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 Amazon Resource Name (ARN) yang sebenarnya ke SNS topik tersebut. Sebagai contoh: arn:aws:sns:us-east-1:123456789012:aws-mp-subscription-notification-PRODUCTCODE

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

  • SNSTopik Amazon: 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)).

  • SNSTopik Amazon: 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 menanggapi pemberitahuan ini, lihat topik berikut:

SNSTopik Amazon: aws-mp-entitlement-notification

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

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

Bagian <action-name> akan selalu 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. aws-mp-subscription-notification SNS 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 (FDAs), 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 berakhirnya 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.

SNSTopik Amazon: 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. JSONNilai properti ini bukan tipe data boolean. Sebaliknya, nilai dikonversi ke tipe data string. Untuk informasi lebih lanjut, lihat uji coba gratis SaaS.

Bagian <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. Jika penawaran berbasis perjanjian diterima oleh pembeli, pesan ini dikirim lagi dengan yang baru. offer-identifier

  • 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 (FDAs), subscribe-success tindakan 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 SQS antrian ke topik SNS

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

catatan

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

Polling SQS antrian untuk pemberitahuan

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