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

このガイドでは、AIコーディングツールを使ってCapacitorアプリに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 に移動します。CapacitorアプリがiOSとAndroidの両方を対象とする場合は、App StoreとGoogle Playの両方を接続してください。これは購入処理に必須です。 アプリストアを接続する

2. パブリックSDKキーをコピーする: Adapty ダッシュボードで App settings → General に移動し、API keys セクションを確認します。コード上では、これが adapty.activate() に渡す文字列です。

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

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

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 Capacitor SDK

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

Adaptyのドキュメントはプレーンテキストのマークダウンとして取得できます。URLの末尾に .md を追加するか、記事タイトルの下にある Copy for LLM をクリックしてください。例：adapty-cursor-capacitor.md

以下の実装ウォークスルーの各ステージには、貼り付け用の .md リンクが含まれた「LLMに送るもの」ブロックがあります。

一度に複数のドキュメントが必要な場合は、以下のインデックスファイルとプラットフォーム別サブセットを参照してください。

実装ウォークスルー

このガイドの残りでは、実装順序に沿ってAdapty統合を進めていきます。各ステージには、LLMに送るドキュメント、完了時に確認できること、よくある問題が含まれています。

統合を計画する

コードに取り掛かる前に、LLMにプロジェクトを分析して実装計画を立てるよう依頼してください。AIツールが計画モードをサポートしている場合（CursorやClaude Codeのプランモードなど）、LLMがコードを書く前にプロジェクト構造とAdaptyドキュメントの両方を確認できるよう、そのモードを使用してください。

購入処理のアプローチをLLMに伝えてください。これによって参照すべきガイドが変わります：

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

どれを選べばよいかわからない場合は、クイックスタートの比較表を参照してください。

SDKをインストールして設定する

npmでAdapty SDKの依存関係を追加し、パブリックSDKキーで有効化します。これが基盤となるため、これなしでは他の機能は動作しません。

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

LLMに送るもの：

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

ペイウォールを表示して購入を処理する

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

進めながら各購入をサンドボックスでテストしてください — 最後まで待つ必要はありません。セットアップ手順についてはサンドボックスでの購入テストを参照してください。

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

Read these Adapty docs before writing code:
- https://adapty.io/docs/ja/capacitor-quickstart-manual.md
- https://adapty.io/docs/ja/fetch-paywalls-and-products-capacitor.md
- https://adapty.io/docs/ja/present-remote-config-paywalls-capacitor.md
- https://adapty.io/docs/ja/capacitor-making-purchases.md
- https://adapty.io/docs/ja/capacitor-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-capacitor.md
- https://adapty.io/docs/ja/report-transactions-observer-mode-capacitor.md

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

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

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

LLMに送るもの：

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

ユーザーを識別する

アプリのユーザーアカウントをAdaptyプロファイルにリンクし、デバイスをまたいで購入が引き継がれるようにします。

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

LLMに送るもの：

Read these Adapty docs before writing code:
- https://adapty.io/docs/ja/capacitor-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つのファイルにまとめたものです。非常に大きなファイルなので、全体像が必要な場合にのみ使用してください。
• Capacitor専用の capacitor-llms.txt と capacitor-llms-full.txt: サイト全体と比べてトークンを節約できる、プラットフォーム別のサブセットです。