# Unity IAP v5 中的新功能

> Unity IAP v5 引入了直接到消费者付款和托管的网上商店店面，并改进了目录管理和报告。

了解最新版本的 Unity 应用内购 (IAP) 中的新功能和改进。Unity IAP v5 引入了 Direct-to-Consumer 支付基础设施、托管的网上商店店面、AI 辅助迁移工具以及对目录管理和报告的改进。以下部分将介绍每个新功能并链接到更多信息。

有关此版本中更改和更新的完整列表，请参阅 [Unity IAP 更改日志](https://docs.unity3d.com/Packages/com.unity.purchasing@latest?subfolder=/changelog/CHANGELOG.html)。

> **Note:**
>
> 从 SDK v5.4 开始，Unity IAP 将开发者数据处理为[开发者数据框架](/cloud/developer-data.md.md)的一部分。因此，您有责任使用 [UnityConsent](https://docs.unity3d.com/ScriptReference/UnityConsent.ConsentState.html) 模块[管理用户同意](/cloud/developer-data/user-consent.md.md)。

## 通过第三方提供商直接到消费者付款##direct-to-consumer-payments-with-third-party-providers

从 IAP v5.4 开始，您可以集成 Direct-to-Consumer (D2C) 支付提供商，从而直接向 Apple App Store 和 Google Play Store 以外的玩家销售应用内商品。Unity IAP 支持 [Stripe](https://stripe.com) 和 [Coda](https://www.coda.co/product/codapay/) 作为记录商家付款提供商，这意味着他们代表您处理税务合规、欺诈预防、争议和客户支持。

此集成需要 Remote Catalog 和 IAP v5.4 包。您可以通过 SDK、后端 API、服务器端验证或 Cloud Code 模块实现购买，具体取决于您的架构。

> **Note:**
>
> Apple 和 Google 现在支持特定地区的外部 Web 链接和第三方付款。资格、费用和技术要求因平台和地区而异。您有责任遵守每个平台和地区的要求。

有关完整的集成工作流程，请参阅[集成 D2C 支付提供](/iap/payment-providers/workflow.md)商。要配置特定提供程序，请参阅 [Configure Stripe](/iap/payment-providers/configure-stripe.md) 或 [Configure Coda](/iap/payment-providers/configure-coda.md)。

## Unity Dashboard（Unity 后台）中的目录管理##catalog-management-in-the-unity-dashboard

从 IAP v5 开始，可以从 Unity Dashboard（Unity 后台）管理 IAP 目录，而无需修改游戏客户端。Dashboard（后台）提供了一个集中位置，可以导入现有目录、添加和编辑各个列表以及将列表组织到类别中。

在 Unity Dashboard（Unity 后台）中，您可以：

* 使用 Secret Manager 中存储的凭据从 App Store Connect 或 Google Play 导入现有目录。
* 添加新列表并编辑列表详细信息，包括本地化内容、定价和特定于商店的覆盖。
* 将列表分配给类别以组织目录。

从 Unity Editor 或 CLI 部署 Remote Catalog 时，Unity 会自动将这些列表添加到 Dashboard（后台），因此您可以将它们与导入的任何目录一起管理。

首先，请参阅 [Manage catalogs in the Unity Dashboard](/iap/dashboard-catalog.md)（Unity 后台中的管理目录）。有关目录的概述以及可用于定义目录的方法，请参阅[创建 IAP 目录](/iap/catalogs.md)。

## 用于 IAP 迁移和集成的 AI 技能##ai-skills-for-iap-migration-and-integration

从 IAP v5.3.0 开始，Unity IAP 包含 AI 技能，可帮助您迁移到 IAP v5 并进行集成。这些技能支持以下情形：

* 将项目从版本 4 迁移到版本 5。
* 了解 Codeless IAP 的工作原理。
* 将 IAP v5 购买处理添加到不使用 IAP 的项目，例如具有商店场景 UI 但没有购买逻辑的项目。
* 从 IAP v5 迁移到 IAP+ 可将商店计费移至直接面向消费者的支付提供商，或在商店计费旁边添加新`StoreController`。
* 将项目从原生 Google Play 计费 (Android Java) 迁移到 IAP v5。该技能还会检查 IAP v5 不支持的项目功能，并发出相关警告。

每个转换都会生成详细报告，以便您可以查看技能对项目所做的每个更改，包括设置、代码、事件和配置文件。

可从页面底部的 **Project Settings** > **Services** > **In-App Purchasing** 访问 Editor 中的技能。您可以使用两种技能：

* **打开技能文件夹**：打开包含技能文件的文件夹，以便在首选 AI 工具中复制或安装 IAP AI 技能。
* **安装到 Claude Code**：将技能作为名为 `in-app-purchases` 的技能直接安装到 Claude Code 中。

安装完成后，从 AI 工具运行 `in-app-purchases` 并提示其执行所需的迁移或集成。

有关从版本 4 迁移到版本 5 所需的代码更改的完整列表，请参阅[从 IAP 版本 4 升级到版本 5](/iap/upgrade-to-iap-v5.md)。

## 托管的网上商店店面##hosted-webshop-storefront

Unity Webshop 是从 Unity Dashboard（Unity 后台）创建和管理的游戏应用内购的托管网络店面。网上商店会读取项目的现有 IAP 目录并将购买内容转发给您配置的付款提供商，因此无需单独的目录或付款设置。

在 Unity Dashboard（Unity 后台）中，您可以：

* 在 `shop.unity.com/{studio}/game/{slug}` 上创建并发布具有公共 URL 的网上商店。
* 根据游戏的 Apple App Store 列表或使用 AI 辅助主题创建功能生成主题店面或您自己的截屏。
* 配置支付提供商路由，使用玩家标签为不同玩家提供不同的提供商，并为不符合路由规则的玩家提供后备提供商。
* 在发布之前预览草案中的更改，并将非生产环境草案提升到生产环境。

玩家可以从游戏中的深层链接、Discord 频道、您的网站或任何其他表面访问该网上商店。目录和定价更改将在下次页面加载时反映，无需重新发布。

要开始使用，请参阅[创建和发布第一个网上商店](/iap/webshop/create-and-publish-your-first-webshop.md)。

## Unity Dashboard（Unity 后台）中的收入报告##revenue-reporting-in-the-unity-dashboard

从 IAP v5.4.0 开始，您可以在 Unity Dashboard（Unity 后台）中查看应用内购的收入报告。收入报告可以统一查看应用程序在提供商和平台上的 IAP 表现，包括总收入和转化率等指标。

要收集报告数据，请将项目链接到 Unity 云项目，并在 Unity Editor 中启用 Diagnostic Data。然后，您可以在 Unity Dashboard（Unity 后台）中查看 **Development**（开发）> **In-App Purchases（应用内购**）> **Revenue Performance（收入表现**）中的汇总数据，您可以在其中选择指标并按日期范围或平台等条件进行过滤。

首先，请参阅[设置 IAP 性能报告](/iap/reporting/set-up-performance-reporting.md)。有关可用的指标、尺寸和配置选项，请参阅[收入绩效参考](/iap/reporting/revenue-performance-reference.md)。