View a markdown version of this page

Utilizzo delle Revenue Share del Marketplace - AWS Centrale Partner
Cos'è il Marketplace Revenue Share?Utilizzo delle Revenue Share del MarketplaceEtichettatura delle quote di fatturato del Marketplace

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 delle Revenue Share del Marketplace

Un Marketplace Revenue Share è un input per un prodotto AWS Marketplace che dichiara la parte del fatturato totale del prodotto riscossa tramite AWS Marketplace.AWS utilizza questo input per correlare le Marketplace-collected entrate di un partner con altri segnali di fatturato.

Il Marketplace Revenue Share Service utilizza le API per creare, recuperare ed elencare le risorse Marketplace Revenue Share e gestirne le allocazioni (le percentuali di compartecipazione ai ricavi dichiarate dai partner e le finestre di data di validità). Le operazioni di AWS tagging standard sono supportate nella risorsa Marketplace Revenue Share.

Cos'è il Marketplace Revenue Share?

Un Marketplace Revenue Share ha due livelli:

  • La condivisione: un input per un singolo prodotto AWS Marketplace, identificato dal MarketplaceProductId. Esiste esattamente un Marketplace Revenue Share per prodotto.

  • Una o più allocazioni: ogni allocazione dichiara una RevenueSharePercent finestra di data di validità (EffectiveDatefacoltativamente). ExpirationDate Una condivisione può avere molte allocazioni nel tempo, ma in qualsiasi momento può essere applicata una sola allocazione. ACTIVE

Le allocazioni hanno le seguenti proprietà chiave:

  • Stato: ACTIVE o. INACTIVE Al momento della creazione, lo status è predefinito su. ACTIVE Solo ACTIVE le allocazioni partecipano al calcolo delle entrate e ai controlli di sovrapposizione.

  • Invariante di sovrapposizione: all'interno di una singola azione, non è possibile che due ACTIVE allocazioni abbiano intervalli sovrapposti. [EffectiveDate, ExpirationDate] È consentita al massimo un'ACTIVEallocazione a tempo indeterminato (noExpirationDate) per azione in qualsiasi momento.

Utilizzo delle Revenue Share del Marketplace

I partner gestiscono le Marketplace Revenue Share e le relative allocazioni tramite il Marketplace Revenue Share Service. Il ciclo di vita procede attraverso due flussi: il flusso di condivisione (creazione, recupero, elenco, tag) e il flusso di allocazioni (creazione, aggiornamento, eliminazione parziale, recupero, elenco).

Creazione di una quota di fatturato del Marketplace

Il primo passaggio consiste nella creazione di un Marketplace Revenue Share per un prodotto AWS Marketplace utilizzando l'azione CreateMarketplaceRevenueShare API. La condivisione viene identificata dal Marketplace ProductId e funge da contenitore per tutte le allocazioni successive.

Quando creano un Marketplace Revenue Share, i partner devono fornire:

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

  • ProductId— l'ID del prodotto Marketplace di 25 caratteri. Modello:[a-z0-9]{25}.

I partner possono opzionalmente fornire:

  • Tags— fino a 50 coppie chiave-valore per l'organizzazione delle risorse al momento della creazione. TagResourceDa utilizzare per aggiungere tag dopo la creazione.

  • ClientToken— un token di idempotenza per evitare creazioni duplicate in caso di nuovo tentativo. Massimo 64 caratteri. Gli SDK generano automaticamente questo token.

Convalida del prodotto: al momento della creazione, il servizio verifica con AWS Marketplace che il prodotto sia di proprietà dell'account del chiamante o di un account sussidiario collegato al chiamante tramite Partner Account Connection (PAC). Se il prodotto non esiste o l'account proprietario non è autorizzato per il chiamante, l'API restituisce un messaggio indicativo. ValidationException PRODUCT_NOT_FOUND_OR_NOT_OWNED

Una quota per prodotto: una seconda CreateMarketplaceRevenueShare chiamata per lo stesso prodotto con gli stessi ProductId rendimenti. Catalog ConflictException

La risposta restituisce il Arn (formatoarn:{partition}:partnercentral:{region}:{account-id}:catalog/{catalog}/marketplace-revenue-share/{productId}) della condivisione, il CatalogProductId, il Version numero iniziale (che inizia da 1 e aumenta a ogni mutazione di allocazione) e tutti i tag applicati al momento della creazione.

Aggiungere allocazioni

Una volta creato un Marketplace Revenue Share, i partner dichiarano una percentuale di compartecipazione alle entrate e una finestra di data di validità creando un'allocazione tramite l'azione API. CreateMarketplaceRevenueShareAllocation

Quando creano un'allocazione, i partner devono fornire:

  • Catalog— AWS oppure. Sandbox

  • MarketplaceRevenueShareIdentifier— l'identificatore della quota principale.

  • RevenueSharePercent— la percentuale delle entrate del prodotto raccolte tramite Marketplace fornita come decimale (ad esempio, 0.45 per il 45%).

  • EffectiveDate— la data di calendario in cui questa allocazione diventa effettiva. Formato:YYYY-MM-DD.

La risposta restituisce lo stato dell'allocazione Id (formatomrsa-[A-Za-z0-9]{13}), lo stato dell'allocazione (ACTIVEalla creazione) e il valore cumulato della condivisione principale Version (per ogni mutazione di allocazione viene visualizzato un numero intero di versione per condivisione, utilizzato per bloccare in modo ottimistico i successivi aggiornamenti dell'allocazione).

Aggiornamento delle allocazioni

I partner possono aggiornare un'allocazione utilizzando l'azione UpdateMarketplaceRevenueShareAllocation API. I campi aggiornabili dipendono dal fatto che l'allocazione sia con data futura, attuale o passata.

Quando aggiornano un'allocazione, i partner devono fornire:

  • Catalog— AWS oppure. Sandbox

  • MarketplaceRevenueShareIdentifier— l'identificatore della quota principale.

  • AllocationId— l'mrsa-ID dell'allocazione da aggiornare.

  • MarketplaceRevenueShareVersion— la versione corrente della condivisione principale per un blocco ottimistico dell'allocazione. Ritornano i conflitti Bump. ConflictException

I partner possono fornire facoltativamente:

  • RevenueSharePercent— la percentuale aggiornata di compartecipazione alle entrate. Modificabile solo su allocazioni con data futura.

  • EffectiveDate— la data di validità aggiornata. Modificabile solo su allocazioni con data futura.

  • ExpirationDate— la data di scadenza aggiornata. Modificabile sulle allocazioni con data futura (qualsiasi valore> EffectiveDate) e sulle allocazioni attualmente in vigore o a tempo indeterminato (qualsiasi valore). ≥ today

  • StatusINACTIVE— oppure. ACTIVE L'impostazione su INACTIVE soft elimina l'allocazione. Modificabile solo su allocazioni con data futura.

  • ClientToken— un token di idempotenza.

Visualizzazione dei dettagli della quota di fatturato del Marketplace

I partner possono recuperare informazioni complete per un singolo Marketplace Revenue Share utilizzando l'azione GetMarketplaceRevenueShare API. Ciò restituisce la condivisione ArnCatalog,ProductId,, Version (la versione corrente dell'azione principale) e tutti i tag applicati alla condivisione. CreatedDate LastModifiedDate

I partner possono recuperare una singola allocazione utilizzando l'azione GetMarketplaceRevenueShareAllocation API con le allocazioni. Id Viene restituito:

  • L'allocazione Id e la quota principale. MarketplaceRevenueShareArn

  • RevenueSharePercent, EffectiveDate, ExpirationDate.

  • Status(ACTIVEoINACTIVE).

  • La quota principale MarketplaceRevenueShareVersion serve a bloccare con ottimismo gli aggiornamenti successivi.

  • CreatedDate e LastModifiedDate.

Quotazione delle quote di reddito del Marketplace

I partner possono visualizzare tutte le Revenue Share del Marketplace di proprietà del proprio account utilizzando l'azione ListMarketplaceRevenueShares API. Ciò restituisce un elenco impaginato di riepiloghi delle azioni.

I partner possono filtrare i risultati in base a:

  • Catalog— AWS oppure Sandbox (richiesto).

  • ProductIds— un elenco di ID di prodotto specifici del Marketplace da recuperare.

La risposta include un riepilogo per ogni condivisione: ArnCatalog,ProductId,, l'ultima Version eLastModifiedDate. CreatedDate

Usa MaxResults e NextToken impagina set di risultati di grandi dimensioni.

Elencare le allocazioni

I partner possono elencare le allocazioni per uno specifico Marketplace Revenue Share utilizzando l'azione ListMarketplaceRevenueShareAllocations API. Ciò restituisce un elenco impaginato di riepiloghi delle allocazioni con funzionalità di filtro.

I partner possono filtrare i risultati per:

  • Status— ACTIVE oppureINACTIVE.

  • Intervallo di date di validità —EffectiveDateOnOrAfter/EffectiveDateOnOrBeforeper recuperare le allocazioni la cui data di validità rientra in una finestra specifica.

La risposta include informazioni di riepilogo per ogni allocazione:Id,,,RevenueSharePercent, EffectiveDate ExpirationDate StatusMarketplaceRevenueShareVersion, e timestamp di controllo.

Etichettatura delle quote di fatturato del Marketplace

Le operazioni di AWS tagging standard sono supportate nella risorsa Marketplace Revenue Share:

  • TagResource— aggiungere o sovrascrivere tag su un Marketplace Revenue Share. Massimo 50 tag per condivisione.

  • UntagResource— rimuovi tag specifici per chiave.

  • ListTagsForResource— recupera tutti i tag attualmente applicati a un Marketplace Revenue Share.

Le allocazioni non supportano i tag. Etichetta la condivisione principale per organizzare le allocazioni correlate.

Ogni operazione di etichettatura accetta il formato della Arn condivisione come arn:{partition}:partnercentral:{region}:{account-id}:catalog/{catalog}/marketplace-revenue-share/{productId} identificatore della risorsa. Il AWS tag-on-create standard è supportato anche dal campo on. Tags CreateMarketplaceRevenueShare