フローへの移行

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

フローは現在、iOS、Android、React Native、Flutter、Capacitor SDK v4 以上でサポートされています。他のプラットフォームおよびフレームワークのサポートは近日公開予定です。

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

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

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

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

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

移行すべきか？

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

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

移行方法

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

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

フローを作成する

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

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

フローテンプレートからのフロー作成やAIによる自動生成はまだ利用できません。どちらも近日公開予定です。現時点では、すべての新しいフローはよく使われるいくつかの画面から始まり、必要に応じて編集やスタイルの調整が可能です。

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

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

プレビューモードでは、Adapty はストア内のプロダクトにアクセスできないため、プレビューに表示される価格は実際のものではありません。実際の購入確認は後ほど、サンドボックスアカウントを使った v4 ビルドで行います。詳しくは SDK を更新するを参照してください。

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

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

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

移行中は古いプレースメントをそのまま稼働させておいてください古いアプリバージョンのユーザーは、オンボーディングとペイウォールのプレースメントIDがアプリにコンパイルされています。そのため、アプリを更新するまでは既存のオンボーディングやペイウォールが表示されます。SDK v4 の導入率が十分に高まってから、古いプレースメントを廃止してください。

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

SDKのアップデート

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

フローが表示されるのは、SDK v4+ でビルドされたアプリをインストールしたユーザーのみです。古いバージョンのアプリを使用しているユーザーには、引き続き既存のオンボーディングとペイウォールが表示されます。これが、移行期間中に古いプレースメントを稼働させたままにしておく理由です。フローをまだサポートしていないプラットフォームでも同様です。