Adapty Developer CLI クイックスタートガイド

Adapty CLI を使うと、アプリの設定をすべてコマンドラインから行えます。ターミナルツールや MCP クライアントを好む方は、ダッシュボードのクイックスタートの代わりにお使いください。

完了すると、アプリ、アクセスレベル、プロダクト、フローまたはペイウォール、プレースメントがすべて Adapty ダッシュボードに表示されます。

Claude Cowork で CLI を実行する場合は、まず Claude でセットアップしてください — Claude Cowork で Adapty CLI をセットアップするを参照してください。

1. CLI をインストールする

Node.js 18 以降が必要です。

CLI をインストールするには、次のコマンドを実行します：

npm install -g adapty

または、直接実行する場合：

npx adapty auth login

2. 認証する

ログインコマンドを実行して、CLI を Adapty アカウントに接続します。

adapty auth login

CLI がブラウザタブを開きます。ターミナルに表示されたコードとブラウザに表示されたコードが一致していることを確認し、Authorize をクリックします。認証が完了するとターミナルに確認メッセージが表示されます。

3. アプリを作成する

Adapty のアプリはモバイルアプリケーションを表します。1 つの Adapty アプリが App Store と Google Play の両方に接続されるため、公開するストアの数に関わらず、作成するのは 1 つで十分です。

adapty apps create --title "My App" --platform ios --platform android --apple-bundle-id com.example.app --google-bundle-id com.example.app

adapty apps create --title "My App" --platform ios --apple-bundle-id com.example.app

adapty apps create --title "My App" --platform android --google-bundle-id com.example.app

このコマンドは <app-id> を返します。以降のコマンドではすべてこの ID を使用します。

4. アクセスレベルを作成する（任意）

アクセスレベルは、購入後にユーザーがアクセスできる内容を管理します。特定のプロダクトを購入したかどうかを確認する代わりに、アプリはユーザーが特定のアクセスレベルを持っているかどうかを確認します。これにより、アプリのロジックを特定のプロダクト ID から切り離すことができます。

premium アクセスレベルは新しいアプリとともに自動的に作成されます。ほとんどのアプリではこの手順はスキップできます。 手順 5 ではアクセスレベル ID として premium を使用してください。

異なるプロダクトが異なるユーザーグループの異なる機能をアンロックする場合 — たとえば「Basic」サブスクライバーと「Pro」サブスクライバーがアプリの異なる部分にアクセスできる場合 — にのみ、このコマンドを実行してください。

adapty access-levels create --app <app-id> --sdk-id "pro" --title "Pro"

• --sdk-id はアプリコード内でユーザーがその機能を利用できるかどうかを確認するために使う識別子です（例：if user.hasAccessLevel("pro")）。この手順をスキップしてデフォルトのアクセスレベルを使う場合、その --sdk-id は premium です。
• --title は Adapty ダッシュボードでの参照用に表示されるラベルです。

このコマンドは <access-level-id> を返します。

5. プロダクトを作成する

Adapty におけるプロダクトは、アプリが販売するもの — サブスクリプションや買い切り購入 — を表します。App Store Connect と Google Play のアイテムを 1 つの Adapty プロダクトにまとめて、一元管理できます。

各ストアのプロダクト ID が必要です：App Store Connect の Apple プロダクト ID、および Google Play Console の Android プロダクト ID とベースプラン ID。確認方法の詳細はプロダクトを参照してください。

ステップ4をスキップした場合は、ステップ3の apps create コマンドで返された default_access_level.id を <access-level-id> として使用してください。

adapty products create --app <app-id> --title "My Product" --access-level-id <access-level-id> --period monthly --ios-product-id <your.apple.id> --android-product-id <your.google.id> --android-base-plan-id <your.base-plan.id>

adapty products create --app <app-id> --title "My Product" --access-level-id <access-level-id> --period monthly --ios-product-id <your.apple.id>

adapty products create --app <app-id> --title "My Product" --access-level-id <access-level-id> --period monthly --android-product-id <your.google.id> --android-base-plan-id <your.base-plan.id>

コマンドは <product-id> を返します。

このプロダクトをStripeまたはPaddleを通じてウェブでも販売する場合は、同じコマンドにそれらのIDを追加してください。コマンドリファレンスの products create を参照してください。

6. フローまたはペイウォールを作成する

すべてのプロダクトは、アプリに表示される前にフローまたはペイウォールに含まれている必要があります。どちらか一方を選んでください。

• フローとは、ノーコードのフロー＆ペイウォールビルダーでデザインし、Adapty SDKがネイティブにレンダリングする1つまたは複数の画面のことです。ペイウォール画面、オンボーディング、クイズなどが含まれます。購入画面のレンダリングをAdaptyに任せたい場合はフローを選択してください。フローにはAdapty SDK 4.0以降が必要です。
• ペイウォールとは、デザインが紐付いていないプロダクトの集合です。購入画面を自分のアプリコードでレンダリングし、Adaptyにはプロダクトの配信のみ（オプションでリモートコンフィグも）を担当させたい場合はペイウォールを選択してください。

プレースメントは1つのコンテンツタイプを提供するため、ステップ7の前に決定してください。

6a. フローを作成する

CLIはフローレコードを作成します。フローのスクリーンはビルダーコンフィグ（CLIが生成しないJSONドキュメント）に格納されます。ターミナルからコンフィグを作成するには、CLIを代わりに操作してくれるflow-generatorスキルを使用してください。

フローを作成します：

adapty flows create --app <app-id> --name "Onboarding"

コマンドは <flow-id> を返します。

スクリーンはflow-generatorスキルまたはFlow & Paywall Builderでビルドします。どちらの方法でも、ユーザーにはまだ表示されない保存済みドラフトが作成されます。

フローを公開します:

adapty flows publish --app <app-id> <flow-id>

コマンドを実行すると確認を求められます。公開はバックグラウンドで行われるため、adapty flows get --app <app-id> <flow-id> でステータスが published になるまで確認してください。publication_failed の場合は、flows config get で原因を確認できます。プレースメントには公開済みのフローのみ設定できます。

6b. ペイウォールを作成する

ペイウォールは、プロダクトを保持するコンテナです。

adapty paywalls create --app <app-id> --title "My Paywall" --product-id <product-id>

adapty paywalls create --app <app-id> --title "My Paywall" --product-id <product-id-1> --product-id <product-id-2>

コマンドは <paywall-id> を返します。

7. プレースメントを作成する

プレースメントとは、アプリ内でフローやペイウォールを表示するポイントのことです。アプリのコードにハードコードするのはプレースメント ID だけです。どのフローやペイウォールをどのユーザーに表示するかは、新しいアプリバージョンをリリースすることなくダッシュボードで管理できます。

--developer-id は、Adapty にこのポイントで何を表示するかを問い合わせる際にアプリのコードで参照する文字列です。"main"、"onboarding"、"settings" のように、場所を説明する名前を付けましょう。

adapty placements create --app <app-id> --title "Onboarding" --developer-id "onboarding" --audiences '[{"content_type":"flow","segment_ids":[],"flow_id":"<flow-id>","priority":0}]'

adapty placements create --app <app-id> --title "Main" --developer-id "main" --audiences '[{"content_type":"paywall","segment_ids":[],"paywall_id":"<paywall-id>","priority":0}]'

--audiences フラグは、どのフローまたはペイウォールをどのユーザーに表示するかを制御します。上記の例では、単一のデフォルトオーディエンスを設定しています。つまり、このプレースメントにアクセスするすべてのユーザーが同じコンテンツを見ます。プレースメントが提供できるコンテンツタイプは1種類のみであるため、すべてのオーディエンスエントリに同じ content_type を指定する必要があります。セグメントによるターゲティングについては、コマンドリファレンスのオーディエンスの形状を参照してください。

次のステップ

すべてのエンティティが Adapty ダッシュボード に表示されるようになりました。次のステップ：

• フローを後から変更する — フロージェネレータースキルに変更内容を伝えるか、フロー＆ペイウォールビルダーでフローを開いてください。
• アプリでペイウォールを表示する — SDK でペイウォールとプロダクトを取得し、独自のコードで画面を構築してください。
• Adapty SDK を統合する — SDK をアプリに追加して、プレースメントを取得・表示できるようにします。
• 異なるセグメントのユーザーを異なるフローやペイウォールにルーティングする — コマンドリファレンスの placements update と segments list を参照してください。