Skip to content
AppDues
Log in
Contact salesSign up

React Native Web でサブスクリプションを一元管理する

React Native で作ったアプリを Web にも広げるとき、課金だけを別システムで用意すると、購入履歴・権利判定・解約対応が二重管理になりがちです。React Native SDK(react-native-purchases)は 9.7.6 以降で React Native Web に対応し、エンタイトルメントシステムで iOS・Android・Web の購入を集約できるようになりました。このページでは、実際に設定するときの判断ポイントと、Web 環境でできること・できないことを順に確認します。

何が変わるのか:3プラットフォームを1つの SDK で扱う

これまでは、Web 側に独自の課金フローを用意し、ネイティブの購入状態と突き合わせるカスタムロジックが必要でした。React Native Web 対応により、Web での購入もネイティブ購入と同じバックエンドに流れます。アプリ側は単一のエンタイトルメントシステムを見ればよくなり、複数データソースの照合を前提とした設計を強いられません。

対象は iOS・Android・Web の3プラットフォームです。すでにモバイルで展開しているアプリに Web を追加する場合も、最初から共通コードベースで作る場合も、サブスクリプション基盤を作り直す必要はないというのが発表内容です。Expo プロジェクトでも、react-native-purchases を追加することが出発点になります。

Web の購入はどこを通るのか

iOS と Android では、SDK は App Store と Google Play に直接統合されます。Web の場合は Web Billing が購入を処理し、決済プロセッサーとして Stripe または Paddle が使われます。Web Billing はネイティブのアプリ内課金とは別の仕組みですが、同じエンタイトルメントシステムに接続されます。共通の appUserID を使えば、プラットフォームをまたいでアクセス権を付与できます。

アプリの視点では、ユーザーがどこで契約したかによってサブスクリプション状態が変わるわけではありません。Web で登録したユーザーも、プラットフォーム別の分岐コードを追加しなくても、モバイル側でそのままプレミアム機能を利用できます。

設定手順:プラットフォームごとに API キーを選ぶ

最初の作業は、動いているプラットフォームに応じて適切な公開 API キーで SDK を初期化することです。Web では Web Billing 用の公開 API キー、iOS では Apple 用、Android では Google 用のキーを使います。次のコードは、その分岐をそのまま示したものです。

初期化の分岐はプラットフォーム判定だけに閉じ込め、その後の処理は共通化できます。オファリングの取得、エンタイトルメントの確認、パッケージ購入は、iOS・Android・Web のいずれでも同じ呼び出し方になります。購入元ごとにアプリのロジックを分ける必要はありません。

Web 購入を有効にするには、ダッシュボード側で Web Billing 用のアプリを作成し、Web 向けプロダクトを設定します。これらは iOS・Android のプロダクトと並べて管理できますが、課金経路はネイティブストアではなく Web Billing です。

Expo での使いどころと限界

Expo で開発している場合、Web 対応は日常の確認作業を軽くします。カスタム開発クライアントを用意する前の段階でも、ブラウザ上でサブスクリプション UI を表示し、エンタイトルメント判定や購入フローのつながりを確認できます。初期の反復が速くなり、設定の誤りに早く気づけます。

ただし、これはネイティブ課金の実テストを置き換えるものではありません。iOS と Android で実際のアプリ内課金を最後まで検証するには、これまで通り Expo の開発ビルドが必要です。Web は設定確認と UI 検証、開発ビルドはストア課金の検証、と役割を分けて考えると判断しやすくなります。

Web 環境での制限と、その回避の考え方

Web 課金はネイティブのアプリストアとは仕組みが違うため、いくつかの操作はそのままでは使えません。まず、Web の購入には Web Billing が必要で、iOS や Android のネイティブアプリ内課金を Web 側で処理することはできません。また、ネイティブストアの API に依存する操作、たとえば getProducts、purchaseProduct、restorePurchases などは Web ではサポートされません。Expo Go のようなサンドボックス環境でも購入処理は動きません。

次のコードは、Web では動作せず iOS・Android では動作する restorePurchases の例です。Web 側の画面やナビゲーションに「購入を復元」を出すかどうかは、この違いを前提に決めます。

Web サブスクリプションの更新や解約は、ホストされたカスタマーポータルから行えます。ネイティブアプリストアの外に出る場合でも、ユーザーが契約を管理する経路を用意しておくことが重要です。

実装前のチェックリスト

リリース前に、次の点を順に確認してください。

  • react-native-purchases が 9.7.6 以降であることを確認する。
  • Web は Web Billing 用の公開 API キー、iOS は Apple 用、Android は Google 用のキーで初期化しているか確認する。
  • ダッシュボードに Web Billing 用アプリと Web 向けプロダクトを作成済みか確認する。
  • オファリング取得・エンタイトルメント確認・パッケージ購入が、プラットフォーム分岐なしで共通コードから呼べるか確認する。
  • Web の画面に getProducts、purchaseProduct、restorePurchases など Web 非対応の操作を出していないか確認する。
  • 共通の appUserID で、Web 購入後にモバイル側のエンタイトルメントが有効になる流れを確認する。
  • ネイティブ課金の実テストは Expo の開発ビルドで行う。
  • Web 契約の更新・解約の案内先としてカスタマーポータルを用意する。

短いシナリオ例:Web で契約し、アプリで使う

たとえば、ユーザーがブラウザで有料プランに加入したとします。この購入は Web Billing を通り、共通の appUserID に紐づいてエンタイトルメントが有効になります。同じユーザーがモバイルアプリを開くと、アプリはネイティブ購入か Web 購入かを区別せず、エンタイトルメントの有無だけを見て有料機能を表示できます。

この流れが成立するかどうかは、初期化のキー選択と appUserID の扱いにかかっています。逆に、Web 側で restorePurchases を呼ぶような設計にすると、Web ではサポートされない操作に依存してしまいます。Web では購入と契約管理、ネイティブではストア課金の検証、という境界を意識して実装すると、プラットフォームごとの差異を最小限に抑えられます。

今後の位置づけ

モバイルと Web の両方でサブスクリプションを提供するアプリは増えています。クロスプラットフォームのサブスクリプション管理をより簡潔で信頼できるものにするための投資が続けられており、React Native Web 対応はその土台に位置づけられています。すでに React Native と react-native-purchases をモバイルで使っているなら、Web 対応の追加はアーキテクチャを大きく変えずに進められる選択肢です。

Frequently asked questions

React Native Web 対応に必要な react-native-purchases のバージョンは?

9.7.6 以降です。このバージョンから、iOS・Android・Web のサブスクリプションを同じ SDK とエンタイトルメントシステムで扱えるようになります。

Web とネイティブで API キーは分ける必要がありますか?

はい。Web では Web Billing 用の公開 API キー、iOS では Apple 用、Android では Google 用のキーで初期化します。分岐は初期化時だけで、その後のオファリング取得やエンタイトルメント確認は共通化できます。

Web で restorePurchases は使えますか?

Web ではサポートされません。restorePurchases はネイティブストアの API に依存する操作で、iOS と Android では動作します。getProducts や purchaseProduct も同様に Web 非対応です。

Expo なら Web だけで課金のテストが完結しますか?

いいえ。Web ではサブスクリプション UI やエンタイトルメントロジックの確認ができますが、iOS・Android の実際のアプリ内課金を検証するには Expo の開発ビルドが必要です。Expo Go などのサンドボックス環境では購入処理はサポートされません。

Web で契約したサブスクリプションの更新や解約はどこで行いますか?

ホストされたカスタマーポータルから管理できます。ネイティブアプリストアの外でも、更新や解約を一貫した方法で行える経路として案内できます。