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
**penting**
Notifikasi SNS untuk produk AWS Marketplace SaaS diganti dengan notifikasi Amazon EventBridge . Jika Anda memiliki produk SaaS yang terintegrasi dengan SNS, mereka akan terus berfungsi. Daftar baru pada akhirnya akan beralih ke menggunakan Amazon EventBridge alih-alih SNS. Untuk informasi selengkapnya, lihat [Mengelola acara berlangganan SaaS dengan Amazon EventBridge](saas-eventbridge-integration.md).
Untuk menerima pemberitahuan, Anda berlangganan topik Amazon Simple Notification Service (Amazon SNS) AWS Marketplace untuk 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`](#saas-sns-message-body)— 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`](#saas-sns-subscription-message-body)— 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:
+ [Mengintegrasikan langganan Pay-As-You-Go atau produk SaaS Anda dengan AWS Marketplace](saas-integrate-subscription.md)
+ [Mengintegrasikan produk kontrak SaaS Anda dengan AWS Marketplace](saas-integrate-contract.md)
+ [Mengintegrasikan produk berbasis kontrak SaaS Anda dengan AWS Marketplace](saas-integrate-contract-with-pay.md)
## Topik Amazon SNS: `aws-mp-entitlement-notification`
Setiap pesan dalam `aws-mp-entitlement-notification` topik memiliki format berikut.
```
{
"action": "",
"customer-identifier": " X01EXAMPLEX",
"product-code": "n0123EXAMPLEXXXXXXXXXXXX",
}
```
**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`](#saas-sns-subscription-message-body) 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 kedaluwarsa perjanjian.
Produk dengan harga kontrak (termasuk kontrak dengan pay-as-you-go) harus menanggapi pesan-pesan ini. Untuk informasi selengkapnya tentang cara merespons, lihat[Skenario: Pantau perubahan langganan pengguna](saas-integrate-contract.md#saas-contract-monitor-changes).
## Topik Amazon SNS: `aws-mp-subscription-notification`
Setiap pesan dalam `aws-mp-subscription-notification` topik memiliki format berikut.
```
{
"action": "",
"customer-identifier": " X01EXAMPLEX",
"product-code": "n0123EXAMPLEXXXXXXXXXXXX",
"offer-identifier": "offer-abcexample123",
"isFreeTrialTermPresent":"true"
}
```
`offer-identifier`Ini termasuk dalam pemberitahuan hanya ketika tindakan `subscribe-success` atau`subscribe-fail`. Itu tidak termasuk dalam notifikasi saat tindakan `unsubscribe-pending` atau`unsubscribe-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 tanggapan dari [DescribeEntity API](https://docs.aws.amazon.com//marketplace/latest/APIReference/work-with-private-offers.html#describe-entity) atau visibilitas penawaran perjanjian di dasbor [perpanjangan Perjanjian](https://docs.aws.amazon.com//marketplace/latest/userguide/agreements-renewals-dashboard.html).
**catatan**
Untuk [DescribeEntity API](https://docs.aws.amazon.com//marketplace/latest/APIReference/work-with-private-offers.html#describe-entity), jika Anda menemukan aspek penargetan Akun AWS dalam akun dari aturan penargetan untuk penawaran itu, itu adalah penawaran pribadi. Jika tidak ada aspek penargetan Akun AWS dalam akun dari aturan penargetan untuk penawaran itu, itu adalah penawaran umum.
`isFreeTrialTermPresent`Properti 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](https://docs.aws.amazon.com/marketplace/latest/userguide/saas-free-trials.html).
**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](https://docs.aws.amazon.com/marketplace/latest/userguide/private-offers-upgrades-and-renewals.html#private-offers-upgrades-and-renewals-process) 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:
+ [Mengintegrasikan langganan Pay-As-You-Go atau produk SaaS Anda dengan AWS Marketplace](saas-integrate-subscription.md)
+ [Mengintegrasikan produk berbasis kontrak SaaS Anda dengan AWS Marketplace](saas-integrate-contract-with-pay.md)
## 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](https://docs.aws.amazon.com/sns/latest/dg/subscribe-sqs-queue-to-sns-topic.html).*
**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](https://docs.aws.amazon.com/sns/latest/dg/sns-send-message-to-sqs-cross-account.html) Layanan Pemberitahuan *Sederhana Amazon*.
### Polling antrian SQS untuk pemberitahuan
Setelah Anda berlangganan antrian 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.