プレースメント

プレースメントとは、Adaptyのコンテンツを挿入するアプリ内のポイントです。アプリ起動時、プレミアム機能の前、設定画面など、任意の場所でプレースメントを呼び出せます。

プレースメントには3種類のタイプがあります。そのうち2つは新しい用途向けです：

• フロープレースメントはフローを提供します。フロー & ペイウォールビルダーで作成した1画面または複数画面のシーケンスです。フローはオンボーディング、ペイウォール、またはペイウォールで終わるオンボーディングになります。画面を自分でビルドする場合は、ペイウォールプレースメントを使用してください。
• ペイウォールプレースメントはペイウォール（ダッシュボードで作成するプロダクト設定）を、自分でビルドした画面に渡します。

3つ目のタイプであるオンボーディングプレースメントは、旧来のオンボーディングビルダーからオンボーディングを提供します。Adapty はそのビルダーを 2026 年 10 月 1 日に廃止予定のため、新しいオンボーディングはフローとして作成してください。

ルールと注意事項

• プレースメントのタイプは作成時に固定されます。各タイプにはそれぞれ固有の指標セットがあるためです。
• プレースメント ID はアプリ全体で一意です。同じ ID をあるプレースメントでフローに、別のプレースメントでペイウォールに使うことはできません。
• 手動実装のペイウォールとフローは同一の A/B テストを共有できません。それぞれ専用のプレースメントタイプが必要なためです。両者を比較するには、フロー専用のプレースメントでフローを段階的にロールアウトし、それぞれの結果を比較してください。
• ペイウォールプレースメントをフローに移行するには、新しい ID で新しいフロープレースメントを作成し、それを呼び出すアプリリリースを行ってください。詳しくはフローへの移行を参照してください。
• アプリにハードコードするのはプレースメント ID だけです。 それ以外のすべて（どのフローやペイウォールを配信するか、オーディエンスのセグメンテーション、A/B テスト）はダッシュボードからアプリのリリースなしで制御できます。
• プレースメント ID はダッシュボードの ID と完全に一致している必要があります。 余分な空白が入らないようにコピーしてください。ID が一致しない場合、SDK のリクエストは失敗し、ローカルのフォールバックファイルが設定されている場合はそちらが使用されます。
• 旧ペイウォールビルダーのみ — Show on device をオフにしても、ペイウォールはプレースメントから削除されません。プレースメントはビルダーの設定なしでそのペイウォールを解決するため、アプリに表示するものがなくなります。ペイウォールの表示を停止するには、プレースメントのオーディエンスからそのペイウォールを削除してください。

プレースメント一覧

すべてのプレースメントを確認するには、Adapty のメインメニューから Placements に移動します。プレースメントは Paywalls、Onboardings、Flows の種類別に表示されます。

各タブには、フロー・ペイウォール・オンボーディング・A/B テストが表示されるユーザージャーニー上のさまざまな場所が一覧表示されます。リストの各アイテムは特定のプレースメントに対応しており、簡単に管理・編集できます。

プレースメントの詳細を編集したり、特定のオーディエンス向けに希望のフロー、ペイウォール、オンボーディング、またはA/B テストと関連付けたり、不要なプレースメントを削除したりできます。テーブル内の数値は、各プレースメントが有効化されてからの分析データを反映しています。

ここからできること：

• 新しいプレースメントを作成する
• 既存のプレースメントを編集する
• 既存のプレースメントを削除する
• ローカルフォールバックのフロー、ペイウォール、またはオンボーディングをダウンロードする。これらのファイルは、ユーザーがアプリを開いた際に Adapty バックエンドへの接続がない場合（インターネット未接続、またはバックエンド障害の稀なケース）かつデバイスにキャッシュがない場合に使用されます。Fallbacks のダウンロードはフローとペイウォールの両方をカバーしており、ダウンロードダイアログで選択する SDK バージョンによって、バンドルにフロー（SDK 4.0 以降）が含まれるか、ペイウォールのみが含まれるかが決まります。