2023.12.13

【Amazon】リアルタイム通知で定期購入の状態変化を検知する

saratogax

記事内に商品プロモーションを含む場合があります

2021 年の 7 月 15 日、Amazon のアプリ内課金で「リアルタイム通知(Real-Time notifications)」の機能が発表されました。

Apple や Google には以前から同様の機能があり、サブスクや都度課金で活用されています。

リアルタイム通知の公式ドキュメント

機能の発表と同時に、リアルタイム通知のドキュメントページも公開されました。

Overview of Real-Time Notifications

これまでは、サブスクの有効期限を過ぎたタイミングなどで Amazon のサーバへ購入状態をチェックしにいかないといけませんでしたが、今後はこの通知が購入状態の変更を検知するトリガーになります。

通知が届いたら、該当の購入情報のレシート検証をして、保持しているユーザのデータに反映する流れですね。

ちなみに通知は、Amazon から送られてくるので、それを受信するための仕組みはこちらで用意する必要があります。

API など受け口となるエンドポイントを用意しておくといいでしょう。

レシート検証とリアルタイム通知の利用フロー

このリアルタイム通知、どのような場面で利用価値が出てくるでしょうか。

これまでの通常のレシート検証やサブスクの更新タイミングと合わせて見てみましょう。

まずは商品購入完了までの流れ。

1. アプリで商品を購入
2. 購入情報(レシート)をバックエンドサーバに送信
3. バックエンドサーバが Amazon RVS でレシート検証

Amazon RVS のレシート検証については、過去にまとめた記事があるので興味があればご覧ください。

リアルタイム通知を受け取るための要件

先ほど、リアルタイム通知を受け付ける API などのエンドポイントを用意しておくといいと書きました。

具体的には、エンドポイントには以下の前提条件があります。

・HTTPS の通信が可能(有効な SSL サーバ証明書)
・POST リクエストを受け付けるエンドポイント

通常、HTTPS のプロトコルを介してリクエストを受ける際は、信頼された認証局から発行された証明書を利用します。

なので、HTTPS かつ POST のリクエストを処理するエンドポイントを用意しておけば問題ありません。

テスト購入の通知にも対応しているようなので、テスト環境でも同様に設定しておくと開発もスムーズですね。

リアルタイム通知の内容

リアルタイム通知は、JSON メッセージを介して配信されます。

ただし、JSON の 1 階層目に必要な情報が羅列されているわけではなく、AWS SNS の通知フォーマットの形式となります。

Amazon Simple Notification Service (SNS) Developer Guide.

以下の「Message」フィールドにリアルタイム通知の内容が入ってくると言うことですね。

{
  "Type" : "Notification",
  "MessageId" : "22b80b92-fdea-4c2c-8f9d-bdfb0c7bf324",
  "TopicArn" : "arn:aws:sns:us-west-2:123456789012:MyTopic",
  "Subject" : "My First Message",
  "Message" : "Hello world!",
  "Timestamp" : "2012-05-02T00:54:06.655Z",
  "SignatureVersion" : "1",
  "Signature" : "EXAMPLEw6JRN...",
  "SigningCertURL" : "https://sns.us-west-2.amazonaws.com/SimpleNotificationService-f3ecfb7224c7233fe7bb5f59f96de52f.pem",
  "UnsubscribeURL" : "https://sns.us-west-2.amazonaws.com/?Action=Unsubscribe&SubscriptionArn=arn:aws:sns:us-west-2:123456789012:MyTopic:c9135db0-26c4-47ec-8998-413945fb5a96"
}

リアルタイム通知の内容は以下の通り。

「レシートID」と「AmazonのユーザID」があれば、バックエンド側で保持している情報と紐付けはできそうです。

項目	内容
receiptId	レシートの ID
relatedReceipts	関連する追加のレシート
appUserId	Amazon のユーザ ID
notificationType	通知タイプ
appPackageName	アプリのパッケージ名
timestamp	タイムスタンプ
betaProductTransaction	テストアプリの商品かどうか

JSON に置き換えると、こんなイメージです。

{
  "receiptId" : "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "relatedReceipts" : [],
  "appUserId" : "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "notificationType" : "SUBSCRIPTION_RENEWED",
  "appPackageName" : "xxxxxxxxxx",
  "timestamp" : 1402008634018,
  "betaProductTransaction" : false
}

通知タイプの種類

Amazon のリアルタイム通知には多くの通知タイプが用意されています。

消費型やサブスクの購入時には以下のタイプになりますし、

CONSUMABLE_PURCHASED
SUBSCRIPTION_PURCHASED

サブスクの状態変更に合わせたタイプも最低限は揃っていますね。というか、むしろ充実しています。

SUBSCRIPTION_RENEWED
SUBSCRIPTION_AUTO_RENEWAL_OFF
SUBSCRIPTION_CANCELLED
SUBSCRIPTION_EXPIRED
SUBSCRIPTION_IN_GRACE_PERIOD
SUBSCRIPTION_SCHEDULED_TO_END

どちらにしても、通知タイプに関係なく AmazonRVS でレシート検証を行うことが推奨されているので、最新の状態はそちらで確認すべきでしょう。

リアルタイム通知と言っても、通知が遅れてくる可能性もありますし、こちらのバックエンドサーバの処理でエラーとなり処理に時間が掛かるケースも想定しておかないといけないですからね。

幸い「timestamp」の項目があるので、タイムスタンプを履歴などに残しておくと後から時系列で確認しやすいですね。