Amazon SNS の SaaS 製品に関する通知 - AWS Marketplace

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

Amazon SNS の SaaS 製品に関する通知

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

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

  • 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-notificationtopic の形式は次のとおりです。

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

-<action-name>は常にです entitlement-updated

注記
  • エンタイトルメントメッセージの場合、アクション (新規、アップグレード、更新、期限切れ) に関係なく、メッセージは同じです。それ以降の呼び出しGetEntitlementは、アップデートの内容を検出するために必要です。

  • を使用する場合消費を伴うSaaS契約 (超過)では、出品者にはaws-mp-subscription-notificationSNS トピック。これは、出品者が超過価格を追加したときに受け取る追加の通知です。売り手が新規顧客を獲得するとき、ただ得るのではなくentitlement-updated(あらゆる種類のアクションを指す場合があります)、売り手はこれが新しい顧客であることを示す購読メッセージを受け取ります。

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

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

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

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

-offer-identifierオファーがプライベートオファー

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

  • subscribe-successsubscribe-successメッセージは、出品者が計量記録の送信を開始できる時期を知らせます。

  • subscribe-fail— もしsubscribe-failメッセージが生成され、購入者がすでに移行していても支払いが失敗した可能性がありますAWS Marketplace出品者の SaaS ランディングページに移動します。売り手は待つべきですsubscribe-success製品の消費を許可する前のメッセージ。

  • unsubscribe-pending— 購入者が退会すると、unsubscribe-pending最初にメッセージを送信。これは、購入者が完全にキャンセルされる前に、最終的なメータリングレコードを送信する時間が限られている(約1時間)ことを示します。

  • unsubscribe-successunsubscribe-successメッセージはキャンセルの完了を通知し、それ以降はメータリングレコードは受け入れられません。

注記
  • 購入者が購読を解除し、決勝戦の前にすぐに正常に再購読した場合unsubscribe-successメッセージを送信、最終unsubscribe-successメッセージは送信されず、subscribe-success代わりにメッセージが送信されます。

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

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

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

注記

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

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

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