翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# SaaS サブスクリプションまたはPay-As-You-Go製品と の統合 AWS Marketplace
<a name="saas-integrate-subscription"></a>

**新しい SaaS 製品の 2026 年 6 月 1 日の変更に関する統合要件**  
AWS Marketplace は同時契約のサポートを導入し、同じ契約期間中に 1 つの AWS アカウントで同じ製品を複数回購入できるようになりました。2026 年 6 月 1 日以降、更新された統合要件をサポートするために、すべての新しい SaaS 製品が必要になります。[同時契約用の新しい統合を確認します](https://catalog.workshops.aws/mpseller/en-US/saas/integration-for-concurrent-agreements)。

製品を と統合することは、 の 1 つのステップ AWS Marketplace です[での SaaS 製品の作成 AWS Marketplace](saas-create-product.md)。Software as a Service (SaaS) サブスクリプション製品を と統合するには AWS Marketplace、コードを記述し、いくつかの顧客シナリオに正常に応答できることを示す必要があります。以下のセクションでは、SaaS サブスクリプションモデルを と統合する方法を示します AWS Marketplace。

**重要**  
このガイドは、*従量制料金 (PAYG)* の SaaS 製品を対象としています。*契約ベース*の SaaS 製品を実装する場合は、代わりに [SaaS 契約ベースの製品を と統合する AWS Marketplace](saas-integrate-contract-with-pay.md) を使用します。PAYG 製品は、使用権限 SNS トピックまたは GetEntitlements API を使用しません。

**注記**  
開始する前に、 AWS Marketplaceで対象の Software as a Service (SaaS) 製品に適した料金モデルを選択していることを確認してください。詳細については、「[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)

## シナリオ: サービスが新規顧客を検証する
<a name="saas-subscription-validate-customer"></a>

顧客が製品をサブスクライブすると、その顧客は登録 URL (一時的な `x-amzn-marketplace-token` トークンを含む HTTP POST リクエスト) にリダイレクトされます。このリクエストには、次の方法で応答します。

1. で `[ResolveCustomer](https://docs.aws.amazon.com/marketplacemetering/latest/APIReference/API_ResolveCustomer.html)` API オペレーションを呼び出し`ProductCode`て`CustomerAWSAccountId`、トークンを `CustomerIdentifier``LicenseArn`、、、および と交換します AWS Marketplace Metering Service。

1. 今後の呼び出しのために`CustomerIdentifier``CustomerAWSAccountId`、、`LicenseArn`、、および をシステム`ProductCode`内に保持します。顧客が有効なサブスクリプションを持っているかどうかと、顧客について必要な情報をすべて保存する必要があります。

1. リクエストへの対応として、ユーザーが初めて使用するときの操作を (サービスに応じて) 表示する必要があります。

## シナリオ: 使用量を計測する
<a name="saas-subscription-meter-usage"></a>

顧客がサービスを利用し始めたら、計測レコードを 1 時間ごとに送信する必要があります。計測の詳細については、[SaaS サブスクリプションでの使用量の計測の設定](metering-for-usage.md) を参照してください。

 AWS CloudTrail を使用してアクティビティをモニタリングし、請求情報が に送信されていることを確認することをお勧めします AWS。計測レコードを送信する場合は、次の点に注意してください。
+ 計測リクエストは、毎時 0 分に重複排除されます。
+ 送信したレコードは 1 時間ごとに累積されます。
+ 過去 1 時間以内にレコードがない場合でも、ベストプラクティスとして、使用量 0 の計測レコードを 1 時間ごとに送信することを強くお勧めします。

## シナリオ: ユーザーサブスクリプションの変更を監視する
<a name="saas-subscription-monitor-changes"></a>

Amazon Simple Queue Service (Amazon SQS) キューを設定し、製品の Amazon SNS トピックをサブスクライブします。SNS トピック情報は、製品の作成時に AWS Marketplace Seller Operations チームから受け取った E メールメッセージに含まれていました。詳細については、「[での SaaS 製品の作成 AWS Marketplace](saas-create-product.md)」を参照してください。SNS トピックをサブスクライブすると、特定の顧客へのアクセス権の付与や取り消しなど、顧客のサブスクリプションの変更に関する通知が届きます。

**注記**  
Amazon SNS トピックの Amazon リソースネーム (ARN) は `arn:aws:sns:us-east-1:<account id>:aws-mp-subscription-notification-<product code>` のようになります。

応答する必要がある通知は以下のとおりです。
+ `subscribe-success` - 顧客がサブスクライブされ、顧客 ID に照合して正常に計測できる。
+ `unsubscribe-pending` - 顧客がサブスクリプション解除中である。最新の計測レコードはすべて送信する必要があります。
+ `unsubscribe-success` - 顧客が購読を解除した。顧客の計測レコードは受け付けられなくなります。顧客リソースを閉鎖する手順に従い、保存ポリシーを遵守してください。
+ `subscribe-fail` - 顧客のサブスクリプションが失敗した。顧客 ID に照合して計測したり、顧客に代わってリソースを作成したりしないでください。

## シナリオ: 顧客のサブスクリプションを確認する
<a name="saas-subscription-verify-subscriptions"></a>

顧客に代わってリソースを作成する前に、顧客が製品にアクセスできることを確認してください。Amazon SQS 経由で受け取った通知から顧客の最新のステータスを保存し、顧客にアクセス許可があるかどうかを確認できます。

## SaaS サブスクリプション製品統合のテスト
<a name="saas-subscription-integration-testing"></a>

SaaS サブスクリプション製品を と統合したら AWS Marketplace、詳細なテストを実施して、統合が成功していることを確認する必要があります。次の手順では、製品統合を確認するステップを示します。

**注記**  
自分のアカウントを使って製品をサブスクライブし、正常に統合できたことを確認します。料金を一時的に下げて、それらのアカウントで高額な料金を発生させずに購入フローをテストすることができます。価格を一時的に引き下げたり、追加のテストアカウントに製品へのアクセスを許可したりする方法について詳しくは、[AWS Marketplace Seller Operations](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 Seller Operations チームに通知します。`BatchMeterUsage` API オペレーションで計測レコードが正常に送信されたことを確認して、ソリューションに関する一連の最終テストを実行します。

統合とテストが完了したら、最終レビューを実行し、製品を一般公開できます AWS Marketplace。詳細については、「[での SaaS 製品の作成 AWS Marketplace](saas-create-product.md)」を参照してください。