Azure-kundanvändningsatribution

Artikel
06/14/2024

Kundanvändningsattribution associerar användning från Azure-resurser i kundprenumerationer som skapats när du distribuerar din IP-adress med dig som partner. Genom att skapa dessa associationer i interna Microsoft-system får du bättre intern insyn i azure-fotavtrycket som kör din programvara. För Azure-programerbjudanden på den kommersiella marknadsplatsen hjälper den här spårningsfunktionen dig att anpassa dig till Microsofts säljteam och få kredit för Microsofts partnerprogram. Kundanvändningstillskrivning gäller inte för erbjudanden för virtuella Azure-datorer på den kommersiella marknadsplatsen. Det finns inget som en Marketplace-utgivare behöver göra för erbjudanden för virtuella datorer för att säkerställa att deras Azure-förbrukning spåras i slutkundsprenumerationer.

Kundanvändningsttribution har stöd för tre distributionsalternativ:

Azure Resource Manager-mallar (de vanliga grunderna för Azure-appar, som även kallas för "lösningsmallar" eller "hanterade appar" på den kommersiella marknadsplatsen): partner skapar Resource Manager-mallar för att definiera infrastrukturen och konfigurationen av sina Azure-lösningar. Med en Resource Manager-mall kan dina kunder distribuera lösningens resurser i ett konsekvent och repeterbart tillstånd.
Azure Resource Manager-API:er: partner kan anropa Resource Manager-API:er för att distribuera en Resource Manager-mall eller direkt etablera Azure-tjänster.
Terraform: partner kan använda Terraform för att distribuera en Resource Manager-mall eller distribuera Azure-tjänster direkt.

Se Sekundära användningsfall senare i den här artikeln för kundanvändningstillskrivning utanför den kommersiella marknadsplatsen.

Viktigt!

Kundanvändningsattribution är inte avsett att spåra arbetet med systemintegratörer, hanterade tjänsteleverantörer eller verktyg som främst är utformade för att distribuera och hantera Azure-resurser.
Kundanvändningsattribution är för nya distributioner och stöder inte spårningsresurser som redan har distribuerats.
- Alla Azure-tjänster är inte kompatibla med kundanvändningsatribution. Azure Kubernetes Services (AKS), VM Scale Sets och Azure Batch har kända problem som orsakar underrapportering av användning.
- Azure-förbrukningsdata för kundanvändning delas inte externt med partner.

Azure-appar på den kommersiella marknadsplatsen

Det är till stor del automatiskt att spåra Azure-användning från Azure-appar som publicerats på den kommersiella marknadsplatsen. När du laddar upp en Resource Manager-mall som en del av den tekniska konfigurationen av din Azure-appplan för Marketplace lägger Partnercenter till ett spårnings-ID som kan läsas av Azure Resource Manager.

Kommentar

För att säkerställa att programmets användning tillskrevs korrekt i våra system:

Om du definierar spårnings-ID:t i resurstypen Microsoft.Resources/deployment med en variabel ersätter du variabeln med spårnings-ID:t som visas i Partnercenter på planens tekniska konfigurationssida (se Lägg till ett GUID i en Resource Manager-mall nedan).
Om resource manager-mallen använder resurser av typen Microsoft.Resources/deployments för andra syften än kundanvändningsattribution kan Microsoft inte lägga till ett spårnings-ID för kundanvändningsattribution för din räkning. Lägg till en ny resurs av typen Microsoft.Resources/deployments och lägg till spårnings-ID:t som visas i Partnercenter på planens tekniska konfigurationssida (se Lägga till ett GUID i en Resource Manager-mall nedan).

Om du använder Azure Resource Manager-API:er måste du lägga till ditt spårnings-ID enligt anvisningarna nedan för att skicka det till Azure Resource Manager när koden distribuerar resurser. Det här ID:t visas i Partnercenter på sidan Teknisk konfiguration för din Azure-programplan.

Kommentar

För befintliga Azure-appar påbörjades en engångsmigrering i mars 2021 för att uppdatera spårnings-ID:t i varje plans tekniska konfiguration. Användning från tidigare distributioner av dessa erbjudanden förblir spårad i Microsoft-system.

När du uppdaterar dina erbjudanden behöver du inte längre lägga till resurstypen Microsoft.Resources/deployments i huvudmallfilen.

Andra användningsfall

Du kan använda kundanvändningstillskrivning för att spåra Azure-användning av lösningar som inte är tillgängliga på den kommersiella marknadsplatsen. De här lösningarna finns vanligtvis i snabbstartslagringsplatsen, privata GitHub-lagringsplatser eller kommer från 1:1-kundengagemang som skapar varaktiga IP-adresser (till exempel en distribuerad och skalbar app).

Det krävs flera manuella steg:

Skapa ett eller flera GUID:er som ska användas som spårnings-ID: er.
Registrera dessa GUID:er i Partnercenter.
Lägg till dina registrerade GUID:er i din Azure-app och/eller användaragentsträngar.

Skapa GUID:er

Till skillnad från de spårnings-ID:n som Partnercenter skapar åt dig för Azure-appar på den kommersiella marknadsplatsen, kräver andra användningar av kundanvändningsattribution att du skapar ett GUID som ska användas som spårnings-ID. Ett GUID är en unik referensidentifierare som har 32 hexadecimala siffror. Om du vill skapa GUID för spårning bör du använda en GUID-generator, till exempel via PowerShell:

[guid]::NewGuid()

Du bör skapa ett unikt GUID för varje produkt- och distributionskanal. Du kan använda ett enda GUID för en produkts flera distributionskanaler om du inte vill att rapporteringen ska delas upp. Rapportering sker av PartnerID och GUID.

Registrera GUID:er

GUID måste sedan registreras i Partnercenter så att de kan associeras med dig som partner:

Logga in på Partnercenter.
Registrera dig som utgivare på den kommersiella marknadsplatsen.
Välj Inställningar (kugghjulsikon) i det övre högra hörnet och sedan Kontoinställningar.
Välj Organisationsprofilidentifierare>Lägg till spårnings-GUID.>
I rutan GUID anger du ditt spårnings-GUID. Ange bara GUID utan prefixet pid- . I rutan Beskrivning anger du ditt lösningsnamn eller din beskrivning.
Om du vill registrera mer än ett GUID väljer du Lägg till spårnings-GUID igen. Ytterligare rutor visas på sidan.
Välj Spara.

Lägga till ett GUID i en Resource Manager-mall

Om du vill lägga till ditt registrerade GUID i en Resource Manager-mall gör du en enda ändring i huvudmallfilen:

Öppna Resource Manager-mallen.
Lägg till en ny resurs av typen Microsoft.Resources/deployments i huvudmallfilen. Resursen måste bara finnas i mainTemplate.json- eller azuredeploy.json-filen, inte i några kapslade eller länkade mallar.
Ange GUID-värdet efter prefixet pid- som namnet på resursen. Om GUID till exempel är eb7927c8-dd66-43e1-b0cf-c346a422063 blir resursnamnet pid-eb7927c8-dd66-43e1-b0cf-c346a422063. Exempel:

{ // 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

Kontrollera om det finns fel i mallen.
Publicera om mallen på lämpliga lagringsplatser.
Kontrollera att GUID lyckades i malldistributionen.

Dricks

Mer information om hur du skapar och publicerar Resource Manager-mallar finns i: skapa och distribuera din första Resource Manager-mall.

Verifiera distributioner som spåras med ett GUID

När du har modifierat mallen och kört en testdistribution använder du följande PowerShell-skript för att hämta de resurser som du distribuerade och taggade.

Du kan använda skriptet för att kontrollera att GUID har lagts till i Resource Manager-mallen. Skriptet gäller inte för Resource Manager API- eller Terraform-distributioner.

Logga in på Azure. Välj prenumerationen med den distribution som du vill verifiera innan du kör skriptet. Kör skriptet i prenumerationskontexten för distributionen.

GUID (nedan kallat "deploymentName") och resourceGroupName-namnet på distributionen är obligatoriska parametrar.

Du kan hämta det ursprungliga Verify-DeploymentGuid-skriptet på 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
}

Meddela dina kunder

Partner bör informera sina kunder om distributioner som använder kundanvändningstillskrivning. Följande exempel innehåller innehåll som du kan använda för att meddela dina kunder om dessa distributioner. I exemplen ersätter du <PARTNER> med ditt företagsnamn. Partner bör se till att meddelandet överensstämmer med deras principer för datasekretess och insamling, inklusive alternativ för kunder som ska undantas från spårning.

Meddelande för Resource Manager-malldistributioner

När du distribuerar den här mallen kan Microsoft identifiera installationen av <PARTNER-programvara> med de distribuerade Azure-resurserna. Microsoft kan korrelera de resurser som används för att stödja programvaran. Microsoft samlar in den här informationen för att tillhandahålla de bästa upplevelserna med sina produkter och för att driva verksamheten. Data samlas in och styrs av Microsofts sekretesspolicyer som finns på https://www.microsoft.com/trustcenter.

Meddelande för SDK- eller API-distributioner

När du distribuerar <PARTNER-programvara> kan Microsoft identifiera installationen av <PARTNER-programvara> med de distribuerade Azure-resurserna. Microsoft kan korrelera de resurser som används för att stödja programvaran. Microsoft samlar in den här informationen för att tillhandahålla de bästa upplevelserna med sina produkter och för att driva verksamheten. Data samlas in och styrs av Microsofts sekretesspolicyer som finns på https://www.microsoft.com/trustcenter.

Använda Resource Manager-API:er

I vissa fall kan du göra anrop direkt mot Resource Manager REST API:er för att distribuera Azure-tjänster. Azure stöder flera SDK:er för att aktivera dessa anrop. Du kan använda någon av SDK:erna eller anropa REST-API:erna direkt för att distribuera resurser.

Om du vill aktivera kundanvändningsattribution inkluderar du ditt spårnings-ID i användaragenthuvudet i begäran när du utformar dina API-anrop. Formatera strängen med prefixet pid- . Exempel:

//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-"

Viktigt!

Om du använder Resource Manager-API:er med en Azure-app på den kommersiella marknadsplatsen använder du spårnings-ID:t i Partnercenter. Använd INTE ett GUID.

Olika SDK:er interagerar med Resource Manager-API:erna på olika sätt och kräver vissa skillnader i koden. Exemplen nedan innehåller den icke-kommersiella marknadsplatsmetoden med hjälp av ett GUID och täcker en mängd olika populära Azure SDK:er.

Exempel: Python SDK

För Python använder du konfigurationsattributet. Du kan bara lägga till attributet till en UserAgent. Exempel:

client = azure.mgmt.servicebus.ServiceBusManagementClient(**parameters)
client.config.add_user_agent("pid-b6addd8f-5ff4-4fc0-a2b5-0ec7861106c4")

Viktigt!

Lägg till attributet för varje klient. Det finns ingen global statisk konfiguration. Du kan tagga en klientfabrik för att säkerställa att varje klient spårar. Mer information finns i det här klientfabriksexemplet på GitHub.

Exempel: .NET SDK

För .NET måste du ange användaragenten. Använd biblioteket Microsoft.Azure.Management.Fluent för att ange användaragenten med följande kod (exempel i 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>");

Viktigt!

Från och med juni 2023 arkiveras nu den senaste Partner Center .NET SDK-versionen 3.4.0. Du kan ladda ned SDK-versionen från GitHub tillsammans med en readme-fil som innehåller användbar information.

Partner uppmanas att fortsätta att använda REST-API:er för Partnercenter.

Exempel: Azure PowerShell

Om du distribuerar resurser via Azure PowerShell lägger du till ditt GUID med den här metoden:

[Microsoft.Azure.Common.Authentication.AzureSession]::ClientFactory.AddUserAgent("pid-eb7927c8-dd66-43e1-b0cf-c346a422063")

Kommentar

Vi rekommenderar att du använder Azure Az PowerShell-modulen för att interagera med Azure. Se Installera Azure PowerShell för att komma igång. Information om hur du migrerar till Az PowerShell-modulen finns i artikeln om att migrera Azure PowerShell från AzureRM till Az.

Exempel: Azure CLI

När du använder Azure CLI för att lägga till ditt GUID anger du AZURE_HTTP_USER_AGENT miljövariabeln inom omfånget för ett skript. Du kan också ange variabeln globalt för shell-omfång:

export AZURE_HTTP_USER_AGENT='pid-eb7927c8-dd66-43e1-b0cf-c346a422063'

Mer information finns i Azure SDK for Go.

Använda Terraform

Stöd för Terraform är tillgängligt via Azure-providerns version 1.21.0: https://github.com/terraform-providers/terraform-provider-azurerm/blob/master/CHANGELOG.md#1210-january-11-2019. Detta gäller för alla partner som distribuerar sin lösning via Terraform och alla resurser som distribueras och mäts av Azure-providern (version 1.21.0 eller senare).

Azure-providern för Terraform har lagt till ett nytt valfritt fält med namnet partner_id för att ange det spårnings-GUID som används för din lösning. Värdet för det här fältet kan också hämtas från ARM_PARTNER_ID miljövariabeln.

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"}

Viktigt!

Om du använder Terraform med en Azure-app på den kommersiella marknadsplatsen använder du hela spårnings-ID:t i Partnercenter. Använd INTE ett GUID.

Få support

Läs mer om supportalternativen på den kommersiella marknadsplatsen på Support för det kommersiella marketplace-programmet i Partnercenter.

Så här skickar du en begäran om tekniskt samråd

Besök Partner Technical Services.
Välj Molninfrastruktur och hantering för att visa den tekniska resan.
Välj Distributionstjänster>Skicka en begäran.
Logga in med ditt MSA (Microsoft AI Cloud Partner Program-konto) eller ditt Microsoft Entra-ID (partnerinstrumentpanelskonto).
Slutför/granska kontaktinformationen i formuläret som öppnas. Samrådsinformationen kan vara ifylld i förväg eller så kan du ha listrutealternativ.
Ange en rubrik och en detaljerad beskrivning av problemet.
Välj Skicka.

Visa stegvisa instruktioner med skärmbilder på Using Technical Presales and Deployment Services (Använda tekniska presales och distributionstjänster).

Du kommer att kontaktas av en Microsoft Partner Technical Consultant för att konfigurera ett samtal för att omfångsbegränsa dina behov.

Vanliga frågor

Kan det ändras när ett spårnings-ID har lagts till?

Spårnings-ID:n för Azure-appar på den kommersiella marknadsplatsen hanteras automatiskt av Partnercenter. En kund kan dock ladda ned en mall och ändra eller ta bort spårnings-ID:t. Partner bör proaktivt beskriva spårnings-ID:ts roll för sina kunder för att förhindra borttagning eller redigeringar. Om du ändrar spårnings-ID:t påverkas endast nya distributioner och resurser, inte befintliga.

Kan jag spåra mallar som distribuerats från en icke-Microsoft-lagringsplats som GitHub?

Ja, så länge spårnings-ID:t finns när mallen distribueras spåras användningen. Om du vill behålla associationen mellan dig som utgivare och din mall som distribuerats från en icke-Microsoft-lagringsplats laddar du först ned en kopia av den publicerade mallen (som innehåller spårnings-ID:t) från erbjudandets kommersiella marknadsplatslista i Azure-portalen. Publicera den versionen till GitHub eller en annan lagringsplats som inte kommer från Microsoft.

Om mallen inte visas på den kommersiella marknadsplatsen och innehåller ett registrerat GUID kontrollerar du att GUID finns i den version som du publicerar till GitHub eller en annan lagringsplats som inte är från Microsoft.

Nej. Microsoft delar inte Azure-förbrukningsdata som spåras via kundanvändningsattribution externt med partner.

Får kunderna rapportering om kundanvändningsttribution?

Nej. Kunder kan spåra användningen av alla resurser eller resursgrupper i Azure-portalen. Kunder ser inte användning uppdelad efter spårnings-ID för kundanvändningsattribution.

Liknar kundanvändningsattributionen den digitala partnern för posten (DPOR) eller partneradministratörslänken (PAL)?

Kundanvändningsattribution är en mekanism för att associera Azure-användning med en partners repeterbara, distribuerade IP-adress – som bildar associationen vid tidpunkten för distributionen. DPOR och PAL är avsedda att associera en konsultpartner (Systems Integrator) eller hanteringspartner (Managed Service Provider) med en kunds relevanta Azure-fotavtryck under den tid då partnern är engagerad med kunden.

Dela via

Azure-kundanvändningsatribution

Azure-appar på den kommersiella marknadsplatsen

Andra användningsfall

Skapa GUID:er

Registrera GUID:er

Lägga till ett GUID i en Resource Manager-mall

Verifiera distributioner som spåras med ett GUID

Meddela dina kunder

Meddelande för Resource Manager-malldistributioner

Meddelande för SDK- eller API-distributioner

Använda Resource Manager-API:er

Exempel: Python SDK

Exempel: .NET SDK

Exempel: Azure PowerShell

Exempel: Azure CLI

Använda Terraform

Få support

Så här skickar du en begäran om tekniskt samråd

Vanliga frågor

Kan det ändras när ett spårnings-ID har lagts till?

Kan jag spåra mallar som distribuerats från en icke-Microsoft-lagringsplats som GitHub?

Får kunderna rapportering om kundanvändningsttribution?

Liknar kundanvändningsattributionen den digitala partnern för posten (DPOR) eller partneradministratörslänken (PAL)?

Feedback

Ytterligare resurser

Dela via

Azure-kundanvändningsatribution

Azure-appar på den kommersiella marknadsplatsen

Andra användningsfall

Skapa GUID:er

Registrera GUID:er

Lägga till ett GUID i en Resource Manager-mall

Verifiera distributioner som spåras med ett GUID

Meddela dina kunder

Meddelande för Resource Manager-malldistributioner

Meddelande för SDK- eller API-distributioner

Använda Resource Manager-API:er

Exempel: Python SDK

Exempel: .NET SDK

Exempel: Azure PowerShell

Exempel: Azure CLI

Använda Terraform

Få support

Så här skickar du en begäran om tekniskt samråd

Vanliga frågor

Kan det ändras när ett spårnings-ID har lagts till?

Kan jag spåra mallar som distribuerats från en icke-Microsoft-lagringsplats som GitHub?

Delar Microsoft attributionsdata för kundanvändning med partner?

Får kunderna rapportering om kundanvändningsttribution?

Liknar kundanvändningsattributionen den digitala partnern för posten (DPOR) eller partneradministratörslänken (PAL)?

Feedback

Ytterligare resurser