View a markdown version of this page

Utilisation de vos parts de revenus sur le Marketplace - AWS Partner Central
Qu'est-ce qu'une Marketplace Revenue Share ?Utilisation de vos parts de revenus sur le MarketplaceMarquage des parts de revenus de Marketplace

La référence AWS Partner Central d'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 le Marketplace

Une Marketplace Revenue Share est une entrée pour un produit AWS Marketplace qui déclare la part du chiffre d'affaires total du produit collecté 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 Marketplace Revenue Share Service propose des API pour créer, récupérer et répertorier les ressources Marketplace Revenue Share, et pour gérer leurs allocations (les pourcentages de partage des revenus déclarés par les partenaires et les dates d'entrée en vigueur). Les opérations de AWS balisage standard sont prises en charge sur la ressource Marketplace Revenue Share.

Qu'est-ce qu'une Marketplace Revenue Share ?

Une Marketplace Revenue Share comporte deux niveaux :

  • Le partage : entrée pour un seul produit AWS Marketplace, identifié par le MarketplaceProductId. Il existe exactement une Marketplace Revenue Share par produit.

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

Les allocations présentent les principales propriété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 des chevauchements.

  • Invariable de chevauchement : au sein d'une même action, aucune fourchette ne peut se chevaucher [EffectiveDate, ExpirationDate] entre deux ACTIVE allocations. Au plus une ACTIVE allocation illimitée (nonExpirationDate) est autorisée par action à tout moment.

Utilisation de vos parts de revenus sur le Marketplace

Les partenaires gèrent les Marketplace Revenue Shares et leurs allocations via le Marketplace Revenue Share Service. Le cycle de vie suit deux flux : le flux de partage (création, récupération, liste, balise) et le flux d'allocations (création, mise à jour, suppression logicielle, récupération, liste).

Création d'un partage des revenus sur le Marketplace

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

Lors de la création d'une Marketplace Revenue Share, les partenaires doivent fournir :

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

  • 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. TagResourceÀ utiliser pour ajouter des balises après la création.

  • ClientToken— un jeton d'idempuissance pour empêcher les créations dupliquées 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 subsidiaire 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 obtenir le même ProductId résultat pour les mêmes Catalog retoursConflictException.

La réponse renvoie le partage Arn (formatarn:{partition}:partnercentral:{region}:{account-id}:catalog/{catalog}/marketplace-revenue-share/{productId}), 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 Marketplace 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 du partage parent.

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

  • EffectiveDate— la date calendaire à laquelle cette allocation prend effet. Format :YYYY-MM-DD.

La réponse renvoie l'allocation Id (formatmrsa-[A-Za-z0-9]{13}), le statut de l'allocation (ACTIVElors de la création) et l'augmentation de l'action parent Version (un seul entier de version par action est augmenté à 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 UpdateMarketplaceRevenueShareAllocation l'action API. Les champs modifiables varient selon que l'allocation est future, actuellement effective ou dépassée.

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

  • Catalog— AWS ouSandbox.

  • MarketplaceRevenueShareIdentifier— l'identifiant du partage parent.

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

  • MarketplaceRevenueShareVersion— la version actuelle de la part de la société mère pour un blocage optimiste de l'allocation. Les conflits liés aux bosses ConflictException réapparaissent.

Les partenaires peuvent éventuellement fournir :

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

  • EffectiveDate— la date d'entrée en vigueur mise à jour. Modifiable uniquement pour 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 permet INACTIVE de supprimer progressivement l'allocation. Modifiable uniquement pour les allocations à date future.

  • ClientToken— un jeton d'impuissance.

Afficher les détails du Marketplace Revenue Share

Les partenaires peuvent récupérer des informations complètes pour une seule Marketplace Revenue Share à l'aide de l'action GetMarketplaceRevenueShare API. Cela renvoie le partageArn, CatalogProductId, Version (la version actuelle du partage parent), CreatedDateLastModifiedDate, et toutes les balises appliquées au partage.

Les partenaires peuvent récupérer une allocation unique à l'aide de l'action de l'GetMarketplaceRevenueShareAllocationAPI associée à l'allocationId. Cela renvoie :

  • L'allocation Id et la part des parentsMarketplaceRevenueShareArn.

  • RevenueSharePercent, EffectiveDate, ExpirationDate.

  • Status(ACTIVEouINACTIVE).

  • La part du parent est MarketplaceRevenueShareVersion destinée à un verrouillage optimiste des mises à jour ultérieures.

  • CreatedDate et LastModifiedDate.

Liste des parts de revenus de Marketplace

Les partenaires peuvent consulter toutes les Marketplace Revenue Shares 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 par :

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

Allocations d'annonces

Les partenaires peuvent répertorier les allocations pour un Marketplace Revenue Share spécifique à l'aide de l'action ListMarketplaceRevenueShareAllocations API. Cela renvoie une liste paginée de résumés d'allocation avec des fonctionnalités de filtrage.

Les partenaires peuvent filtrer les résultats par :

  • 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 de Marketplace

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

  • TagResource— ajoutez ou remplacez des tags sur un Marketplace Revenue Share. 50 tags maximum par partage.

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

  • ListTagsForResource— récupérer tous les tags actuellement appliqués à une Marketplace Revenue Share.

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 champ surTags. CreateMarketplaceRevenueShare