View a markdown version of this page

Arbeiten Sie mit Ihren Umsatzzuordnungs-IDs - AWS Partner Central
Was ist eine Revenue Attribution ID?Arbeiten Sie mit Ihren Umsatzzuordnungs-IDs

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 Umsatzzuordnungs-IDs

Eine Umsatzzuordnungs-ID ist eine Kennung auf Deal-Ebene, die Ihren AWS Marketplace-Produktumsatz bestimmten AWS Marketplace-Angeboten and/or AWS von Partner Central zuordnet. Sie baut auf der Implementierung der Partner Revenue Measurement (PRM) auf Produktebene auf: PRM erfasst den gesamten zugeschriebenen Umsatz für ein Marketplace-Produkt, und eine Umsatzzuordnungs-ID ordnet diesen Umsatz bestimmten Deals gemäß den von Ihnen angegebenen Prozentsätzen für die monatliche Kostenzuweisung zu.

Der Revenue Attribution Service stellt APIs zur Verfügung, um Umsatzzuordnungs-IDs zu erstellen, abzurufen, aufzulisten und zu aktualisieren und ihre monatlichen Kostenzuordnungseinträge asynchron zu verwalten.

Was ist eine Revenue Attribution ID?

Eine Umsatzzuordnungs-ID besteht aus zwei Ebenen:

  • Die Zuordnung ist eine vom Partner benannte, vom Partner beschriebene Ressource, die durch eine ra- Präfix-ID (z. B.) und einen ARN identifiziert wird. ra-aabbccddee001 Jede Zuordnung bezieht sich auf einen Catalog (AWSfür Produktions- und Testzwecke) und das Konto des PartnersSandbox.

  • Ein oder mehrere monatliche Kostenzuordnungseinträge. Jeder Eintrag ordnet eine einzelne Kombination (Angebots-ID oder Opportunity-ID, Abrechnungsmonat) einem Prozentsatz der Kostenzuweisung zu. Die Einträge werden in Stapeln asynchron mithilfe eines Aufgabenmusters für die Zuordnung verwaltet.

Eine Umsatzattribution-ID kann auf zwei Arten verwendet werden:

  • Als Overlay auf Angebotsebene für Ihre bestehende PRM-Implementierung auf Produktebene. Erstellen Sie eine Umsatzzuordnungs-ID, verknüpfen Sie Ihre entsprechenden Marketplace-Angebote ( and/or ACE Opportunities) und AWS ordnen Sie Ihren bereits gemessenen Produktumsatz diesen spezifischen Angeboten zu — es sind keine Änderungen an Ihren vorhandenen Ressourcen-Tags oder User-Agent-Strings erforderlich.

  • Als eigenständige Kennung, die direkt als Ressourcen-Tag-Wert (aws-apn-id=<RA ID>) oder in einer User-Agent-Zeichenfolge (APN_1.1/pc_<RA ID>$) verwendet wird, um den AWS Konsum von Anfang an einem bestimmten Geschäft zuzuordnen.

Arbeiten Sie mit Ihren Umsatzzuordnungs-IDs

Partner können Umsatzattribution-IDs und ihre monatlichen Kostenzuordnungseinträge über den Revenue Attribution Service verwalten. Der Lebenszyklus durchläuft zwei unabhängige Abläufe: den Ablauf der Attributionsdatensätze (erstellen, aktualisieren, abrufen, auflisten) und den Zuordnungsfluss (eine Batch-Aufgabe starten, Ergebnisse abfragen, einzelne Einträge abrufen, Einträge für eine Zuordnung auflisten).

Eine Umsatzzuordnungs-ID erstellen

Der erste Schritt besteht darin, mithilfe der CreateRevenueAttribution API-Aktion eine Umsatzattribution-ID zu erstellen. Die zurückgegebene Id und Arn kann sofort als Ressourcen-Tag-Wert oder in einer User-Agent-Zeichenfolge verwendet werden, um den Verbrauch zuzuordnen. AWS

Bei der Erstellung einer Umsatzzuordnungs-ID müssen Partner Folgendes angeben:

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

  • Name— ein für Menschen lesbarer Name für die Zuordnung. Muss im Katalog und im Konto des Partners eindeutig sein. Maximal 128 Zeichen.

Partner können optional Folgendes bereitstellen:

  • Description— Freitextbeschreibung der Zuschreibung. Maximal 1024 Zeichen.

  • MarketplaceProduct— das AWS Marketplace-Produkt, das mit dieser Zuordnung verknüpft werden soll. Geben Sie ProductIdentifier (die 25-stellige Marketplace-Produkt-ID) und TenancyModel (MULTI_TENANToderSINGLE_TENANT) an. Wenn sie bei der Erstellung weggelassen wird, bezieht sich die Zuordnung auf den gesamten Verbrauch, der unter der Umsatzzuordnungs-ID gemessen wird, unabhängig davon, welches Marketplace-Produkt der Kunde gekauft hat. Dies ist nützlich, wenn eine einzelne Bereitstellung mehr als ein Marketplace-Angebot umfasst.

  • Tags— bis zu 200 Schlüssel-Wert-Paare für die Ressourcenorganisation. Tag-Schlüssel müssen innerhalb der Anfrage eindeutig sein.

Best Practice: Geben Sie anMarketplaceProduct.ProductIdentifier, wann immer Ihr Angebot an ein bestimmtes Marketplace-Angebot gebunden ist. Auf diese Weise können AWS Sie überprüfen, ob das Produkt dem Konto des anrufenden Partners oder einem Tochterkonto gehört, das über die Partner Account Connection (PAC) verknüpft ist, und in der Antwort werden die gelösten ProductCode und ProductType (z. B. SaaSAMI,,ML) angezeigt. Wenn das Produkt keinem autorisierten Konto gehört, gibt die API eine entsprechende Begründung zurück ValidationExceptionPRODUCT_NOT_FOUND_OR_NOT_OWNED.

Die Antwort gibt die MarketplaceProduct Attribute new Id (formatra-[a-z0-9]{13})Arn, aufgelöst und die ursprüngliche Version Zahl (die bei 1 beginnt und bei jeder nachfolgenden Aktualisierung erhöht wird) zurück.

Hinzufügen von Einträgen für die monatliche Kostenzuweisung

Sobald eine Umsatzzuordnungs-ID erstellt wurde, ordnen Partner ihr AWS Marketplace Offers and/or ACE Opportunities zu, indem sie über die StartRevenueAttributionAllocationsTask API-Aktion einen Stapel von Einträgen für die monatliche Kostenzuweisung einreichen. Dies ist ein asynchroner Vorgang, der bis zu 250 Zuordnungsänderungen (CREATE and/or UPDATE) pro Aufgabe akzeptiert.

Jeder Zuordnungseintrag gibt Folgendes an:

  • Angebots-ID oder Opportunity-ID — die eindeutige Kennung des Deals, das verknüpft wird. Wenn ein Marketplace-Angebot bereits mit einer ACE-Opportunity verknüpft ist, müssen Partner nur die Angebots-ID angeben; der Umsatz AWS wird automatisch der verknüpften Opportunity zugeordnet.

  • Abrechnungsmonat — der Kalendermonat, für den die Kostenzuweisung gilt (z. B.2026-04).

  • Kostenzuweisung in% — der Anteil des AWS Gesamtverbrauchs des Produkts, der auf dieses Angebot in diesem Abrechnungsmonat entfällt. Erforderlich für SaaS-Produkte mit mehreren Mandanten, einschließlich von Partnern gehosteter Komponenten für Hybridbereitstellungen, bei denen Kunden die Infrastruktur gemeinsam nutzen.

  • AWS Kundenkonto-ID — das AWS Konto des Kunden, der das Produkt konsumiert. Erforderlich für SaaS-Produkte mit mehreren Mandanten.

Der Prozentsatz der Gesamtkostenzuweisung für alle Zuordnungseinträge für eine bestimmte Umsatzzuordnungs-ID und denselben Abrechnungsmonat darf 100% nicht überschreiten. Wenn der Gesamtwert 100% übersteigt, wird der fehlerhafte Eintrag bei der asynchronen Geschäftsvalidierung mit einem Fehlercode pro Datensatz zurückgewiesen.

Synchrone Validierung: StartRevenueAttributionAllocationsTask Führt die grundlegende Formvalidierung synchron durch (Feldtypen, Muster, Stapelgröße). Wenn die grundlegende Validierung erfolgreich ist, gibt die API den Status TaskId with zurück. IN_PROGRESS Die Unternehmensvalidierung (Cap-Checks, Unveränderbarkeitsregeln, Suche nach Abhängigkeiten anhand von Marketplace und ACE) wird asynchron ausgeführt, und die Ergebnisse pro Datensatz werden anhand von Daten ermittelt. GetRevenueAttributionAllocationsTask

Um eine übermittelte Aufgabe zu überwachen, verwenden Partner eine Umfrage GetRevenueAttributionAllocationsTask mit der Revenue Attribution Resource Id oder ARN. Die Antwort geht von IN_PROGRESS bis COMPLETED (unabhängig davon, ob einzelne Datensätze erfolgreich waren oder nicht) und gibt Folgendes zurück:

  • TaskStatus— IN_PROGRESSCOMPLETED, oder FAILED (Fehler bei der Aufgabe auf oberster Ebene).

  • RecordResults— für jeden Eingabedatensatz: der zugewiesene AllocationId (falls erfolgreich), der Status (SUCCEEDEDoderFAILED) pro Datensatz sowie ein strukturierter Fehlercode und eine Meldung, falls der Datensatz fehlgeschlagen ist.

Die Partner sollten die Aufgabenergebnisse umgehend abrufen. Nach Abschluss der Aufgabe können die Ergebnisse pro Datensatz abgeglichen werden. Fehlgeschlagene Eingaben können korrigiert und in einer neuen Aufgabe erneut eingereicht werden.

Einträge für die monatliche Kostenzuweisung bearbeiten

Einträge zur Kostenzuweisung werden pro Abrechnungsmonat nach folgenden Regeln verwaltet:

  • Partner können jederzeit einen neuen monatlichen Eintrag für den aktuellen oder einen zukünftigen Abrechnungsmonat hinzufügen.

  • Partner können einen monatlichen Eintrag für den aktuellen oder einen zukünftigen Abrechnungsmonat jederzeit aktualisieren.

  • Partner können den Eintrag des letzten Monats bis zum 7. des aktuellen Monats aktualisieren. In diesem Fenster können Partner die tatsächliche Nutzung im AWS Cost Explorer überprüfen, bevor sie die Zuordnung für den Vormonat abschließen.

Nach dem 7. des aktuellen Monats kann die Zuordnung für den vorherigen Abrechnungsmonat nicht mehr geändert werden. Aktualisierungen eines aktuellen oder zukünftigen Monatseintrags gelten ab dem nächsten monatlichen Abrechnungszeitraum. Die historische Zuordnung für frühere Monate wird nicht rückwirkend neu berechnet.

Aktualisierungen von Zuordnungseinträgen werden über dieselbe StartRevenueAttributionAllocationsTask API-Aktion übermittelt, wobei für jeden betroffenen Eintrag die Operation Einstellung auf UPDATE gesetzt ist. Das asynchrone Aufgabenmuster behandelt Aktualisierungen und Kreationen einheitlich.

Aktualisierung einer Umsatzzuordnungs-ID

Partner können die Description einer vorhandenen Umsatzzuordnungs-ID mithilfe der UpdateRevenueAttribution API-Aktion aktualisieren. Der Attributionsdatensatz selbst ist ansonsten unveränderlich —Name,MarketplaceProduct, und die Tag-on-Create-Werte können nach der Erstellung nicht mehr geändert werden. Um die Ressource erneut zu taggen, verwenden Sie die standardmäßigen AWS Tagging-Operationen für den ARN der Attribution.

Bei der Aktualisierung einer Umsatzzuordnungs-ID müssen Partner Folgendes angeben:

  • Catalog— AWS oderSandbox.

  • Identifier— die ra- ID des Attributs, das aktualisiert werden soll.

  • Version— die aktuelle Version der Attribution für optimistisches Sperren.

Partner können optional Folgendes bereitstellen:

  • Description— die aktualisierte Freitextbeschreibung. Maximal 1024 Zeichen.

  • ClientToken— ein Idempotenz-Token für das Update.

Optimistische Sperrung: Das Version Feld stellt sicher, dass Aktualisierungen nur gelten, wenn sich die Zuordnung seit dem letzten Abruf nicht geändert hat. Wenn die übermittelte Version Version nicht mit der aktuellen Ressourcenversion übereinstimmt, wird das Update abgelehnt ConflictException und es wird eine Meldung mit den übermittelten und aktuellen Versionsnummern angezeigt. Es empfiehlt sich, GetRevenueAttribution vor jedem Update die neueste Version abzurufen.

Details zur Umsatzzuordnungs-ID anzeigen

Partner können mithilfe der GetRevenueAttribution API-Aktion vollständige Informationen für eine einzelne Umsatzzuordnungs-ID abrufen. Das Ergebnis ist:

Metadaten der Ressource:

  • Eindeutiger Bezeichner (Id) und Amazon-Ressourcenname (Arn).

  • Der, Catalog in dem die Zuordnung existiert.

  • Name und Description.

  • Die abgerufenen Version und die LatestVersion (verwenden Sie die neueste Version für nachfolgende Aktualisierungen).

Marketplace-Produktattribute (falls sie bei der Erstellung festgelegt MarketplaceProduct wurden):

  • ProductId— die vom Partner bereitgestellte Marketplace-Produkt-ID.

  • ProductCode— der AWS Marketplace-Produktcode, von dem die Lösung gefunden wurdeProductId.

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

  • TenancyModel— MULTI_TENANT oderSINGLE_TENANT.

Informationen zur Prüfung:

  • CreatedDate und LastModifiedDate.

Partner können Version in der Anfrage optional eine spezifische Angabe machen, um eine historische Version der Zuordnung abzurufen. Lassen Sie es aus, Version um die neueste Version zurückzugeben.

Um einen bestimmten Eintrag für die monatliche Kostenzuweisung abzurufen, verwenden Partner die GetRevenueAttributionAllocation API-Aktion mit den Einträgen. AllocationId Dadurch werden die Angebots- oder Opportunity-ID, der Abrechnungsmonat, die Kostenzuweisung in%, die AWS Kundenkonto-ID sowie der Status und die Prüfungsinformationen des Eintrags zurückgegeben.

Auflisten der Umsatzzuordnungs-IDs

Partner können mithilfe der ListRevenueAttributions API-Aktion alle Umsatzzuordnungs-IDs in ihrem Konto einsehen. Dadurch wird eine paginierte Liste von Attributionszusammenfassungen mit Filter- und Sortierfunktionen zurückgegeben.

Partner können die Ergebnisse nach folgenden Kriterien filtern:

  • Catalog— AWS oder Sandbox (erforderlich).

  • Identifiers— eine Liste mit bis zu 100 spezifischen ra- IDs, die abgerufen werden sollen.

  • CreatedAfter/CreatedBefore— nach Zeitstempelbereich für die Erstellung filtern (einschließlich).

Partner können die Ergebnissortierung mithilfe des folgenden Sort Parameters konfigurieren:

  • SortBy— CreatedDate oderLastModifiedDate.

  • SortOrder— ASCENDING oderDESCENDING.

Die Antwort enthält eine Zusammenfassung für jede Zuordnung:Arn,,Id, gelöste MarketplaceProduct Attribute CatalogName,, CreatedDateLastModifiedDate, das letzte und TotalRevenueAttributionAssociationCount (die Anzahl der aktiven monatlichen KostenzuordnungseinträgeVersion, die mit der Zuordnung verknüpft sind).

Verwenden Sie MaxResults (Standard 25, maximal 100) und, um in großen NextToken Ergebnismengen zu paginieren. Die Antwort enthält eine Angabe, NextToken ob weitere Seiten verfügbar sind.

Auflistung der Einträge zur monatlichen Kostenzuweisung

Partner können mithilfe der ListRevenueAttributionAllocations API-Aktion die Einträge für die monatliche Kostenzuweisung für eine bestimmte Umsatzzuordnungs-ID auflisten. Dadurch wird eine paginierte Liste von Zuordnungszusammenfassungen mit Filterfunktionen zurückgegeben.

Partner können die Ergebnisse nach folgenden Kriterien filtern:

  • MarketplaceOfferId— listet nur Einträge auf, die einem bestimmten Marketplace-Angebot zugeordnet sind.

  • AwsPartnerCentralOpportunityId— listet nur Einträge auf, die einer bestimmten Partner Central-Opportunity zugeordnet sind.

  • BillingMonth— listet nur Einträge für einen bestimmten Kalendermonat auf.

Die Antwort enthält zusammenfassende Informationen für jeden Eintrag: dieAllocationId, die zugehörige Angebots- oder Opportunity-ID, die AWS Kundenkonto-ID, den Abrechnungsmonat, den Prozentsatz der Kostenzuweisung, den Namen und Status des Eintrags sowie Zeitstempel für die Prüfung.

Dashboard-Erstellung: Die Kombination aus ListRevenueAttributions und ListRevenueAttributionAllocations wurde entwickelt, um die Erstellung von Partner-Dashboards zu unterstützen. Partner können Ansichten wie die folgenden erstellen:

  • Alle Umsatzzuordnungs-IDs, die in den letzten 30 Tagen erstellt wurden, sortiert nach Erstellungsdatum.

  • Alle monatlichen Kostenzuordnungseinträge für ein bestimmtes Marketplace-Angebot für mehrere Umsatzzuordnungs-IDs.

  • Alle Einträge zur Kostenzuweisung für den aktuellen Abrechnungsmonat, um sicherzustellen, dass die Gesamtsummen pro Zuordnung nicht mehr als 100% betragen.

  • Alle Umsatzzuordnungs-IDs, für die mindestens ein aktiver Umlageeintrag () vorhanden ist. TotalRevenueAttributionAssociationCount > 0