Adaptyでは、フローはオンボーディングとペイウォールをひとつのプレースメントの背後にある単一のエンティティとして組み合わせたものです。フローは、現在それぞれ独立して構築・配信している個別のオンボーディングとペイウォールを置き換えます。

このガイドでは、フローに移行する際に何が変わるのか、そして古いバージョンのアプリを使用しているユーザーへの影響を最小限に抑えながら変更を展開する方法を説明します。

フロー vs. オンボーディングとペイウォール

個別のオンボーディングとペイウォールを使う場合、2つのビルダーと2つのプレースメントを管理する必要があります。また、オンボーディングからペイウォールへのユーザーの受け渡しも自分のコードで行う必要があります。

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

以下の表で各オプションの違いを比較します：

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

移行すべきか？

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

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

移行方法

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

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

フローを構築する

Flows ページで Create flow をクリックしてビルダーを起動し、オンボーディングとペイウォールをひとつの体験として再構築します。ビルダーの詳細については以下を参照してください：

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

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

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

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

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

新しいフロープレースメントには、まったく新しい固有のプレースメントIDを付与してください。 既存のペイウォールまたはオンボーディングのプレースメントIDと同じものや、再利用したものは使用できません。

すべての場所を一度にフローに移行する必要はありません。iOS SDK v4では、getFlow メソッドがフロープレースメントとペイウォールプレースメントの両方からフェッチするため、アプリはどこでも同じメソッドを呼び出せます。ペイウォールビルダーのペイウォールを使いたいプレースメントはそのままにして、それ以外にフローを使いましょう。

移行期間中、各プレースメントタイプは独自の指標を追跡します。古いバージョンと新しいバージョンのアプリが両方稼働している間、データは2セットのプレースメントに分かれます。古いオンボーディングとペイウォールのプレースメントが古いバージョンをカバーし、新しいフロープレースメントがSDK v4以降をカバーします。これらは別々のコホートとして比較し、ユーザーがアップデートするにつれてフロープレースメントのシェアが増加することを想定してください。

フローを使ったA/Bテストも引き続き実施できます：フロープレースメント上のフローバリアント間で通常のA/Bテストを実行できます。クロスプレースメントのA/Bテストは現在ペイウォールのみ利用可能なため、フロープレースメント間では実行できません。新しいフローと古いペイウォールの比較は、単一のテストではなくコホート比較になります — それらは異なるプレースメントタイプに存在するためです。

SDKをアップデートする

フロープレースメントの準備ができたら、アプリをそこに向けます。フローはAdapty SDK v4以降でのみレンダリングされます。SDKをアップグレードし、getFlow(placementId:) を使って新しいプレースメントからフローをフェッチします。具体的なアップグレード手順については iOS SDK v4 移行ガイドを参照してください。

フローを組み込んだら、他の購入フローと同様に検証します：デバイスまたはシミュレーターで実行し、サンドボックス購入を行って、プロダクト、購入処理、アクセスレベルがすべて正常に動作することを確認してください。