View a markdown version of this page

Utilisation de vos parts de revenus sur la place de marché - AWS Partner Central
Qu'est-ce qu'une part des revenus d'une place de marché ?Utilisation de vos parts de revenus sur la place de marchéMarquage des parts de revenus du marché

La référence de AWS Partner Central l'API a été restructurée. Pour plus d'informations sur les opérations d'API prises en charge, consultez la référence des AWS Partner Central API.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Utilisation de vos parts de revenus sur la place de marché

Une part des revenus du Marketplace est une entrée pour un produit AWS Marketplace qui déclare la partie des revenus totaux du produit collectés via AWS Marketplace. AWS utilise cette entrée pour corréler les Marketplace-collected revenus d'un partenaire avec d'autres signaux de revenus.

Le service Marketplace Revenue Share expose des API permettant de créer, de récupérer et de répertorier les ressources Marketplace Revenue Share, et de gérer leurs allocations (les pourcentages de partage des revenus déclarés par les partenaires et les fenêtres de date d'entrée en vigueur). Les opérations de AWS marquage standard sont prises en charge sur la ressource Marketplace Revenue Share.

Qu'est-ce qu'une part des revenus d'une place de marché ?

Une part des revenus de la place de marché comporte deux niveaux :

  • Le partage  : une entrée pour un seul produit de la AWS Marketplace, identifié par la MarketplaceProductId. Il y a exactement une part des revenus du marché par produit.

  • Une ou plusieurs allocations  : chaque allocation déclare une fenêtre RevenueSharePercent de date d'entrée en vigueur (EffectiveDatefacultatifExpirationDate). Une action peut avoir de nombreuses allocations au fil du temps, mais à tout moment, une seule ACTIVE allocation peut s'appliquer.

Les allocations présentent les propriétés clés suivantes :

  • Statut — ACTIVE ouINACTIVE. Lors de la création, le statut par défaut est. ACTIVE Seules ACTIVE les allocations participent au calcul des recettes et aux contrôles de chevauchement.

  • Invariant de chevauchement  : au sein d'une même action, aucune ACTIVE allocation ne peut présenter de [EffectiveDate, ExpirationDate] fourchettes qui se chevauchent. Au plus une ACTIVE allocation illimitée (nonExpirationDate) est autorisée par action à tout moment.

Utilisation de vos parts de revenus sur la place de marché

Les partenaires gèrent les parts de revenus de Marketplace et leurs allocations via le service Marketplace Revenue Share. Le cycle de vie se déroule selon deux flux : le flux de partage (création, récupération, liste, étiquette) et le flux d'allocations (création, mise à jour, suppression logicielle, récupération, liste).

Création d'une part des revenus sur la place de marché

La première étape consiste à créer une part des revenus du Marketplace pour un produit AWS Marketplace à l'aide de l'action CreateMarketplaceRevenueShare API. La part est identifiée par la Marketplace ProductId et sert de conteneur pour toutes les allocations ultérieures.

Lors de la création d'une part des revenus de la place de marché, les partenaires doivent fournir :

  • Catalog— AWS pour la production ou Sandbox pour les essais.

  • ProductId— l'identifiant du produit Marketplace à 25 caractères. Motif :[a-z0-9]{25}.

Les partenaires peuvent éventuellement fournir :

  • Tags— jusqu'à 50 paires clé-valeur pour l'organisation des ressources au moment de la création. Permet TagResource d'ajouter des balises après la création.

  • ClientToken— un jeton d'idempotence pour empêcher la création de doublons lors d'une nouvelle tentative. 64 caractères maximum. Les SDK génèrent automatiquement ce jeton.

Validation du produit : lors de la création, le service vérifie auprès de AWS Marketplace que le produit appartient au compte de l'appelant ou à un compte filiale connecté à l'appelant via Partner Account Connection (PAC). Si le produit n'existe pas ou si le compte propriétaire n'est pas autorisé pour l'appelant, l'API revient ValidationException avec raisonPRODUCT_NOT_FOUND_OR_NOT_OWNED.

Une action par produit : un deuxième CreateMarketplaceRevenueShare appel pour le même produit pour ProductId les mêmes Catalog retoursConflictException.

La réponse renvoie le Arn (formatarn:{partition}:partnercentral:{region}:{account-id}:catalog/{catalog}/marketplace-revenue-share/{productId}) du partage, le CatalogProductId, le Version numéro initial (qui commence à 1 et augmente à chaque mutation d'allocation) et toutes les balises appliquées lors de la création.

Ajouter des allocations

Une fois qu'une part des revenus de la place de marché est créée, les partenaires déclarent un pourcentage de part des revenus et une fenêtre de date d'entrée en vigueur en créant une allocation via l'action de l'CreateMarketplaceRevenueShareAllocationAPI.

Lors de la création d'une allocation, les partenaires doivent fournir :

  • Catalog— AWS ouSandbox.

  • MarketplaceRevenueShareIdentifier— l'identifiant de l'action mère.

  • RevenueSharePercent— le pourcentage des recettes du produit collectées via Marketplace, fourni sous forme décimale (par exemple, 0.45 pour 45 %).

  • EffectiveDate— la date calendaire à laquelle cette allocation entre en vigueur. Format :YYYY-MM-DD.

La réponse renvoie l'allocation Id (formatmrsa-[A-Za-z0-9]{13}), l'état de l'allocation (ACTIVElors de la création) et l'augmentation du partage parent Version (un entier de version unique par partage est modifié à chaque mutation d'allocation, utilisé pour un verrouillage optimiste lors des mises à jour d'allocation suivantes).

Mettre à jour les allocations

Les partenaires peuvent mettre à jour une allocation à l'aide de l'action de l'UpdateMarketplaceRevenueShareAllocationAPI. Les champs modifiables varient selon que l'allocation est datée du futur, actuellement en vigueur ou passée.

Lors de la mise à jour d'une allocation, les partenaires doivent fournir :

  • Catalog— AWS ouSandbox.

  • MarketplaceRevenueShareIdentifier— l'identifiant de l'action mère.

  • AllocationId— l'mrsa-identifiant de l'allocation à mettre à jour.

  • MarketplaceRevenueShareVersion— la version actuelle de l'action mère pour un verrouillage optimiste de l'allocation. Les conflits de bosses sont de retourConflictException.

Les partenaires peuvent éventuellement fournir :

  • RevenueSharePercent— le pourcentage actualisé de la part des recettes. Modifiable uniquement sur les allocations à date future.

  • EffectiveDate— la date d'entrée en vigueur mise à jour. Modifiable uniquement sur les allocations à date future.

  • ExpirationDate— la date d'expiration mise à jour. Modifiable sur les allocations à date future (n'importe quelle valeur> EffectiveDate) et sur les allocations actuellement en vigueur ou à durée indéterminée (n'importe quelle valeur). ≥ today

  • Status— ACTIVE ouINACTIVE. Le réglage sur INACTIVE Suppression automatique de l'allocation. Modifiable uniquement sur les allocations à date future.

  • ClientToken— un jeton d'idempotence.

Afficher les détails de la part des revenus de Market

Les partenaires peuvent récupérer des informations complètes pour une seule part des revenus du Marketplace à l'aide de l'action de l'GetMarketplaceRevenueShareAPI. Cela renvoie les balisesArn,Catalog,ProductId, Version (la version actuelle du partage parent) et toutes les balises appliquées au partage. CreatedDate LastModifiedDate

Les partenaires peuvent récupérer une seule allocation à l'aide de l'action de l'GetMarketplaceRevenueShareAllocationAPI avec les allocationsId. Cela renvoie :

  • L'allocation Id et la part de la société mèreMarketplaceRevenueShareArn.

  • RevenueSharePercent, EffectiveDate, ExpirationDate.

  • Status(ACTIVEouINACTIVE).

  • La part mère est MarketplaceRevenueShareVersion destinée à un verrouillage optimiste des mises à jour suivantes.

  • CreatedDate et LastModifiedDate.

Répertorier les parts de revenus de

Les partenaires peuvent consulter toutes les parts de revenus du Marketplace détenues par leur compte à l'aide de l'action ListMarketplaceRevenueShares API. Cela renvoie une liste paginée des résumés des partages.

Les partenaires peuvent filtrer les résultats selon les critères suivants :

  • Catalog— AWS ou Sandbox (obligatoire).

  • ProductIds— une liste d'identifiants de produits Marketplace spécifiques à récupérer.

La réponse inclut un résumé pour chaque partage :Arn,Catalog,ProductId, le plus récent VersionCreatedDate, etLastModifiedDate.

Utilisez MaxResults et NextToken pour paginer dans de grands ensembles de résultats.

Répartition des inscriptions

Les partenaires peuvent répertorier les allocations pour une part de revenus spécifique de la place de marché à l'aide de l'action d'ListMarketplaceRevenueShareAllocationsAPI. Cela renvoie une liste paginée de résumés des allocations avec des fonctionnalités de filtrage.

Les partenaires peuvent filtrer les résultats selon les critères suivants :

  • Status— ACTIVE ouINACTIVE.

  • Plage de dates d'entrée en vigueur —EffectiveDateOnOrAfter/EffectiveDateOnOrBeforepour récupérer les allocations dont la date d'entrée en vigueur se situe dans une fenêtre spécifique.

La réponse inclut des informations récapitulatives pour chaque allocation :Id,,RevenueSharePercent, EffectiveDate ExpirationDate StatusMarketplaceRevenueShareVersion, et les horodatages d'audit.

Marquage des parts de revenus du marché

Les opérations de AWS marquage standard sont prises en charge sur la ressource Marketplace Revenue Share :

  • TagResource— ajoutez ou remplacez des balises sur une part des revenus de la Marketplace. Maximum de 50 balises par partage.

  • UntagResource— supprimez des tags spécifiques par clé.

  • ListTagsForResource— récupérer toutes les balises actuellement appliquées à une part des revenus d'une place de marché.

Les allocations ne prennent pas en charge les balises. Marquez le partage parent pour organiser les allocations associées.

Chaque opération de balisage accepte le partage Arn (formatarn:{partition}:partnercentral:{region}:{account-id}:catalog/{catalog}/marketplace-revenue-share/{productId}) comme identifiant de ressource. Le AWS tag-on-create standard est également pris en charge via le Tags champ activé. CreateMarketplaceRevenueShare