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
Per ricevere notifiche, ti abboni agli argomenti di Marketplace AWS Amazon Simple Notification Service (Amazon SNS) forniti durante 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— 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— Questo argomento ti avvisa quando un acquirente sottoscrive o annulla l'iscrizione a un prodotto e include il contrassegno
offer-identifierper 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:
Argomento di Amazon SNS: aws-mp-entitlement-notification
Ogni messaggio nell'aws-mp-entitlement-notificationargomento ha il seguente formato.
{ "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, 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 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 (FDA), 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, consultaScenario: monitoraggio delle modifiche agli abbonamenti degli utenti.
Argomento di Amazon SNS: aws-mp-subscription-notification
Ogni messaggio nell'aws-mp-subscription-notificationargomento ha il seguente formato.
{ "action": "<action-name>", "customer-identifier": "X01EXAMPLEX", "product-code": "n0123EXAMPLEXXXXXXXXXXXX", "offer-identifier": "offer-abcexample123", "isFreeTrialTermPresent":"true" }
Viene visualizzato nella notifica offer-identifier solo se l'offerta è un'offerta privata.
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.
<action-name>Varierà a seconda della notifica. Le azioni possibili sono:
-
subscribe-success— Ilsubscribe-successmessaggio segnala quando il venditore può iniziare a inviare i dati di misurazione. -
subscribe-fail— Se ilsubscribe-failmessaggio 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 ilsubscribe-successmessaggio prima di consentire il consumo del prodotto. -
unsubscribe-pending— Quando un acquirente annulla l'iscrizione, viene prima inviato ununsubscribe-pendingmessaggio. 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— Ilunsubscribe-successmessaggio 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 con successo prima dell'invio del
unsubscribe-successmessaggio finale, ilunsubscribe-successmessaggio finale non verrà inviato e verrà inviato unsubscribe-successmessaggio al suo posto. -
Per gli accordi con data futura (FDA), l'azione di sottoscrizione riuscita 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:
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.
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 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.
