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 AWS Marketplace SaaS vengono sostituite dalle notifiche Amazon. EventBridge Se disponi di prodotti SaaS esistenti integrati con SNS, continueranno a funzionare. Le nuove offerte alla fine passeranno all'utilizzo di Amazon EventBridge anziché SNS. Per ulteriori informazioni, consulta Gestione degli eventi di abbonamento SaaS con Amazon EventBridge.
Per ricevere notifiche, ti iscrivi agli argomenti di Amazon Simple Notification Service (Amazon SNS) AWS Marketplace forniti durante la creazione del prodotto. Gli argomenti forniscono notifiche sulle modifiche agli abbonamenti dei clienti e ai diritti contrattuali per i tuoi prodotti. Ciò consente di 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) relativo all'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 Amazon SNS: aws-mp-entitlement-notification— Questo argomento ti avvisa quando gli acquirenti creano un nuovo contratto, lo aggiornano, lo rinnovano o 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 Amazon SNS: aws-mp-subscription-notification— Questo argomento ti avvisa quando un acquirente si iscrive o annulla l'iscrizione a un prodotto e include le offerte private e un contrassegno
offer-identifierper le prove gratuite di 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 saperne di più sugli scenari in cui rispondi a queste notifiche, consulta i seguenti argomenti:
Argomento Amazon SNS: aws-mp-entitlement-notification
Ogni messaggio nell'argomento ha il seguente formato. aws-mp-entitlement-notification
{ "action": "<action-name>", "customer-identifier": "X01EXAMPLEX", "product-code": "n0123EXAMPLEXXXXXXXXXXXX", }
Lo <action-name> saranno sempre
entitlement-updated.
Nota
-
Per i messaggi di autorizzazione, indipendentemente dall'azione (nuova, aggiornamento, rinnovo o scadenza), il messaggio è lo stesso.
GetEntitlementÈ necessaria una chiamata successiva a per scoprire il contenuto dell'aggiornamento. -
Per quanto riguarda il contratto SaaS con consumo (overages), ai venditori viene fornito l'argomento aws-mp-subscription-notification SNS. Si tratta di una notifica aggiuntiva che un venditore riceve quando aggiunge prezzi in eccedenza. Quando un venditore acquisisce nuovi clienti, anziché limitarsi a riceverli
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 (FDA), questo argomento viene avviato alla data di inizio del contratto (e non alla data di firma del contratto). Viene inoltre avviato quando vengono apportate modifiche successive al diritto, ad esempio annullamento, sostituzione, rinnovo o scadenza del contratto.
I prodotti con prezzi contrattuali (compresi i contratti con pagamento in base al consumo) devono rispondere a questi messaggi. Per ulteriori informazioni su come rispondere, consulta. Scenario: monitoraggio delle modifiche agli abbonamenti degli utenti
Argomento Amazon SNS: aws-mp-subscription-notification
Ogni messaggio nell'argomento ha il seguente formato. aws-mp-subscription-notification
{ "action": "<action-name>", "customer-identifier": "X01EXAMPLEX", "product-code": "n0123EXAMPLEXXXXXXXXXXXX", "offer-identifier": "offer-abcexample123", "isFreeTrialTermPresent":"true" }
offer-identifierÈ incluso nella notifica solo quando l'azione è subscribe-success osubscribe-fail. Non è incluso nelle notifiche quando l'azione è unsubscribe-pending ounsubscribe-success. Per le offerte create prima di 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, comprese le offerte private e le offerte pubbliche.
Per informazioni sui tipi di offerta, consulta la risposta dell'DescribeEntity API o la visibilità dell'offerta di un accordo nella dashboard dei rinnovi degli accordi.
Nota
Per quanto riguarda l'DescribeEntity API, se trovi un Account AWS aspetto della regola di targeting dell'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 versione di prova gratuita. Il valore JSON di questa proprietà non è un tipo di dati booleano. Il valore viene invece convertito in un tipo di dati stringa. Per ulteriori informazioni, consulta le versioni di prova gratuite di SaaS.
<action-name>Varierà a seconda della notifica. Le azioni possibili sono:
-
subscribe-success— Ilsubscribe-successmessaggio segnala quando il venditore può iniziare a inviare i record delle misurazioni. Se l'acquirente accetta un'offerta basata su un accordo, questo messaggio viene inviato nuovamente insieme alla nuova.offer-identifier -
subscribe-fail— Se ilsubscribe-failmessaggio viene generato, il pagamento potrebbe non essere riuscito anche se l'acquirente è già passato dalla landing page SaaS del venditore AWS Marketplace a quella del venditore. Il venditore deve attendere ilsubscribe-successmessaggio prima di consentire il consumo del prodotto. -
unsubscribe-pending— Quando un acquirente annulla l'iscrizione, viene inviatounsubscribe-pendingprima un messaggio. Ciò indica che il venditore ha un tempo limitato (circa un'ora) per ricevere i dati finali delle misurazioni prima che l'acquirente venga annullato completamente. -
unsubscribe-success— Ilunsubscribe-successmessaggio segnala il completamento dell'annullamento, dopodiché non saranno accettate ulteriori registrazioni delle misurazioni.
Nota
-
Se un acquirente annulla l'iscrizione e poi si iscrive nuovamente con successo prima che venga inviato il
unsubscribe-successmessaggio finale, ilunsubscribe-successmessaggio finale non verrà inviato e verrà invece inviato unsubscribe-successmessaggio. -
Per gli accordi con data futura (FDA), l'
subscribe-successazione viene avviata alla data di inizio del contratto (e non alla data di firma del contratto).
I prodotti con prezzi in abbonamento (compresi i contratti con pagamento in base al consumo) devono rispondere a questi messaggi. Per ulteriori informazioni su come rispondere, consulta i seguenti argomenti:
Sottoscrizione di una coda SQS all'argomento SNS
Consigliamo di sottoscrivere una coda Amazon SQS agli 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.
Nota
Puoi abbonarti solo agli argomenti SNS utilizzati per vendere i prodotti. AWS Marketplace 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 altro account nella Amazon Simple Notification Service Developer Guide.
Eseguire il polling della coda SQS per le notifiche
Dopo aver iscritto la coda SQS a un argomento SNS, i messaggi vengono archiviati in SQS. È necessario definire un servizio che interroghi continuamente la coda, cerchi i messaggi e li gestisca di conseguenza.
