Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Mengintegrasikan kontrak pay-as-you-go SaaS Anda dengan produk dengan AWS Marketplace
Mengintegrasikan produk Anda dengan AWS Marketplace adalah salah satu langkah. Membuat produk SaaS di AWS Marketplace Untuk mengintegrasikan produk kontrak perangkat lunak Anda sebagai layanan (SaaS) AWS Marketplace, Anda harus menulis kode dan menunjukkan bahwa ia dapat merespons dengan sukses beberapa skenario pelanggan. Bagian berikut menjelaskan skenario ini, menjelaskan cara menanggapinya, dan memberikan gambaran umum tentang pengujian integrasi Anda.
catatan
Sebelum Anda mulai, pastikan Anda telah memilih model harga yang tepat untuk perangkat lunak Anda sebagai produk layanan (SaaS). AWS Marketplace Untuk informasi selengkapnya, lihat Merencanakan produk SaaS Anda.
Topik
Skenario: Layanan Anda memvalidasi pelanggan baru
Ketika pelanggan berlangganan produk Anda, mereka diarahkan ke pendaftaran AndaURL, yang merupakan HTTP POST permintaan dengan token sementarax-amzn-marketplace-token
. Tanggapi permintaan ini dengan cara berikut:
-
Tukarkan token dengan a
CustomerIdentifier
CustomerAWSAccountId
,, danProductCode
dengan memanggilResolveCustomer
API operasi di AWS Marketplace Metering Service. -
Verifikasi langganan dan kuantitas (jika ada) yang dapat diakses pelanggan dengan memanggil
GetEntitlements
tindakan di AWS Marketplace Entitlement Service. -
Pertahankan
CustomerIdentifier
,CustomerAWSAccountId
, danProductCode
dalam sistem Anda untuk panggilan future. Simpan apakah pelanggan memiliki langganan yang valid, bersama dengan informasi apa pun yang Anda butuhkan tentang pelanggan. -
Sebagai tanggapan atas permintaan tersebut, Anda harus menunjukkan pengalaman penggunaan pertama pengguna Anda (sebagaimana berlaku untuk layanan Anda).
Skenario: Layanan Anda menangani permintaan pelanggan
Ketika pelanggan membuat permintaan ke layanan Anda, Anda harus menanggapi skenario berikut dengan tindakan atau pesan yang sesuai:
-
Mereka tidak memiliki ID pelanggan di sistem Anda. Ini berarti mereka belum berlangganan. Anda harus memberi mereka pesan yang menjelaskan cara berlangganan.
-
Mereka memiliki ID pelanggan, dan
GetEntitlements
API operasi mengembalikan hak yang sesuai. Dalam skenario ini, Anda harus memenuhi permintaan. -
Mereka memang memiliki ID pelanggan, tetapi
GetEntitlements
API operasi tidak mengembalikan hak, atau jumlah yang tidak cukup untuk memenuhi permintaan. Dalam skenario ini, Anda harus menentukan cara menangani akses dan mengelola pengalaman mereka.
Skenario: Penggunaan meter
Ketika pelanggan mulai menggunakan layanan Anda, Anda harus mengirim catatan pengukuran setiap jam. Untuk detail tentang cara meteran, lihatMengkonfigurasi pengukuran untuk penggunaan dengan langganan SaaS.
Kami menyarankan Anda menggunakan AWS CloudTrail untuk memantau aktivitas untuk memastikan bahwa informasi penagihan sedang dikirim ke AWS. Ingatlah hal berikut saat mengirim catatan pengukuran:
-
Permintaan pengukuran tidak digandakan pada jam tersebut.
-
Catatan yang dikirim setiap jam bersifat kumulatif.
-
Kami sangat menyarankan sebagai praktik terbaik bahwa, bahkan jika tidak ada catatan dalam satu jam terakhir, Anda mengirim catatan pengukuran setiap jam, dengan penggunaan 0.
Skenario: Memantau perubahan hak pengguna
Siapkan antrian Amazon Simple Queue Service (AmazonSQS), dan berlangganan topik Amazon produk SNS Anda—ada dua SNS topik, satu untuk perubahan hak dan satu untuk perubahan langganan. Informasi topik Anda disertakan dalam pesan email yang Anda terima dari tim Operasi AWS Marketplace Penjual saat Anda membuat produk. Untuk informasi selengkapnya, lihat Membuat produk SaaS di AWS Marketplace. Dengan berlangganan SNS topik Anda, Anda menerima pemberitahuan tentang perubahan langganan pelanggan, termasuk menyediakan atau mencabut akses untuk pelanggan tertentu.
catatan
SNSTopik Amazon Resource Name (ARN) untuk perubahan langganan terlihat sepertiarn:aws:sns:us-east-1:
. SNSTopik ARN untuk perubahan hak terlihat seperti<account
id>
:aws-mp-subscription-notification-<product
code>
arn:aws:sns:us-east-1:
.<account
id>
:aws-mp-entitlement-notification-<product
code>
Pemberitahuan yang harus Anda tanggapi adalah sebagai berikut:
-
entitlement-updated
(dalam SNS topik hak) - Hak pelanggan telah berubah, dan Anda harus memanggilGetEntitlements
API operasi untuk melihat status baru. Perbarui toko pelanggan Anda, dan, jika berlaku (misalnya, kontrak pelanggan telah berakhir), ikuti praktik Anda untuk mematikan sumber daya pelanggan, mengikuti kebijakan retensi Anda. -
subscribe-success
(dalam SNS topik berlangganan) — Pelanggan berlangganan, dan Anda dapat berhasil mengukur ID pelanggan mereka. -
unsubscribe-pending
(dalam SNS topik berlangganan) — Pelanggan sedang dalam proses berhenti berlangganan. Anda harus mengirim catatan pengukuran terakhir. -
unsubscribe-success
(dalam SNS topik berlangganan) — Pelanggan telah berhenti berlangganan. Catatan pengukuran untuk pelanggan tidak akan lagi diterima. Ikuti praktik Anda untuk mematikan sumber daya pelanggan, mengikuti kebijakan retensi Anda. -
subscribe-fail
(dalam SNS topik berlangganan) — Langganan pelanggan gagal. Anda tidak boleh meteran terhadap ID pelanggan mereka atau mengaktifkan sumber daya atas nama pelanggan.
catatan
Untuk informasi tambahan, lihat Memeriksa hak menggunakan AWS Marketplace Entitlement Service.
Menguji integrasi produk kontrak SaaS Anda
Setelah Anda mengintegrasikan kontrak Anda dengan pay-as-you-go produk AWS Marketplace, Anda harus melakukan pengujian mendalam untuk memastikan bahwa integrasi berhasil. Prosedur berikut menguraikan langkah-langkah untuk memverifikasi integrasi produk Anda.
catatan
Gunakan akun Anda sendiri untuk berlangganan produk Anda dan uji apakah integrasi berhasil. Harga dapat dikurangi sementara sehingga Anda dapat menguji alur pembelian tanpa menimbulkan biaya tinggi di akun tersebut. Untuk informasi selengkapnya tentang mengurangi harga sementara atau mengizinkan akun pengujian tambahan mengakses produk Anda, hubungi tim Operasi AWS Marketplace Penjual
Setelah produk Anda diluncurkan, layanan harus terus menanggapi skenario ini untuk pelanggan baru.
-
Gunakan akun yang diizinkan untuk menguji pengalaman pelanggan dengan mendapatkan kontrak untuk produk Anda.
-
Setelah akun memiliki kontrak, pastikan bahwa akun dialihkan ke pendaftaranURL, dan bahwa pengalihan adalah POST permintaan yang menyertakan token sementara. Pastikan aplikasi Anda mempertahankan ID pelanggan untuk panggilan future dan menangani hak yang dimiliki pelanggan dengan benar. Ini menguji bagian dariSkenario: Layanan Anda memvalidasi pelanggan baru.
-
Setelah memverifikasi akun pengujian pada langkah sebelumnya, masukkan akun ke dalam aplikasi Anda. Misalnya, Anda dapat meminta pelanggan uji mengisi formulir untuk membuat pengguna baru. Atau, berikan mereka langkah selanjutnya untuk mendapatkan akses ke aplikasi SaaS Anda. Ini menguji bagian dariSkenario: Layanan Anda memvalidasi pelanggan baru.
-
Jika tidak ada hak yang dikembalikan dari
GetEntitlements
API operasi, baik selama orientasi atau dalam izin verifikasi Anda yang sedang berlangsung, aplikasi Anda harus mengelola akses dan pengalaman dengan benar bagi pengguna yang tidak berhak. Tes iniSkenario: Layanan Anda menangani permintaan pelanggan. -
Setelah pelanggan pengujian onboard, buat permintaan yang akan mengirim catatan pengukuran AWS untuk tujuan penagihan dengan menggunakan operasi di
BatchMeterUsage
API. AWS Marketplace Metering Service Tes iniSkenario: Penggunaan meter. -
Uji perubahan langganan. Verifikasi bahwa aplikasi Anda menangani skenario berhenti berlangganan, langganan yang berhasil, dan gagal berlangganan dengan benar. Tes iniSkenario: Memantau perubahan hak pengguna.
-
Setelah Anda menyelesaikan semua persyaratan integrasi dan menguji solusinya, beri tahu tim Operasi AWS Marketplace Penjual. Mereka kemudian akan menguji solusinya dengan memverifikasi bahwa Anda telah berhasil memanggil
GetEntitlements
API operasi dan cukup memasukkan pelanggan baru. Mereka juga akan memverifikasi bahwa Anda telah berhasil mengirim catatan terukur denganBatchMeterUsage
API operasi.
Setelah integrasi dan pengujian selesai, Anda dapat melakukan tinjauan akhir dan mencantumkan produk Anda di depan umum AWS Marketplace. Untuk informasi selengkapnya, lihat Membuat produk SaaS di AWS Marketplace.