View a markdown version of this page

Utilizzo dei tuoi Revenue Attribution ID - AWS Centrale Partner
Cos'è un Revenue Attribution ID?Utilizzo dei tuoi Revenue Attribution ID

L' AWS Partner Central API Reference è stato ristrutturato. Per ulteriori informazioni sulle operazioni API supportate, consulta l'AWS Partner Central 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 tuoi prodotti AWS Marketplace a specifiche opportunità di AWS Marketplace Offers Partner Central. and/or AWS Si basa sull'implementazione del Partner Revenue Measurement (PRM) a livello di prodotto: il 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 espone le API per creare, recuperare, elencare e aggiornare i Revenue Attribution ID e per gestire le relative voci mensili di allocazione dei costi in modo asincrono.

Cos'è un Revenue Attribution ID?

Un Revenue Attribution ID è composto da due livelli:

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

  • Una o più voci mensili di allocazione dei costi, ciascuna 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 uno schema 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 offerte di Marketplace and/or ACE Opportunities applicabili e AWS associa i ricavi dei prodotti già misurati a quelle offerte specifiche: non è necessaria alcuna modifica ai tag delle risorse o alle stringhe degli agenti utente 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 dei tuoi Revenue Attribution ID

I partner possono gestire i Revenue Attribution ID e le relative voci mensili di allocazione dei costi tramite il Revenue Attribution Service. Il ciclo di vita procede attraverso due flussi indipendenti: il flusso dei record di attribuzione (creazione, aggiornamento, recupero, elenco) e il flusso delle allocazioni (avvio di un'attività batch, ricerca dei risultati, recupero di singole voci, elenco delle 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'ID restituito Id Arn può essere utilizzato immediatamente come valore del tag di risorsa o in una stringa user-agent per attribuire il consumo. AWS

Quando si crea un Revenue Attribution ID, i partner devono fornire:

  • Catalog— AWS per la produzione o Sandbox per il collaudo.

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

I partner possono fornire facoltativamente:

  • Description— descrizione a 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 comprende più di una scheda 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: indicalo MarketplaceProduct.ProductIdentifier ogni volta che la tua offerta è ancorata a una specifica inserzione sul Marketplace. Ciò consente di 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 di visualizzare la risposta risolta ProductCode e ProductType (ad esempio,SaaS,AMI,ML). Se il prodotto non è di proprietà di un account autorizzato, l'API viene ValidationException restituita con una motivazione. 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 parte 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 Offers and/or ACE Opportunities ad esso inviando un batch di voci mensili di allocazione dei costi tramite l'azione API. StartRevenueAttributionAllocationsTask Si tratta di un'operazione asincrona che accetta fino a 250 modifiche all'allocazione () per attività. CREATE and/or UPDATE

Ogni voce di allocazione specifica:

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

  • Mese di fatturazione: il mese di calendario a cui si applica 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. Necessario per i prodotti SaaS multi-tenant, compresi i componenti ospitati dai partner per implementazioni ibride, in cui i clienti condividono l'infrastruttura.

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

La percentuale totale di allocazione dei costi tra tutte le voci di allocazione per un determinato Revenue Attribution ID 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 viene superata, l'API restituisce uno stato con. TaskId IN_PROGRESS La convalida aziendale (controlli dei limiti massimi, regole di immutabilità, ricerche delle dipendenze rispetto a 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 il Revenue Attribution Resource Id o ARN. GetRevenueAttributionAllocationsTask La risposta procede da IN_PROGRESS a COMPLETED (indipendentemente dal fatto che i singoli record abbiano avuto esito positivo o negativo) e restituisce:

  • TaskStatus—IN_PROGRESS,COMPLETED, o FAILED (errore dell'attività di primo livello).

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

I partner devono recuperare tempestivamente i risultati delle attività. Una volta completata l'attività, i risultati per record possono essere riconciliati ed eventuali immissioni non riuscite possono essere corrette e inviate nuovamente 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 le seguenti regole:

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

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

  • I partner possono aggiornare la voce 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 UPDATE per ogni voce interessata. Il modello di attività asincrono gestisce gli aggiornamenti e le creazioni in modo uniforme.

Aggiornamento di un Revenue Attribution ID

I partner possono aggiornare un Revenue Attribution ID esistente utilizzando l'azione UpdateRevenueAttribution API. Description 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 etichettatura standard sull'ARN dell' AWS attribuzione.

Quando si aggiorna un Revenue Attribution ID, i partner devono fornire:

  • Catalog— AWS o. Sandbox

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

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

I partner possono fornire facoltativamente:

  • Description— la descrizione aggiornata in testo libero. 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 ConflictException e viene visualizzato un messaggio contenente i numeri della versione inviata e corrente. La procedura migliore è 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

  • L'attribuzione 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 del Marketplace (MarketplaceProductse impostati 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 oSINGLE_TENANT.

Informazioni sull'audit:

  • CreatedDate e LastModifiedDate.

I partner possono opzionalmente fornire uno specifico Version nella richiesta per recuperare una versione storica dell'attribuzione. Ometti di restituire la versione più Version recente.

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

Elenco degli ID di attribuzione dei ricavi

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

I partner possono filtrare i risultati per:

  • Catalog— AWS o Sandbox (obbligatorio).

  • 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 o. LastModifiedDate

  • SortOrder— ASCENDING oDESCENDING.

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

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

Elenco delle voci mensili relative all'allocazione dei costi

I partner possono elencare le voci di allocazione dei costi mensili 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 Opportunity 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 l'ID opportunità associato, l'ID dell' AWS account del cliente, il mese di fatturazione, la% di allocazione dei costi, il nome e lo stato della voce e i timestamp di verifica.

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

  • Tutti i Revenue Attribution ID creati negli ultimi 30 giorni, ordinati per data di creazione.

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

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

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