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à.
# Integrazione del prodotto SaaS basato su contratti con Marketplace AWS
**I requisiti di integrazione cambiano il 1° giugno 2026 per i nuovi prodotti SaaS**
AWS Marketplace sta introducendo il supporto per Concurrent Agreements, che consente acquisti multipli dello stesso prodotto su un singolo account AWS durante lo stesso periodo del contratto. A partire dal 1° giugno 2026, tutti i nuovi prodotti SaaS dovranno supportare requisiti di integrazione aggiornati. [Esamina la nuova integrazione per gli accordi concorrenti](https://catalog.workshops.aws/mpseller/en-US/saas/integration-for-concurrent-agreements).
L'integrazione del prodotto con Marketplace AWS è un solo passaggio. [Creazione di un prodotto SaaS in Marketplace AWS](saas-create-product.md) Per integrare un prodotto contrattuale SaaS (Software as a Service) con Marketplace AWS, è necessario scrivere codice e dimostrare che è in grado di rispondere con successo a diversi scenari di clienti. Le sezioni seguenti descrivono questi scenari, spiegano come rispondervi e forniscono una panoramica sui test dell'integrazione.
**Nota**
Questa guida si riferisce esclusivamente ai prodotti *SaaS basati su contratto*. Se stai implementando un prodotto SaaS *Pay-As-You-Go (PAYG)*, [Integrazione dell'abbonamento Pay-As-You-Go o del prodotto SaaS con Marketplace AWS](saas-integrate-subscription.md) usalo invece. I prodotti PAYG non utilizzano argomenti SNS di accesso o l'API. GetEntitlements
Prima di iniziare, assicurati di aver scelto il modello di prezzo giusto per il tuo prodotto Software as a Service (SaaS). Marketplace AWS Per ulteriori informazioni, consulta [Pianificazione del prodotto SaaS](saas-prepare.md).
**Topics**
+ [Scenario: il tuo servizio convalida nuovi clienti](#saas-contract-with-pay-validate-customer)
+ [Scenario: il tuo servizio gestisce le richieste dei clienti](#saas-contract-with-pay-customer-requests)
+ [Scenario: utilizzo del contatore](#saas-contract-with-pay-meter-usage)
+ [Scenario: monitoraggio delle modifiche ai diritti degli utenti](#saas-contract-with-pay-monitor-changes)
+ [Test del contratto SaaS con integrazione pay-as-you-go](#saas-contract-consumption-integration-testing)
## Scenario: il tuo servizio convalida nuovi clienti
Quando un cliente si abbona al tuo prodotto, viene reindirizzato all'URL di registrazione, che è una richiesta HTTP POST con un token temporaneo. `x-amzn-marketplace-token` Rispondi a questa richiesta nei seguenti modi:
1. Scambia il token con un `CustomerIdentifier``CustomerAWSAccountId`,`LicenseArn`, e `ProductCode` chiamando l'operazione `[ ResolveCustomer](https://docs.aws.amazon.com/marketplacemetering/latest/APIReference/API_ResolveCustomer.html)` API in AWS Marketplace Metering Service.
1. Verifica l'abbonamento e la quantità (se applicabile) a cui il cliente ha accesso richiamando l'`[ GetEntitlements](https://docs.aws.amazon.com/marketplaceentitlement/latest/APIReference/API_GetEntitlements.html)`azione nel AWS Marketplace Entitlement Service.
1. Mantieni il`CustomerIdentifier`, `CustomerAWSAccountId``LicenseArn`, e `ProductCode` nel tuo sistema per le chiamate future. Memorizza se il cliente ha un abbonamento valido, insieme a tutte le informazioni di cui hai bisogno sul cliente.
1. In risposta alla richiesta, devi mostrare la prima esperienza di utilizzo dell'utente (se applicabile al tuo servizio).
## Scenario: il tuo servizio gestisce le richieste dei clienti
Quando un cliente invia una richiesta al tuo servizio, devi rispondere ai seguenti scenari con azioni o messaggi appropriati:
+ Non hanno un ID cliente nel tuo sistema. Ciò significa che non si sono ancora abbonati. Dovresti inviare loro un messaggio che descriva come iscriversi.
+ Hanno un ID cliente e l'operazione `GetEntitlements` API restituisce un'autorizzazione appropriata. In questo scenario, è necessario soddisfare la richiesta.
+ Hanno un ID cliente, ma l'operazione `GetEntitlements` API non restituisce alcuna autorizzazione o una quantità insufficiente per soddisfare la richiesta. In questo scenario, è necessario determinare come gestire l'accesso e gestire la loro esperienza.
## Scenario: utilizzo del contatore
Quando il cliente inizia a utilizzare il servizio, è necessario inviare i dati di misurazione ogni ora. Per informazioni dettagliate su come eseguire la misurazione, vedere. [Configurazione della misurazione per l'utilizzo con gli abbonamenti SaaS](metering-for-usage.md)
Ti consigliamo di AWS CloudTrail utilizzarlo per monitorare l'attività per garantire che i dati di fatturazione vengano inviati a AWS. Tieni presente quanto segue quando invii i record di misurazione:
+ Le richieste di misurazione vengono deduplicate ogni ora.
+ I record inviati ogni ora sono cumulativi.
+ Come procedura ottimale, consigliamo vivamente di inviare i record di misurazione ogni ora, anche se non sono stati registrati dati nell'ultima ora, utilizzando 0.
## Scenario: monitoraggio delle modifiche ai diritti degli utenti
Configura una coda Amazon Simple Queue Service (Amazon SQS) e iscriviti agli argomenti Amazon SNS del tuo prodotto: sono disponibili due argomenti SNS, uno per le modifiche ai diritti e uno per le modifiche all'abbonamento. Le informazioni sull'argomento sono state incluse nel messaggio e-mail che hai ricevuto dal team Seller Operations al momento della creazione del prodotto. Marketplace AWS Per ulteriori informazioni, consulta [Creazione di un prodotto SaaS in Marketplace AWS](saas-create-product.md). Iscrivendoti ai tuoi argomenti SNS, ricevi notifiche sulle modifiche agli abbonamenti dei clienti, inclusa la concessione o la revoca dell'accesso per clienti specifici.
**Nota**
Un argomento SNS è il seguente: Amazon Resource Name (ARN) per una modifica dell'abbonamento. `arn:aws:sns:us-east-1:{{}}:aws-mp-subscription-notification-{{}}` Viene visualizzato l'ARN di un argomento SNS per le modifiche alle autorizzazioni. `arn:aws:sns:us-east-1:{{}}:aws-mp-entitlement-notification-{{}}`
Le notifiche a cui devi rispondere sono le seguenti:
+ `entitlement-updated`(nell'argomento SNS sulle autorizzazioni): l'autorizzazione del cliente è cambiata ed è necessario chiamare l'operatore dell'`GetEntitlements`API per visualizzare il nuovo stato. Aggiorna il tuo negozio clienti e, se applicabile (ad esempio, se il contratto del cliente è scaduto), segui le tue procedure per la chiusura delle risorse destinate ai clienti, attenendoti alle tue politiche di fidelizzazione.
+ `subscribe-success`(nell'argomento SNS relativo agli abbonamenti): il cliente è abbonato ed è possibile eseguire correttamente il conteggio del relativo ID cliente.
+ `unsubscribe-pending`(nell'argomento SNS relativo all'abbonamento): il cliente sta annullando l'iscrizione. È necessario inviare tutti i dati relativi all'ultima misurazione.
+ `unsubscribe-success`(nell'argomento SNS relativo all'abbonamento): il cliente ha annullato l'iscrizione. I record di misurazione per il cliente non saranno più accettati. Segui le tue procedure per chiudere le risorse dei clienti, rispettando le tue politiche di fidelizzazione.
+ `subscribe-fail`(nell'argomento Abbonamento SNS): l'abbonamento del cliente non è riuscito. Non è necessario verificare l'ID cliente o abilitare le risorse per conto del cliente.
**Nota**
Per ulteriori informazioni, consulta [Verifica dei diritti utilizzando il AWS Marketplace Entitlement Service](checking-entitlements.md).
## Test del contratto SaaS con integrazione pay-as-you-go
Dopo aver integrato il contratto con il pay-as-you-go prodotto con Marketplace AWS, è necessario condurre test approfonditi per garantire che l'integrazione abbia successo. La procedura seguente descrive i passaggi per verificare l'integrazione del prodotto.
**Nota**
Usa i tuoi account per abbonarti al tuo prodotto e verificare che l'integrazione abbia successo. I prezzi possono essere temporaneamente ridotti in modo da poter testare il flusso di acquisto senza incorrere in addebiti elevati su tali account. Per ulteriori informazioni sulla riduzione temporanea dei prezzi o sull'autorizzazione all'accesso al prodotto da parte di altri account di prova, contatta il team [operativo del Marketplace AWS venditore](https://aws.amazon.com/marketplace/management/contact-us/).
Dopo il lancio del prodotto, il servizio deve continuare a rispondere a questi scenari per i nuovi clienti.
1. Utilizza un account autorizzato per testare l'esperienza del cliente stipulando un contratto per il tuo prodotto.
1. Dopo che l'account ha stipulato il contratto, assicurati che l'account venga reindirizzato all'URL di registrazione e che il reindirizzamento sia una richiesta POST che includa un token temporaneo. Assicurati che l'applicazione mantenga l'ID cliente per le chiamate future e gestisca correttamente l'autorizzazione del cliente. Questo verifica parte di. [Scenario: il tuo servizio convalida nuovi clienti](#saas-contract-with-pay-validate-customer)
1. Dopo aver verificato l'account di prova nel passaggio precedente, inserisci l'account nella tua applicazione. Ad esempio, puoi chiedere al cliente che effettua il test di compilare un modulo per creare un nuovo utente. Oppure, fornisci loro altri passaggi successivi per accedere alla tua applicazione SaaS. Questo verifica parte di. [Scenario: il tuo servizio convalida nuovi clienti](#saas-contract-with-pay-validate-customer)
1. Se il funzionamento dell'`GetEntitlements`API non restituisce alcuna autorizzazione, né durante l'onboarding né nei pass di verifica in corso, l'applicazione deve gestire correttamente l'accesso e l'esperienza degli utenti non idonei. Questi test. [Scenario: il tuo servizio gestisce le richieste dei clienti](#saas-contract-with-pay-customer-requests)
1. Dopo l'onboarding del cliente che effettua il test, effettua le richieste per inviare i dati di misurazione ai AWS fini della fatturazione utilizzando l'operazione `BatchMeterUsage` API di. AWS Marketplace Metering Service Questi [Scenario: utilizzo del contatore](#saas-contract-with-pay-meter-usage) test.
1. Test per le modifiche all'abbonamento. Verifica che l'applicazione gestisca correttamente gli scenari di annullamento dell'iscrizione, iscrizione riuscita e sottoscrizione non riuscita. Questi test. [Scenario: monitoraggio delle modifiche ai diritti degli utenti](#saas-contract-with-pay-monitor-changes)
1. Dopo aver completato tutti i requisiti di integrazione e testato la soluzione, avvisa il team operativo del Marketplace AWS venditore. Il team testerà quindi la soluzione verificando che tu abbia chiamato correttamente l'`GetEntitlements`API Operation e che i nuovi clienti siano stati sufficientemente acquisiti. Verificheranno inoltre che tu abbia inviato correttamente i record misurati con l'operazione API. `BatchMeterUsage`
Una volta completati l'integrazione e il test, puoi eseguire una revisione finale e pubblicare il tuo prodotto. Marketplace AWS Per ulteriori informazioni, consulta [Creazione di un prodotto SaaS in Marketplace AWS](saas-create-product.md).