翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
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 契約 (追加使用量あり) (超過) とも呼ばれる) を含むすべての価格モデルで利用できます。
これらの通知に応答するシナリオの詳細は、次のトピックを参照してください。
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-notificationSNSトピック が提供されます。これは、超過料金が追加された場合に出品者が受け取る追加の通知です。販売者が新規顧客を獲得すると、販売者に
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値はブール値データ型ではありません。代わりに、値は文字列データ型に変換されます。詳細については、「SaaS 無料トライアル」を参照してください。
- <action-name>
は通知によって異なります。指定できるアクションは以下のとおりです。
-
subscribe-success
- このsubscribe-success
メッセージは、出品者が計測レコードの送信を開始できる時期を通知します。購入者が契約ベースのオファーを受け入れると、このメッセージは新しい で再度送信されますoffer-identifier
。 -
subscribe-fail
– メッセージsubscribe-fail
が生成された場合、購入者が既に から販売者の SaaS ランディングページに移行しているにもかかわらず AWS Marketplace 、支払いが失敗した可能性があります。販売者は、商品の使用を許可する前にsubscribe-success
メッセージを待つ必要があります。 -
unsubscribe-pending
- 購入者がサブスクリプションを解除すると、最初にunsubscribe-pending
メッセージが送信されます。これは、購入者が完全にキャンセルされる前に、販売者が最終的な計測レコードを送信するまでの時間が限られている (約 1 時間) ことを示しています。 -
unsubscribe-success
-unsubscribe-success
このメッセージはキャンセルの完了を知らせるもので、それ以降の計測レコードは受け付けられません。
注記
-
購入者がサブスクリプションを解除し、最後の
unsubscribe-success
メッセージが送信される前にすぐに再サブスクライブに成功した場合、最後のunsubscribe-success
メッセージは送信されず、代わりにsubscribe-success
メッセージが送信されます。 -
将来の日付のアグリーメント (FDAs) の場合、
subscribe-success
アクションはアグリーメントの開始日 (アグリーメント署名日ではなく) に開始されます。
サブスクリプション料金の商品 ( との契約を含む pay-as-you-go) は、これらのメッセージに応答する必要があります。応答の管理方法については、次のトピックを参照してください。
SNS トピックへのSQSキューのサブスクライブ
提供されたSNSトピックに Amazon SQSキューをサブスクライブすることをお勧めします。SQS キューの作成とトピックへのキューのサブスクライブに関する詳細な手順については、「Amazon Simple Notification Service デベロッパーガイド」の「Amazon SNSトピックへの Amazon SQSキューのサブスクライブ」を参照してください。
注記
製品を販売する AWS アカウント ために使用される のトピックのみをサブスクライブ AWS Marketplace SNSできます。ただし、メッセージを別のアカウントに転送することはできます。詳細については、「Amazon Simple Notification Service デベロッパーガイド」の「別のアカウントの Amazon SQSキューSNSへの Amazon メッセージの送信」を参照してください。
通知のSQSキューのポーリング
SQS キューをSNSトピックにサブスクライブすると、メッセージは に保存されますSQS。継続的にキューをポーリングし、メッセージを探して必要に応じて処理するサービスを定義する必要があります。