本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
透過 將客戶加入您的 SaaS 產品 AWS Marketplace
透過軟體即服務 SaaS） 訂閱和 SaaS 合約，您的客戶可透過 訂閱您的產品， AWS Marketplace 但存取您 AWS 環境中的產品。訂閱產品後，您的客戶會被引導至您建立和管理的網站，作為 SaaS 產品的一部分，以註冊其帳戶並設定產品。
建立 SaaS 產品清單時，您會將 URL提供給註冊登陸頁面。我們會在客戶訂閱後使用 URL將客戶重新導向至您的註冊登陸頁面。在軟體的註冊登陸頁面上，您可以收集為客戶建立帳戶所需的任何資訊。如果您打算透過電子郵件聯絡客戶以取得用量通知，建議您收集客戶的電子郵件地址。
註冊登陸頁面必須能夠識別和接受來自 的表單資料中的x-amzn-marketplace-token權杖， AWS Marketplace 以及客戶用於計費的識別符。然後，它應該將該權杖值傳遞至 AWS Marketplace Metering Service ，以解析唯一的客戶識別符、客戶 AWS 帳戶 ID 和對應的產品代碼。如需程式碼範例，請參閱「ResolveCustomer 程式碼範例」。
注意
註冊權杖會解析為特定訂閱的客戶，且每個產生的權杖都有 4 小時的過期時段。只要呼叫者API使用相同的權杖呼叫 ，就會繼續傳回相同的回應值，直到權杖過期為止。
設定您的 SaaS 產品以接受新的買家
您有責任正確設定 SaaS 軟體，以接受新客戶並適當計量新客戶。下列程序概述了識別、實作和計量新客戶對軟體存取權的一種建議方法：
-
當客戶造訪您 AWS Marketplace 網站上的產品頁面時，他們選擇訂閱您的產品。
-
客戶的 AWS 帳戶 已訂閱您的 產品。這表示從產品傳送的訂閱和計量記錄會成為客戶 AWS 帳單的一部分。
-
會為客戶產生註冊權杖，其中包含其客戶識別碼和您的產品代碼。
-
客戶會重新導向至軟體的註冊登陸頁面。此頁面必須能夠接受具有客戶識別符的字符。
-
客戶的瀏覽器會將
POST請求傳送至軟體的註冊登陸頁面 URL。請求包含一個POST參數x-amzn-marketplace-token，其中包含客戶的註冊權杖。從您註冊網站的角度來看，客戶已提交具有此參數的表單。註冊權杖是不透明的字串。如果優惠類型為免費試用，第二個參數x-amzn-marketplace-offer-type的值為free-trial，則會新增至請求。 -
若要將此註冊權杖兌換為客戶識別符、客戶 AWS 帳戶 ID 和產品代碼，您的網站必須在 AWS Marketplace Metering Service ResolveCustomer上呼叫 。客戶識別符不是客戶的 AWS 帳戶 ID，但其在產品之間是通用的，因此應作為客戶記錄的一部分儲存至內部來源。產品程式碼是 AWS 提供給您的 SaaS 產品的唯一字串。每個 AWS 產品都有一個唯一的產品代碼，在註冊期間指派給您。
注意
若要查看
ResolveCustomer呼叫的範例，請參閱 ResolveCustomer 程式碼範例。 -
指示客戶在您的產品中建立帳戶或登入現有帳戶。
注意
如果設定或連結至產品中的現有客戶帳戶需要您的團隊手動程序，您可以使用聯絡我們表單來收集客戶的聯絡資訊。在收集其聯絡資訊並解決其 AWS Marketplace 唯一的客戶識別符 （如步驟 6 中所取得） 之後， 會顯示客戶的通知訊息。在通知中，說明他們的帳戶正在設定中，並要求他們等待您與他們聯絡。為客戶提供預期的周轉時間和您的聯絡資訊。也傳送具有相同詳細資訊的電子郵件訊息給客戶。
-
客戶現在已使用該 SaaS 產品特有的憑證登入您的網站。在您的帳戶資料庫中，您可以為每個客戶有一個項目。您的帳戶資料庫必須具有 AWS 客戶識別符的資料欄，您填入您在步驟 6 中取得的客戶識別符。確認您的系統中沒有其他帳戶共用此客戶識別碼。對於透過 訂閱多個產品的客戶 AWS Marketplace，客戶識別符將保持不變，每個訂閱都有唯一的產品代碼。
-
在賣方註冊過程中，您會訂閱 Amazon 主題，這些SNS主題會在客戶訂閱或取消訂閱您的產品時通知您。這些是 Amazon SNS通知的JSON格式，可通知您客戶動作：
權限通知 – 對於具有包含合約之定價模型的產品，當買家建立新合約、升級合約、續約合約或合約過期時，您會收到通知。您的帳戶資料庫必須具有訂閱狀態的額外資料欄。如需詳細資訊，請參閱Amazon SNS主題： aws-mp-entitlement-notification。
訂閱通知 – 對於具有任何定價模型的產品，包括合約和訂閱，當購買者訂閱或取消訂閱產品時，您會收到通知。如需詳細資訊，請參閱Amazon SNS主題： aws-mp-subscription-notification。
我們建議您使用 Amazon Simple Queue Service （Amazon SQS） 來擷取這些訊息。收到 的訂閱通知後
subscribe-success，客戶帳戶已準備好進行計量。您在此通知之前傳送的記錄不會被計量。如需如何執行此操作的詳細資訊，請參閱 Amazon Simple Notification Service 開發人員指南 中的步驟 2：授予 Amazon SNS主題傳送訊息至 Amazon SQS佇列的許可。注意
除非您收到
subscribe-success通知，否則請勿啟用產品訂閱。 -
使用儲存在資料庫中的客戶識別碼，透過 AWS Marketplace Metering Service 來計量用量，或透過 檢查權限 AWS Marketplace Entitlement Service。
安全性和訂購
身為賣方，您有責任僅信任立即從 AWS 或系統簽署的客戶識別符。我們建議您立即解決註冊權杖，因為它可能會在大約 1 小時後過期。解析註冊權杖之後，請將客戶識別符作為已簽署的屬性存放在客戶的瀏覽器工作階段上，直到註冊完成為止。
