---
title: "AIアシスタンスを使ってUnityアプリにAdaptyを統合する"
description: "Cursor、Context7、ChatGPT、Claude、その他のAIツールを使用して、UnityアプリにAdaptyを統合するためのステップバイステップガイド。"
---

このガイドでは、AIコーディングツールを使ってUnityアプリにAdaptyを段階的に統合する手順を説明します。適切なAdaptyドキュメントを正しい順序でAIに提供することがポイントです。

For a fully automated integration, use the [adapty-sdk-integration skill](https://github.com/adaptyteam/adapty-sdk-integration-skill): it runs the whole integration from your AI coding tool in one command.

## 始める前に：ダッシュボードの設定 \{#before-you-start-dashboard-setup\}

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

### スキルを使うアプローチ（推奨） \{#skill-approach-recommended\}

Adapty CLIスキルを使うと、LLMがアプリ、プロダクト、アクセスレベル、ペイウォール、プレースメントを直接設定できます。ダッシュボードを都度開く必要がなく、[ストアの接続](integrate-payments)だけダッシュボードで行えば大丈夫です。

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

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

### ダッシュボードを使うアプローチ \{#dashboard-approach\}

すべてを手動で設定したい場合は、コードを書く前に以下の準備が必要です。ダッシュボードの値はLLMが調べることができないため、ご自身で用意してください。

1. **アプリストアを接続する**: Adapty ダッシュボードで **App settings → General** に移動し、UnityアプリがiOSとAndroid両方を対象としている場合はApp StoreとGoogle Playの両方を接続してください。購入機能を動作させるために必須です。
   [アプリストアを接続する](integrate-payments)

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

3. **プロダクトを少なくとも1つ作成する**: Adapty ダッシュボードで **Products** ページに移動してください。プロダクトはコードから直接参照しません。Adaptyはペイウォールを通じてプロダクトを配信します。
   [プロダクトを追加する](quickstart-products)

4. **ペイウォールとプレースメントを作成する**: Adapty ダッシュボードの **Paywalls** ページでペイウォールを作成し、**Placements** ページでプレースメントに割り当てます。コードでは、プレースメントIDが `Adapty.GetPaywall("YOUR_PLACEMENT_ID")` に渡す文字列になります。
   [ペイウォールを作成する](quickstart-paywalls)

5. **アクセスレベルを設定する**: Adapty ダッシュボードの **Products** ページでプロダクトごとに設定します。コードでは `profile.AccessLevels["premium"]?.IsActive` で確認する文字列です。デフォルトの `premium` アクセスレベルはほとんどのアプリで機能します。プロダクトによって異なる機能へのアクセス権を付与する場合（例：`basic` プランと `pro` プラン）は、コーディングを始める前に[追加のアクセスレベルを作成](assigning-access-level-to-a-product)してください。

:::tip
5つすべて揃ったら、コードを書く準備完了です。LLMに「Public SDKキーはX、プレースメントIDはY」と伝えると、正確な初期化コードとペイウォール取得コードを生成してもらえます。
:::

### 準備ができたら設定する \{#set-up-when-ready\}

コーディングを始めるにあたって必須ではありませんが、統合が成熟するにつれて必要になります：

- **A/B テスト**: **Placements** ページで設定します。コードの変更は不要です。
  [A/B テスト](ab-tests)
- **追加のペイウォールとプレースメント**: 異なるプレースメントIDで `GetPaywall` の呼び出しを追加します。
- **アナリティクス統合**: **Integrations** ページで設定します。統合によって設定方法が異なります。[アナリティクス統合](analytics-integration)と[アトリビューション統合](attribution-integration)を参照してください。

## AdaptyドキュメントをLLMに提供する \{#feed-adapty-docs-to-your-llm\}

### Context7を使う（推奨） \{#use-context7-recommended\}

[Context7](https://context7.com)は、LLMが最新のAdaptyドキュメントに直接アクセスできるMCPサーバーです。質問の内容に基づいて適切なドキュメントを自動的に取得するため、URLを手動で貼り付ける必要がありません。

Context7は**Cursor**、**Claude Code**、**Windsurf**、その他のMCP対応ツールで使用できます。セットアップするには以下を実行してください：

```
npx ctx7 setup
```

エディタを自動検出してContext7サーバーを設定します。手動設定については[Context7 GitHubリポジトリ](https://github.com/upstash/context7)を参照してください。

設定が完了したら、プロンプトでAdaptyライブラリを参照してください：

```
Use the adaptyteam/adapty-docs library to look up how to install the Unity SDK
```

:::warning
Context7を使うとドキュメントのリンクを手動で貼り付ける必要がなくなりますが、実装の順序は重要です。すべてが正しく動作するよう、以下の[実装ウォークスルー](#implementation-walkthrough)をステップ順に進めてください。
:::

### プレーンテキストのドキュメントを使う \{#use-plain-text-docs\}

AdaptyのドキュメントはプレーンテキストのMarkdownとしてアクセスできます。URLの末尾に `.md` を追加するか、記事タイトルの下にある **Copy for LLM** をクリックしてください。例：[adapty-cursor-unity.md](https://adapty.io/docs/ja/adapty-cursor-unity.md)。

以下の[実装ウォークスルー](#implementation-walkthrough)の各ステージには、貼り付け用の `.md` リンクを含む「LLMに送信するもの」ブロックが含まれています。

より多くのドキュメントが必要な場合は、以下の[インデックスファイルとプラットフォーム別サブセット](#plain-text-doc-index-files)を参照してください。

## 実装ウォークスルー \{#implementation-walkthrough\}

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

### 統合の計画を立てる \{#plan-your-integration\}

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

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

- [**Adapty ペイウォールビルダー**](adapty-paywall-builder): Adaptyのノーコードビルダーでペイウォールを作成し、SDKが自動的にレンダリングします。
- [**手動で作成したペイウォール**](unity-making-purchases): コードで独自のペイウォールUIを構築しますが、プロダクトの取得と購入処理にはAdaptyを使用します。
- [**オブザーバーモード**](observer-vs-full-mode): 既存の購入インフラを維持し、アナリティクスと統合のみにAdaptyを使用します。

どれを選べばいいか迷っていますか？[クイックスタートの比較表](unity-quickstart-paywalls)を読んでください。

### SDKをインストールして設定する \{#install-and-configure-the-sdk\}

Unity Package ManagerでAdapty SDKパッケージを追加し、Public SDKキーで有効化します。これが基盤となり、他のすべての機能はこれなしでは動作しません。

**ガイド:** [Adapty SDKをインストールして設定する](sdk-installation-unity)

LLMに送信するもの：
```
Read these Adapty docs before writing code:
- https://adapty.io/docs/ja/sdk-installation-unity.md
```

:::tip[チェックポイント]
- **期待される結果:** プロジェクトがビルドされ実行されます。UnityコンソールにAdaptyのアクティベーションログが表示されます。
- **注意点:** 「Public API key is missing」→ プレースホルダーをApp settingsの実際のキーに置き換えたか確認してください。
:::

### ペイウォールを表示して購入を処理する \{#show-paywalls-and-handle-purchases\}

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

進めながらサンドボックスで各購入をテストしてください。最後まで待たないようにしましょう。設定手順については[サンドボックスで購入をテストする](test-purchases-in-sandbox)を参照してください。

<Tabs groupId="paywall-approach">

<TabItem value="builder" label="Paywall Builder" default>

**ガイド:**
- [ペイウォールを使って購入を有効にする（クイックスタート）](unity-quickstart-paywalls)
- [ペイウォールビルダーのペイウォールと設定を取得する](unity-get-pb-paywalls)
- [ペイウォールを表示する](unity-present-paywalls)
- [ペイウォールイベントを処理する](unity-handling-events)
- [ボタンアクションに応答する](unity-handle-paywall-actions)

LLMに送信するもの：
```
Read these Adapty docs before writing code:
- https://adapty.io/docs/ja/unity-quickstart-paywalls.md
- https://adapty.io/docs/ja/unity-get-pb-paywalls.md
- https://adapty.io/docs/ja/unity-present-paywalls.md
- https://adapty.io/docs/ja/unity-handling-events.md
- https://adapty.io/docs/ja/unity-handle-paywall-actions.md
```

:::tip[チェックポイント]
- **期待される結果:** 設定したプロダクトとともにペイウォールが表示されます。プロダクトをタップするとサンドボックスの購入ダイアログが表示されます。
- **注意点:** ペイウォールが空または `GetPaywall` エラー → プレースメントIDがダッシュボードと完全に一致しているか、またプレースメントにオーディエンスが割り当てられているか確認してください。
:::

</TabItem>

<TabItem value="manual" label="Manual paywalls">

**ガイド:**
- [カスタムペイウォールで購入を有効にする（クイックスタート）](unity-quickstart-manual)
- [ペイウォールとプロダクトを取得する](fetch-paywalls-and-products-unity)
- [リモートコンフィグで設計されたペイウォールをレンダリングする](present-remote-config-paywalls-unity)
- [購入を行う](unity-making-purchases)
- [購入を復元する](unity-restore-purchase)

LLMに送信するもの：
```
Read these Adapty docs before writing code:
- https://adapty.io/docs/ja/unity-quickstart-manual.md
- https://adapty.io/docs/ja/fetch-paywalls-and-products-unity.md
- https://adapty.io/docs/ja/present-remote-config-paywalls-unity.md
- https://adapty.io/docs/ja/unity-making-purchases.md
- https://adapty.io/docs/ja/unity-restore-purchase.md
```

:::tip[チェックポイント]
- **期待される結果:** カスタムペイウォールにAdaptyから取得したプロダクトが表示されます。プロダクトをタップするとサンドボックスの購入ダイアログが表示されます。
- **注意点:** プロダクト配列が空 → ダッシュボードでペイウォールにプロダクトが割り当てられているか、またプレースメントにオーディエンスが設定されているか確認してください。
:::

</TabItem>

<TabItem value="observer" label="Observer mode">

**ガイド:**
- [オブザーバーモードの概要](observer-vs-full-mode)
- [オブザーバーモードを実装する](implement-observer-mode-unity)
- [オブザーバーモードでトランザクションを報告する](report-transactions-observer-mode-unity)

LLMに送信するもの：
```
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-unity.md
- https://adapty.io/docs/ja/report-transactions-observer-mode-unity.md
```

:::tip[チェックポイント]
- **期待される結果:** 既存の購入フローでサンドボックス購入を行った後、Adapty ダッシュボードの **Event Feed** にトランザクションが表示されます。
- **注意点:** イベントが表示されない → トランザクションをAdaptyに報告しているか確認し、両ストアのサーバー通知が設定されているか確認してください。
:::

</TabItem>

</Tabs>

### サブスクリプションのステータスを確認する \{#check-subscription-status\}

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

**ガイド:** [サブスクリプションのステータスを確認する](unity-check-subscription-status)

LLMに送信するもの：
```
Read these Adapty docs before writing code:
- https://adapty.io/docs/ja/unity-check-subscription-status.md
```

:::tip[チェックポイント]
- **期待される結果:** サンドボックスで購入した後、`profile.AccessLevels["premium"]?.IsActive` が `true` を返します。
- **注意点:** 購入後に `AccessLevels` が空 → ダッシュボードでプロダクトにアクセスレベルが割り当てられているか確認してください。
:::

### ユーザーを識別する \{#identify-users\}

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

:::important
アプリに認証機能がない場合はこのステップをスキップしてください。
:::

**ガイド:** [ユーザーを識別する](unity-quickstart-identify)

LLMに送信するもの：
```
Read these Adapty docs before writing code:
- https://adapty.io/docs/ja/unity-quickstart-identify.md
```

:::tip[チェックポイント]
- **期待される結果:** `Adapty.Identify("your-user-id")` を呼び出した後、ダッシュボードの **Profiles** セクションにカスタムユーザーIDが表示されます。
- **注意点:** 匿名プロファイルのアトリビューションを防ぐため、`Identify` はアクティベーション後、ペイウォール取得前に呼び出してください。
:::

### リリースの準備をする \{#prepare-for-release\}

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

**ガイド:** [リリースチェックリスト](release-checklist)

LLMに送信するもの：
```
Read these Adapty docs before releasing:
- https://adapty.io/docs/ja/release-checklist.md
```

:::tip[チェックポイント]
- **期待される結果:** すべてのチェックリスト項目が確認済み：ストア接続、サーバー通知、購入フロー、アクセスレベルの確認、プライバシー要件。
- **注意点:** サーバー通知が未設定 → **App settings → iOS SDK** でApp Store Server Notificationsを設定し、**App settings → Android SDK** でGoogle Play Real-Time Developer Notificationsを設定してください。
:::

## プレーンテキストのドキュメントインデックスファイル \{#plain-text-doc-index-files\}

個々のページを超えてLLMにより広いコンテキストを提供する必要がある場合、すべてのAdaptyドキュメントをリストアップまたは結合したインデックスファイルを提供しています：

- [`llms.txt`](https://adapty.io/docs/ja/llms.txt): `.md` リンク付きで全ページをリスト表示します。LLMがウェブサイトにアクセスできるようにするための[新興標準](https://llmstxt.org/)です。一部のAIエージェント（例：ChatGPT）では、`llms.txt` をダウンロードしてチャットにファイルとしてアップロードする必要があります。
- [`llms-full.txt`](https://adapty.io/docs/ja/llms-full.txt): Adaptyドキュメントサイト全体を1つのファイルにまとめたものです。非常に大きなファイルのため、全体像が必要な場合のみ使用してください。
- Unity専用の [`unity-llms.txt`](https://adapty.io/docs/ja/unity-llms.txt) と [`unity-llms-full.txt`](https://adapty.io/docs/ja/unity-llms-full.txt): サイト全体と比べてトークンを節約できるプラットフォーム別サブセットです。