Kotlin Multiplatform SDKでオンボーディングを取得する

Adapty ダッシュボードのビルダーでオンボーディングのビジュアルデザインを完成させた後、Kotlin Multiplatform アプリでそれを表示できます。このプロセスの最初のステップは、以下で説明するように、プレースメントに関連付けられたオンボーディングとそのビュー設定を取得することです。

始める前に、以下を確認してください：

1. Adapty Kotlin Multiplatform SDK バージョン 3.15.0 以上がインストールされていること。
2. オンボーディングを作成済みであること。
3. オンボーディングをプレースメントに追加済みであること。

オンボーディングの取得

ノーコードビルダーでオンボーディングを作成すると、アプリが取得・表示するためのコンテナとして保存されます。このコンテナは、表示するコンテンツ、表示方法、ユーザーの操作（クイズの回答やフォーム入力など）の処理まで、すべてを管理します。また、アナリティクスイベントも自動的に追跡されるため、ビュートラッキングを別途実装する必要はありません。

パフォーマンスを最大限に高めるため、ユーザーに表示する前に画像が十分ダウンロードできるよう、早い段階でオンボーディングの設定を取得しておくことをおすすめします。

オンボーディングを取得するには、getOnboarding メソッドを使用します：

Adapty.getOnboarding(
    placementId = "YOUR_PLACEMENT_ID",
    locale = "en",
    fetchPolicy = AdaptyPaywallFetchPolicy.Default,
    loadTimeout = 5.seconds
).onSuccess { paywall ->
    // the requested paywall
}.onError { error ->
    // handle the error
}

パラメーター：

レスポンスパラメーター：

デフォルトオーディエンスのオンボーディングでフェッチを高速化する

通常、オンボーディングはほぼ瞬時にフェッチされるため、このプロセスの高速化を気にする必要はありません。ただし、オーディエンスやオンボーディングの数が多く、ユーザーのインターネット接続が不安定な場合、オンボーディングのフェッチに想定以上の時間がかかることがあります。そのような状況では、オンボーディングをまったく表示しないよりも、デフォルトのオンボーディングを表示してスムーズなユーザー体験を提供することを検討するとよいでしょう。

これに対処するには、getOnboardingForDefaultAudience メソッドを使用できます。このメソッドは、指定したプレースメントの All Users オーディエンス向けオンボーディングを取得します。ただし、推奨されるアプローチは getOnboarding メソッドでオンボーディングを取得することであり、詳細については上記のオンボーディングの取得セクションを参照してください。

Adapty.getOnboardingForDefaultAudience(
    placementId = "YOUR_PLACEMENT_ID",
    locale = "en",
    fetchPolicy = AdaptyPaywallFetchPolicy.Default,
).onSuccess { paywall ->
    // the requested paywall
}.onError { error ->
    // handle the error
}

パラメーター：