Android - 新しいペイウォールビルダーのペイウォールを表示する

ペイウォールビルダーを使ってペイウォールをカスタマイズした場合、ユーザーに表示するためのレンダリングコードをモバイルアプリに書く必要はありません。このようなペイウォールには、表示内容と表示方法の両方が含まれています。

このガイドは、SDK v3.0 が必要な新しいペイウォールビルダーのペイウォール専用です。ペイウォールの表示方法は、異なるバージョンのペイウォールビルダーで設計されたペイウォール、リモートコンフィグペイウォール、Observer モードによって異なります。

以下で使用する viewConfiguration オブジェクトの取得方法については、ペイウォールビルダーのペイウォールと設定を取得するをご覧ください。

リクエストパラメータ:

パラメータ必須/任意説明
viewConfiguration必須ペイウォールのビジュアル詳細を含む AdaptyUI.LocalizedViewConfiguration オブジェクトを指定します。Adapty.getViewConfiguration(paywall) メソッドで読み込んでください。詳細はペイウォールのビジュアル設定を取得するをご覧ください。
products任意画面上のプロダクト表示タイミングを最適化するために AdaptyPaywallProduct の配列を指定します。null を渡すと、AdaptyUI が必要なプロダクトを自動的に取得します。
eventListener任意ペイウォールイベントを監視するために AdaptyUiEventListener を指定します。使いやすさのために AdaptyUiDefaultEventListener の拡張を推奨します。詳細はペイウォールイベントの処理をご覧ください。
insets任意

インセットは、システムバーの後ろにタップ可能な要素が隠れないようにするためのペイウォール周囲のスペースです。

デフォルト: UNSPECIFIED(Adapty がインセットを自動調整します。エッジ・ツー・エッジのペイウォールに適しています)

ペイウォールがエッジ・ツー・エッジでない場合は、カスタムインセットを設定することをお勧めします。設定方法は下記のペイウォールインセットの変更セクションをご覧ください。

personalizedOfferResolver任意パーソナライズされた価格設定(詳細はこちら)を指定するには、AdaptyUiPersonalizedOfferResolver を実装し、AdaptyPaywallProduct が個人化された価格かどうかを true/false で返す独自のロジックを渡してください。
tagResolver任意ペイウォールテキスト内のカスタムタグを解決するために AdaptyUiTagResolver を使用します。このリゾルバーはタグパラメータを受け取り、対応する文字列に解決します。詳細はペイウォールビルダーのカスタムタグのトピックをご覧ください。
timerResolver任意カスタムタイマー機能を使用する場合は、ここにリゾルバーを渡してください。

Adapty SDK がモバイルアプリにどのように統合されているか、実際の例を見てみませんか?ペイウォールの表示、購入処理、その他の基本機能を含む完全なセットアップを実演しているサンプルアプリをご覧ください。

ペイウォールインセットの変更

インセットは、システムバーの後ろにタップ可能な要素が隠れないようにするためのペイウォール周囲のスペースです。デフォルトでは、Adapty がインセットを自動調整します。これはエッジ・ツー・エッジのペイウォールに適しています。

ペイウォールがエッジ・ツー・エッジでない場合は、カスタムインセットの設定をお勧めします:

  • ステータスバーとナビゲーションバーのどちらも AdaptyPaywallView と重なっていない場合は AdaptyPaywallInsets.NONE を使用してください。
  • ペイウォールが上部のステータスバーとは重なっているが下部とは重なっていない場合など、より詳細な設定が必要な場合は、以下の例のように bottomInset のみを 0 に設定できます:

開発者定義タイマーの使用

モバイルアプリで開発者定義タイマーを使用するには、カスタムタイマーとペイウォールのレンダリング時に置き換えられる文字列値をペアにしたディクショナリまたはマップである timerResolver オブジェクトを作成します。以下に例を示します:

この例では、CUSTOM_TIMER_NY は Adapty ダッシュボードで設定した開発者定義タイマーの Timer ID です。timerResolver により、アプリはタイマーの終了時刻(元日など)から現在時刻を引いて計算した 13d 09h 03m 34s のような正確な値でタイマーを動的に更新します。

カスタムタグの使用

モバイルアプリでカスタムタグを使用するには、カスタムタグとペイウォールのレンダリング時に置き換えられる文字列値をペアにしたディクショナリまたはマップである tagResolver オブジェクトを作成します。以下に例を示します:

この例では、USERNAME は Adapty ダッシュボードで <USERNAME/> として入力したカスタムタグです。tagResolver により、アプリはこのカスタムタグを John のような指定された値に動的に置き換えます。

tagResolver はペイウォールを表示する直前に作成・設定することをお勧めします。準備ができたら、ペイウォール表示に使用する AdaptyUI メソッドに渡してください。

ペイウォールのローディングインジケーターの色を変更する

ローディングインジケーターのデフォルトカラーは、次の方法でオーバーライドできます:


<style name="AppTheme" parent="android:Theme.Material.Light.NoActionBar">

    <item name="adapty_progressIndicatorColor">@color/yourColor</item>
</style>