View a markdown version of this page

Notifications Amazon SNS pour les produits SaaS - AWS Marketplace
Rubrique Amazon SNS : aws-mp-entitlement-notificationRubrique Amazon SNS : aws-mp-subscription-notificationAbonnement d'une file d'attente SQS à la rubrique SNS

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.

Notifications Amazon SNS pour les produits SaaS

Important

Les notifications SNS pour les produits AWS Marketplace SaaS sont remplacées par des EventBridge notifications Amazon. Si des produits SaaS existants sont intégrés à SNS, ils continueront de fonctionner. Les nouvelles offres passeront éventuellement à l'utilisation d'Amazon EventBridge au lieu de SNS. Pour de plus amples informations, veuillez consulter Gestion des événements d'abonnement SaaS avec Amazon EventBridge.

Pour recevoir des notifications, vous vous abonnez aux rubriques Amazon Simple Notification Service (Amazon SNS) qui vous AWS Marketplace ont été fournies lors de la création du produit. Les rubriques fournissent des notifications concernant les modifications apportées aux abonnements des clients et aux droits contractuels pour vos produits. Elle vous permet de savoir quand octroyer et annuler l'accès pour des clients spécifiques.

Note

Au cours du processus de création du produit, vous recevrez le nom de ressource Amazon (ARN) réel associé à la rubrique SNS. Par exemple : arn:aws:sns:us-east-1:123456789012:aws-mp-subscription-notification-PRODUCTCODE

Les rubriques Amazon SNS suivantes sont disponibles pour les produits SaaS (Software as a Service) :

  • Rubrique Amazon SNS : aws-mp-entitlement-notification— Cette rubrique vous informe lorsque les acheteurs créent un nouveau contrat, le mettent à niveau, le renouvellent ou qu'il expire. Ceci n'est disponible que pour les produits dont les modèles de tarification incluent un contrat (également appelés contrats SaaS et contrats SaaS avec consommation (excédents)).

  • Rubrique Amazon SNS : aws-mp-subscription-notification— Cette rubrique vous informe lorsqu'un acheteur s'abonne ou se désabonne d'un produit et inclut un indicateur pour les offres privées et un indicateur d'essais gratuits offer-identifier pour les essais gratuits de SaaS. Cela est disponible pour tous les modèles de tarification, y compris les contrats et les abonnements (également appelés abonnements SaaS , contrats SaaS et contrats SaaS avec consommation (excédents).

Pour en savoir plus sur les scénarios dans lesquels vous répondez à ces notifications, consultez les rubriques suivantes :

Rubrique Amazon SNS : aws-mp-entitlement-notification

Le format de chaque message de la aws-mp-entitlement-notification rubrique est le suivant.

{
    "action": "<action-name>",
    "customer-identifier": " X01EXAMPLEX",
    "product-code": "n0123EXAMPLEXXXXXXXXXXXX",
}

Ils le <action-name> seront toujours entitlement-updated.

Note

  • Pour les messages d'autorisation, quelle que soit l'action (nouvelle, mise à niveau, renouvellement ou expiration), le message est le même. Un appel ultérieur à GetEntitlement est nécessaire pour découvrir le contenu de la mise à jour.

  • Pour les contrats SaaS avec consommation (excédents), la rubrique aws-mp-subscription-notification SNS est fournie aux vendeurs. Il s'agit d'une notification supplémentaire que reçoit un vendeur lorsqu'il ajoute une tarification excédentaire. Lorsqu'un vendeur acquiert de nouveaux clients, au lieu de se contenter d'en obtenir entitlement-updated (ce qui peut faire référence à n'importe quel type d'action), le vendeur reçoit un message d'abonnement indiquant qu'il s'agit d'un nouveau client.

  • Pour les accords à date ultérieure (FDA), cette rubrique est initiée à la date de début de l'accord (et non à la date de signature de l'accord). Il est également lancé lorsque des modifications ultérieures surviennent dans le droit, telles que l'annulation, le remplacement, le renouvellement ou l'expiration du contrat.

Les produits dont la tarification est contractuelle (y compris les contrats avec paiement à l'utilisation) doivent répondre à ces messages. Pour plus d'informations sur la façon de répondre, consultezScénario : surveiller les modifications apportées aux abonnements des utilisateurs.

Rubrique Amazon SNS : aws-mp-subscription-notification

Le format de chaque message de la aws-mp-subscription-notification rubrique est le suivant.

{
    "action": "<action-name>",
    "customer-identifier": " X01EXAMPLEX",
    "product-code": "n0123EXAMPLEXXXXXXXXXXXX",
    "offer-identifier": "offer-abcexample123",
    "isFreeTrialTermPresent":"true"
}

Le offer-identifier n'est inclus dans la notification que lorsque l'action est subscribe-success ousubscribe-fail. Il n'est pas inclus dans les notifications lorsque l'action est unsubscribe-pending ouunsubscribe-success. Pour les offres créées avant janvier 2024, cet identifiant est inclus dans la notification uniquement pour les offres privées. Pour les offres créées à partir de janvier 2024, cet identifiant est inclus dans les notifications pour toutes les offres, y compris les offres privées et les offres publiques.

Pour plus d'informations sur les types d'offres, consultez la réponse de l'DescribeEntity API ou la visibilité de l'offre d'un accord dans le tableau de bord des renouvellements des contrats.

Note

En ce qui concerne DescribeEntity l'API, si vous trouvez une facette de ciblage Compte AWS dans le compte de la règle de ciblage pour cette offre, il s'agit d'une offre privée. S'il n'existe pas de Compte AWS volet de règle de ciblage dans le compte pour cette offre, il s'agit d'une offre publique.

L'isFreeTrialTermPresentétablissement indique si l'abonnement de l'acheteur est un essai gratuit. La valeur JSON de cette propriété n'est pas un type de données booléen. Au lieu de cela, la valeur est convertie en un type de données de chaîne. Pour plus d'informations, consultez la section Essais gratuits de SaaS.

Cela <action-name> varie en fonction de la notification. Les actions possibles sont les suivantes :

  • subscribe-success— Le subscribe-success message indique quand le vendeur peut commencer à envoyer des relevés de comptage. Si une offre basée sur un accord est acceptée par l'acheteur, ce message est à nouveau envoyé avec la nouvelle. offer-identifier

  • subscribe-fail— Si le subscribe-fail message est généré, le paiement a peut-être échoué même si l'acheteur est déjà passé de la page AWS Marketplace d'accueil SaaS du vendeur. Le vendeur doit attendre le subscribe-success message avant d'autoriser la consommation du produit.

  • unsubscribe-pending— Lorsqu'un acheteur se désabonne, un unsubscribe-pending message est d'abord envoyé. Cela indique que le vendeur dispose d'un temps limité (environ une heure) pour envoyer les derniers relevés de comptage avant que l'acheteur ne soit complètement annulé.

  • unsubscribe-success— Le unsubscribe-success message indique que l'annulation est terminée, après quoi aucun autre enregistrement de comptage ne sera accepté.

Note

  • Si un acheteur se désabonne puis se réabonne immédiatement avant l'envoi du dernier unsubscribe-success message, le message final ne sera pas envoyé et un unsubscribe-success subscribe-success message sera envoyé à la place.

  • Pour les accords à date future (FDA), l'subscribe-successaction est initiée à la date de début de l'accord (et non à la date de signature de l'accord).

Les produits soumis à des tarifs d'abonnement (y compris les contrats avec paiement à l'utilisation) doivent répondre à ces messages. Pour plus d'informations sur la manière de répondre, consultez les rubriques suivantes :

Abonnement d'une file d'attente SQS à la rubrique SNS

Nous vous recommandons d'inscrire une file d'attente Amazon SQS aux rubriques SNS fournies. Pour obtenir des instructions détaillées sur la création d'une file d'attente SQS et son inscription à une rubrique, consultez la section Abonnement d'une file d'attente Amazon SQS à une rubrique Amazon SNS dans le guide du développeur Amazon Simple Notification Service.

Note

Vous ne pouvez vous abonner qu'aux sujets AWS Marketplace SNS Compte AWS utilisés pour vendre les produits. Vous pouvez toutefois transférer les messages vers un autre compte. Pour plus d'informations, consultez la section Envoyer des messages Amazon SNS à une file d'attente Amazon SQS d'un autre compte dans le manuel Amazon Simple Notification Service Developer Guide.

Interrogation de la file d'attente SQS pour accéder aux notifications

Une fois que vous avez inscrit votre file d'attente SQS à une rubrique SNS, les messages sont stockés dans SQS. Vous devez définir un service qui interroge continuellement la file d'attente, recherche les messages et les gère en conséquence.