フローへの移行

Adaptyでは、フローはオンボーディングとペイウォールをひとつのエンティティとしてまとめ、単一のプレースメントで配信します。フローは、個別に構築・配信していたオンボーディングとペイウォールを置き換えるものです。

このガイドでは、フローへ移行する際の変更点と、古いバージョンのアプリのユーザーに影響を与えずに移行を進める方法を説明します。

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

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

フローはこの両方を1つの体験に統合します。イントロ画面、クイズ、購入画面を1つのエディターで作成し、1つのプレースメントから配信できます。このプレースメントは新しいものです。フローは独自のコンテンツタイプなので、置き換えるオンボーディングやペイウォールのプレースメントでは動作しません。

以下の表で、各オプションの比較をご確認ください。

移行すべきかどうか

長期的な視点で開発するなら、フローの方が優れた基盤になります — リリーススケジュールに合わせたタイミングで移行しましょう。

移行方法

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

1. フローを作成する: 既存のペイウォールをワンクリックで変換するか、テンプレートからフローを作成します。開発者不要。
2. デバイスでプレビューする: Adapty モバイルアプリを使って実機でフローを確認します。アプリのビルド不要。
3. フロー用の新しいプレースメントを作成する: 固有の ID を持つ新しいフロープレースメントを作成し、既存のプレースメントとの共存方法を決定します。
4. SDK を更新する: Adapty SDK v4 にアップグレードし、プレースメントからフローを取得して、サンドボックス購入を検証します。これが主な開発者の作業です。

フローを作成する

ペイウォールがレガシーペイウォールビルダーで作成されている場合は、作り直すのではなく変換してください。 Move to new builder アクションを使えば、レイアウト・各ロケールのコピー・価格を変数として設定したプロダクト一式を含む下書きフローをワンクリックで再作成できます。元のペイウォールは編集・テスト中もそのまま公開された状態を維持します。詳しくはペイウォールをフローに変換するをご覧ください。

新しいものを一から作成する場合は、目的に合ったルートを選んでください。

• テンプレートから始める：スターターテンプレートまたはフローを空白から作成できます。コード不要です。
• エージェントスキルを使う：AI コーディングツールがターミナルからフローを作成・編集します。クイズ、分岐、ロケールの一括追加に便利です。

構築時のリファレンス：

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

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

アプリに手を加えることなく、実際のデバイスでフローをプレビューできます。Adapty モバイルアプリを iOS または Android 向けにダウンロードしてください。その後、フロービルダーで Test on device をクリックし、ロケールを選択して、デバイスで QR コードをスキャンします。実際の画面、分岐、コピー、デザインを確認できます。

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

フロー、ペイウォール、オンボーディングはそれぞれ異なるコンテンツタイプであり、それぞれ独自の指標セットで計測されます。そのため、プレースメントは1つのタイプのみに対応します。プレースメントのタイプは作成時に固定されるため、既存のオンボーディングやペイウォールのプレースメントをフローのプレースメントに変換する方法はありません（プレースメントタイプを参照）。配信するフローごとに、専用の新しいプレースメントが必要です。

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

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

SDKを更新する

フロープレースメントの準備ができたら、アプリをそこに向けます。フローはAdapty SDK v4以降でのみレンダリングされます。SDKをアップグレードして、新しいプレースメントからgetFlowでフローを取得してください。具体的なアップグレード手順については、各プラットフォームのv4移行ガイド — iOS、Android、React Native、Flutter、Unity、Kotlin Multiplatform、Capacitor — を参照してください。

フローの接続が完了したら、通常の購入フローと同様に動作確認を行います。実機またはシミュレーターで実行し、サンドボックス購入を行って、プロダクト・購入・アクセスレベルがすべて正しく機能することを確認してください。各プラットフォームのテストガイドをご参照ください: iOS、Android、React Native、Flutter、Unity、Kotlin Multiplatform、Capacitor。