ÿÿ Developer CLI クむックスタヌト | Adapty ドキュメント
English äž­æ–‡TÃŒrkçeРусскОйEspañol日本語Tiếng Việt

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 ダッシュボヌド に衚瀺されるようになりたした。次は

  • ペむりォヌルをデザむンする — ノヌコヌドのペむりォヌルビルダヌを䜿っお、䜜成したペむりォヌルにビゞュアル・レむアりト・コピヌを远加したす。
  • Adapty SDK を組み蟌む — アプリに SDK を远加しお、プレヌスメントを取埗・衚瀺したす。
  • 異なるナヌザヌセグメントを異なるペむりォヌルにルヌティングする — 詳现は完党リファレンスの placements update ず segments list を参照しおください。
ÿÿÿÿ