View a markdown version of this page

Bekerja dengan Pangsa Pendapatan Marketplace Anda - AWS Pusat Partner
Apa itu Pangsa Pendapatan Pasar?Bekerja dengan Pangsa Pendapatan Marketplace AndaMenandai Pangsa Pendapatan Marketplace

Referensi Pusat Partner AWS API direstrukturisasi. Untuk informasi selengkapnya tentang operasi API yang didukung, lihat Refer Pusat Partner AWS ensi API.

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

Bekerja dengan Pangsa Pendapatan Marketplace Anda

Pangsa Pendapatan Marketplace adalah input untuk produk AWS Marketplace yang menyatakan porsi dari total pendapatan produk yang dikumpulkan melalui AWS Marketplace. AWS menggunakan input ini untuk menghubungkan Marketplace-collected pendapatan mitra dengan sinyal pendapatan lainnya.

Layanan Pembagian Pendapatan Marketplace menampilkan API untuk membuat, mengambil, dan membuat daftar sumber daya Bagi Hasil Marketplace, dan untuk mengelola alokasinya (persentase bagi hasil yang dinyatakan mitra dan jendela tanggal efektif). Operasi AWS penandaan standar didukung di sumber Marketplace Revenue Share.

Apa itu Pangsa Pendapatan Pasar?

Pangsa Pendapatan Marketplace memiliki dua lapisan:

  • Saham — masukan untuk satu produk AWS Marketplace, yang diidentifikasi oleh MarketplaceProductId. Ada tepat satu Pangsa Pendapatan Pasar per produk.

  • Satu atau lebih alokasi — setiap alokasi RevenueSharePercent menyatakan jendela tanggal efektif (EffectiveDate, opsionalExpirationDate). Sebuah saham dapat memiliki banyak alokasi dari waktu ke waktu, tetapi setiap saat hanya satu al ACTIVE okasi yang dapat berlaku.

Alokasi memiliki properti utama ini:

  • Status - ACTIVE atauINACTIVE. Pada pembuatan, status default keACTIVE. Hanya ACTIVE alokasi yang berpartisipasi dalam perhitungan pendapatan dan pemeriksaan tumpang tindih.

  • Invarian tumpang tindih — dalam satu saham, tidak ada dua ACTIVE alokasi yang mungkin memiliki rentang tumpang tindih[EffectiveDate, ExpirationDate]. Paling banyak satu ACTIVE alokasi terbuka (tidakExpirationDate) diizinkan per saham kapan saja.

Bekerja dengan Pangsa Pendapatan Marketplace Anda

Mitra mengelola Saham Pendapatan Marketplace dan alokasinya melalui Layanan Pembagian Pendapatan Marketplace. Siklus hidup berlangsung melalui dua alur: aliran berbagi (buat, ambil, daftar, tag) dan aliran alokasi (buat, perbarui, hapus lunak, ambil, daftar).

Membuat Pangsa Pendapatan Marketplace

Langkah pertama adalah membuat Pangsa Pendapatan Marketplace untuk produk AWS Marketplace menggunakan tindakan CreateMarketplaceRevenueShare API. Saham diidentifikasi oleh Marketplace ProductId dan berfungsi sebagai wadah untuk semua alokasi berikutnya.

Saat membuat Pangsa Pendapatan Marketplace, mitra harus menyediakan:

  • Catalog- AWS untuk produksi atau Sandbox untuk pengujian.

  • ProductId— ID produk Marketplace 25 karakter. Pola:[a-z0-9]{25}.

Mitra dapat secara opsional menyediakan:

  • Tags— hingga 50 pasangan kunci-nilai untuk organisasi sumber daya pada saat pembuatan. Gunakan TagResource untuk menambahkan tag setelah pembuatan.

  • ClientToken— token idempotensi untuk mencegah kreasi duplikat saat dicoba lagi. Maksimal 64 karakter. SDK menghasilkan token ini secara otomatis.

Validasi Produk: Pada saat pembuatan, layanan memverifikasi dengan AWS Marketplace bahwa produk dimiliki oleh akun penelepon atau oleh akun anak perusahaan yang terhubung ke penelepon melalui Partner Account Connection (PAC). Jika produk tidak ada atau akun pemilik tidak diotorisasi untuk pemanggil, API kembali ValidationException dengan alasanPRODUCT_NOT_FOUND_OR_NOT_OWNED.

Satu Saham Per Produk: Pang CreateMarketplaceRevenueShare gilan kedua untuk hal yang sama ProductId dalam pengem Catalog balian yang samaConflictException.

Respons mengembalikan share Arn (formatarn:{partition}:partnercentral:{region}:{account-id}:catalog/{catalog}/marketplace-revenue-share/{productId}), the, the CatalogProductId, Version nomor awal (yang dimulai pada 1 dan bertambah pada setiap mutasi alokasi), dan tag apa pun yang diterapkan saat pembuatan.

Menambahkan alokasi

Setelah Pangsa Pendapatan Marketplace dibuat, mitra menyatakan persentase bagi hasil dan jendela tanggal efektif dengan membuat alokasi melalui tindakan API. CreateMarketplaceRevenueShareAllocation

Saat membuat alokasi, mitra harus menyediakan:

  • Catalog— AWS atauSandbox.

  • MarketplaceRevenueShareIdentifier— pengidentifikasi saham induk.

  • RevenueSharePercent- persentase pendapatan produk yang dikumpulkan melalui Marketplace disediakan sebagai desimal (misalnya, 0.45 untuk 45%).

  • EffectiveDate- tanggal kalender ketika alokasi ini menjadi efektif. Format: YYYY-MM-DD.

Respons mengembalikan alokasi Id (formatmrsa-[A-Za-z0-9]{13}), status alokasi (ACTIVEsaat dibuat), dan saham induk terbentur Version (bilangan bulat versi tunggal per saham ditabrak pada setiap mutasi alokasi, digunakan untuk penguncian optimis pada pembaruan alokasi berikutnya).

Memperbarui alokasi

Mitra dapat memperbarui alokasi menggunakan tindakan UpdateMarketplaceRevenueShareAllocation API. Bidang yang dapat diperbarui bergantung pada apakah alokasi tersebut bertanggal di masa mendatang, efektif saat ini, atau bertanggal lampau.

Saat memperbarui alokasi, mitra harus menyediakan:

  • Catalog— AWS atauSandbox.

  • MarketplaceRevenueShareIdentifier— pengidentifikasi saham induk.

  • AllocationId— mrsa- ID alokasi yang akan diperbarui.

  • MarketplaceRevenueShareVersion— versi saham induk saat ini untuk penguncian optimis pada alokasi. Konflik benjolan kembaliConflictException.

Mitra dapat secara opsional menyediakan:

  • RevenueSharePercent— persentase bagi hasil yang diperbarui. Hanya dapat diedit pada alokasi bertanggal mendatang.

  • EffectiveDate- tanggal efektif yang diperbarui. Hanya dapat diedit pada alokasi bertanggal mendatang.

  • ExpirationDate— tanggal kedaluwarsa yang diperbarui. Dapat diedit pada alokasi bertanggal masa depan (nilai apa pun> EffectiveDate) dan pada alokasi yang efektif saat ini atau terbuka (nilai apa pun). ≥ today

  • Status— ACTIVE atauINACTIVE. Pengaturan untuk INACTIVE soft-menghapus alokasi. Hanya dapat diedit pada alokasi bertanggal mendatang.

  • ClientToken— token idempotensi.

Melihat detail Pangsa Pendapatan Marketplace

Mitra dapat mengambil informasi lengkap untuk satu Pangsa Pendapatan Marketplace menggunakan tindakan GetMarketplaceRevenueShare API. Ini mengembalikan sahamArn,, CatalogProductId, Version (versi saham induk saat ini),, CreatedDateLastModifiedDate, dan tag apa pun yang diterapkan pada bagian tersebut.

Mitra dapat mengambil satu alokasi menggunakan tindakan GetMarketplaceRevenueShareAllocation API dengan alokasiId. Ini mengembalikan:

  • Alokasi Id dan saham indukMarketplaceRevenueShareArn.

  • RevenueSharePercent, EffectiveDate, ExpirationDate.

  • Status(ACTIVEatauINACTIVE).

  • Saham induk adalah MarketplaceRevenueShareVersion untuk penguncian optimis pada pembaruan berikutnya.

  • CreatedDate dan LastModifiedDate.

Daftar Pangsa Pendapatan Pasar

Mitra dapat melihat semua Saham Pendapatan Marketplace yang dimiliki oleh akun mereka menggunakan tindakan ListMarketplaceRevenueShares API. Ini mengembalikan daftar ringkasan berbagi halaman.

Mitra dapat memfilter hasil berdasarkan:

  • Catalog— AWS atau Sandbox (wajib).

  • ProductIds— daftar ID produk Marketplace tertentu untuk diambil.

Tanggapan mencakup ringkasan untuk setiap saham: ArnCatalog,ProductId,, terbaruVersion,CreatedDate, danLastModifiedDate.

Gunakan MaxResults dan buat NextToken paginasi melalui kumpulan hasil yang besar.

Alokasi daftar

Mitra dapat membuat daftar alokasi untuk Pangsa Pendapatan Marketplace tertentu menggunakan tindakan ListMarketplaceRevenueShareAllocations API. Ini mengembalikan daftar ringkasan alokasi berhalaman dengan kemampuan pemfilteran.

Mitra dapat memfilter hasil berdasarkan:

  • Status— ACTIVE atauINACTIVE.

  • Rentang tanggal efektif —EffectiveDateOnOrAfter/EffectiveDateOnOrBeforeuntuk mengambil alokasi yang tanggal efektifnya berada dalam jendela tertentu.

Tanggapan mencakup informasi ringkasan untuk setiap alokasi: IdRevenueSharePercent,EffectiveDate,,ExpirationDate,Status,MarketplaceRevenueShareVersion, dan cap waktu audit.

Menandai Pangsa Pendapatan Marketplace

Operasi AWS penandaan standar didukung di sumber Marketplace Revenue Share:

  • TagResource— menambahkan atau mengganti tag pada Pangsa Pendapatan Marketplace. Maksimal 50 tag per saham.

  • UntagResource— menghapus tag tertentu dengan kunci.

  • ListTagsForResource— mengambil semua tag yang saat ini diterapkan ke Pangsa Pendapatan Marketplace.

Alokasi tidak mendukung tag. Tandai bagian induk untuk mengatur alokasi terkait.

Setiap operasi penandaan menerima share Arn (formatarn:{partition}:partnercentral:{region}:{account-id}:catalog/{catalog}/marketplace-revenue-share/{productId}) sebagai pengidentifikasi sumber daya. AWS Tag-on-create standar juga didukung melalui bidang aktif. Tags CreateMarketplaceRevenueShare