View a markdown version of this page

Arbeiten Sie mit Ihren Marketplace-Umsatzanteilen - AWS Partner Central
Was ist eine Marketplace-Umsatzbeteiligung?Arbeiten Sie mit Ihren Marketplace-UmsatzanteilenKennzeichnung von Marketplace-Umsatzanteilen

Die AWS Partner Central API-Referenz wurde neu strukturiert. Weitere Informationen zu den unterstützten API-Vorgängen finden Sie in der AWS Partner Central API-Referenz.

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Arbeiten Sie mit Ihren Marketplace-Umsatzanteilen

Eine Marketplace-Umsatzbeteiligung ist eine Eingabe für ein AWS Marketplace-Produkt, mit der der Anteil des Gesamtumsatzes des Produkts angegeben wird, der über AWS Marketplace erzielt wird. AWS verwendet diese Eingabe, um den Umsatz eines Partners mit anderen Marketplace-collected Umsatzsignalen zu korrelieren.

Der Marketplace Revenue Share Service stellt APIs zur Verfügung, um Marketplace Revenue Share Ressourcen zu erstellen, abzurufen und aufzulisten und deren Zuweisungen zu verwalten (die vom Partner angegebenen Prozentsätze der Umsatzbeteiligung und Zeitfenster für das Datum des Inkrafttretens). Standardmäßige AWS Tagging-Operationen werden auf der Ressource Marketplace Revenue Share unterstützt.

Was ist eine Marketplace-Umsatzbeteiligung?

Eine Marketplace-Umsatzbeteiligung besteht aus zwei Ebenen:

  • Die Aktie — ein Input für ein einzelnes AWS Marketplace-Produkt, das vom Marketplace identifiziert wirdProductId. Pro Produkt gibt es genau eine Marketplace-Umsatzbeteiligung.

  • Eine oder mehrere Zuweisungen — für jede Zuordnung wird ein RevenueSharePercent Zeitfenster mit Gültigkeitsdatum angegeben (EffectiveDateoptionalExpirationDate). Einer Aktie können im Laufe der Zeit viele Allokationen zugewiesen werden, aber zu jedem Zeitpunkt kann nur eine ACTIVE Zuteilung gelten.

Allokationen haben die folgenden wichtigen Eigenschaften:

  • Status — ACTIVE oderINACTIVE. Bei der Erstellung ist der Status standardmäßig auf ACTIVE eingestellt. Nur ACTIVE Zuweisungen werden bei Umsatzberechnungen und Überschneidungsprüfungen berücksichtigt.

  • Überschneidungsinvariant — innerhalb einer Aktie dürfen sich keine zwei ACTIVE Allokationen überschneiden. [EffectiveDate, ExpirationDate] Pro Aktie ist zu jedem Zeitpunkt höchstens eine unbefristete ACTIVE Zuteilung (neinExpirationDate) zulässig.

Arbeiten Sie mit Ihren Marketplace-Umsatzanteilen

Partner verwalten Marketplace Revenue Shares und ihre Allokationen über den Marketplace Revenue Share Service. Der Lebenszyklus durchläuft zwei Abläufe: den Share-Flow (Erstellen, Abrufen, Auflisten, Taggen) und den Zuteilungsfluss (Erstellen, Aktualisieren, Vorläufiges Löschen, Abrufen, Auflisten).

Eine Marketplace-Umsatzbeteiligung erstellen

Der erste Schritt besteht darin, mithilfe der CreateMarketplaceRevenueShare API-Aktion eine Marketplace-Umsatzbeteiligung für ein AWS Marketplace-Produkt zu erstellen. Die Aktie wird vom Marketplace identifiziert ProductId und dient als Container für alle nachfolgenden Allokationen.

Bei der Erstellung einer Marketplace-Umsatzbeteiligung müssen die Partner Folgendes angeben:

  • Catalog— AWS für die Produktion oder Sandbox zum Testen.

  • ProductId— die 25-stellige Marketplace-Produkt-ID. Muster:[a-z0-9]{25}.

Partner können optional Folgendes bereitstellen:

  • Tags— bis zu 50 Schlüssel-Wert-Paare für die Ressourcenorganisation zum Zeitpunkt der Erstellung. Wird verwendetTagResource, um Stichwörter nach der Erstellung hinzuzufügen.

  • ClientToken— ein Idempotenz-Token, um doppelte Kreationen beim erneuten Versuch zu verhindern. Maximal 64 Zeichen. SDKs generieren dieses Token automatisch.

Produktvalidierung: Bei der Erstellung überprüft der Service gegenüber AWS Marketplace, ob das Produkt dem Konto des Anrufers oder einem Tochterkonto gehört, das über die Partnerkontoverbindung (PAC) mit dem Anrufer verbunden ist. Wenn das Produkt nicht existiert oder das Konto des Besitzers nicht für den Anrufer autorisiert ist, gibt die API eine entsprechende Begründung zurück. ValidationException PRODUCT_NOT_FOUND_OR_NOT_OWNED

Eine Aktie pro Produkt: Ein zweiter CreateMarketplaceRevenueShare Aufruf für dasselbe Produkt mit denselben ProductId Catalog Renditen. ConflictException

Die Antwort gibt die Aktie Arn (Formatarn:{partition}:partnercentral:{region}:{account-id}:catalog/{catalog}/marketplace-revenue-share/{productId}), die, die CatalogProductId, die Version Anfangszahl (die bei 1 beginnt und bei jeder Zuordnungsänderung erhöht wird) und alle Tags zurück, die bei der Erstellung angewendet wurden.

Hinzufügen von Allokationen

Sobald eine Marketplace-Umsatzbeteiligung erstellt wurde, geben die Partner einen Prozentsatz der Umsatzbeteiligung und ein Gültigkeitsdatum an, indem sie mithilfe der API-Aktion eine Zuordnung erstellen. CreateMarketplaceRevenueShareAllocation

Bei der Erstellung einer Zuordnung müssen Partner Folgendes angeben:

  • Catalog— AWS oderSandbox.

  • MarketplaceRevenueShareIdentifier— die Kennung der Mutteraktie.

  • RevenueSharePercent— der Prozentsatz des über Marketplace erzielten Umsatzes mit dem Produkt, der als Dezimalzahl angegeben wird (z. B. 0.45 für 45%).

  • EffectiveDate— das Kalenderdatum, an dem diese Zuteilung wirksam wird. Format:YYYY-MM-DD.

Die Antwort gibt die Allokation Id (Formatmrsa-[A-Za-z0-9]{13}), den Allokationsstatus (ACTIVEbei der Erstellung) und den Wert „Erhöht“ der übergeordneten Aktie zurück Version (eine einzelne Ganzzahl pro Aktie wird bei jeder Allokationsmutation erhöht und für die optimistische Sperrung bei nachfolgenden Allokationsaktualisierungen verwendet).

Allokationen werden aktualisiert

Partner können eine Zuordnung mithilfe der UpdateMarketplaceRevenueShareAllocation API-Aktion aktualisieren. Die aktualisierbaren Felder hängen davon ab, ob die Zuordnung zukunftsbezogen, aktuell gültig oder überfällig ist.

Bei der Aktualisierung einer Allokation müssen die Partner Folgendes angeben:

  • Catalog— AWS oderSandbox.

  • MarketplaceRevenueShareIdentifier— die Kennung der Mutteraktie.

  • AllocationId— die mrsa- ID der Allokation, die aktualisiert werden soll.

  • MarketplaceRevenueShareVersion— die aktuelle Version der Stammaktie zur optimistischen Festlegung der Allokation. Bump-Konflikte kehren zurückConflictException.

Partner können optional Folgendes bereitstellen:

  • RevenueSharePercent— der aktualisierte Prozentsatz der Umsatzbeteiligung. Kann nur bei zukünftigen Zuweisungen bearbeitet werden.

  • EffectiveDate— das aktualisierte Datum des Inkrafttretens. Nur bei zukünftigen Zuweisungen editierbar.

  • ExpirationDate— das aktualisierte Ablaufdatum. Bearbeitbar für zukünftige Allokationen (beliebiger Wert> EffectiveDate) und für aktuell gültige oder unbefristete Allokationen (beliebiger Wert). ≥ today

  • Status— ACTIVE oder. INACTIVE Bei Einstellung auf „INACTIVESoft-Delete“ wird die Zuordnung gelöscht. Nur bei zukünftigen Zuweisungen editierbar.

  • ClientToken— ein Idempotenz-Token.

Details zur Marketplace-Umsatzbeteiligung anzeigen

Partner können mithilfe der GetMarketplaceRevenueShare API-Aktion vollständige Informationen für eine einzelne Marketplace-Umsatzbeteiligung abrufen. Dadurch werden die aktuelle Version der Aktie ArnCatalog,ProductId,, Version (die aktuelle Version der übergeordneten Aktie) und alle Tags zurückgegeben CreatedDateLastModifiedDate, die auf die Aktie angewendet wurden.

Partner können eine einzelne Zuordnung mithilfe der GetMarketplaceRevenueShareAllocation API-Aktion mit der Zuordnung abrufenId. Das Ergebnis ist:

  • Die Aktien der Allokation Id und der MuttergesellschaftMarketplaceRevenueShareArn.

  • RevenueSharePercent, EffectiveDate, ExpirationDate.

  • Status(ACTIVEoderINACTIVE).

  • Die Mutteraktie dient MarketplaceRevenueShareVersion zur optimistischen Fixierung auf nachfolgende Aktualisierungen.

  • CreatedDate und LastModifiedDate.

Auflistung der Marketplace-Umsatzanteile

Partner können mithilfe der ListMarketplaceRevenueShares API-Aktion alle Marketplace-Umsatzanteile einsehen, die ihrem Konto gehören. Dadurch wird eine paginierte Liste mit Aktienzusammenfassungen zurückgegeben.

Partner können die Ergebnisse nach folgenden Kriterien filtern:

  • Catalog— AWS oder Sandbox (erforderlich).

  • ProductIds— eine Liste bestimmter Marketplace-Produkt-IDs, die abgerufen werden sollen.

Die Antwort enthält eine Zusammenfassung für jede Aktie: ArnCatalog,ProductId,, die neueste Version Aktie undLastModifiedDate. CreatedDate

Verwenden Sie MaxResults undNextToken, um in großen Ergebnismengen zu paginieren.

Zuweisungen auflisten

Partner können mithilfe der ListMarketplaceRevenueShareAllocations API-Aktion die Zuweisungen für eine bestimmte Marketplace-Umsatzbeteiligung auflisten. Dadurch wird eine paginierte Liste von Zuordnungszusammenfassungen mit Filterfunktionen zurückgegeben.

Partner können die Ergebnisse nach folgenden Kriterien filtern:

  • Status— ACTIVE oderINACTIVE.

  • Gültigkeitszeitraum —EffectiveDateOnOrAfter/EffectiveDateOnOrBefore, um Allokationen abzurufen, deren Gültigkeitsdatum in ein bestimmtes Fenster fällt.

Die Antwort enthält zusammenfassende Informationen für jede Zuordnung:Id,,,, RevenueSharePercent EffectiveDate ExpirationDate StatusMarketplaceRevenueShareVersion, und die Zeitstempel für die Prüfung.

Kennzeichnung von Marketplace-Umsatzanteilen

Standardvorgänge AWS zum Taggen werden in der Ressource Marketplace Revenue Share unterstützt:

  • TagResource— Tags auf einer Marketplace-Umsatzbeteiligung hinzufügen oder überschreiben. Maximal 50 Tags pro Aktie.

  • UntagResource— bestimmte Tags per Schlüssel entfernen.

  • ListTagsForResource— ruft alle Tags ab, die derzeit einer Marketplace-Umsatzbeteiligung zugeordnet sind.

Allokationen unterstützen keine Stichwörter. Kennzeichnen Sie die übergeordnete Aktie, um die zugehörigen Allokationen zu organisieren.

Bei jedem Tagging-Vorgang wird das Format Arn (Formatarn:{partition}:partnercentral:{region}:{account-id}:catalog/{catalog}/marketplace-revenue-share/{productId}) der Aktie als Ressourcenkennung akzeptiert. Das AWS Standard-Tag-on-Create wird auch über das Feld on unterstützt. Tags CreateMarketplaceRevenueShare