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

AI アシスタントを使っていますか？LLM が CLI を操作しやすくなる Adapty CLI スキル が利用できます。

Adapty CLI を使うと、アプリの設定をすべてコマンドラインから行えます。ターミナル作業を好む方や MCP クライアントを使う方向けに、ダッシュボードのクイックスタートの代替手段として活用できます。

App Store Connect や Google Play への接続は、ダッシュボードでの一度きりのセットアップが必要です — 手順 3 で説明します。

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

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 つで十分です。

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

次の手順に進む前に、Adapty ダッシュボードでアプリを App Store Connect および Google Play に接続してください。手順 5 では両ストアのプロダクト 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> として使用してください。

ここでリンクするストアのプロダクト ID（--ios-product-id、--android-product-id）は作成後に変更できません。別のストアプロダクト ID を使用する場合は、新しいプロダクトを作成してください。

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

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

ペイウォールはプロダクトを格納するコンテナです。Adapty では、ペイウォールがユーザーにプロダクトを届ける唯一の方法です。すべてのプロダクトは、アプリに表示される前にペイウォールに含まれている必要があります。

ペイウォールがプレースメントにリンクされると、そのプロダクトは変更できません。別のプロダクトを使用するには、新しいペイウォールを作成してプレースメントがそちらを参照するように更新してください。

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

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

プレースメントは、アプリ内でペイウォールを表示する場所を指します。アプリコードにハードコードするのはプレースメント ID だけです。どのペイウォールをどのユーザーに表示するかといった設定はすべて、新しいアプリバージョンをリリースすることなくダッシュボードから管理できます。

--developer-id は、後でアプリコードからこの場所に表示するペイウォールを Adapty に問い合わせる際に参照する文字列です。場所を表すわかりやすい名前（例："main"、"onboarding"、"settings"）を指定してください。

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

--audiences フラグは、どのユーザーにどのペイウォールを表示するかを制御します。上の例では単一のデフォルトオーディエンスを設定しており、このプレースメントのすべてのユーザーに同じペイウォールが表示されます。

次のステップ

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