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.
Gestion des événements d'abonnement SaaS avec Amazon EventBridge
Vous pouvez utiliser Amazon EventBridge pour intégrer et gérer des produits SaaS avec AWS Marketplace. Des événements sont envoyés en cas de modification des abonnements des clients et des droits contractuels pour vos produits. Vous recevez des notifications lorsque les clients s'abonnent, lorsque leurs droits changent et lorsqu'ils annulent, afin de savoir exactement quand accorder ou révoquer l'accès. Ces événements jouent deux rôles principaux :
-
Fabricant : il s'agit du fabricant d'origine du produit répertorié dans AWS Marketplace, également connu sous le nom de fournisseur indépendant de solutions (ISV).
-
Promoteur : il s'agit de l'auteur initial d'un contrat d'achat pour le produit répertorié dans AWS Marketplace. Il peut s'agir de l'ISV ou d'un partenaire de distribution autorisé à revendre le produit.
Deux modèles de vente distincts déterminent si vous, en tant qu'ISV, agissez en tant que fabricant ou proposant. Votre rôle détermine les notifications que vous recevez EventBridge.
| Schéma de vente | Description | Le rôle de l'ISV |
|---|---|---|
| AWS Marketplace offre publique ou privée | Vous proposez une offre ou un contrat directement à l'acheteur. | À la fois fabricant et proposant |
| Offre privée pour les partenaires de la chaîne | Un partenaire de distribution autorisé à revendre votre produit propose une offre ou un contrat à l'acheteur. | Fabricant |
EventBridge événements pour les produits SaaS
Lorsqu'une AWS Marketplace transaction a lieu, EventBridge envoie des événements à votre bus d'événements par défaut. Votre rôle en tant que fabricant ou proposant détermine les événements que vous recevrez.
| Nom de l’événement | Initié par | Réponse | Destinataire |
|---|---|---|---|
|
Un nouvel accord est créé, un accord existant est remplacé ou un accord existant est renouvelé. | Le contrat d'achat est enregistré et des mesures après-vente sont prises. DescribeAgreement L'API est utilisée pour déterminer si le nouvel accord est un essai gratuit. |
Fabricant et proposant |
|
Un accord existant est modifié. | L'enregistrement du contrat d'achat est modifié. | Fabricant et proposant |
|
Un contrat a expiré, est annulé, est résilié. | La clôture du contrat d'achat est enregistrée et des actions d'annulation sont effectuées après le contrat. L'ISV commence à révoquer les droits des clients. | Fabricant et proposant |
| Avis relatif à la convention d'achat émis - Fabricant | AWS a publié un avis susceptible d'invalider cet accord. Les conditions pouvant déclencher cette alerte incluent la fermeture du compte de l'acheteur, la compromission, les abus ou les fraudes. | AWS a identifié un problème qui affecte ce contrat. Ce problème peut affecter la facturation ou l'accès au service. Contactez directement l'acheteur et déterminez s'il convient de modifier son accès. | Fabricant uniquement |
| Avis relatif au contrat d'achat résolu - Fabricant | AWS a résolu les problèmes qui avaient une incidence sur cet accord. | AWS a résolu le problème concernant ce contrat. Si vous avez modifié l'abonnement ou l'accès de l'acheteur, vous pouvez le rétablir à votre guise. | Fabricant uniquement |
| Licence mise à jour - Fabricant | Le droit de l'acheteur à un produit a changé. | Les droits des clients sont vérifiés à l'aide de l'GetEntitlementsAPI et les services sont fournis en conséquence. |
Fabricant uniquement |
| Licence déprovisionnée - Fabricant | Le droit de l'acheteur à un produit a pris fin. | Pour les produits basés sur l'utilisation, cet événement marque le début d'une fenêtre de rapport final d'une heure. Les vendeurs doivent collecter et signaler toute utilisation non déclarée à l'aide de l'BatchMeterUsageAPI. À la fermeture de cette fenêtre, les droits des clients sont totalement révoqués et les rapports d'utilisation ne sont plus acceptés. |
Fabricant uniquement |
| Seuil de dépenses atteint | Les dépenses cumulées de l'acheteur pour un produit SaaS payant à l'utilisation ont atteint un seuil de dépenses et ont AWS Marketplace lancé une vérification du paiement (vet) sur la carte de l'acheteur. | À titre informatif ; aucune action n'est requise. AWS Marketplace vérifie la capacité de paiement de l'acheteur. Attendez l'événement Spend Threshold Vet Succeed ou Spend Threshold Vet Failed. | Fabricant et proposant |
| Seuil de dépenses : test réussi | La vérification du paiement sur la carte de l'acheteur a été effectuée et le cycle du seuil de dépenses a été réinitialisé. | À titre informatif ; aucune action n'est requise. AWS Marketplace a validé le mode de paiement de l'acheteur. | Fabricant et proposant |
| Échec de la vérification du seuil de dépenses | La vérification du paiement sur la carte de l'acheteur a échoué. | AWS Marketplace n'a pas pu vérifier le mode de paiement de l'acheteur. AWS Marketplace Je vais réessayer la vérification. | Fabricant et proposant |
Les événements Spend Threshold Atteint, Spend Threshold Vet Succeded et Spend Threshold Vet Failed s'appliquent uniquement aux produits SaaS dont la tarification est basée sur l'utilisation (paiement à l'utilisation). AWS Marketplace n'envoie pas ces événements pour les produits SaaS dont la tarification est réservée aux contrats ou aux abonnements.
Note
Les types d'événements de contrat d'achat pour le fabricant et le proposant sont presque identiques, à l'exception de la présence d'un identifiant ResaleAuthorization. Pour éviter les messages redondants, seul l'événement du contrat d'achat du proposant est envoyé lorsque vous êtes à la fois le fabricant et le proposant.
Pour obtenir la liste complète des types d'événements et leurs schémas détaillés, consultez EventBridge Événements Amazon le Guide du vendeur.
Fenêtre de rapport d'utilisation finale pour les produits basés sur l'utilisation
Pour les produits dotés d'un composant de facturation basé sur l'utilisation, AWS Marketplace donne aux vendeurs une heure pour soumettre les derniers enregistrements d'utilisation des clients dont les droits ont expiré. Après cette période, l'BatchMeterUsageAPI rejette l'utilisation signalée et vous ne pouvez pas facturer le client.
AWS Marketplace envoie l'événement License Deprovisioned - Manufacturer pour signaler le début de la dernière fenêtre de reporting. Les vendeurs disposent d'une heure après avoir reçu cet événement pour collecter toute utilisation non déclarée pour le client et la signaler à l'aide de l'BatchMeterUsageAPI.
Après la fermeture de la fenêtre d'une heure, AWS Marketplace révoque intégralement les droits du client et n'accepte plus les rapports d'utilisation.
Intégrez EventBridge à votre produit SaaS
Utilisez-le EventBridge pour intégrer vos opérations de provisionnement de locataires à votre annonce SaaS AWS sur Marketplace.
-
Les règles relatives aux événements définissent la manière de réagir à un événement. Ces règles peuvent réagir immédiatement ou selon un calendrier défini.
-
Les modèles d'événements sont définis dans les règles des événements et vous permettent de filtrer les types d'événements spécifiques envoyés à votre bus d'événements par défaut. Des modèles de modèles pour chaque type d'événement sont disponibles dans la EventBridge console. À l'étape de configuration du modèle d'événement, sélectionnez les AWS services comme source de l'événement et AWS Marketplace Agreements and Licenses comme AWS service.
-
Tous les types d'événements AWS Marketplace Agreements et Licences utilisent la structure suivante.
{ "detail-type": ["e.g. Purchase Agreement Ended - Manufacturer"], "source": ["aws.agreement-marketplace"] } -
-
Les cibles sont des ressources qui reçoivent des événements lorsqu'ils correspondent au modèle d'événement défini pour une règle. De nombreux AWS services s'intègrent EventBridge et peuvent servir de cibles, notamment les fonctions Lambda, Step Functions et API Gateway.
Pour plus d'informations sur la configuration EventBridge des règles, consultez Mise en route : création d'une règle Amazon EventBridge Event Bus.
