SaaS 製品に関する Amazon SNS 通知

通知を受信するには、販売者は製品作成時に提供された AWS Marketplace Amazon Simple Notification Service (Amazon SNS) トピックをサブスクライブする必要があります。このトピックでは、製品の顧客のサブスクリプションおよび契約の使用権限の変更に関する通知が提供されます。これにより、特定の顧客に対するアクセス許可の付与および取り消しをいつ行うかを把握できます。

注記

製品の作成プロセス中に SNS トピックの実際の Amazon リソースネーム (ARN) に発行されます。例: arn:aws:sns:us-east-1:123456789012:aws-mp-subscription-notification-PRODUCTCODE

Software as a Service (SaaS) 製品では、次の Amazon SNS トピックを使用できます。

• Amazon SNS トピック: aws-mp-entitlement-notification - このトピックでは、購入者が新しい契約を作成したり、アップグレードしたり、更新したり、有効期限が切れたりしたときに通知されます。これは、契約 (SaaS 契約およびSaaS 契約 (追加使用量あり) (超過) とも呼ばれる) を含む価格モデルの製品でのみ利用できます。

• Amazon SNS トピック: aws-mp-subscription-notification - このトピックでは、購入者が製品をサブスクライブまたはサブスクライブ解除したときに通知します。これには、プライベートオファーの場合は offer-identifier が、SaaS 無料トライアルの場合は無料トライアルフラグが含まれます。これは、契約やサブスクリプション (SaaS サブスクリプション、SaaS 契約、SaaS 契約 (追加使用量あり) (超過) とも呼ばれる) を含むすべての価格モデルで利用できます。

これらの通知に応答するシナリオの詳細は、次のトピックを参照してください。

• SaaS サブスクリプション製品の統合

• SaaS 契約製品を統合する

• SaaS 契約と従量制料金サービスを統合する

Amazon SNS トピック: aws-mp-entitlement-notification

aws-mp-entitlement-notification トピック内の各メッセージの形式は次のとおりです。

{
    "action": "<action-name>",
    "customer-identifier": " X01EXAMPLEX",
    "product-code": "n0123EXAMPLEXXXXXXXXXXXX",
}

<action-name> は常に entitlement-updated になります。

注記

• 使用権限メッセージの場合、アクション (新規、アップグレード、更新、期限切れ) に関係なく、メッセージは同じです。更新の内容を確認するには、以降に GetEntitlement を呼び出す必要があります。

• SaaS 契約 (追加使用量あり) (超過) の場合、販売者にはaws-mp-subscription-notification SNS トピックが提供されます。これは、超過料金が追加された場合に出品者が受け取る追加の通知です。販売者が新規顧客を獲得すると、販売者に entitlement-updated (何らかのアクションを指す場合があります) が届くだけでなく、新規顧客であることを示すサブスクライブメッセージが届きます。

• 将来の日付の契約 (FDAsについては、このトピックは契約開始日に開始されます (契約署名日ではありません）。また、契約のキャンセル、置き換え、更新、有効期限など、使用権限で後続の変更が発生したときにも開始されます。

契約料金の製品 ( との契約を含む pay-as-you-go) は、これらのメッセージに応答する必要があります。応答する方法の詳細については、シナリオ: ユーザーサブスクリプションの変更を監視する を参照してください。

Amazon SNS トピック: aws-mp-subscription-notification

aws-mp-subscription-notification トピック内の各メッセージの形式は次のとおりです。

{
    "action": "<action-name>",
    "customer-identifier": " X01EXAMPLEX",
    "product-code": "n0123EXAMPLEXXXXXXXXXXXX",
    "offer-identifier": "offer-abcexample123",
    "isFreeTrialTermPresent":"true"
}

offer-identifier は、オファーがプライベートオファーの場合にのみ通知に表示されます。

購入者のサブスクリプションが無料トライアルかどうかは、isFreeTrialTermPresent プロパティによって示されます。このプロパティの JSON 値は boolean データ型ではありません。代わりに、値は文字列データ型に変換されます。詳細については、「SaaS 無料トライアル」を参照してください。

<action-name> は、通知によって異なります。指定できるアクションは以下のとおりです。

• subscribe-success - この subscribe-success メッセージは、出品者が計測レコードの送信を開始できる時期を通知します。

• subscribe-fail - subscribe-fail メッセージが生成される場合、購入者が AWS Marketplace から販売者の SaaS ランディングページに既に遷移していても、支払いが失敗した可能性があります。販売者は、商品の使用を許可する前に subscribe-success メッセージを待つ必要があります。

• unsubscribe-pending - 購入者がサブスクリプションを解除すると、最初に unsubscribe-pending メッセージが送信されます。これは、購入者が完全にキャンセルされる前に、販売者が最終的な計測レコードを送信するまでの時間が限られている (約 1 時間) ことを示しています。

• unsubscribe-success - unsubscribe-success このメッセージはキャンセルの完了を知らせるもので、それ以降の計測レコードは受け付けられません。

注記

• 購入者がサブスクリプションを解除し、最後の unsubscribe-success メッセージが送信される前にすぐに再サブスクライブに成功した場合、最後の unsubscribe-success メッセージは送信されず、代わりに subscribe-success メッセージが送信されます。

• 将来の日付の契約 (FDAsの場合、サブスクライブの成功アクションは契約開始日に開始されます (契約署名日ではありません）。

サブスクリプション料金が設定された製品 ( との契約を含む pay-as-you-go) は、これらのメッセージに応答する必要があります。応答の管理方法については、次のトピックを参照してください。

• SaaS サブスクリプション製品の統合

• SaaS 契約と従量制料金サービスを統合する

SNS トピックへの SQS キューのサブスクライブ

Amazon SQS キューを指定された SNS トピックにサブスクライブすることを推奨します。SQS キューを作成し、そのキューをトピックにサブスクライブする方法の詳細については、「Amazon Simple Notification Service デベロッパーガイド」の「Amazon SNS トピックへ Amazon SQS キューをサブスクライブする」を参照してください。

注記

AWS Marketplace SNS トピックは、製品の販売に使用される AWS アカウント からのみサブスクライブできます。ただし、メッセージを別のアカウントに転送することはできます。詳細については、「Amazon Simple Notification Service デベロッパーガイド」の「別のアカウントの Amazon SQS キューへ Amazon SNS メッセージを送信する」を参照してください。

通知の SQS キューのポーリング

SQS キューを SNS トピックにサブスクライブすると、メッセージは SQS に保存されます。継続的にキューをポーリングし、メッセージを探して必要に応じて処理するサービスを定義する必要があります。