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 アプリが両方のプラットフォームを対象とする場合は、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.getFlow() に渡す文字列です。 ペイウォールを作成する

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サーバーです。何を質問するかに応じて、LLMが自動的に適切なドキュメントを取得するため、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: サイト全体と比べてトークンを節約できるプラットフォーム固有のサブセットです。