Adapty では、フローはオンボーディングとペイウォールをひとつのエンティティとしてまとめ、単一のプレースメントで提供します。フローは、現在それぞれ個別に構築・配信しているオンボーディングとペイウォールを置き換えるものです。 このガイドでは、フローに移行する際の変更点と、古いバージョンのアプリを使用しているユーザーを中断させずに移行を展開する方法について説明します。

フローとオンボーディング・ペイウォールの比較

オンボーディングとペイウォールを別々に管理する場合、2つのビルダーと2つのプレースメントを維持する必要があります。また、オンボーディングからペイウォールへのユーザーの受け渡しも自分のコードで実装しなければなりません。

フローはその両方を1つのエクスペリエンスに置き換えます。イントロ画面、クイズ、購入画面をひとつのエディターで作成し、ひとつのプレースメントから配信できます。

以下の表は、各オプションの違いを比較したものです：

	フロー	ペイウォールビルダーのペイウォール	オンボーディング
複数画面	あり	なし（単一画面）	あり
レンダリング	ネイティブ	ネイティブ	WebView
プロダクトとプレースメント	プレースメント1つ。プロダクトをフローに直接追加する	プレースメント1つ。プロダクトをペイウォールに直接追加する	プレースメント1つだが、独自のプロダクトは持たない。販売するには別途ペイウォールを作成し、独立したプレースメントから提供する

移行すべきか？

既存のオンボーディングとペイウォールは引き続き動作し、Adaptyもそれらのサポートを続けます。ただし、新機能はスタンドアロンのオンボーディングビルダーやペイウォールビルダーではなく、フローに対して追加されるようになっています。

長期的な視点で構築するなら、フローの方が優れた基盤です — リリーススケジュールに合わせてタイミングよく移行してください。

移行方法

移行は4つのステップで構成されています。作業のほとんどはSDKの一度きりのアップグレードです。フローのビルドとプレビューはノーコードで行えます。

1. フローを作成する：ノーコードエディタでフローを作成します。開発者は不要です。
2. デバイスでプレビューする：Adapty モバイルアプリを使って実機でフローを確認します。アプリのビルドは不要です。
3. フロー用のプレースメントを新規作成する：固有の ID を持つ新しいフロープレースメントを作成し、既存のプレースメントとの共存方法を決めます。
4. SDK を更新する：iOS、Android、または React Native の SDK v4 にアップグレードし、プレースメントからフローを取得して、サンドボックス購入を確認します。これが主な開発者タスクです。

フローを作成する

Flows ページで Create flow をクリックして、オンボーディングとペイウォールをひとつの体験として構築しましょう。ビルダーについて詳しく知りたい場合は、以下をご覧ください。

• フロードキュメント：ビルダーの使い方と作成できるコンテンツを説明しています。
• よくあるフローのレシピ：よく使われる画面を作成するためのステップバイステップガイドです。
• AI に質問する：詰まったときは、ドキュメントの各ページにあるチャットを活用してください。

デバイスでプレビューする

実際のデバイスで、アプリに触れることなくフローをプレビューできます。App Store から Adapty アプリをダウンロードしてください。次に、フロービルダーで Test on device をクリックし、ロケールを選択して、デバイスで QR コードをスキャンします。実際の画面、分岐、コピー、デザインを確認できます。

フローの新規プレースメントを作成する

プレースメントは、フロー、ペイウォール、オンボーディングのいずれか1種類のコンテンツのみを扱います。既存のオンボーディングやペイウォールのプレースメントをフロー用に変換することはできません（プレースメントタイプを参照）。フローには専用の新しいプレースメントが必要です。

新しいフロープレースメントには、完全に新しいユニークなプレースメントIDを付けてください。 既存のペイウォールまたはオンボーディングのプレースメントのIDと一致したり、再利用したりすることはできません。

SDKのすべてのプレースメントを一度にフローへ移行する必要はありません。SDK v4では、getFlowメソッドがフロープレースメントとペイウォールプレースメントの両方からデータを取得するため、アプリはどこでも同じメソッドを呼び出せます。ペイウォールビルダーのペイウォールは使いたいプレースメントにそのまま残し、それ以外のプレースメントにフローを使いましょう。 移行期間中、各プレースメントタイプはそれぞれ独自の指標を追跡します。旧バージョンと新バージョンのアプリが同時に稼働している間、データは2つのプレースメントセットに分かれます。旧オンボーディングおよびペイウォールプレースメントは古いバージョンをカバーし、新しいフロープレースメントはSDK v4以降をカバーします。これらを別々のコホートとして比較し、ユーザーがアップデートするにつれてフロープレースメントのシェアが増加することを見込んでください。 フローを使ったA/Bテストも引き続き実行できます。フロープレースメントのフローバリアント間で通常のA/Bテストを実施できます。クロスプレースメントA/Bテストは現在ペイウォールのみ対応しているため、フロープレースメント間では実行できません。新しいフローと既存のペイウォールを比較する場合は、単一のテストではなくコホート比較となります。これは異なるプレースメントタイプに存在するためです。

SDKのアップデート

フロープレースメントの準備ができたら、アプリをそこに向けましょう。フローはAdapty SDK v4以降でのみレンダリングされます。SDKをアップグレードし、新しいプレースメントからgetFlowでフローを取得してください。具体的なアップグレード手順については、各プラットフォームのv4移行ガイドを参照してください — iOS、Android、またはReact Native。 フローの接続が完了したら、通常の購入フローと同様に確認しましょう。デバイスまたはシミュレーターで実行し、サンドボックス購入（iOS / Android）を行って、プロダクト、購入処理、アクセスレベルがすべて正常に動作するか確認してください。