借助 AI 将 Adapty 集成到您的 Unity 应用中

本指南帮助您借助 LLM 将 Adapty 集成到您的 Unity 应用。您将从准备 Adapty 看板开始，然后通过向 LLM 发送相关文档链接，逐步完成每个实现阶段。在指南末尾，您还能找到使用 AI 工具配合 Adapty 文档的最佳实践。

复制本页完整 Markdown 内容并粘贴到您的 LLM 中即可开始——点击页面顶部的 Copy for LLM，或打开 .md 版本。LLM 将根据指南链接和检查点引导您完成每个阶段。

开始之前：看板配置

Adapty 在您编写任何 SDK 代码之前，需要先完成一些看板配置。您可以通过交互式 LLM 技能，或手动通过看板来完成配置。

Skill 方法

Adapty CLI skill 让你的 LLM 直接设置应用、产品、访问等级、付费墙和版位，无需为每个步骤打开看板。你只需要在看板中连接你的商店。

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

添加 skill 后，在你的 agent 中运行 /adapty-cli。它将引导你完成每个步骤，包括何时需要打开看板连接你的商店。

看板配置方式

如果您倾向于手动配置所有内容，以下是编写任何代码之前所需的准备工作。您的 LLM 无法自动查找看板中的值——您需要自行提供这些信息。

连接您的应用商店：在 Adapty 看板中，前往 App settings → General。如果您的 Unity 应用同时面向两个平台，请同时连接 App Store 和 Google Play。这是购买功能正常运行的必要条件。连接应用商店
复制您的公共 SDK 密钥：在 Adapty 看板中，前往 App settings → General，找到 API keys 部分。在代码中，这是您传递给 Adapty 配置构建器的字符串。
至少创建一个产品：在 Adapty 看板中，前往 Products 页面。您无需在代码中直接引用产品——Adapty 通过付费墙来分发产品。添加产品
创建付费墙和版位：在 Adapty 看板中，在 Paywalls 页面创建付费墙，然后在 Placements 页面将其分配到一个版位。在代码中，版位 ID 是您传递给 Adapty.GetPaywall("YOUR_PLACEMENT_ID") 的字符串。创建付费墙
设置访问等级：在 Adapty 看板的 Products 页面中，为每个产品进行配置。在代码中，通过 profile.AccessLevels["premium"]?.IsActive 检查相应字符串。默认的 premium 访问等级适用于大多数应用。如果付费用户根据所购产品获得不同功能的访问权限（例如 basic 方案与 pro 方案），请在开始编写代码前创建额外的访问等级。

一旦您集齐了这五项信息，就可以开始编写代码了。告诉您的 LLM：“我的 Public SDK key 是 X，我的版位 ID 是 Y”，这样它就能生成正确的初始化和付费墙获取代码。

准备就绪后进行设置

这些内容不是开始编码的必要条件，但随着集成的成熟，你会需要它们：

A/B 测试：在 Placements 页面进行配置，无需更改代码。 A/B 测试
更多付费墙和版位：添加更多使用不同版位 ID 的 GetPaywall 调用。
分析集成：在 Integrations 页面进行配置，具体设置因集成而异。请参阅分析集成和归因集成。

将 Adapty 文档输入到您的 LLM

使用 Context7（推荐）

Context7 是一个 MCP 服务器，可让您的 LLM 直接访问最新的 Adapty 文档。您的 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 Unity SDK

尽管 Context7 无需手动粘贴文档链接，但实现顺序非常重要。请按照以下实现演练逐步操作，确保一切正常运行。

使用纯文本文档

您可以以纯文本 Markdown 格式访问任意 Adapty 文档。只需在 URL 末尾添加 .md，或点击文章标题下方的 Copy for LLM。例如：adapty-cursor-unity.md。

下方实施演练中的每个阶段都包含一个”Send this to your LLM”区块，其中附有可粘贴的 .md 链接。

如需一次性获取更多文档，请参阅下方的索引文件与平台专属子集。

实施演练

本指南的其余部分按实施顺序介绍 Adapty 集成流程。每个阶段包含需要发送给 LLM 的文档、完成后应看到的效果以及常见问题。

规划你的集成

在开始编写代码之前，请让你的 LLM 分析你的项目并制定实施计划。如果你的 AI 工具支持规划模式（如 Cursor 或 Claude Code 的 plan 模式），请使用该模式，以便 LLM 在编写任何代码之前，能够同时读取你的项目结构和 Adapty 文档。

告诉你的 LLM 你使用哪种购买方式——这将影响它应该遵循哪些指南：

Adapty 付费墙编辑工具：您在 Adapty 的无代码编辑工具中创建付费墙，SDK 会自动渲染。
手动创建的付费墙：您在代码中构建自己的付费墙 UI，但仍使用 Adapty 获取产品并处理购买。
观察者模式：您保留现有的购买基础设施，仅使用 Adapty 进行分析和集成。

不确定选哪个？请阅读快速入门中的对比表。

安装并配置 SDK

通过 Unity Package Manager 添加 Adapty SDK 包，并使用您的 Public SDK key 激活。这是基础步骤——没有它，其他功能都无法正常使用。

指南： 安装并配置 Adapty SDK

将以下内容发送给您的 LLM：

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

检查点

预期结果： 项目成功构建并运行。Unity 控制台显示 Adapty 激活日志。
常见问题： “Public API key is missing” → 检查你是否已将占位符替换为来自 App settings 的真实密钥。

展示付费墙并处理购买

通过版位 ID 获取付费墙，展示付费墙，并处理购买事件。您需要参考的指南取决于您如何处理购买。

在操作过程中，请在沙盒环境中测试每次购买——不要等到最后再测试。设置说明请参阅在沙盒中测试购买。

指南：

在编写代码之前，请阅读以下 Adapty 文档：
- https://adapty.io/docs/zh/unity-quickstart-paywalls.md
- https://adapty.io/docs/zh/unity-get-pb-paywalls.md
- https://adapty.io/docs/zh/unity-present-paywalls.md
- https://adapty.io/docs/zh/unity-handling-events.md
- https://adapty.io/docs/zh/unity-handle-paywall-actions.md

Checkpoint

预期结果： 付费墙显示已配置的产品。点击某个产品会触发沙盒购买对话框。
注意事项： 付费墙为空或出现 GetPaywall 错误 → 请确认版位 ID 与看板中的完全一致，且该版位已分配目标受众。

指南：

在编写代码之前，请阅读以下 Adapty 文档：
- https://adapty.io/docs/zh/unity-quickstart-manual.md
- https://adapty.io/docs/zh/fetch-paywalls-and-products-unity.md
- https://adapty.io/docs/zh/present-remote-config-paywalls-unity.md
- https://adapty.io/docs/zh/unity-making-purchases.md
- https://adapty.io/docs/zh/unity-restore-purchase.md

检查点

预期效果： 您的自定义付费墙显示从 Adapty 获取的产品。点击某个产品会触发沙盒购买对话框。
注意事项： 产品数组为空 → 请确认付费墙已在看板中分配了产品，且版位已设置目标受众。

检查订阅状态

购买完成后，检查用户画像中是否存在有效的访问等级，以控制对高级内容的访问权限。

指南： 检查订阅状态

将以下内容发送给您的大语言模型：

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

检查点

预期结果： 在沙盒购买完成后，profile.AccessLevels["premium"]?.IsActive 返回 true。
注意事项： 购买后 AccessLevels 为空 → 请检查该产品是否已在看板中分配了访问等级。

识别用户

将您的应用用户账户与 Adapty 用户画像关联，使购买记录可跨设备持久保存。

如果您的应用无需身份验证，请跳过此步骤。

指南： 识别用户

将以下内容发送给您的 LLM：

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

Checkpoint

预期结果： 调用 Adapty.Identify("your-user-id") 后，看板的 Profiles 部分会显示您的自定义用户 ID。
注意事项： 请在激活之后、获取付费墙之前调用 Identify，以避免匿名用户画像归因问题。

准备发布

一旦您的集成在沙盒环境中正常运行，请仔细阅读发布检查清单，确保一切已准备好投入生产环境。

指南： 发布检查清单

将以下内容发送给您的 LLM：

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

Checkpoint

预期结果： 所有检查项均已确认：商店连接、服务器通知、购买流程、访问等级检查及隐私要求。
注意事项： 缺少服务器通知 → 请在 App settings → iOS SDK 中配置 App Store 服务器通知，并在 App settings → Android SDK 中配置 Google Play 实时开发者通知。

纯文本文档索引文件

如果您需要为 LLM 提供超出单个页面范围的更广泛上下文，我们提供了列出或汇总所有 Adapty 文档的索引文件：

llms.txt：列出所有页面的 .md 链接。这是一种新兴标准，用于让网站对大语言模型（LLM）可访问。请注意，对于某些 AI 智能体（例如 ChatGPT），您需要下载 llms.txt 并将其作为文件上传到对话中。
llms-full.txt：将整个 Adapty 文档站点合并为单个文件。体积非常大——仅在需要完整内容时使用。
Unity 专用的 unity-llms.txt 和 unity-llms-full.txt：平台专属子集，与完整站点相比可节省 token 用量。