アプリ内購入Webhook:購読の変化を即座に受け取る
アプリ内で購入、更新、解約、失効などが起きた瞬間に外部システムへ通知を送る仕組みです。購読者の状態変化をリアルタイムで把握できるため、再開案内、請求トラブルの連絡、オンボーディングの自動化に使えます。
Webhookでできること
Webhookを使うと、利用状況に応じた次の対応を自動化できます。
- 解約を検知して、オファーや割引の提示につなげる
- 請求の問題を早期に知らせ、アクセス喪失や収益減を抑える
- 新規購入やアップグレードの直後に、新しい特典を案内する
導入前に、どのイベントでどの処理を起こすかを決めておくと、通知の重複や誤ったアクセス制御を防ぎやすくなります。
イベントの読み方
受信側では、イベント種別ごとに処理を分けるのが基本です。特に重要な区別は次のとおりです。
- テスト(TEST):ダッシュボードから送る検証用通知として、本番処理と区別する
- 初回購入(INITIAL_PURCHASE):新しい購読が始まった合図として、歓迎やオンボーディングを開始する
- 非更新型購入(NON_RENEWING_PURCHASE):自動更新されない購入として、更新型購読とは別に管理する
- 更新(RENEWAL):既存購読が継続した合図として、利用状況の確認や次回案内に使う
- 製品変更(PRODUCT_CHANGE):購読者が別の製品へ移った合図として、権利内容を切り替える
- キャンセル(CANCELLATION):購読または非更新型購入が終了した合図として、理由を確認する
- キャンセル取り消し(UNCANCELLATION):未失効のキャンセルされたサブスクリプションが再有効化された合図として、アクセスを維持する
- 請求問題(BILLING_ISSUE):課金処理に問題が起きた合図であり、直ちに失効したとは限らない。CANCELLATIONイベントとcancel_reason=BILLING_ERRORを監視している場合は無視しても問題ありません
- 一時停止(SUBSCRIPTION_PAUSED):購読が一時停止した合図として、再開条件を確認する
- 移行(TRANSFER):取引と権利が別のApp User IDへ移る処理の開始を示す
- 失効(EXPIRATION):購読が終わり、アクセス削除が必要な合図として扱う
導入チェックリスト
次の順序で確認すると、誤処理を減らせます。
- まずテストイベントで受信と記録が動くか確認する
- 初回購入と更新を分けて、歓迎処理と継続処理が混ざらないようにする
- 請求問題と失効を分けて、課金トラブルで即座に権限を奪わないようにする
- キャンセル時は理由を確認し、再有効化の可能性を残す
- 失効や一時停止では、再開・再購入の導線を用意する
- 製品変更と移行では、旧IDと新IDの権利状態を照合する
ノーコード統合を使う場合は、リアルタイムのイベントと収益データを外部ツールへ渡す前に、重複通知や遅延を許容できる処理設計を確認してください。連携先として、Adjust、Apple Search Ads、Singular、Branch、SplitMetrics Acquire、Meta Ads、Tenjin、AppsFlyerが挙げられています。
Frequently asked questions
請求に問題が起きたら、すぐにアクセスを切るべきですか?
課金エラーは直ちに失効を意味しません。請求処理の問題を示す通知であり、利用者がすぐに対処できるよう案内することが目的です。BILLING_ISSUEは失効ではありません。CANCELLATIONイベントとcancel_reason=BILLING_ERRORを監視している場合は無視しても問題ありません。
更新イベントはどのような場合に発生しますか?
更新は通常、現在の請求期間が終わるタイミングで起こります。一時停止していた利用者が再開した場合にも更新として扱われます。
テストイベントは何に使いますか?
テストイベントは、ダッシュボードから受信側の処理を確認するために送る検証用通知です。本番の購入や更新とは区別して扱ってください。