Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Notifiche Amazon SNS per prodotti SaaS
**Importante**
Le notifiche SNS per i prodotti Marketplace AWS SaaS vengono sostituite dalle notifiche Amazon EventBridge . Se disponi di prodotti SaaS esistenti integrati con SNS, continueranno a funzionare. Le nuove inserzioni alla fine passeranno all'utilizzo di Amazon EventBridge anziché di SNS. Per ulteriori informazioni, consulta [Gestione degli eventi di abbonamento SaaS con Amazon EventBridge](saas-eventbridge-integration.md).
Per ricevere notifiche, ti abboni agli argomenti di Amazon Simple Notification Service (Amazon SNS) che ti vengono forniti durante Marketplace AWS la creazione del prodotto. Gli argomenti forniscono notifiche sulle modifiche agli abbonamenti dei clienti e ai diritti contrattuali per i tuoi prodotti. In questo modo puoi sapere quando fornire e revocare l'accesso a clienti specifici.
**Nota**
Durante il processo di creazione del prodotto, riceverai l'effettivo Amazon Resource Name (ARN) sull'argomento SNS. Ad esempio: `arn:aws:sns:us-east-1:123456789012:aws-mp-subscription-notification-PRODUCTCODE`
I seguenti argomenti di Amazon SNS sono disponibili per i prodotti Software as a Service (SaaS):
+ [Argomento di Amazon SNS: `aws-mp-entitlement-notification`](#saas-sns-message-body)— Questo argomento ti invia una notifica quando gli acquirenti creano un nuovo contratto, lo aggiornano, lo rinnovano o il contratto scade. È disponibile solo per i prodotti con modelli di prezzo che includono un contratto (noti anche come contratti **SaaS e contratti SaaS** **con consumo (eccedenze**)).
+ [Argomento di Amazon SNS: `aws-mp-subscription-notification`](#saas-sns-subscription-message-body)— Questo argomento ti avvisa quando un acquirente sottoscrive o annulla l'iscrizione a un prodotto e include il contrassegno `offer-identifier` per le offerte private e un contrassegno per le prove gratuite SaaS. È disponibile per tutti i modelli di prezzo, inclusi contratti e abbonamenti (noti anche **come abbonamenti SaaS, contratti SaaS** **e contratti SaaS** **con consumo (eccedenze**).
Per ulteriori informazioni sugli scenari in cui rispondi a queste notifiche, consulta i seguenti argomenti:
+ [Integrazione dell'abbonamento Pay-As-You-Go o del prodotto SaaS con Marketplace AWS](saas-integrate-subscription.md)
+ [Integrazione del prodotto contrattuale SaaS con Marketplace AWS](saas-integrate-contract.md)
+ [Integrazione del prodotto SaaS basato su contratti con Marketplace AWS](saas-integrate-contract-with-pay.md)
## Argomento di Amazon SNS: `aws-mp-entitlement-notification`
Ogni messaggio nell'`aws-mp-entitlement-notification`argomento ha il seguente formato.
```
{
"action": "",
"customer-identifier": " X01EXAMPLEX",
"product-code": "n0123EXAMPLEXXXXXXXXXXXX",
}
```
Lo ** saranno sempre` entitlement-updated`.
**Nota**
Per i messaggi di autorizzazione, indipendentemente dall'azione (nuova, upgrade, rinnovo o scaduta), il messaggio è lo stesso. `GetEntitlement`È necessaria una successiva chiamata a per scoprire il contenuto dell'aggiornamento.
[Per il **contratto SaaS con consumo (eccedenze)**, ai venditori viene fornito l'argomento SNS. `aws-mp-subscription-notification`](#saas-sns-subscription-message-body) Si tratta di una notifica aggiuntiva che un venditore riceve quando aggiunge prezzi eccedenti. Quando un venditore acquisisce nuovi clienti, anziché limitarsi ad acquisirli `entitlement-updated` (il che può riferirsi a qualsiasi tipo di azione), riceve un messaggio di iscrizione che indica che si tratta di un nuovo cliente.
Per gli accordi con data futura (FDAs), questo argomento viene avviato alla data di inizio dell'accordo (e non alla data di firma dell'accordo). Viene inoltre avviato quando si verificano modifiche successive del diritto, ad esempio annullamento, sostituzione, rinnovo o scadenza del contratto.
I prodotti con prezzi contrattuali (compresi i contratti con pay-as-you-go) devono rispondere a questi messaggi. Per ulteriori informazioni su come rispondere, consulta[Scenario: monitoraggio delle modifiche agli abbonamenti degli utenti](saas-integrate-contract.md#saas-contract-monitor-changes).
## Argomento di Amazon SNS: `aws-mp-subscription-notification`
Ogni messaggio nell'`aws-mp-subscription-notification`argomento ha il seguente formato.
```
{
"action": "",
"customer-identifier": " X01EXAMPLEX",
"product-code": "n0123EXAMPLEXXXXXXXXXXXX",
"offer-identifier": "offer-abcexample123",
"isFreeTrialTermPresent":"true"
}
```
`offer-identifier`Viene incluso nella notifica solo quando l'azione è `subscribe-success` o`subscribe-fail`. Non è incluso nelle notifiche quando l'azione è `unsubscribe-pending` o`unsubscribe-success`. Per le offerte create prima del gennaio 2024, questo identificatore è incluso nella notifica solo per le offerte private. Per le offerte create a gennaio 2024 e versioni successive, questo identificatore è incluso nelle notifiche di tutte le offerte, incluse le offerte private e le offerte pubbliche.
Per informazioni sui tipi di offerta, consulta la risposta dell'[DescribeEntity API](https://docs.aws.amazon.com//marketplace/latest/APIReference/work-with-private-offers.html#describe-entity) o la visibilità dell'offerta di un accordo nella dashboard dei [rinnovi degli accordi](https://docs.aws.amazon.com//marketplace/latest/userguide/agreements-renewals-dashboard.html).
**Nota**
Per quanto riguarda l'[DescribeEntity API](https://docs.aws.amazon.com//marketplace/latest/APIReference/work-with-private-offers.html#describe-entity), se trovi un Account AWS aspetto della regola di targeting relativo all'account per quell'offerta, si tratta di un'offerta privata. Se Account AWS nell'account non è presente un aspetto della regola di targeting per quell'offerta, si tratta di un'offerta pubblica.
La `isFreeTrialTermPresent` proprietà indica se l'abbonamento dell'acquirente è una prova gratuita. Il valore JSON di questa proprietà non è un tipo di dati *booleano*. *Il valore viene invece convertito in un tipo di dati di tipo stringa.* Per ulteriori informazioni, consulta le versioni di prova [gratuite di SaaS](https://docs.aws.amazon.com/marketplace/latest/userguide/saas-free-trials.html).
**Varierà a seconda della notifica. Le azioni possibili sono:
+ `subscribe-success`— Il `subscribe-success` messaggio segnala quando il venditore può iniziare a inviare i dati di misurazione. Se l'acquirente [accetta un'offerta basata su un contratto](https://docs.aws.amazon.com/marketplace/latest/userguide/private-offers-upgrades-and-renewals.html#private-offers-upgrades-and-renewals-process), questo messaggio viene inviato nuovamente con la nuova. `offer-identifier`
+ `subscribe-fail`— Se il `subscribe-fail` messaggio viene generato, il pagamento potrebbe non essere riuscito anche se l'acquirente è già passato dalla landing page SaaS Marketplace AWS alla pagina di destinazione SaaS del venditore. Il venditore deve attendere il `subscribe-success` messaggio prima di consentire il consumo del prodotto.
+ `unsubscribe-pending`— Quando un acquirente annulla l'iscrizione, viene prima inviato un `unsubscribe-pending` messaggio. Ciò indica che il venditore ha un periodo di tempo limitato (circa un'ora) per ricevere i registri finali delle misurazioni prima che l'acquirente venga annullato completamente.
+ `unsubscribe-success`— Il `unsubscribe-success` messaggio segnala il completamento dell'annullamento, dopodiché non verranno accettati altri record di misurazione.
**Nota**
Se un acquirente annulla l'iscrizione e poi si iscrive nuovamente immediatamente prima che venga inviato il `unsubscribe-success` messaggio finale, il `unsubscribe-success` messaggio finale non verrà inviato e verrà inviato un `subscribe-success` messaggio al suo posto.
Per gli accordi con data futura (FDAs), l'`subscribe-success`azione viene avviata alla data di inizio dell'accordo (e non alla data di firma dell'accordo).
I prodotti con prezzi in abbonamento (compresi i contratti con pay-as-you-go) devono rispondere a questi messaggi. Per ulteriori informazioni su come rispondere, consulta i seguenti argomenti:
+ [Integrazione dell'abbonamento Pay-As-You-Go o del prodotto SaaS con Marketplace AWS](saas-integrate-subscription.md)
+ [Integrazione del prodotto SaaS basato su contratti con Marketplace AWS](saas-integrate-contract-with-pay.md)
## Sottoscrizione di una coda SQS all'argomento SNS
Ti consigliamo di iscriverti a una coda Amazon SQS per gli argomenti SNS forniti. *Per istruzioni dettagliate sulla creazione di una coda SQS e sulla sottoscrizione della coda a un argomento, consulta Sottoscrizione di una coda [Amazon SQS a un argomento Amazon SNS nella Amazon Simple Notification Service Developer Guide](https://docs.aws.amazon.com/sns/latest/dg/subscribe-sqs-queue-to-sns-topic.html).*
**Nota**
Puoi abbonarti solo agli argomenti Marketplace AWS SNS di chi vende i prodotti. Account AWS Tuttavia, puoi inoltrare i messaggi a un altro account. Per ulteriori informazioni, consulta [Invio di messaggi Amazon SNS a una coda Amazon SQS in un account diverso nella](https://docs.aws.amazon.com/sns/latest/dg/sns-send-message-to-sqs-cross-account.html) Amazon *Simple Notification Service Developer Guide*.
### Sondaggio della coda SQS per le notifiche
Dopo aver sottoscritto la coda SQS a un argomento SNS, i messaggi vengono archiviati in SQS. È necessario definire un servizio che effettui continuamente il polling della coda, cerchi i messaggi e li gestisca di conseguenza.