プレースメント

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

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

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

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

ルールと注意事項

• プレースメントのタイプは作成時に固定されます。 タイプごとに独自の指標セットがあるためです。
• プレースメント ID はアプリ全体で一意です。 同じ ID を、あるところではフローに、別のところではペイウォールに使い回すことはできません。
• カスタムペイウォールとフローは1つの 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 以降）が含まれるか、ペイウォールのみが含まれるかが決まります。