View a markdown version of this page

Utilizzo dei tuoi Revenue Attribution ID - AWS Centrale Partner
Che cos'è un Revenue Attribution ID?Utilizzo degli ID di attribuzione delle entrate

L' Centrale Partner AWS API Reference è stato ristrutturato. Per ulteriori informazioni sulle operazioni API supportate, consulta l'Centrale Partner AWS API Reference.

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Utilizzo dei tuoi Revenue Attribution ID

Un Revenue Attribution ID è un identificatore a livello di offerta che associa le entrate dei prodotti AWS Marketplace a specifiche opportunità di AWS Marketplace and/or AWS Offers Partner Central. Si basa sull'implementazione del Partner Revenue Measurement (PRM) a livello di prodotto: PRM acquisisce le entrate totali attribuite per un prodotto Marketplace e un Revenue Attribution ID associa tali entrate a offerte specifiche in base alle percentuali di allocazione dei costi mensili specificate.

Il Revenue Attribution Service utilizza le API per creare, recuperare, elencare e aggiornare gli ID di attribuzione dei ricavi e per gestire le relative voci di allocazione dei costi mensili in modo asincrono.

Che cos'è un Revenue Attribution ID?

Un Revenue Attribution ID ha due livelli:

  • L'attribuzione a una risorsa denominata e descritta dal partner identificata da un ra- prefisso ID (ad esempio) e da un ARN. ra-aabbccddee001 Ogni attribuzione è limitata a un account (per la produzione, Sandbox per i testCatalog) e all'AWSaccount del partner.

  • Una o più voci mensili relative all'allocazione dei costi. Ogni voce associa una singola combinazione (ID offerta o ID opportunità, mese di fatturazione) a una percentuale di allocazione dei costi. Le voci vengono gestite in batch in modo asincrono tramite un modello di attività di allocazione.

Un Revenue Attribution ID può essere utilizzato in due modi:

  • Come sovrapposizione a livello di offerta sull'implementazione PRM esistente a livello di prodotto. Crea un Revenue Attribution ID, associa le tue offerte Marketplace and/or Offers ACE Opportunities applicabili e AWS associa le entrate dei prodotti già misurate a quelle offerte specifiche: non sono necessarie modifiche ai tag di risorsa o alle stringhe dello user agent esistenti.

  • Come identificatore autonomo utilizzato direttamente come valore del tag di risorsa (aws-apn-id=<RA ID>) o in una stringa user-agent () per attribuire il consumo a un'offerta specifica sin dall'inizio. APN_1.1/pc_<RA ID>$AWS

Utilizzo degli ID di attribuzione delle entrate

I partner possono gestire i Revenue Attribution ID e le relative voci di allocazione dei costi mensili tramite il Revenue Attribution Service. Il ciclo di vita procede attraverso due flussi indipendenti: il flusso di registrazione dell'attribuzione (creazione, aggiornamento, recupero, elenco) e il flusso di allocazioni (avvio di un'attività in batch, ricerca risultati, recupero singole voci, elenco voci per un'attribuzione).

Creazione di un Revenue Attribution ID

Il primo passaggio consiste nella creazione di un Revenue Attribution ID utilizzando l'azione CreateRevenueAttribution API. L'Ide restituito Arn può essere utilizzato immediatamente come valore del tag di risorsa o in una stringa user-agent per attribuire il consumo.AWS

Quando creano un Revenue Attribution ID, i partner devono fornire:

  • Catalog— AWS per la produzione o Sandbox per i test.

  • Name— un nome leggibile dall'uomo per l'attribuzione. Deve essere unico all'interno del Catalogo e dell'account del partner. Massimo 128 caratteri.

I partner possono opzionalmente fornire:

  • Description— descrizione in testo libero dell'attribuzione. Massimo 1024 caratteri.

  • MarketplaceProduct— il prodotto AWS Marketplace da associare a questa attribuzione. Fornisci ProductIdentifier (l'ID del prodotto Marketplace di 25 caratteri) e TenancyModel (MULTI_TENANToSINGLE_TENANT). Se omessa al momento della creazione, l'attribuzione si applica a tutti i consumi misurati con il Revenue Attribution ID, indipendentemente dal prodotto Marketplace acquistato dal cliente, utile quando una singola distribuzione copre più di un'inserzione del Marketplace.

  • Tags— fino a 200 coppie chiave-valore per l'organizzazione delle risorse. Le chiavi dei tag devono essere univoche all'interno della richiesta.

Procedura consigliata: fornisci informazioni MarketplaceProduct.ProductIdentifier ogni volta che la tua offerta è associata a una specifica inserzione nel Marketplace. In questo modo è possibile AWS verificare che il prodotto sia di proprietà dell'account del partner chiamante o di un account sussidiario collegato tramite Partner Account Connection (PAC) e nella risposta viene visualizzato il ProductCode messaggio e ProductType (ad esempio, SaaSAMI,ML). Se il prodotto non è di proprietà di un account autorizzato, l'API viene ValidationException restituita motivatamente. PRODUCT_NOT_FOUND_OR_NOT_OWNED

La risposta restituisce il nuovo Id (formatora-[a-z0-9]{13})Arn, MarketplaceProduct gli attributi risolti e il Version numero iniziale (che inizia da 1 e aumenta a ogni aggiornamento successivo).

Aggiungere voci mensili di allocazione dei costi

Una volta creato un Revenue Attribution ID, i partner associano AWS Marketplace and/or Offers ACE Opportunities ad esso inviando un batch di voci mensili di allocazione dei costi tramite l'StartRevenueAttributionAllocationsTaskazione API. Si tratta di un'operazione asincrona che accetta fino a 250 modifiche di allocazione () per attività. CREATE and/or UPDATE

Ogni voce di allocazione specifica:

  • ID offerta o ID opportunità: l'identificatore univoco dell'offerta associata. Se un'offerta Marketplace è già collegata a un'opportunità ACE, i partner devono solo fornire l'ID dell'offerta; attribuisce AWS automaticamente le entrate all'opportunità collegata.

  • Mese di fatturazione: il mese di calendario a cui si riferisce l'allocazione dei costi (ad esempio,2026-04).

  • % di allocazione dei costi: la parte del AWS consumo totale del prodotto attribuibile a questa offerta in questo mese di fatturazione. Richiesto per i prodotti SaaS multi-tenant, compresi i componenti ospitati dai partner per le implementazioni ibride, in cui i clienti condividono l'infrastruttura.

  • ID AWS account cliente: l'AWS account del cliente che utilizza il prodotto. Richiesto per i prodotti SaaS multi-tenant.

La percentuale totale di allocazione dei costi tra tutte le voci di allocazione per un determinato ID di attribuzione dei ricavi e per lo stesso mese di fatturazione non deve superare il 100%. Se il totale supera il 100%, la voce incriminata viene rifiutata durante la convalida aziendale asincrona con un codice di errore per record.

Convalida sincrona: StartRevenueAttributionAllocationsTask esegue la convalida della forma di base in modo sincrono (tipi di campo, modelli, dimensioni del batch). Se la convalida di base ha esito positivo, l'API restituisce uno stato with. TaskId IN_PROGRESS La convalida aziendale (controlli dei limiti, regole di immutabilità, ricerche delle dipendenze su Marketplace e ACE) viene eseguita in modo asincrono e i risultati per record vengono rilevati tramite. GetRevenueAttributionAllocationsTask

Per monitorare un'attività inviata, i partner effettuano un sondaggio utilizzando GetRevenueAttributionAllocationsTask il Revenue Attribution Resource Id o ARN. La risposta passa da IN_PROGRESS a COMPLETED (indipendentemente dal fatto che i singoli record abbiano avuto esito positivo o negativo) e restituisce:

  • TaskStatus— IN_PROGRESSCOMPLETED, o FAILED (operazione di primo livello non riuscita).

  • RecordResults— per ogni record di input: lo stato assegnato AllocationId (in caso di successo), lo stato per record (SUCCEEDEDoFAILED) e un codice di errore strutturato e un messaggio in caso di errore del record.

I partner devono recuperare tempestivamente i risultati delle attività. Una volta completata l'attività, è possibile riconciliare i risultati per record e le immissioni non riuscite possono essere corrette e reinviate in una nuova attività.

Modifica delle voci mensili di allocazione dei costi

Le voci di allocazione dei costi vengono gestite per mese di fatturazione con queste regole:

  • I partner possono aggiungere una nuova voce mensile per il mese di fatturazione attuale o futuro in qualsiasi momento.

  • I partner possono aggiornare una registrazione mensile per il mese di fatturazione attuale o futuro in qualsiasi momento.

  • I partner possono aggiornare la registrazione del mese scorso fino al 7 del mese corrente. Questa finestra consente ai partner di esaminare l'utilizzo effettivo in AWS Cost Explorer prima di finalizzare l'allocazione del mese precedente.

Dopo il 7 del mese corrente, l'attribuzione per il mese di fatturazione precedente non può più essere modificata. Gli aggiornamenti alla voce del mese corrente o futuro si applicano a partire dal ciclo di fatturazione mensile successivo. L'attribuzione storica per i mesi precedenti non viene ricalcolata retroattivamente.

Gli aggiornamenti alle voci di allocazione vengono inviati tramite la stessa azione StartRevenueAttributionAllocationsTask API, Operation impostata su UPDATE per ogni voce interessata. Il modello di attività asincrono gestisce gli aggiornamenti e le creazioni in modo uniforme.

Aggiornamento di un ID di attribuzione dei ricavi

I partner possono aggiornare l'ID Description di attribuzione delle entrate esistente utilizzando l'azione UpdateRevenueAttribution API. Il record di attribuzione stesso è altrimenti immutabile e i valori tag-on-create non possono essere modificati dopo la creazione. Name MarketplaceProduct Per rietichettare la risorsa, utilizza le operazioni di AWS etichettatura standard sull'ARN dell'attribuzione.

Quando aggiornano un Revenue Attribution ID, i partner devono fornire:

  • Catalog— AWS oppure. Sandbox

  • Identifier— l'ra-ID dell'attribuzione da aggiornare.

  • Version— la versione attuale dell'attribuzione per il blocco ottimistico.

I partner possono opzionalmente fornire:

  • Description— la descrizione a testo libero aggiornata. Massimo 1024 caratteri.

  • ClientToken— un token di idempotenza per l'aggiornamento.

Blocco ottimistico: il Version campo garantisce che gli aggiornamenti si applichino solo se l'attribuzione non è cambiata dall'ultima volta che è stata recuperata. Se la versione inviata Version non corrisponde alla versione corrente della risorsa, l'aggiornamento viene rifiutato con ConflictException un messaggio contenente i numeri di versione inviata e corrente. È consigliabile recuperare la versione più recente GetRevenueAttribution prima di ogni aggiornamento.

Visualizzazione dei dettagli del Revenue Attribution ID

I partner possono recuperare informazioni complete per un singolo Revenue Attribution ID utilizzando l'GetRevenueAttributionazione API. Viene restituito:

Metadati delle risorse:

  • Identificatore univoco (Id) e Amazon Resource Name (Arn).

  • Il Catalog in cui esiste l'attribuzione.

  • Name e Description.

  • Il recuperato Version e il LatestVersion (usa l'ultimo per gli aggiornamenti successivi).

Attributi del prodotto Marketplace (MarketplaceProductse impostato al momento della creazione):

  • ProductId— l'ID del prodotto Marketplace fornito dal partner.

  • ProductCode— il codice del prodotto AWS Marketplace risolto daProductId.

  • ProductType—SaaS,AMI, ContainerML,Data, oProfessional Services.

  • TenancyModel— MULTI_TENANT oppureSINGLE_TENANT.

Informazioni sull'audit:

  • CreatedDate e LastModifiedDate.

I partner possono facoltativamente fornire informazioni specifiche Version nella richiesta per recuperare una versione storica dell'attribuzione. Ometti per restituire la versione più Version recente.

Per recuperare una voce specifica relativa all'allocazione dei costi mensili, i partner utilizzano l'azione GetRevenueAttributionAllocation API con la voce. AllocationId Ciò restituisce l'ID dell'offerta o l'ID dell'opportunità, il mese di fatturazione, la percentuale di allocazione dei costi, l'ID AWS dell'account del cliente e le informazioni sullo stato e sul controllo della voce.

Elenco degli ID di attribuzione dei ricavi

I partner possono visualizzare tutti gli ID di attribuzione delle entrate nel proprio account utilizzando l'azione ListRevenueAttributions API. Ciò restituisce un elenco impaginato di riepiloghi delle attribuzioni con funzionalità di filtraggio e ordinamento.

I partner possono filtrare i risultati per:

  • Catalog— AWS oppure Sandbox (richiesto).

  • Identifiers— un elenco di un massimo di 100 ra- ID specifici da recuperare.

  • CreatedAfter/CreatedBefore— filtra per intervallo di data e ora di creazione (incluso).

I partner possono configurare l'ordinamento dei risultati utilizzando il parametro: Sort

  • SortBy— CreatedDate oppure. LastModifiedDate

  • SortOrder— ASCENDING oppureDESCENDING.

La risposta include un riepilogo per ogni attribuzione:Arn,Id,Catalog,Name, MarketplaceProduct attributi risolti,CreatedDate,LastModifiedDate, gli ultimi Version e TotalRevenueAttributionAssociationCount (il numero di voci attive di allocazione dei costi mensili collegate all'attribuzione).

Utilizza MaxResults (impostazione predefinita 25, massimo 100) e impagina tra set NextToken di risultati di grandi dimensioni. La risposta include un messaggio NextToken se sono disponibili pagine aggiuntive.

Elenco delle voci di allocazione dei costi mensili

I partner possono elencare le voci mensili di allocazione dei costi per uno specifico Revenue Attribution ID utilizzando l'ListRevenueAttributionAllocationsazione API. Ciò restituisce un elenco impaginato di riepiloghi delle allocazioni con funzionalità di filtro.

I partner possono filtrare i risultati per:

  • MarketplaceOfferId— elenca solo le voci associate a una specifica offerta del Marketplace.

  • AwsPartnerCentralOpportunityId— elenca solo le voci associate a una specifica opportunità di Partner Central.

  • BillingMonth— elenca solo le voci relative a un mese di calendario specifico.

La risposta include informazioni di riepilogo per ogni voce: l'AllocationIdID dell'offerta o dell'opportunità associato, l'ID dell'AWS account cliente, il mese di fatturazione, la percentuale di allocazione dei costi, il nome e lo stato della voce e gli orari di verifica.

Creazione di dashboard: la combinazione di ListRevenueAttributions e ListRevenueAttributionAllocations è progettata per supportare la creazione di dashboard per i partner. I partner possono creare visualizzazioni come:

  • Tutti gli ID di attribuzione delle entrate creati negli ultimi 30 giorni, ordinati per data di creazione.

  • Tutte le voci mensili relative all'allocazione dei costi per una specifica offerta Marketplace su più Revenue Attribution ID.

  • Tutte le voci relative all'allocazione dei costi per il mese di fatturazione corrente, per verificare che i totali non superino il 100% per attribuzione.

  • Tutti gli ID di attribuzione dei ricavi che hanno almeno una voce di allocazione attiva (). TotalRevenueAttributionAssociationCount > 0