Flutter SDKにウェブペイウォールを実装する

始める前に、ダッシュボードでウェブペイウォールを設定し、Adapty SDK バージョン 3.6.1 以降をインストールしていることを確認してください。

自分で作成したペイウォールを使用している場合は、SDKメソッドを使ってウェブペイウォールを処理する必要があります。.openWebPaywallメソッドは次の動作を行います。

Adaptyが特定のユーザーに表示されたペイウォールとリダイレクト先のウェブページを紐付けるための一意のURLを生成します。
ユーザーがアプリに戻ったタイミングを追跡し、短い間隔で.getProfileをリクエストして、プロファイルのアクセス権が更新されたかどうかを確認します。

これにより、決済が成功してアクセス権が更新された場合、サブスクリプションはほぼ即座にアプリ内で有効化されます。

try {
  await Adapty().openWebPaywall(product: <YOUR_PRODUCT>);
  // The web paywall will be opened
} on AdaptyError catch (adaptyError) {
  // handle the error
} catch (e) {
  // handle other errors
}

openWebPaywallメソッドには2つのバージョンがあります。

openWebPaywall(product) — ペイウォールによってURLを生成し、プロダクトデータもURLに追加します。
openWebPaywall(paywall) — プロダクトデータを追加せずにペイウォールによってURLを生成します。Adaptyのペイウォールのプロダクトとウェブペイウォールのプロダクトが異なる場合に使用します。

エラーの処理

エラー	説明	推奨アクション
AdaptyError.paywallWithoutPurchaseUrl	ペイウォールにウェブ購入URLが設定されていない	Adapty ダッシュボードでペイウォールが正しく設定されているか確認してください
AdaptyError.productWithoutPurchaseUrl	プロダクトにウェブ購入URLがない	Adapty ダッシュボードでプロダクトの設定を確認してください
AdaptyError.failedOpeningWebPaywallUrl	ブラウザでURLを開くことができなかった	デバイスの設定を確認するか、別の購入方法を提供してください
AdaptyError.failedDecodingWebPaywallUrl	URLのパラメータのエンコードに失敗した	URLパラメータが有効で適切にフォーマットされているか確認してください

アプリ内ブラウザでウェブペイウォールを開く

アプリ内ブラウザでのウェブペイウォールの表示は、Adapty SDK v3.15 以降でサポートされています。

デフォルトでは、ウェブペイウォールは外部ブラウザで開きます。

シームレスなユーザー体験を提供するために、アプリ内ブラウザでウェブペイウォールを開くことができます。これにより、ウェブ購入ページがアプリ内に表示され、ユーザーはアプリを切り替えることなく取引を完了できます。

これを有効にするには、inパラメータを.inAppBrowserに設定します。

try {
  await Adapty().openWebPaywall(
    product: <YOUR_PRODUCT>,
    openIn: AdaptyWebPresentation.inAppBrowser,
  );
  // The web paywall will be opened in the in-app browser
} on AdaptyError catch (adaptyError) {
  // handle the error
} catch (e) {
  // handle other errors
}