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

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

iOS での初回オファーの適用資格を確認し、適用資格がある場合にペイウォールビューがそのケースを処理できるよう調整することを忘れないでください。

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

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

do {
    let flow = try await Adapty.getFlow(placementId: "YOUR_PLACEMENT_ID")
    let config = flow.remoteConfigs.first(where: { $0.locale == "en" })
        ?? flow.remoteConfigs.first
    let headerText = config?.dictionary?["header_text"] as? String
} catch {
    // handle the error
}

Adapty.getFlow(placementId: "YOUR_PLACEMENT_ID") { result in
    let flow = try? result.get()
    let config = flow?.remoteConfigs.first(where: { $0.locale == "en" })
        ?? flow?.remoteConfigs.first
    let headerText = config?.dictionary?["header_text"] as? String
}

必要な値をすべて取得したら、それらを組み合わせて見栄えの良いページをレンダリングしましょう。さまざまなスマートフォンの画面サイズや向きに対応したデザインにして、どのデバイスでもシームレスで使いやすい体験を提供してください。

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

フォールバックペイウォールというバックアップペイウォールを作成することをおすすめします。インターネット接続がない場合やキャッシュが利用できない場合でも、このバックアップが表示されるためスムーズな体験が維持されます。

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

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

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

try await Adapty.logShowFlow(flow)

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

リモートコンフィグを使ってペイウォールをカスタマイズした場合、ユーザーに表示するためのレンダリング処理をアプリのコードに実装する必要があります。リモートコンフィグは柔軟にカスタマイズできるため、ペイウォールに何を含めるか、どのように表示するかはすべて開発者次第です。Adapty はリモートコンフィグを取得するメソッドを提供しており、リモートコンフィグで設定したカスタムペイウォールを自由に表示できます。

iOS で初回オファーの対象ユーザーを確認することを忘れずに、対象ユーザーの場合の処理もペイウォールに組み込んでください。

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

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

do {
    let paywall = try await Adapty.getPaywall(placementId: "YOUR_PLACEMENT_ID")
    let headerText = paywall.remoteConfig?.dictionary?["header_text"] as? String
} catch {
    // handle the error
}

Adapty.getPaywall(placementId: "YOUR_PLACEMENT_ID") { result in
    let paywall = try? result.get()
    let headerText = paywall?.remoteConfig?.dictionary?["header_text"] as? String
}

必要な値をすべて取得したら、それらを組み合わせて見栄えの良いページをレンダリングしましょう。さまざまなスマートフォンの画面サイズや向きに対応したデザインにして、どのデバイスでもシームレスで使いやすい体験を提供してください。

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

フォールバックペイウォールというバックアップペイウォールを作成することをおすすめします。インターネット接続がない場合やキャッシュが利用できない場合でも、このバックアップが表示されるためスムーズな体験が維持されます。

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

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

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

Adapty.logShowPaywall(paywall)