AIアシスタンスを使ってAdaptyをKotlin Multiplatformアプリに統合する

このガイドでは、AIコーディングツールを使いながら、Kotlin MultiplatformアプリへのAdapty統合をステップバイステップで進めます。適切なAdaptyドキュメントを正しい順番でAIに渡していくことがポイントです。

はじめる前に：ダッシュボードの設定

AdaptyのSDKコードを書く前に、ダッシュボードでいくつかの設定が必要です。インタラクティブなLLMスキルを使う方法と、ダッシュボードから手動で行う方法があります。

スキルを使う方法（推奨）

Adapty CLIスキルを使うと、アプリ、プロダクト、アクセスレベル、ペイウォール、プレースメントの設定をLLMから直接行えます。ダッシュボードを都度開く必要がありません。必要なのは、ダッシュボードでストアを接続することだけです。

npx skills add adaptyteam/adapty-cli --skill adapty-cli

スキルを追加したら、エージェントで /adapty-cli を実行してください。各ステップを順番にガイドしてくれます。ストアの接続が必要なタイミングでは、ダッシュボードを開くよう案内されます。

ダッシュボードを使う方法

すべて手動で設定したい場合は、コードを書く前に以下の手順を完了してください。ダッシュボードの値はLLMが自動で取得することはできないため、自分で用意する必要があります。

1. アプリストアを接続する: Adapty ダッシュボードで App settings → General に移動し、KMPアプリがApp StoreとGoogle Play両方を対象とする場合は両方接続してください。これは購入機能を動作させるために必要です。 アプリストアを接続する

2. Public SDK keyをコピーする: Adapty ダッシュボードで App settings → General に移動し、API keys セクションを確認してください。コード上では、Adaptyの設定ビルダーに渡す文字列です。

3. プロダクトを少なくとも1つ作成する: Adapty ダッシュボードの Products ページで作成してください。コードからプロダクトを直接参照することはなく、Adaptyはペイウォール経由でプロダクトを配信します。 プロダクトを追加する

4. ペイウォールとプレースメントを作成する: Adapty ダッシュボードの Paywalls ページでペイウォールを作成し、Placements ページでプレースメントに割り当ててください。コード上では、Adapty.getPaywall("YOUR_PLACEMENT_ID") に渡す文字列がプレースメントIDです。 ペイウォールを作成する

5. アクセスレベルを設定する: Adapty ダッシュボードの Products ページで各プロダクトに対して設定してください。コード上では profile.accessLevels["premium"]?.isActive で確認する文字列です。デフォルトの premium アクセスレベルはほとんどのアプリで使えます。プロダクトによってアクセスできる機能が異なる場合（例: basic プランと pro プラン）は、コーディングを始める前に追加のアクセスレベルを作成してください。

準備が整ったら設定するもの

コーディングを始めるのに必須ではありませんが、統合が進むにつれて必要になるものです：

• A/B テスト: Placements ページで設定できます。コードの変更は不要です。 A/B テスト
• 追加のペイウォールとプレースメント: 異なるプレースメントIDを使って getPaywall の呼び出しを追加してください。
• アナリティクス連携: Integrations ページで設定します。連携方法は各サービスによって異なります。アナリティクス連携とアトリビューション連携を参照してください。

AdaptyドキュメントをLLMに渡す

Context7を使う（推奨）

Context7は、LLMが最新のAdaptyドキュメントに直接アクセスできるMCPサーバーです。質問内容に応じて必要なドキュメントを自動的に取得するため、URLを手動で貼り付ける必要がありません。

Context7は Cursor、Claude Code、Windsurf、その他のMCP対応ツールで利用できます。設定するには次のコマンドを実行してください：

npx ctx7 setup

エディタを自動検出してContext7サーバーを設定します。手動でセットアップする場合はContext7 GitHubリポジトリを参照してください。

設定後は、プロンプトでAdaptyライブラリを参照できます：

Use the adaptyteam/adapty-docs library to look up how to install the Kotlin Multiplatform SDK

プレーンテキストのドキュメントを使う

AdaptyのドキュメントはどれもプレーンテキストのMarkdownで取得できます。URLの末尾に .md を付けるか、記事タイトルの下にある Copy for LLM をクリックしてください。例: adapty-cursor-kmp.md

以下の実装ウォークスルーの各ステップには、「LLMに送る内容」ブロックに .md リンクが含まれています。

まとめて複数のドキュメントを渡したい場合は、下記のインデックスファイルとプラットフォーム別サブセットを参照してください。

実装ウォークスルー

このガイドの残りの部分では、実装順にAdaptyの統合を進めます。各ステップにはLLMに送るドキュメント、完了時の確認事項、よくある問題を記載しています。

統合を計画する

コードを書き始める前に、LLMにプロジェクトを分析させて実装計画を立てましょう。AIツールにプランニングモードがある場合（CursorやClaude Codeのプランモードなど）、それを使うことでLLMがプロジェクト構造とAdaptyドキュメントの両方を読んでからコードを書いてくれます。

購入の実装方法をLLMに伝えてください。選択によって参照すべきガイドが変わります：

• Adapty ペイウォールビルダー: Adaptyのノーコードビルダーでペイウォールを作成し、SDKが自動的にレンダリングします。
• 手動作成のペイウォール: 自分でペイウォールUIをコードで作成しますが、プロダクトの取得と購入処理にはAdaptyを使います。
• オブザーバーモード: 既存の購入インフラをそのまま使い、Adaptyはアナリティクスと連携のみに使います。

どれを選べばいいか迷ったら、クイックスタートの比較表を参照してください。

SDKのインストールと設定

GradleでAdapty SDKの依存関係を追加し、Public SDK keyで有効化してください。これがすべての基盤になります。

ガイド: Adapty SDKのインストールと設定

LLMに送る内容：

Read these Adapty docs before writing code:
- https://adapty.io/docs/ja/sdk-installation-kotlin-multiplatform.md

ペイウォールの表示と購入処理

プレースメントIDでペイウォールを取得し、表示して、購入イベントを処理します。必要なガイドは購入の実装方法によって異なります。

進めながら都度サンドボックスで購入をテストしてください。最後まで待たないようにしましょう。設定方法はサンドボックスでの購入テストを参照してください。

Read these Adapty docs before writing code:
- https://adapty.io/docs/ja/kmp-quickstart-paywalls.md
- https://adapty.io/docs/ja/kmp-get-pb-paywalls.md
- https://adapty.io/docs/ja/kmp-present-paywalls.md
- https://adapty.io/docs/ja/kmp-handling-events.md
- https://adapty.io/docs/ja/kmp-handle-paywall-actions.md

Read these Adapty docs before writing code:
- https://adapty.io/docs/ja/kmp-quickstart-manual.md
- https://adapty.io/docs/ja/fetch-paywalls-and-products-kmp.md
- https://adapty.io/docs/ja/present-remote-config-paywalls-kmp.md
- https://adapty.io/docs/ja/kmp-making-purchases.md
- https://adapty.io/docs/ja/kmp-restore-purchase.md

Read these Adapty docs before writing code:
- https://adapty.io/docs/ja/observer-vs-full-mode.md
- https://adapty.io/docs/ja/implement-observer-mode-kmp.md
- https://adapty.io/docs/ja/report-transactions-observer-mode-kmp.md

サブスクリプションのステータスを確認する

購入後、ユーザープロファイルのアクティブなアクセスレベルを確認してプレミアムコンテンツを制限します。

ガイド: サブスクリプションのステータスを確認する

LLMに送る内容：

Read these Adapty docs before writing code:
- https://adapty.io/docs/ja/kmp-check-subscription-status.md

ユーザーを識別する

アプリのユーザーアカウントをAdaptyプロファイルに紐付けて、デバイスをまたいで購入情報を引き継げるようにします。

ガイド: ユーザーを識別する

LLMに送る内容：

Read these Adapty docs before writing code:
- https://adapty.io/docs/ja/kmp-quickstart-identify.md

リリースの準備をする

サンドボックスで統合の動作確認ができたら、リリースチェックリストを確認してすべて本番環境に対応しているか確認しましょう。

ガイド: リリースチェックリスト

LLMに送る内容：

Read these Adapty docs before releasing:
- https://adapty.io/docs/ja/release-checklist.md

プレーンテキストのドキュメントインデックスファイル

個別のページを超えてLLMにより広いコンテキストを提供したい場合は、Adaptyのすべてのドキュメントをリスト化または統合したインデックスファイルを用意しています：

• llms.txt: すべてのページを .md リンク付きでリスト化しています。LLMがウェブサイトにアクセスしやすくするための新たな標準です。一部のAIエージェント（ChatGPTなど）では、llms.txt をダウンロードしてチャットにファイルとしてアップロードする必要があります。
• llms-full.txt: Adaptyのドキュメントサイト全体を1つのファイルにまとめたものです。非常に大きいため、全体像が必要なときだけ使用してください。
• Kotlin Multiplatform専用の kmp-llms.txt と kmp-llms-full.txt: サイト全体と比べてトークンを節約できるプラットフォーム別サブセットです。