Unity SDKでリモートコンフィグで設計されたペイウォールをレンダリングする

リモートコンフィグを使用してペイウォールをカスタマイズした場合、ユーザーに表示するためのレンダリングをアプリのコードで実装する必要があります。リモートコンフィグはニーズに合わせた柔軟性を提供するため、ペイウォールに含める内容や表示方法はすべて自由に決められます。Adapty はリモートコンフィグを取得するためのメソッドを提供しており、カスタムペイウォールを自由に表示できます。

フローのリモートコンフィグを取得して表示する

v4 では、フローは RemoteConfigs リストで設定されたロケールごとに 1 つの AdaptyRemoteConfig エントリを持ちます。ユーザーの設定に合わせたロケールを選択し、必要な値を読み取ってください。

using System.Linq;
using AdaptySDK;

Adapty.GetFlow("YOUR_PLACEMENT_ID", (flow, error) => {
    if (error != null) {
        // handle the error
        return;
    }

    var config = flow.RemoteConfigs.FirstOrDefault(c => c.Locale == "en")
        ?? flow.RemoteConfigs.FirstOrDefault();
    var headerText = config?.Dictionary?["header_text"] as string;

    // Or access raw JSON data
    var jsonData = config?.Data;
});

必要な値をすべて取得したら、次はそれらをレンダリングして見栄えのよいページに組み立てましょう。さまざまなスマートフォンの画面サイズや向きに対応したデザインにして、あらゆるデバイスでシームレスかつ快適なユーザー体験を提供してください。

AdaptyのアナリティクスでファネルやA/Bテストの情報を記録できるよう、以下の説明に従い必ずペイウォール閲覧イベントを記録してください。

ペイウォールの表示が完了したら、次は購入フローの設定に進みます。ユーザーが購入を行う際は、フローから取得したプロダクトを使って .MakePurchase() を呼び出すだけです。.MakePurchase() メソッドの詳細については、購入処理をご覧ください。

フォールバックペイウォールと呼ばれるバックアップペイウォールの作成をおすすめします。このバックアップは、インターネット接続がない場合やキャッシュが利用できない場合にユーザーへ表示され、そのような状況でもスムーズな体験を提供します。

ペイウォールの表示イベントをトラッキングする

Adaptyはフローとペイウォールのパフォーマンス測定をサポートします。購入データは自動的に収集されますが、ユーザーがフローを閲覧したタイミングはあなたしか把握できないため、表示のログ記録はご自身で行う必要があります。

表示イベントをログに記録するには、.LogShowFlow(flow) を呼び出すだけです。これによりファネルやA/B テストの指標に反映されます。

フローBuilderやペイウォールビルダーでレンダリングされたフローやペイウォールを表示する場合、.LogShowFlow(flow)を呼び出す必要はありません。Adaptyはそれらのケースでビューを自動的に追跡します。

Adapty.LogShowFlow(flow, (error) => {
    // handle the error
});

リクエストパラメータ:

パラメーター	必須/任意	説明
flow	必須	`Adapty.GetFlow` で取得した `AdaptyFlow` オブジェクト。

リモートコンフィグを使ってペイウォールをカスタマイズした場合は、ユーザーに表示するためのレンダリング処理をモバイルアプリのコードに実装する必要があります。リモートコンフィグはニーズに合わせた柔軟な設定が可能なため、ペイウォールに含める内容や表示方法はすべて自由に決められます。リモートコンフィグの取得メソッドを提供しているので、リモートコンフィグで設定したカスタムペイウォールを自在に表示できます。

ペイウォールのリモートコンフィグを取得して表示する

ペイウォールのリモートコンフィグを取得するには、remoteConfig プロパティにアクセスして必要な値を取り出します。

Adapty.GetPaywall("YOUR_PLACEMENT_ID", (paywall, error) => {
    if (error != null) {
        // handle the error
        return;
    }
    
    // Access remote config dictionary
    var dictionary = paywall.RemoteConfig?.Dictionary;
    var headerText = dictionary?["header_text"] as string;
    
    // Or access raw JSON data
    var jsonData = paywall.RemoteConfig?.Data;
});

必要な値をすべて取得したら、次はそれらをレンダリングして、見栄えの良いページとして組み立てる段階です。さまざまなモバイル端末の画面サイズや向きに対応したデザインにして、あらゆるデバイスでシームレスかつ使いやすい体験を提供しましょう。

ファネルや A/B テストの情報を Adapty アナリティクスで取得できるよう、以下の手順に従ってペイウォール表示イベントを記録してください。

ペイウォールの表示が完了したら、購入フローの設定に進みます。ユーザーが購入する際は、ペイウォールのプロダクトを引数として .MakePurchase() を呼び出すだけです。.MakePurchase() メソッドの詳細については、購入の実装をご覧ください。

インターネット接続やキャッシュが利用できない場合にユーザーに表示されるフォールバックペイウォールの作成をお勧めします。これにより、そのような状況でもスムーズな体験が確保されます。

ペイウォール表示イベントをトラッキングする

Adapty はペイウォールのパフォーマンス測定をサポートしています。購入データは自動的に収集されますが、ペイウォールの表示ログはユーザーがペイウォールを見たタイミングを把握しているのは開発者だけのため、手動での記録が必要です。

ペイウォール表示イベントをログに記録するには .LogShowPaywall(paywall) を呼び出すだけで、ファネルや A/B テストのペイウォール指標に反映されます。

ペイウォールビルダーで作成したペイウォールを表示する場合は、.LogShowPaywall(paywall) を呼び出す必要はありません。

Adapty.LogShowPaywall(paywall, (error) => {
    // handle the error
});

リクエストパラメーター:

パラメーター	必須 / 任意	説明
paywall	必須	`AdaptyPaywall` オブジェクト。