Atribusi penggunaan pelanggan Azure
Atribusi penggunaan pelanggan mengaitkan penggunaan dari sumber daya Azure dalam langganan pelanggan yang dibuat saat menyebarkan IP Anda sebagai mitra. Membentuk asosiasi ini dalam sistem Internal Microsoft menghadirkan visibilitas internal yang lebih besar ke jejak Azure yang menjalankan perangkat lunak Anda. Untuk penawaran Aplikasi Azure di pasar komersial, kemampuan pelacakan ini membantu Anda menyelaraskan dengan tim penjualan Microsoft dan mendapatkan kredit untuk program mitra Microsoft. Atribusi penggunaan pelanggan tidak berlaku untuk penawaran komputer virtual Azure di marketplace komersial. Tidak ada yang perlu dilakukan penerbit pasar untuk penawaran komputer virtual guna memastikan konsumsi Azure terlacak dalam langganan pelanggan akhir.
Atribusi penggunaan pelanggan mendukung tiga opsi penyebaran:
- Templat Azure Resource Manager (dasar umum aplikasi Azure, dalam pasar komersial juga disebut sebagai "templat solusi" atau "aplikasi terkelola"): mitra membuat templat Resource Manager untuk menentukan infrastruktur dan konfigurasi solusi Azure miliknya. Templat Resource Manager memungkinkan pelanggan Anda untuk menggunakan sumber daya solusi Anda dalam keadaan konsisten dan dapat diulang.
- API Azure Resource Manager: mitra dapat memanggil API Resource Manager untuk menyebarkan templat Resource Manager atau menyediakan layanan Azure secara langsung.
- Terraform: mitra dapat menggunakan Terraform untuk menyebarkan templat Resource Manager atau langsung menyebarkan layanan Azure.
Lihat Kasus penggunaan sekunder nanti di artikel ini untuk atribusi penggunaan pelanggan di luar marketplace komersial.
Penting
Atribusi penggunaan pelanggan tidak dimaksudkan untuk melacak pekerjaan integrator sistem, penyedia layanan terkelola, atau alat yang dirancang terutama untuk menyebarkan dan mengelola sumber daya Azure.
Atribusi penggunaan pelanggan adalah untuk penyebaran baru dan tidak mendukung sumber daya pelacakan yang telah disebarkan.
- Tidak semua layanan Azure kompatibel dengan atribusi penggunaan pelanggan. Azure Kubernetes Services (AKS), VM Scale Sets, dan Azure Batch telah mengetahui masalah yang menyebabkan kurangnya pelaporan penggunaan.
- Atribusi penggunaan pelanggan data konsumsi Azure tidak dibagikan secara eksternal dengan mitra.
Pasar komersial aplikasi Azure
Melacak penggunaan Azure dari aplikasi Azure yang diterbitkan ke pasar komersial sebagian besar terjadi secara otomatis. Saat Anda mengunggah templat Resource Manager sebagai bagian dari konfigurasi teknis paket aplikasi Azure pasar Anda,, Pusat Mitra akan menambahkan ID pelacakan yang dapat dibaca oleh Azure Resource Manager.
Catatan
Untuk memastikan penggunaan aplikasi Anda dikaitkan secara akurat dalam sistem kami:
- Jika Anda menentukan ID pelacakan di tipe sumber daya Microsoft.Resources/deployment dengan variabel, ganti variabel dengan ID pelacakan yang terlihat di Pusat Mitra pada halaman Konfigurasi Teknis paket (lihat Menambahkan GUID ke templat Resource Manager di bawah).
- Jika templat Resource Manager Anda menggunakan sumber daya tipe Microsoft.Resources/deployments untuk tujuan selain atribusi penggunaan pelanggan, Microsoft tidak akan dapat menambahkan ID pelacakan atribusi penggunaan pelanggan atas nama Anda. Jika Anda menentukan ID pelacakan di tipe sumber daya Microsoft.Resources/deployment dengan variabel, ganti variabel dengan ID pelacakan yang terlihat di Pusat Mitra pada halaman rencana Konfigurasi teknis (lihat Menambahkan GUID ke templat Resource Manager di bawah).
Jika Anda menggunakan API Azure Resource Manager, Anda harus menambahkan ID pelacakan Anda sesuai instruksi di bawah ini untuk meneruskannya ke Azure Resource Manager saat kode Anda menyebarkan sumber daya. ID ini terlihat di Pusat Mitra di halaman Konfigurasi Teknis paket Aplikasi Azure Anda.
Catatan
Untuk aplikasi Azure yang sudah ada, migrasi satu kali dimulai pada Maret 2021 untuk memperbarui IP pelacakan di konfigurasi teknis setiap paket. Penggunaan dari penyebaran masa lalu dari penawaran tersebut akan tetap dilacak dalam sistem Microsoft.
Saat memperbarui penawaran, Anda tidak perlu lagi menambahkan jenis sumber daya Microsoft.Resources/deployments dalam file templat utama Anda.
Kasus penggunaan lainnya
Anda dapat menggunakan atribusi penggunaan pelanggan untuk melacak penggunaan solusi Azure yang tidak tersedia di marketplace komersial. Solusi ini biasanya berada di repositori Mulai Cepat, repositori GitHub pribadi, atau berasal dari keterlibatan pelanggan 1:1 yang menciptakan IP yang tahan lama (seperti aplikasi yang dapat disebarkan dan dapat diskalakan).
Ada beberapa langkah manual yang diperlukan:
- Buat satu atau beberapa GUID untuk digunakan sebagai ID pelacakan Anda.
- Daftarkan GUID tersebut pada Pusat Mitra.
- Tambahkan GUID terdaftar Anda ke string aplikasi Azure dan/atau agen pengguna Anda.
Buat GUID
Tidak seperti ID pelacakan yang dibuat Pusat Mitra atas nama Anda untuk aplikasi Azure di pasar komersial, penggunaan lain dari Atribusi Penggunaan Pelanggan mengharuskan Anda membuat GUID untuk digunakan sebagai ID pelacakan Anda. GUID adalah pengidentifikasi referensi unik yang memiliki 32 digit heksadesimal. Untuk membuat GUID untuk pelacakan, Anda harus menggunakan generator GUID, misalnya, melalui PowerShell:
[guid]::NewGuid()
Anda harus membuat GUID unik untuk setiap produk dan saluran distribusi. Anda dapat menggunakan satu GUID untuk beberapa saluran distribusi produk jika Anda tidak ingin pelaporan yang terpisah. Pelaporan terjadi oleh PartnerID dan GUID.
Mendaftarkan GUID
GUID selanjutnya harus terdaftar di Pusat Mitra agar dapat dikaitkan dengan Anda sebagai mitra:
Masuk ke Pusat Mitra.
Daftar sebagai penerbit pasar komersial.
Pilih Pengaturan (ikon roda gigi) di sudut kanan atas, lalu Pengaturan akun.
Pilih Profil organisasi>Pengidentifikasi>Tambahkan GUID Pelacakan.
Dalam kotak GUID, masukkan GUID pelacakan Anda. Masukkan GUID saja tanpa prefiks
pid-. Dalam kotak Deskripsi, masukkan nama atau deskripsi solusi Anda.Untuk mendaftarkan lebih dari satu GUID, pilih Tambahkan GUID Pelacakan kembali. Kotak tambahan akan muncul di halaman.
Pilih Simpan.
Menambahkan GUID ke templat Resource Manager
Untuk menambahkan GUID terdaftar Anda ke templat Resource Manager, buat satu modifikasi pada file templat utama:
Buka templat Resource Manager.
Tambahkan sumber daya baru dari jenis Microsoft.Resources/deployments dalam file templat utama. Sumber daya harus berada dalam file mainTemplate.js atau azuredeploy.js saja, bukan dalam templat yang bersarang atau tertaut.
Masukkan nilai GUID setelah prefiks
pid-sebagai nama sumber daya. Misalnya, jika GUID adalah eb7927c8-dd66-43e1-b0cf-c346a422063, nama sumber dayanya akan menjadi pid-eb7927c8-dd66-43e1-b0cf-c346a422063. Contoh:
{ // add this resource to the resources section in the mainTemplate.json
"apiVersion": "2020-06-01",
"name": "pid-XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX", // use your generated GUID here
"type": "Microsoft.Resources/deployments",
"properties": {
"mode": "Incremental",
"template": {
"$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"resources": []
}
}
} // remove all comments from the file when complete
Periksa templat dari kesalahan.
Terbitkan ulang templat dalam repositori yang sesuai.
Tip
Untuk informasi selengkapnya tentang pembuatan dan penerbitan templat Resource Manager, lihat: membuat dan menyebarkan templat Resource Manager pertama Anda.
Memverifikasi penyebaran yang dilacak dengan GUID
Setelah memodifikasi templat dan menjalankan penyebaran pengujian, gunakan skrip PowerShell berikut untuk mengambil sumber daya yang Anda gunakan dan tandai.
Anda dapat menggunakan skrip untuk memverifikasi bahwa GUID berhasil ditambahkan ke templat Resource Manager Anda. Skrip tidak berlaku untuk penyebaran API Resource Manager atau Terraform.
Masuk ke Azure. Pilih langganan dengan penyebaran yang ingin Anda verifikasi sebelum menjalankan skrip. Jalankan skrip dalam konteks langganan penyebaran.
GUID (di bawah ini disebut "deploymentName") dan nama resourceGroupName dari penyebaran adalah parameter yang diperlukan.
Anda bisa mendapatkan skrip Verify-DeploymentGuid asli di GitHub.
Param(
[string][Parameter(Mandatory=$true)]$deploymentName, # the full name of the deployment, e.g. pid-XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
[string][Parameter(Mandatory=$true)]$resourceGroupName
)
# Get the correlationId of the named deployment
$correlationId = (Get-AzResourceGroupDeployment -ResourceGroupName $resourceGroupName -Name "$deploymentName").correlationId
# Find all deployments with that correlationId
$deployments = Get-AzResourceGroupDeployment -ResourceGroupName $resourceGroupName | Where-Object{$_.correlationId -eq $correlationId}
# Find all deploymentOperations in all deployments with that correlationId as PowerShell doesn't surface outputResources on the deployment or correlationId on the deploymentOperation
foreach ($deployment in $deployments){
# Get deploymentOperations by deploymentName
# then the resourceIds for each resource
($deployment | Get-AzResourceGroupDeploymentOperation | Where-Object{$_.targetResource -notlike "*Microsoft.Resources/deployments*"}).TargetResource
}
Memberi tahu pelanggan Anda
Mitra harus memberi tahu pelanggannya tentang penyebaran yang menggunakan atribusi penggunaan pelanggan. Contoh berikut ini mencakup konten yang dapat Anda gunakan untuk memberi tahu pelanggan tentang penyebaran ini. Dalam contoh, ganti <MITRA> dengan nama perusahaan Anda. Mitra harus memastikan pemberitahuan selaras dengan kebijakan privasi dan pengumpulan datanya, termasuk opsi agar pelanggan dikecualikan dari pelacakan.
Pemberitahuan untuk penyebaran templat Resource Manager
Saat Anda menyebarkan templat ini, Microsoft dapat mengidentifikasi penginstalan <perangkat lunak MITRA> dengan sumber daya Azure yang disebarkan. Microsoft dapat menghubungkan sumber daya ini yang digunakan untuk mendukung perangkat lunak. Microsoft mengumpulkan informasi ini untuk memberikan pengalaman terbaik dengan produknya dan untuk mengoperasikan bisnisnya. Data dikumpulkan dan diatur oleh kebijakan privasi Microsoft, yang berada di https://www.microsoft.com/trustcenter.
Pemberitahuan untuk penyebaran SDK atau API
Saat Anda menyebarkan <perangkat lunak MITRA> , Microsoft dapat mengidentifikasi penginstalan <perangkat lunak MITRA> dengan sumber daya Azure yang disebarkan. Microsoft dapat menghubungkan sumber daya ini yang digunakan untuk mendukung perangkat lunak. Microsoft mengumpulkan informasi ini untuk memberikan pengalaman terbaik dengan produknya dan untuk mengoperasikan bisnisnya. Data dikumpulkan dan diatur oleh kebijakan privasi Microsoft, yang berada di https://www.microsoft.com/trustcenter.
Menggunakan API Resource Manager
Dalam beberapa kasus, Anda dapat melakukan panggilan langsung terhadap REST API Resource Manager untuk menyebarkan layanan Azure. Azure mendukung beberapa SDK untuk memungkinkan panggilan ini. Anda dapat menggunakan salah satu SDK atau memanggil REST API secara langsung untuk menyebarkan sumber daya.
Untuk mengaktifkan atribusi penggunaan pelanggan, saat mendesain panggilan API, sertakan ID pelacakan Anda di header agen pengguna dalam permintaan. Format string dengan prefiks pid-. Contoh:
//Commercial Marketplace Azure app
pid-contoso-myoffer-partnercenter //copy the tracking ID exactly as it appears in Partner Center
//Other use cases
pid-b6addd8f-5ff4-4fc0-a2b5-0ec7861106c4 //enter your GUID after "pid-"
Penting
Jika Anda menggunakan API Resource Manager dengan aplikasi Azure di pasar komersial, gunakan ID pelacakan yang disediakan dalam Pusat Mitra. JANGAN gunakan GUID.
Berbagai SDK berinteraksi dengan API Resource Manager secara lain dan akan memerlukan beberapa perbedaan dalam kode Anda. Contoh di bawah ini menampilkan pendekatan pasar non-komersial menggunakan GUID dan mencakup berbagai Azure SDK yang lebih populer.
Contoh: Python SDK
Untuk Python, gunakan atribut config. Anda hanya dapat menambahkan atribut ke UserAgent. Contoh:
client = azure.mgmt.servicebus.ServiceBusManagementClient(**parameters)
client.config.add_user_agent("pid-b6addd8f-5ff4-4fc0-a2b5-0ec7861106c4")
Penting
Tambahkan atribut untuk setiap klien. Tidak ada konfigurasi statis global. Anda mungkin menandai pabrik klien untuk memastikan setiap klien melakukan pelacakan. Untuk informasi selengkapnya, lihat sampel pabrik klien di GitHub ini.
Contoh: .NET SDK
Untuk .NET, pastikan untuk mengatur agen pengguna. Gunakan pustaka Microsoft.Azure.Management.Fluent untuk mengatur agen pengguna dengan kode berikut (contoh di C#):
var azure = Microsoft.Azure.Management.Fluent.Azure
.Configure()
// Add your pid in the user agent header
.WithUserAgent("pid-XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX", String.Empty)
.Authenticate(/* Credentials created via Microsoft.Azure.Management.ResourceManager.Fluent.SdkContext.AzureCredentialsFactory */)
.WithSubscription("<subscription ID>");
Penting
Pada Juni 2023, Pusat Mitra terbaru .NET SDK rilis 3.4.0 sekarang diarsipkan. Anda dapat mengunduh rilis SDK dari GitHub, bersama dengan file readme yang berisi informasi yang berguna.
Mitra didorong untuk terus menggunakan REST API Pusat Mitra.
Contoh: Azure PowerShell
Jika Anda menyebarkan sumber daya melalui Azure PowerShell, tambahkan GUID Anda menggunakan metode ini:
[Microsoft.Azure.Common.Authentication.AzureSession]::ClientFactory.AddUserAgent("pid-eb7927c8-dd66-43e1-b0cf-c346a422063")
Catatan
Sebaiknya Anda menggunakan modul Azure Az PowerShell untuk berinteraksi dengan Azure. Lihat Menginstal Azure PowerShell untuk memulai. Untuk mempelajari cara bermigrasi ke modul Az PowerShell, lihat Memigrasikan Azure PowerShell dari AzureRM ke Az.
Contoh: Azure CLI
Saat menggunakan Azure CLI untuk menyertakan GUID Anda, atur variabel lingkungan AZURE_HTTP_USER_AGENT dalam cakupan skrip. Anda juga dapat mengatur variabel secara global untuk cakupan shell:
export AZURE_HTTP_USER_AGENT='pid-eb7927c8-dd66-43e1-b0cf-c346a422063'
Untuk informasi selengkapnya, lihat Azure SDK untuk Go.
Menggunakan Terraform
Dukungan untuk Terraform tersedia melalui rilis 1.21.0 Penyedia Azure: https://github.com/terraform-providers/terraform-provider-azurerm/blob/master/CHANGELOG.md#1210-january-11-2019. Ini berlaku untuk semua mitra yang menyebarkan solusinya melalui Terraform dan semua sumber daya yang disebarkan dan diukur oleh Penyedia Azure (versi 1.21.0 atau yang lebih baru).
Penyedia Azure untuk Terraform menambahkan bidang opsional baru yang disebut partner_id untuk menentukan GUID pelacakan yang digunakan untuk solusi Anda. Nilai bidang ini juga dapat bersumber dari Variabel Lingkungan ARM_PARTNER_ID.
provider "azurerm" {
subscription_id = "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
client_id = "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
……
# new stuff for ISV attribution
partner_id = "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"}
Penting
Jika Anda menggunakan Terraform dengan aplikasi Azure di pasar komersial, gunakan seluruh ID pelacakan yang disediakan dalam Pusat Mitra. JANGAN gunakan GUID.
Mendapatkan dukungan
Pelajari tentang opsi dukungan dalam pasar komersial di Dukungan untuk program pasar komersial di Pusat Mitra.
Cara mengirimkan permintaan konsultasi teknis
- Kunjungi Layanan Teknis Mitra.
- Pilih Infrastruktur dan manajemen cloud untuk menampilkan perjalanan teknis.
- Pilih Layanan Penyebaran>Kirim permintaan.
- Masuk menggunakan MSA (akun Program Mitra Cloud Microsoft AI) atau ID Microsoft Entra Anda (akun Dasbor Mitra).
- Lengkapi/tinjau informasi kontak pada formulir yang terbuka. Detail konsultasi mungkin telah diisi sebelumnya atau Anda mungkin memiliki opsi drop-down.
- Masukkan judul dan deskripsi terperinci tentang masalah tersebut.
- Pilih kirim.
Lihat instruksi langkah demi langkah dengan cuplikan layar di Menggunakan Prapenjualan Teknis dan Layanan Penyebaran.
Anda akan dihubungi oleh Konsultan Teknis Mitra Microsoft untuk menyiapkan panggilan demi mengatasi kebutuhan Anda.
FAQ
Setelah ID pelacakan ditambahkan, dapatkah id diubah?
ID pelacakan untuk aplikasi Azure di pasar komersial dikelola secara otomatis oleh Pusat Mitra. Namun pelanggan dapat mengunduh templat dan mengubah atau menghapus ID pelacakan. Mitra harus secara proaktif menjelaskan peran ID pelacakan kepada pelanggannya untuk mencegah penghapusan atau pengeditan. Perubahan ID pelacakan hanya memengaruhi penyebaran dan sumber daya baru, bukan yang sudah ada.
Dapatkah saya melacak templat yang disebarkan dari repositori non-Microsoft seperti GitHub?
Ya, selama ID pelacakan ada saat templat disebarkan, penggunaan dilacak. Demi menjaga hubungan antara Anda sebagai penerbit dan templat Anda yang disebarkan dari repositori non-Microsoft, pertama-tama unduh salinan templat yang Anda terbitkan (yang akan berisi ID pelacakan) dari daftar pasar komersial penawaran Anda dalam portal Microsoft Azure. Publikasikan versi tersebut ke GitHub atau repositori non-Microsoft lainnya.
Jika templat Anda tidak tercantum di marketplace komersial dan menyertakan GUID terdaftar, pastikan GUID ada dalam versi yang Anda terbitkan ke GitHub atau repositori non-Microsoft lainnya.
Apakah Microsoft berbagi data Atribusi Penggunaan Pelanggan dengan mitra?
Tidak. Microsoft tidak berbagi data konsumsi Azure yang dilacak melalui Atribusi Penggunaan Pelanggan secara eksternal dengan Mitra.
Apakah pelanggan menerima pelaporan Atribusi Penggunaan Pelanggan?
Tidak. Pelanggan dapat melacak penggunaan semua sumber daya atau grup sumber daya dalam portal Microsoft Azure. Pelanggan tidak melihat penggunaan dipecah oleh ID pelacakan Atribusi Penggunaan Pelanggan.
Apakah atribusi penggunaan pelanggan mirip dengan mitra digital catatan (DPOR) atau tautan admin mitra (PAL)?
Atribusi penggunaan pelanggan adalah mekanisme untuk mengaitkan penggunaan Azure dengan IP mitra yang dapat diulang dan dapat disebarkan - yang membentuk asosiasi pada saat penyebaran. DPOR dan PAL ditujukan untuk mengaitkan konsultan (Integrator Sistem) atau manajemen (Penyedia Layanan Terkelola) bermitra dengan jejak Azure yang relevan milik pelanggan selama untuk saat itu selama mitra terlibat dengan pelanggan.
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk