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
**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 anstelle von SNS zu verwenden. Weitere Informationen finden Sie unter [Verwaltung von SaaS-Abonnementereignissen mit Amazon EventBridge](saas-eventbridge-integration.md).
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`](#saas-sns-message-body)— 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`](#saas-sns-subscription-message-body)— 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:
+ [Integrieren Sie Ihr SaaS-Abonnement oder Pay-As-You-Go -Produkt mit AWS Marketplace](saas-integrate-subscription.md)
+ [Integrieren Sie Ihr SaaS-Vertragsprodukt mit AWS Marketplace](saas-integrate-contract.md)
+ [Integrieren Sie Ihr vertragsbasiertes SaaS-Produkt mit AWS Marketplace](saas-integrate-contract-with-pay.md)
## Amazon SNS SNS-Thema: `aws-mp-entitlement-notification`
Jede Nachricht im `aws-mp-entitlement-notification` Thema hat das folgende Format.
```
{
"action": "",
"customer-identifier": " X01EXAMPLEX",
"product-code": "n0123EXAMPLEXXXXXXXXXXXX",
}
```
Das ** 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-notification`SNS-Thema](#saas-sns-subscription-message-body) 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 unter[Szenario: Überwachen Sie Änderungen an Benutzerabonnements](saas-integrate-contract.md#saas-contract-monitor-changes).
## Amazon SNS SNS-Thema: `aws-mp-subscription-notification`
Jede Nachricht im `aws-mp-subscription-notification` Thema hat das folgende Format.
```
{
"action": "",
"customer-identifier": " X01EXAMPLEX",
"product-code": "n0123EXAMPLEXXXXXXXXXXXX",
"offer-identifier": "offer-abcexample123",
"isFreeTrialTermPresent":"true"
}
```
Die `offer-identifier` ist nur dann in der Benachrichtigung enthalten, wenn die Aktion `subscribe-success` oder lautet`subscribe-fail`. Es ist nicht in Benachrichtigungen enthalten, wenn die Aktion `unsubscribe-pending` oder ist`unsubscribe-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, sowohl für private als auch für öffentliche Angebote.
Informationen zu Angebotstypen finden Sie in der Antwort von [DescribeEntity API](https://docs.aws.amazon.com//marketplace/latest/APIReference/work-with-private-offers.html#describe-entity) oder unter der Sichtbarkeit eines Vertrags im [Dashboard für Vertragsverlängerungen](https://docs.aws.amazon.com//marketplace/latest/userguide/agreements-renewals-dashboard.html).
**Anmerkung**
Bei [DescribeEntity API](https://docs.aws.amazon.com//marketplace/latest/APIReference/work-with-private-offers.html#describe-entity) 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.](https://docs.aws.amazon.com/marketplace/latest/userguide/saas-free-trials.html)
**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 der [Vereinbarung basierendes Angebot](https://docs.aws.amazon.com/marketplace/latest/userguide/private-offers-upgrades-and-renewals.html#private-offers-upgrades-and-renewals-process) 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:
+ [Integrieren Sie Ihr SaaS-Abonnement oder Pay-As-You-Go -Produkt mit AWS Marketplace](saas-integrate-subscription.md)
+ [Integrieren Sie Ihr vertragsbasiertes SaaS-Produkt mit AWS Marketplace](saas-integrate-contract-with-pay.md)
## 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](https://docs.aws.amazon.com/sns/latest/dg/subscribe-sqs-queue-to-sns-topic.html) 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](https://docs.aws.amazon.com/sns/latest/dg/sns-send-message-to-sqs-cross-account.html) 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.