本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 將您的 SaaS 訂閱或Pay-As-You-Go產品與 整合 AWS Marketplace
**新 SaaS 產品的整合需求將於 2026 年 6 月 1 日變更**
AWS Marketplace 推出並行協議的支援，可在同一個協議期間對單一 AWS 帳戶多次購買相同的產品。從 2026 年 6 月 1 日開始，所有新的 SaaS 產品都需要支援更新的整合需求。[檢閱並行協議的新整合](https://catalog.workshops.aws/mpseller/en-US/saas/integration-for-concurrent-agreements)。
將您的產品與 整合 AWS Marketplace 是 中的一個步驟[在 中建立 SaaS 產品 AWS Marketplace](saas-create-product.md)。若要將您的軟體整合為服務 (SaaS) 訂閱產品 AWS Marketplace，您必須撰寫程式碼，並示範它可以成功回應數個客戶案例。下列各節說明如何將 SaaS 訂閱模型與 整合 AWS Marketplace。
**重要**
本指南適用於 *Pay-As-You-Go (PAYG)* SaaS 產品。如果您要實作以*合約為基礎的* SaaS 產品，請[將您的 SaaS 合約型產品與 整合 AWS Marketplace](saas-integrate-contract-with-pay.md)改用 。PAYG 產品不會使用權利 SNS 主題或 GetEntitlements API。
**注意**
開始之前，請確定您已為software-as-a-service(SaaS) 產品選擇正確的定價模式 AWS Marketplace。如需詳細資訊，請參閱[規劃您的 SaaS 產品](saas-prepare.md)。
**Topics**
+ [案例：您的服務會驗證新客戶](#saas-subscription-validate-customer)
+ [案例：計量表用量](#saas-subscription-meter-usage)
+ [案例：監控使用者訂閱的變更](#saas-subscription-monitor-changes)
+ [案例：驗證客戶訂閱](#saas-subscription-verify-subscriptions)
+ [測試您的 SaaS 訂閱產品整合](#saas-subscription-integration-testing)
## 案例：您的服務會驗證新客戶
當客戶訂閱您的產品時，它們會重新導向至您的註冊 URL，這是具有臨時`x-amzn-marketplace-token`字符的 HTTP POST 請求。以下列方式回應此請求：
1. 呼叫 中的 `[ResolveCustomer](https://docs.aws.amazon.com/marketplacemetering/latest/APIReference/API_ResolveCustomer.html)` API 操作，`ProductCode`以交換 `CustomerIdentifier`、`LicenseArn`、 `CustomerAWSAccountId`和 的字符 AWS Marketplace Metering Service。
1. `ProductCode` 在您的系統中保留 `CustomerIdentifier`、`LicenseArn`、 `CustomerAWSAccountId`和 以供日後呼叫。您必須存放客戶是否擁有有效的訂閱，以及您需要的客戶相關資訊。
1. 為了回應請求，您必須顯示使用者的第一次使用體驗 （適用於您的服務）。
## 案例：計量表用量
當客戶開始使用您的服務時，您必須每小時傳送計量記錄。如需如何計量的詳細資訊，請參閱 [使用 SaaS 訂閱設定用量計量](metering-for-usage.md)。
我們建議您使用 AWS CloudTrail 來監控活動，以確保帳單資訊已傳送至其中 AWS。傳送計量記錄時，請記住下列事項：
+ 計量請求會在該小時刪除重複。
+ 每小時傳送的記錄是累積的。
+ 我們強烈建議最佳實務是，即使過去一小時沒有記錄，您仍每小時傳送計量記錄，使用量為 0。
## 案例：監控使用者訂閱的變更
設定 Amazon Simple Queue Service (Amazon SQS) 佇列，並訂閱產品的 Amazon SNS 主題。您的 SNS 主題資訊已包含在您在建立產品時從 AWS Marketplace 賣方營運團隊收到的電子郵件訊息中。如需詳細資訊，請參閱[在 中建立 SaaS 產品 AWS Marketplace](saas-create-product.md)。透過訂閱 SNS 主題，您會收到客戶訂閱變更的通知，包括提供或撤銷特定客戶的存取權。
**注意**
Amazon SNS 主題 Amazon Resource Name (ARN) 看起來像 `arn:aws:sns:us-east-1::aws-mp-subscription-notification-`。
您必須回應的通知包括：
+ `subscribe-success` – 客戶已訂閱，您可以成功根據其客戶 ID 進行計量。
+ `unsubscribe-pending` – 客戶正在進行取消訂閱。您應該傳送任何上次計量記錄。
+ `unsubscribe-success` – 客戶已取消訂閱。將不再接受客戶的計量記錄。遵循您關閉客戶資源的實務，遵守您的保留政策。
+ `subscribe-fail` – 客戶訂閱失敗。您不應該針對其客戶 ID 計量，或代表客戶建立資源。
## 案例：驗證客戶訂閱
代表客戶建立資源之前，請確認客戶應該可以存取您的產品。儲存您透過 Amazon SQS 收到的通知中客戶的最新狀態，以了解客戶是否可以存取。
## 測試您的 SaaS 訂閱產品整合
將 SaaS 訂閱產品與 整合之後 AWS Marketplace，您必須進行深入測試，以確保整合成功。下列程序概述驗證產品整合的步驟。
**注意**
使用您自己的帳戶訂閱您的產品，並測試整合是否成功。價格可以暫時降低，以便您可以測試購買流程，而不會在這些帳戶中產生高額費用。如需暫時降低價格或允許其他測試帳戶存取您產品的詳細資訊，請聯絡[AWS Marketplace 賣方營運](https://aws.amazon.com/marketplace/management/contact-us/)團隊。
啟動產品後，服務必須繼續回應新客戶的這些案例。
1. 訂閱您的產品，使用允許的 帳戶來測試客戶體驗。
1. 使用允許的帳戶訂閱之後，請確定帳戶已重新導向至註冊 URL，而且重新導向是包含臨時權杖的 POST 請求。請確定您的應用程式保留客戶 ID 以供日後呼叫使用。這會測試 的一部分[案例：您的服務會驗證新客戶](#saas-subscription-validate-customer)。
1. 在上一個步驟中驗證測試帳戶後，將帳戶加入您的應用程式。例如，您可以讓測試客戶填寫表單來建立新的使用者。或者，提供他們存取 SaaS 應用程式的其他後續步驟。這會測試 的一部分[案例：您的服務會驗證新客戶](#saas-subscription-validate-customer)。
1. 測試客戶加入後，使用 中的 `BatchMeterUsage` API 操作，提出請求，以將計量記錄傳送到 AWS 進行計費 AWS Marketplace Metering Service。這會測試 [案例：計量表用量](#saas-subscription-meter-usage)。
1. 測試訂閱變更。可能的情況包括取消訂閱、訂閱成功和訂閱失敗。這會測試 [案例：監控使用者訂閱的變更](#saas-subscription-monitor-changes)。
1. 驗證成功的訂閱。收到測試帳戶的 Amazon SNS 通知並顯示成功的訂閱訊息後，即可開始計量。在您收到 Amazon SNS 通知 AWS Marketplace Metering Service 之前傳送到 的記錄不會計量。這會測試 [案例：驗證客戶訂閱](#saas-subscription-verify-subscriptions)。
**注意**
為了避免帳單問題，我們強烈建議以程式設計方式等待此通知，再代表您的客戶啟動資源。
1. 在您完成所有整合要求並測試解決方案之後，請通知 AWS Marketplace 賣方營運團隊。他們會透過 API `BatchMeterUsage`操作驗證您已成功傳送計量記錄，對解決方案執行一系列最終測試。
整合和測試完成後，您可以執行最終審核並在公開上列出您的產品 AWS Marketplace。如需詳細資訊，請參閱[在 中建立 SaaS 產品 AWS Marketplace](saas-create-product.md)。