View a markdown version of this page

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

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 Anda

ID Atribusi Pendapatan adalah pengenal tingkat kesepakatan yang memetakan pendapatan produk AWS Marketplace Anda ke Peluang Pusat Mitra Penawaran AWS and/or AWS Marketplace 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, mencantumkan, dan memperbarui ID Atribusi Pendapatan dan mengelola entri alokasi biaya bulanannya secara asinkron.

Apa itu ID Atribusi Pendapatan?

ID Atribusi Pendapatan memiliki dua lapisan:

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

  • Satu atau lebih entri alokasi biaya bulanan setiap entri memetakan kombinasi tunggal (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 dalam dua cara:

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

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

Bekerja dengan ID Atribusi Pendapatan Anda

Mitra dapat mengelola ID Atribusi Pendapatan dan entri alokasi biaya bulanan mereka melalui Layanan Atribusi Pendapatan. Siklus hidup berlangsung melalui dua aliran independen: alur catatan atribusi (buat, perbarui, ambil, daftar) dan alur alokasi (mulai tugas batch, jajak pendapat untuk hasil, ambil 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 user-agent untuk mengatribusikan 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 dalam Katalog dan akun mitra. Maksimal 128 karakter.

Mitra secara opsional dapat 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 berdasarkan 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 nilai kunci untuk organisasi sumber daya. Kunci tag harus unik dalam permintaan.

Praktik Terbaik: Berikan MarketplaceProduct.ProductIdentifier setiap kali transaksi Anda ditambatkan ke daftar Marketplace tertentu. Hal ini memungkinkan AWS untuk memvalidasi bahwa produk dimiliki oleh akun mitra panggilan atau oleh akun anak perusahaan yang terhubung melalui Koneksi Akun Mitra (PAC), dan memunculkan yang diselesaikan ProductCode dan ProductType (misalnya,, SaaSAMI,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 kenaikan pada setiap pembaruan berikutnya).

Menambahkan entri alokasi biaya bulanan

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

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 mengaitkan 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 dapat diatribusikan pada kesepakatan ini di bulan penagihan ini. Diperlukan untuk produk SaaS multi-penyewa, termasuk komponen yang dihosting mitra untuk penyebaran hibrida, tempat pelanggan berbagi infrastruktur.

  • ID AWS Rekening Pelanggan —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 rekaman.

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

Untuk memantau tugas yang dikirimkan, jajak pendapat bermitra GetRevenueAttributionAllocationsTask dengan Id Sumber Daya Atribusi Pendapatan atau ARN. Respons berlangsung dari IN_PROGRESS ke COMPLETED (terlepas dari apakah catatan individu berhasil atau gagal) dan kembali:

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

  • RecordResults— untuk setiap catatan masukan: yang ditetapkan AllocationId (jika berhasil), status per-rekaman (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 entri yang gagal dapat diperbaiki dan dikirim ulang 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 yang akan datang kapan saja.

  • Mitra dapat memperbarui entri bulanan untuk bulan penagihan saat ini atau yang akan datang 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 masa depan berlaku dari siklus penagihan bulanan berikutnya. Atribusi historis untuk bulan-bulan sebelumnya tidak dihitung ulang secara surut.

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

Memperbarui ID Atribusi Pendapatan

Partner 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 AWS penandaan 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 secara opsional dapat menyediakan:

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

  • ClientToken— token idempotensi untuk pembaruan.

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

Melihat detail ID Atribusi Pendapatan

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

Metadata Sumber Daya:

  • Unique identifier (Id) dan Amazon Resource Name (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 secara opsional dapat memberikan permintaan spesifik Version untuk mengambil versi historis atribusi. Abaikan Version untuk mengembalikan yang terbaru.

Untuk mengambil entri alokasi biaya bulanan tertentu, mitra menggunakan tindakan GetRevenueAttributionAllocation API dengan entri. AllocationId Ini mengembalikan ID Penawaran atau ID Peluang, Bulan Penagihan,% Alokasi Biaya, ID AWS Akun Pelanggan, dan status entri serta 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 paginasi dengan kemampuan pemfilteran dan pengurutan.

Mitra dapat memfilter hasil dengan:

  • Catalog— AWS atau Sandbox (wajib).

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

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

Mitra dapat mengonfigurasi penyortiran hasil menggunakan Sort parameter:

  • SortBy— CreatedDate atauLastModifiedDate.

  • SortOrder— ASCENDING atauDESCENDING.

Tanggapan tersebut mencakup ringkasan untuk setiap atribusi:Arn,,Id, CatalogName, MarketplaceProduct atribut yang diselesaikan,, CreatedDateLastModifiedDate, yang terbaruVersion, dan TotalRevenueAttributionAssociationCount (jumlah entri alokasi biaya bulanan aktif yang ditautkan ke atribusi).

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

Daftar entri alokasi biaya bulanan

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

Mitra dapat memfilter hasil dengan:

  • 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 tersebut mencakup informasi ringkasan untuk setiap entri: ID Penawaran atau ID Peluang terkait, ID AWS Akun Pelanggan, Bulan Penagihan,% Alokasi Biaya, nama dan status entri, dan cap waktu audit. AllocationId

Dashboard Building: 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.