---
title: "フローへの移行"
description: "別々のオンボーディングとペイウォールをひとつのAdaptyフローにまとめる方法 — 変わること、そして古いバージョンのユーザーへの影響なくリリースする方法を説明します。"
---

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

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

:::important
フローは現在 iOS SDK v4 以降でサポートされています。他のプラットフォームやフレームワークへのサポートは近日公開予定です。
:::

## フロー vs. オンボーディングとペイウォール \{#flows-vs-onboardings-and-paywalls\}

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

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

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

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

## 移行すべきか？ \{#should-you-migrate\}

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

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

## 移行方法 \{#how-to-migrate\}

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

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

### フローを構築する \{#build-your-flow\}

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

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

:::note
既製のフローテンプレートからフローを作成したり、AIで生成したりする機能はまだ利用できません — どちらも近日公開予定です。現在は、すべての新しいフローがよく使われる複数の画面からスタートし、それをニーズに合わせて編集・スタイリングできます。
:::

### デバイスでプレビューする \{#preview-on-device\}

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

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

### フロー用の新しいプレースメントを作成する \{#create-a-new-placement-for-your-flow\}

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

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

:::warning
移行期間中は古いプレースメントをそのままにしておく

古いバージョンのアプリには、オンボーディングとペイウォールのプレースメントIDがコンパイルされています。そのユーザーたちはオンボーディングとペイウォールのメソッドを引き続き呼び出し、アップデートするまで既存のオンボーディングとペイウォールを表示します。SDK v4の採用率が十分に高くなってから、古いプレースメントを廃止してください。
:::

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

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

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

### SDKをアップデートする \{#update-the-sdk\}

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

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

:::note
フローはSDK v4以降でビルドされたアプリをインストールしたユーザーにのみ表示されます。古いバージョンのアプリを使っているユーザーは引き続き既存のオンボーディングとペイウォールを受け取ります。これが移行期間中に古いプレースメントを維持し続ける理由です。フローをまだサポートしていないプラットフォームでも同様です。
:::