虚拟货币
快速入门
端到端配置虚拟货币：创建代币货币、通过订阅授予代币，并通过服务端 API 进行消耗。
创建虚拟货币
在 Adapty 中创建虚拟货币，将其关联到产品，使购买行为可授予积分，并设置积分是否过期。
虚拟货币余额
在用户画像中查看虚拟货币余额，并在事件历史记录中回顾每次余额变动。
当用户购买产品或续订订阅时，向其授予虚拟货币——AI 代币、积分或金币。只需定义一种货币，将其关联到需要发放奖励的产品，Adapty 即可自动为每位用户记账并维护其余额。您的应用通过服务端 API 读取和消耗该余额——例如，按次扣减生成所需的代币。
工作原理
- 创建虚拟货币：打开 Products 并点击 Virtual currency 标签页。点击 New virtual currency。为货币定义代码、名称以及可选的描述信息。
- 将货币关联到产品：将货币映射到一次性购买或订阅产品，并设置每次购买可获得的积分数量。
- 自动发放积分：当用户购买关联的一次性产品或续订关联的订阅时，Adapty 会自动将配置的积分添加到其余额中。
- 查看和消费余额：您的应用通过服务端 API 读取每位用户的余额并进行积分的发放或消费操作。
- 追踪每一次变动：每次余额变动都会记录在用户的画像中。
完整的操作流程（从货币设置到通过 API 使用积分），请参阅虚拟货币快速入门。
使用场景
| 应用类型 | 如何使用虚拟货币 |
|---|---|
| AI 应用（图像、视频或文本生成） | 每次生成消耗积分。订阅中包含每月积分额度，并将积分包作为一次性商品出售。 |
| 短剧和视频应用 | 消耗金币解锁剧集。为订阅用户提供周期性金币额度，并将金币包作为一次性商品出售。 |
| 语言学习和教育 | 通过服务端 API 为免费用户提供有限的爱心或生命值额度。付费方案中提供更大额度，或完全跳过余额校验。 |
| 手游 | 同时运行软货币和硬货币：通过服务端 API 因游戏玩法奖励金币，出售宝石换取现金，并在单个原子事务中实现相互兑换。 |
| 生产力应用 | 用积分计量高成本操作（如 OCR 或导出）。免费用户获得少量额度，订阅后获得更多额度，批量工作时可购买积分包。 |
对于订阅配额，请开启积分到期功能。每次续订时未使用的积分自动清零，这样配额就始终是用户保持订阅的动力，重度用户也会选择购买积分包，而不是慢慢消耗囤积的积分。
限制
- 跨设备访问需要身份识别：余额归属于某个用户画像。匿名用户的余额仅保留在其获得余额的设备上，因此请识别用户身份，以便在所有设备上共享余额。详见余额、用户画像与设备。
- 仅支持服务端操作：目前尚无 SDK 方法可读取或消耗余额，因此应用需要一个后端服务，通过服务端 API 读取余额并进行充值或消耗操作。
- 每个应用最多支持 20 种货币：一个应用最多可创建 20 种虚拟货币。