View a markdown version of this page

Pemberitahuan Amazon SNS untuk produk SaaS - AWS Marketplace
Topik Amazon SNS: aws-mp-entitlement-notifikasiTopik Amazon SNS: aws-mp-berlangganan notifikasiBerlangganan 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.

Pemberitahuan Amazon SNS untuk produk SaaS

penting

Pemberitahuan SN AWS Marketplace S untuk produk SaaS diganti dengan EventBridge pemberitahuan Amazon. Jika Anda memiliki produk SaaS yang ada yang terintegrasi dengan SNS, mereka akan terus berfungsi. Daftar baru pada akhirnya akan beralih menggunakan Amazon al EventBridge ih-alih SNS. Untuk informasi selengkapnya, lihat Mengelola acara berlangganan SaaS dengan Amazon EventBridge.

Untuk menerima pemberitahuan, Anda berlangganan topik Amazon Simple Notification Service (Amazon SNS) 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 untuk 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 untuk 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-notifikasi— Topik ini memberi tahu Anda ketika pembeli membuat kontrak baru, meningkatkannya, memperbaruinya, atau kedaluwarsa. Ini hanya tersedia untuk produk dengan model harga yang menyertakan kontrak (juga dikenal sebagai Kontrak SaaS dan Kontrak SaaS dengan Konsumsi (Overages)).

  • Topik Amazon SNS: aws-mp-berlangganan notifikasi— Topik ini memberi tahu Anda ketika pembeli berlangganan atau berhenti berlangganan dari suatu produk dan menyertakan untuk penawaran pribadi dan bendera uji coba gratis offer-identifier 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 (Overages).

Untuk mempelajari lebih lanjut tentang skenario di mana Anda menanggapi pemberitahuan ini, lihat topik berikut:

Topik Amazon SNS: aws-mp-entitlement-notifikasi

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, upgrade, pembaruan, atau kedaluwarsa), pesannya sama. Panggilan berikutnya GetEntitlement diperlukan untuk menemukan konten pembaruan.

  • Untuk Kontrak SaaS dengan Konsumsi (Overages), 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 mungkin merujuk pada tindakan apa pun), penjual menerima pesan berlangganan yang menunjukkan bahwa ini adalah pelanggan baru.

  • Untuk perjanjian bertanggal mendatang (FDA), topik ini dimulai pada tanggal mulai perjanjian (dan bukan tanggal penandatanganan perjanjian). Ini juga dimulai ketika perubahan berikutnya terjadi dalam hak, seperti pembatalan, penggantian, pembaruan, atau berakhirnya perjanjian.

Produk dengan harga kontrak (termasuk kontrak dengan bayar sesuai penggunaan) harus menanggapi pesan-pesan ini. Untuk informasi selengkapnya tentang cara merespons, lihatSkenario: Pantau perubahan langganan pengguna.

Topik Amazon SNS: aws-mp-berlangganan notifikasi

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-identifierIni termasuk dalam notifikasi hanya ketika tindakan tersebut subscribe-success atausubscribe-fail. Itu tidak termasuk dalam notifikasi saat tindakan unsubscribe-pending atauunsubscribe-success. Untuk penawaran yang dibuat sebelum Januari 2024, pengenal ini disertakan dalam pemberitahuan hanya untuk penawaran pribadi. Untuk penawaran yang dibuat pada Januari 2024 dan yang lebih baru, pengenal ini disertakan dalam pemberitahuan untuk semua penawaran, termasuk penawaran pribadi dan penawaran publik.

Untuk informasi tentang jenis penawaran, lihat respons dari DescribeEntity API atau visibilitas penawaran dari perjanjian di dasbor pembaruan perjanjian.

catatan

Untuk DescribeEntity API, jika Anda menemukan aspek penargetan akun Akun AWS di aturan penargetan untuk penawaran tersebut, itu adalah penawaran pribadi. Jika tidak ada aturan penargetan Akun AWS aspek penargetan akun untuk penawaran tersebut, itu adalah penawaran umum.

Pro isFreeTrialTermPresent perti menunjukkan apakah langganan pembeli adalah uji coba gratis. Nilai JSON dari properti ini bukan tipe data boolean. Sebagai gantinya, nilainya dikonversi ke tipe data string. Untuk informasi selengkapnya, lihat uji coba gratis SaaS.

Ini <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 landing SaaS 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 penyelesaian 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 akhir tidak akan dikirim dan unsubscribe-success pesan akan dikirim sebagai gant subscribe-success inya.

  • Untuk perjanjian bertanggal di masa depan (FDA), subscribe-success tindakan dimulai pada tanggal mulai perjanjian (dan bukan tanggal penandatanganan perjanjian).

Produk dengan harga berlangganan (termasuk kontrak dengan bayar sesuai penggunaan) harus menanggapi pesan ini. Untuk informasi selengkapnya tentang cara merespons, lihat topik berikut:

Berlangganan antrian SQS ke topik SNS

Kami merekomendasikan untuk berlangganan antrian Amazon SQS ke topik SNS yang disediakan. Untuk petunjuk terperinci tentang membuat antrian SQS dan berlangganan antrian ke topik, lihat Ber langganan 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 yang berbeda. Untuk informasi selengkapnya, lihat Mengirim pesan Amazon SNS ke antrian Amazon SQS di akun lain di Panduan Pengembang Layanan Pem beritahuan Sederhana Amazon.

Polling antrian SQS untuk notifikasi

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