Amazon SNS SNS-Benachrichtigungen für SaaS-Produkte - AWS Marketplace
Amazon SNS SNS-Thema: aws-mp-entitlement-notificationAmazon SNS SNS-Thema: aws-mp-subscription-notificationAbonnieren einer SQS-Warteschlange zum SNS-Thema

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.

Amazon SNS SNS-Benachrichtigungen für SaaS-Produkte

Um Benachrichtigungen zu erhalten, abonnieren Sie die Themen des Amazon Simple Notification Service (Amazon SNS), die Ihnen bei der Produkterstellung zur AWS Marketplace Verfügung gestellt werden. Die Themen enthalten Benachrichtigungen über Änderungen an den Abonnements und Vertragsansprüchen Ihrer Kunden für Ihre Produkte. So wissen Sie, wann Sie bestimmten Kunden Zugang bereitstellen können und wann Sie den Zugang widerrufen müssen.

Anmerkung

Während der Produkterstellung erhalten Sie den tatsächlichen Amazon-Ressourcennamen (ARN) für das SNS-Thema. Zum Beispiel: arn:aws:sns:us-east-1:123456789012:aws-mp-subscription-notification-PRODUCTCODE

Die folgenden Amazon SNS SNS-Themen sind für SaaS-Produkte (Software as a Service) verfügbar:

  • Amazon SNS SNS-Thema: aws-mp-entitlement-notification— In diesem Thema werden Sie benachrichtigt, wenn Käufer einen neuen Vertrag erstellen, ihn aktualisieren, verlängern oder wenn er abläuft. Dies ist nur für Produkte mit Preismodellen verfügbar, die einen Vertrag beinhalten (auch bekannt als SaaS-Verträge und SaaS-Verträge mit Verbrauch (Overages)).

  • Amazon SNS SNS-Thema: aws-mp-subscription-notification— Dieses Thema informiert Sie, wenn ein Käufer ein Produkt abonniert oder abbestellt, und enthält die Markierungen offer-identifier für private Angebote und kostenlose Testversionen für kostenlose SaaS-Testversionen. Dies ist für alle Preismodelle verfügbar, einschließlich Verträge und Abonnements (auch bekannt als SaaS-Abonnements, SaaS-Verträge und SaaS-Verträge mit Verbrauch (Overages)).

Weitere Informationen zu den Szenarien, in denen Sie auf diese Benachrichtigungen reagieren, finden Sie in den folgenden Themen:

Amazon SNS SNS-Thema: aws-mp-entitlement-notification

Jede Nachricht im aws-mp-entitlement-notification Thema hat das folgende Format.

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

Das <action-name> wird immer so sein entitlement-updated.

Anmerkung

  • Bei Nachrichten über einen Anspruch ist die Meldung unabhängig von der Aktion (neu, Upgrade, Verlängerung oder abgelaufen) dieselbe. Ein nachfolgender Aufruf von GetEntitlement ist erforderlich, um den Inhalt des Updates zu ermitteln.

  • Für SaaS Contracts with Consumption (Overages) wird Verkäufern das aws-mp-subscription-notificationSNS-Thema zur Verfügung gestellt. Dabei handelt es sich um eine zusätzliche Benachrichtigung, die Verkäufer erhalten, wenn sie Preisüberschreitungen hinzufügen. Wenn ein Verkäufer neue Kunden gewinnt, erhält er nicht nur neue Kunden entitlement-updated (was sich auf jede Art von Aktion beziehen kann), sondern eine Abonnementnachricht, die darauf hinweist, dass es sich um einen neuen Kunden handelt.

  • Bei future Vereinbarungen (FDAs) wird dieses Thema am Startdatum der Vereinbarung (und nicht am Datum der Vertragsunterzeichnung) initiiert. Es wird auch initiiert, wenn nachträgliche Änderungen am Anspruch vorgenommen werden, wie z. B. Kündigung, Ersatz, Verlängerung oder Ablauf der Vereinbarung.

Produkte mit Vertragspreisen (einschließlich Verträge mit pay-as-you-go) müssen auf diese Meldungen reagieren. Weitere Informationen darüber, wie Sie darauf reagieren können, finden Sie unterSzenario: Überwachen Sie Änderungen an Benutzerabonnements.

Amazon SNS SNS-Thema: aws-mp-subscription-notification

Jede Nachricht im aws-mp-subscription-notification Thema hat das folgende Format.

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

Das offer-identifier ist in der Benachrichtigung für jedes neue Angebot enthalten, das AWS Marketplace ab Januar 2024 erstellt wird.

Informationen zu den Angebotstypen finden Sie in der Antwort von DescribeEntity API oder unter der Sichtbarkeit eines Vertrags im Dashboard für Vertragsverlängerungen.

Anmerkung

Bei DescribeEntity API gilt: Wenn Sie AWS-Konto in der Targeting-Facette des Accounts eine Regel für dieses Angebot finden, handelt es sich um ein privates Angebot. Wenn es für dieses Angebot keine Regel für die Ausrichtung des Accounts AWS-Konto im Targeting-Bereich gibt, handelt es sich um ein öffentliches Angebot.

Die isFreeTrialTermPresent Unterkunft gibt an, ob es sich bei dem Abonnement des Käufers um eine kostenlose Testversion handelt. Der JSON-Wert dieser Eigenschaft ist kein boolescher Datentyp. Stattdessen wird der Wert in einen String-Datentyp konvertiert. Weitere Informationen finden Sie unter Kostenlose SaaS-Testversionen.

<action-name>Sie variieren je nach Benachrichtigung. Mögliche Aktionen sind:

  • subscribe-success— Die subscribe-success Nachricht signalisiert, wann der Verkäufer mit dem Versand der Messdaten beginnen kann. Wenn der Käufer ein auf einer Vereinbarung basierendes Angebot annimmt, wird diese Nachricht zusammen mit dem neuen Angebot erneut gesendet. offer-identifier

  • subscribe-fail— Wenn die subscribe-fail Nachricht generiert wird, ist die Zahlung möglicherweise fehlgeschlagen, obwohl der Käufer bereits von der SaaS-Landingpage AWS Marketplace zur SaaS-Landingpage des Verkäufers gewechselt ist. Der Verkäufer sollte auf die subscribe-success Nachricht warten, bevor er den Verzehr des Produkts zulässt.

  • unsubscribe-pending— Wenn sich ein Käufer abmeldet, wird zuerst eine unsubscribe-pending Nachricht gesendet. Dies bedeutet, dass dem Verkäufer nur eine begrenzte Zeit (etwa eine Stunde) zur Verfügung steht, um die endgültigen Zählerdaten zu erhalten, bevor der Käufer vollständig storniert wird.

  • unsubscribe-success— Die unsubscribe-success Nachricht signalisiert den Abschluss der Stornierung. Danach werden keine weiteren Zählerdaten mehr akzeptiert.

Anmerkung

  • Wenn sich ein Käufer abmeldet und sich dann sofort wieder abmeldet, bevor die letzte unsubscribe-success Nachricht gesendet wird, wird die letzte unsubscribe-success Nachricht nicht gesendet, sondern stattdessen eine subscribe-success Nachricht gesendet.

  • Bei future Vereinbarungen (FDAs) wird die subscribe-success Aktion am Startdatum der Vereinbarung (und nicht am Datum der Vertragsunterzeichnung) eingeleitet.

Produkte mit Abonnementpreisen (einschließlich Verträge mit pay-as-you-go) müssen auf diese Meldungen reagieren. Weitere Informationen dazu, wie Sie darauf reagieren können, finden Sie in den folgenden Themen:

Abonnieren einer SQS-Warteschlange zum SNS-Thema

Wir empfehlen, eine Amazon SQS SQS-Warteschlange für die bereitgestellten SNS-Themen zu abonnieren. Ausführliche Anweisungen zum Erstellen einer SQS-Warteschlange und zum Abonnieren der Warteschlange für ein Thema finden Sie unter Amazon SQS SQS-Warteschlange für Amazon SNS abonnieren im Amazon Simple Notification Service Developer Guide.

Anmerkung

Sie können nur AWS Marketplace SNS-Themen abonnieren, die zum Verkauf der AWS-Konto Produkte verwendet wurden. Sie können die Nachrichten jedoch an ein anderes Konto weiterleiten. Weitere Informationen finden Sie unter Senden von Amazon SNS SNS-Nachrichten an eine Amazon SQS SQS-Warteschlange in einem anderen Konto im Amazon Simple Notification Service Developer Guide.

Abfrage der SQS-Warteschlange auf Benachrichtigungen

Nachdem Sie Ihre SQS-Warteschlange für ein SNS-Thema abonniert haben, werden die Nachrichten in SQS gespeichert. Sie müssen einen Dienst definieren, der die Warteschlange kontinuierlich abfragt, nach Nachrichten sucht und diese entsprechend verarbeitet.