View a markdown version of this page

Bekerja dengan ID Atribusi Pendapatan - AWS Pusat Partner
Apa itu ID Atribusi Pendapatan?Bekerja dengan ID Atribusi Pendapatan

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 ID Atribusi Pendapatan

ID Atribusi Pendapatan adalah pengenal tingkat kesepakatan yang memetakan pendapatan produk AWS Marketplace Anda ke Peluang Pusat and/or AWS Partner Penawaran AWS Pasar tertentu. Ini dibangun di atas implementasi Pengukuran Pendapatan Mitra (PRM) tingkat produk: PRM menangkap total pendapatan yang dikaitkan untuk produk Marketplace, dan ID Atribusi Pendapatan memetakan pendapatan tersebut ke transaksi tertentu sesuai dengan persentase alokasi biaya bulanan yang Anda tentukan.

Layanan Atribusi Pendapatan mengekspos API untuk membuat, mengambil, membuat daftar, dan memperbarui ID Atribusi Pendapatan dan untuk mengelola entri alokasi biaya bulanan secara asinkron.

Apa itu ID Atribusi Pendapatan?

ID Atribusi Pendapatan memiliki dua lapisan:

  • Atribusi sumber daya yang diberi nama mitra dan dijelaskan mitra yang diidentifikasi oleh ID ra- awalan (misalnya,ra-aabbccddee001) dan ARN. Setiap atribusi dicakup ke Catalog (AWSuntuk produksi, Sandbox untuk pengujian) dan akun mitra.

  • Satu atau lebih entri alokasi biaya bulanan setiap entri memetakan satu kombinasi (ID Penawaran atau ID Peluang, Bulan Penagihan) ke persentase alokasi biaya. Entri dikelola dalam batch secara asinkron melalui pola tugas alokasi.

ID Atribusi Pendapatan dapat digunakan dengan dua cara:

  • Sebagai overlay tingkat kesepakatan pada implementasi PRM tingkat produk Anda yang ada. Buat ID Atribusi Pendapatan, kaitkan Peluang and/or ACE Penawaran Marketplace yang berlaku AWS , dan petakan pendapatan produk yang sudah diukur ke penawaran spesifik tersebut — tidak diperlukan perubahan pada tag sumber daya atau string agen pengguna yang ada.

  • Sebagai pengenal mandiri yang digunakan secara langsung sebagai nilai tag sumber daya (aws-apn-id=<RA ID>) atau dalam string agen pengguna (APN_1.1/pc_<RA ID>$) untuk mengaitkan AWS konsumsi ke kesepakatan tertentu sejak awal.

Bekerja dengan ID Atribusi Pendapatan

Mitra dapat mengelola ID Atribusi Pendapatan dan entri alokasi biaya bulanan mereka melalui Layanan Atribusi Pendapatan. Siklus hidup berlangsung melalui dua alur independen: aliran atribusi-catatan (membuat, memperbarui, mengambil, daftar) dan alur alokasi (memulai tugas batch, polling untuk hasil, mengambil entri individual, daftar entri untuk atribusi).

Membuat ID Atribusi Pendapatan

Langkah pertama adalah membuat ID Atribusi Pendapatan menggunakan tindakan CreateRevenueAttribution API. Yang dikembalikan Id dan Arn dapat digunakan segera sebagai nilai tag sumber daya atau dalam string agen pengguna untuk mengatributkan konsumsi. AWS

Saat membuat ID Atribusi Pendapatan, mitra harus menyediakan:

  • Catalog— AWS untuk produksi atau Sandbox untuk pengujian.

  • Name— nama yang dapat dibaca manusia untuk atribusi. Harus unik di dalam Katalog dan akun mitra. Maksimal 128 karakter.

Mitra dapat secara opsional menyediakan:

  • Description— deskripsi teks bebas dari atribusi. Maksimal 1024 karakter.

  • MarketplaceProduct— produk AWS Marketplace untuk dikaitkan dengan atribusi ini. Berikan ProductIdentifier (ID produk Marketplace 25 karakter) dan TenancyModel (MULTI_TENANTatauSINGLE_TENANT). Jika dihilangkan pada saat pembuatan, atribusi berlaku di semua konsumsi yang diukur di bawah ID Atribusi Pendapatan, terlepas dari produk Marketplace mana yang dibeli pelanggan — berguna ketika satu penerapan mencakup lebih dari satu daftar Marketplace.

  • Tags— hingga 200 pasangan kunci-nilai untuk organisasi sumber daya. Kunci tag harus unik dalam permintaan.

Praktik Terbaik: Berikan MarketplaceProduct.ProductIdentifier setiap kali transaksi Anda ditambatkan ke daftar Marketplace tertentu. Ini memungkinkan AWS untuk memvalidasi bahwa produk dimiliki oleh akun mitra panggilan atau oleh akun anak perusahaan yang terhubung melalui Partner Account Connection (PAC), dan menampilkan masalah yang diselesaikan ProductCode dan ProductType (misalnyaSaaS,AMI,ML) dalam tanggapan. Jika produk tidak dimiliki oleh akun resmi, API kembali ValidationException dengan alasanPRODUCT_NOT_FOUND_OR_NOT_OWNED.

Respons mengembalikan MarketplaceProduct atribut baru Id (formatra-[a-z0-9]{13}),Arn, diselesaikan, dan Version nomor awal (yang dimulai pada 1 dan bertambah pada setiap pembaruan berikutnya).

Menambahkan entri alokasi biaya bulanan

Setelah ID Atribusi Pendapatan dibuat, mitra mengaitkan AWS Marketplace and/or Offers ACE Opportunities dengan mengirimkan batch entri alokasi biaya bulanan melalui tindakan StartRevenueAttributionAllocationsTask API. Ini adalah operasi asinkron yang menerima hingga 250 perubahan alokasi (CREATE and/or UPDATE) per tugas.

Setiap entri alokasi menentukan:

  • ID Penawaran atau ID Peluang — pengenal unik dari kesepakatan yang terkait. Jika Penawaran Marketplace sudah ditautkan ke Peluang ACE, mitra hanya perlu memberikan ID Penawaran; AWS secara otomatis menghubungkan pendapatan ke Peluang yang ditautkan.

  • Bulan Penagihan — bulan kalender di mana alokasi biaya berlaku (misalnya,2026-04).

  • % Alokasi Biaya — porsi dari total AWS konsumsi produk yang disebabkan oleh kesepakatan ini di bulan penagihan ini. Diperlukan untuk produk SaaS multi-penyewa, termasuk komponen yang dihosting mitra untuk penerapan hibrida, tempat pelanggan berbagi infrastruktur.

  • ID AWS Akun Pel anggan — AWS akun pelanggan yang mengkonsumsi produk. Diperlukan untuk produk SaaS multi-penyewa.

Total% Alokasi Biaya di semua entri alokasi untuk ID Atribusi Pendapatan tertentu dan Bulan Penagihan yang sama tidak boleh melebihi 100%. Jika total melebihi 100%, entri yang melanggar ditolak selama validasi bisnis asinkron dengan kode kesalahan per catatan.

Validasi sinkron: StartRevenueAttributionAllocationsTask melakukan validasi bentuk dasar secara sinkron (jenis bidang, pola, ukuran batch). Jika validasi dasar lulus, API mengembalikan status TaskId denganIN_PROGRESS. Validasi bisnis (pemeriksaan cap, aturan kekekalan, pencarian ketergantungan terhadap Marketplace dan ACE) berjalan secara asinkron dan hasil per catatan ditemukan melalui. GetRevenueAttributionAllocationsTask

Untuk memantau tugas yang dikirimkan, mitra melakukan polling GetRevenueAttributionAllocationsTask dengan Id Sumber Daya Atribusi Pendapatan atau ARN. Respons berlanjut dari IN_PROGRESS ke COMPLETED (terlepas dari apakah catatan individu berhasil atau gagal) dan mengembalikan:

  • TaskStatus—IN_PROGRESS,COMPLETED, atau FAILED (kegagalan tugas tingkat atas).

  • RecordResults— untuk setiap catatan input: yang ditetapkan AllocationId (jika berhasil), status per catatan (SUCCEEDEDatauFAILED), dan kode kesalahan terstruktur dan pesan jika catatan gagal.

Mitra harus segera mengambil hasil tugas. Setelah tugas selesai, hasil per catatan dapat direkonsiliasi dan setiap entri yang gagal dapat diperbaiki dan dikirim kembali dalam tugas baru.

Mengedit entri alokasi biaya bulanan

Entri alokasi biaya dikelola per bulan penagihan dengan aturan berikut:

  • Mitra dapat menambahkan entri bulanan baru untuk bulan penagihan saat ini atau bulan mendatang kapan saja.

  • Mitra dapat memperbarui entri bulanan untuk bulan penagihan saat ini atau bulan mendatang kapan saja.

  • Mitra dapat memperbarui entri bulan lalu hingga tanggal 7 bulan berjalan. Jendela ini memungkinkan mitra untuk meninjau penggunaan aktual di AWS Cost Explorer sebelum menyelesaikan alokasi bulan sebelumnya.

Setelah tanggal 7 bulan berjalan, atribusi untuk bulan penagihan sebelumnya tidak dapat lagi diubah. Pembaruan untuk entri bulan saat ini atau yang akan datang berlaku mulai siklus penagihan bulanan berikutnya. Atribusi historis untuk bulan-bulan sebelumnya tidak dihitung ulang secara retroaktif.

Pembaruan untuk entri alokasi dikirimkan melalui tindakan StartRevenueAttributionAllocationsTask API yang sama dengan diset Operation el ke UPDATE untuk setiap entri yang terpengaruh. Pola tugas asinkron menangani pembaruan dan kreasi secara seragam.

Memperbarui ID Atribusi Pendapatan

Mitra dapat memperbarui ID Atribusi Pendapatan yang ada menggunakan tindakan UpdateRevenueAttribution API. Description Catatan atribusi itu sendiri tidak dapat diubah —Name,MarketplaceProduct, dan nilai tag-on-create tidak dapat diubah setelah pembuatan. Untuk menandai ulang sumber daya, gunakan operasi penand AWS aan standar pada ARN atribusi.

Saat memperbarui ID Atribusi Pendapatan, mitra harus memberikan:

  • Catalog— AWS atauSandbox.

  • Identifier— ra- ID atribusi untuk diperbarui.

  • Version— versi atribusi saat ini untuk penguncian optimis.

Mitra dapat secara opsional menyediakan:

  • Description— deskripsi teks bebas yang diperbarui. Maksimal 1024 karakter.

  • ClientToken— token idempotensi untuk pembaruan.

Penguncian Optimis: Version Bidang memastikan pembaruan hanya berlaku jika atribusi tidak berubah sejak terakhir diambil. Jika yang dikirimkan Version tidak cocok dengan versi sumber daya saat ini, pembaruan ditolak dengan pesan yang ConflictException menyertakan nomor versi yang dikirimkan dan nomor versi saat ini. Praktik terbaik adalah mengambil versi terbaru GetRevenueAttribution sebelum setiap pembaruan.

Melihat detail ID Atribusi Pendapatan

Mitra dapat mengambil informasi lengkap untuk ID Atribusi Pendapatan tunggal menggunakan tindakan GetRevenueAttribution API. Ini mengembalikan:

Metadata Sumber Daya:

  • Pengidentifikasi unik (Id) dan Nama Sumber Daya Amazon (Arn).

  • CatalogDi mana atribusi ada.

  • Name dan Description.

  • Yang diambil Version dan LatestVersion (gunakan yang terbaru untuk pembaruan berikutnya).

Atribut Produk Marketplace (jika MarketplaceProduct ditetapkan saat pembuatan):

  • ProductId— ID produk Marketplace yang disediakan oleh mitra.

  • ProductCode— kode produk AWS Marketplace diselesaikan dariProductId.

  • ProductType—SaaS,AMI,Container,ML,Data, atauProfessional Services.

  • TenancyModel— MULTI_TENANT atauSINGLE_TENANT.

Informasi Audit:

  • CreatedDate dan LastModifiedDate.

Mitra dapat secara opsional memberikan permintaan khusus Version untuk mengambil versi historis atribusi. Hilangkan Version untuk mengembalikan yang terbaru.

Untuk mengambil entri alokasi biaya bulanan tertentu, mitra menggunakan tindakan GetRevenueAttributionAllocation API dengan entri tersebutAllocationId. Ini mengembalikan ID Penawaran atau ID Peluang, Bulan Penagihan,% Alokasi Biaya, ID AWS Akun Pelanggan, dan status entri dan informasi audit.

Daftar ID Atribusi Pendapatan

Mitra dapat melihat semua ID Atribusi Pendapatan di akun mereka menggunakan tindakan ListRevenueAttributions API. Ini mengembalikan daftar ringkasan atribusi yang dipaginasi dengan kemampuan pemfilteran dan penyortiran.

Mitra dapat memfilter hasil berdasarkan:

  • Catalog— AWS atau Sandbox (wajib).

  • Identifiers— daftar hingga 100 ra- ID spesifik untuk diambil.

  • CreatedAfter/CreatedBefore— filter berdasarkan rentang stempel waktu pembuatan (inklusif).

Mitra dapat mengonfigurasi penyortiran hasil menggunakan Sort parameter:

  • SortBy— CreatedDate atauLastModifiedDate.

  • SortOrder— ASCENDING atauDESCENDING.

Tanggapan mencakup ringkasan untuk setiap atribusi:Arn,, IdCatalog, MarketplaceProduct atribut yang diselesaikanName,,, terbaru CreatedDate LastModifiedDateVersion, dan TotalRevenueAttributionAssociationCount (jumlah entri alokasi biaya bulanan aktif yang ditautkan ke atribusi).

Gunakan MaxResults (default 25, maksimum 100) dan NextToken untuk membuat paginasi melalui kumpulan hasil yang besar. Tanggapan termasuk NextToken jika halaman tambahan tersedia.

Mencantumkan entri alokasi biaya bulanan

Mitra dapat mencantumkan entri alokasi biaya bulanan untuk ID Atribusi Pendapatan tertentu menggunakan tindakan ListRevenueAttributionAllocations API. Ini mengembalikan daftar ringkasan alokasi yang dipaginasi dengan kemampuan pemfilteran.

Mitra dapat memfilter hasil berdasarkan:

  • MarketplaceOfferId— daftar hanya entri yang terkait dengan Penawaran Marketplace tertentu.

  • AwsPartnerCentralOpportunityId— daftar hanya entri yang terkait dengan Peluang Pusat Mitra tertentu.

  • BillingMonth— daftar hanya entri untuk bulan kalender tertentu.

Tanggapan mencakup informasi ringkasan untuk setiap entri:AllocationId, ID Penawaran atau ID Peluang terkait, ID AWS Akun Pelanggan, Bulan Penagihan,% Alokasi Biaya, nama dan status entri, dan stempel waktu audit.

Membangun Dasbor: Kombinasi ListRevenueAttributions dan ListRevenueAttributionAllocations dirancang untuk mendukung pembuatan dasbor mitra. Mitra dapat membangun tampilan seperti:

  • Semua ID Atribusi Pendapatan dibuat dalam 30 hari terakhir, diurutkan berdasarkan tanggal pembuatan.

  • Semua entri alokasi biaya bulanan untuk Penawaran Marketplace tertentu di beberapa ID Atribusi Pendapatan.

  • Semua entri alokasi biaya untuk bulan penagihan saat ini, untuk memvalidasi bahwa total tidak melebihi 100% per atribusi.

  • Semua ID Atribusi Pendapatan yang memiliki setidaknya satu entri alokasi aktif (TotalRevenueAttributionAssociationCount > 0).