View a markdown version of this page

Amazon SNS-Benachrichtigungen für SaaS-Produkte - AWS Marketplace

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-Benachrichtigungen für SaaS-Produkte

Wichtig

SNS-Benachrichtigungen für AWS Marketplace SaaS-Produkte werden durch EventBridge Amazon-Benachrichtigungen ersetzt. Wenn Sie bereits SaaS-Produkte in SNS integriert haben, funktionieren diese weiterhin. Neue Angebote werden irgendwann dazu übergehen, Amazon EventBridge statt SNS zu verwenden. Weitere Informationen finden Sie unter Verwaltung von SaaS-Abonnementereignissen mit Amazon EventBridge.

Um Benachrichtigungen zu erhalten, abonnieren Sie die Themen von Amazon Simple Notification Service (Amazon SNS), die Ihnen bei der Produkterstellung zur AWS Marketplace Verfügung gestellt werden. Die Themen enthalten Benachrichtigungen über Änderungen der Kundenabonnements und Vertragsansprüche 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) zum SNS-Thema. Zum Beispiel: arn:aws:sns:us-east-1:123456789012:aws-mp-subscription-notification-PRODUCTCODE

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

  • Amazon SNS-Thema: aws-mp-entitlement-notification— Dieses Thema informiert Sie, 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-Nutzungsverträge (Überschreitungen)).

  • Amazon SNS-Thema: aws-mp-subscription-notification— In diesem Thema werden Sie informiert, wenn ein Käufer ein Produkt abonniert oder abbestellt. Es enthält die Markierung „offer-identifierFür private Angebote“ und eine Markierung für 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-Nutzungsverträge (Überschreitungen)).

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

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

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

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

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

Anmerkung
  • Bei Anspruchsmeldungen ist die Meldung unabhängig von der Aktion (neu, Upgrade, Verlängerung oder abgelaufen) dieselbe. Ein weiterer Aufruf von GetEntitlement ist erforderlich, um den Inhalt des Updates zu ermitteln.

  • Bei SaaS-Nutzungsverträgen (Überschreitungen) wird Verkäufern das Thema aws-mp-subscription-notification SNS angezeigt. Dies ist eine zusätzliche Benachrichtigung, die ein Verkäufer erhält, wenn er Preisüberschreitungen hinzufügt. Wenn ein Verkäufer neue Kunden gewinnt, erhält der Verkäufer nicht nur neue Kunden entitlement-updated (was sich auf jede Art von Aktion beziehen kann), sondern eine Abonnement-Nachricht, in der darauf hingewiesen wird, dass es sich um einen neuen Kunden handelt.

  • Bei zukünftigen Verträgen (FDAs) wird dieses Thema am Startdatum der Vereinbarung (und nicht am Tag der Vertragsunterzeichnung) eingeleitet. Es wird auch eingeleitet, wenn sich der Anspruch nachträglich ändert, z. B. bei Kündigung, Ersetzung, Verlängerung oder Ablauf des Vertrags.

Produkte mit Vertragspreisen (einschließlich Verträge mit nutzungsbasierter Bezahlung) müssen auf diese Meldungen reagieren. Weitere Informationen darüber, wie Sie antworten können, finden Sie unter. Szenario: Überwachen Sie Änderungen an Benutzerabonnements

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

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

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

Das offer-identifier ist nur in der Benachrichtigung enthalten, wenn die Aktion subscribe-success oder lautetsubscribe-fail. Es ist nicht in Benachrichtigungen enthalten, wenn es sich bei der Aktion um unsubscribe-pending oder handeltunsubscribe-success. Bei Angeboten, die vor Januar 2024 erstellt wurden, ist diese Kennung nur für private Angebote in der Benachrichtigung enthalten. Bei Angeboten, die im Januar 2024 und später erstellt wurden, ist diese Kennung in den Benachrichtigungen für alle Angebote enthalten, einschließlich privater Angebote und öffentlicher Angebote.

Informationen zu den Angebotstypen finden Sie in der Antwort von der DescribeEntity API oder in der Sichtbarkeit des Angebots einer Vereinbarung im Dashboard zur Verlängerung von Verträgen.

Anmerkung

Was die DescribeEntity API anbelangt, so handelt es sich um ein privates Angebot, wenn du eine Targeting-Regel AWS-Konto in der Account-Facette der Targeting-Regel für dieses Angebot findest. Wenn es für dieses Angebot keine Targeting-Regel AWS-Konto in Bezug auf den Aspekt der Kontoausrichtung gibt, handelt es sich um ein öffentliches Angebot.

Die isFreeTrialTermPresent Eigenschaft 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 Zeichenfolgendatentyp konvertiert. Weitere Informationen finden Sie unter Kostenlose SaaS-Testversionen.

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

  • subscribe-success— Die subscribe-success Nachricht signalisiert, wann der Verkäufer mit dem Versand von Messdaten beginnen kann. Wenn der Käufer ein auf Vereinbarung beruhendes 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 AWS Marketplace SaaS-Landingpage des Verkäufers gewechselt ist. Der Verkäufer sollte auf die subscribe-success Nachricht warten, bevor er den Konsum des Produkts zulässt.

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

  • unsubscribe-success— Die unsubscribe-success Nachricht signalisiert, dass die Stornierung abgeschlossen ist. Nach Ablauf dieser Frist werden keine weiteren Zähleraufzeichnungen mehr akzeptiert.

Anmerkung
  • Wenn sich ein Käufer abmeldet und sich dann sofort erfolgreich erneut 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 zukünftigen Verträgen (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 nutzungsbasierter Bezahlung) müssen auf diese Meldungen reagieren. Weitere Informationen dazu, wie Sie antworten können, finden Sie in den folgenden Themen:

Abonnieren einer SQS-Warteschlange zum SNS-Thema

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

Anmerkung

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

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.