实现 IAP 产品

重要
Unity 分发门户 (UDP) 将于 2025 年 2 月 17 日关闭。 届时将永久停用对 UDP Web 控制台和服务的访问。 要下载您的密钥库和有关如何将您的游戏重新发布到应用商店的说明，请访问 UDP 概述 页面。如果您对您的帐户有任何疑问，请通过 Unity 客户支持 提交工单。

推荐的最佳做法是在 UDP 控制台中添加和管理您的 IAP 产品。 UDP 控制台中的 IAP 目录 是提交到商店后端系统的真实来源。此外，UDP 控制台允许您

• 管理多个 IAP 价格和货币
• 添加多种语言的描述
• 通过 CSV 文件批量上传项目（支持多种货币和语言）

注意：如果您只使用 UDP 包，您仍应在 Unity 编辑器中至少创建一个 IAP 项目，以测试它是否可以与 UDP 控制台正确同步。如果您使用 Unity IAPUnity 应用内购买 的缩写
在 术语表 中查看 包（无代码实现），您必须在 Unity 编辑器中添加每个 IAP 项目并将它们全部上传到 UDP 控制台。如果您使用 Unity IAP 包并在代码中实现了 IAP，请在 UDP 控制台中创建 IAP 项目。

如果您在游戏客户端中维护 IAP 目录，UDP 会在 Unity 编辑器和 UDP 控制台之间保持同步。

在 UDP 控制台中管理应用内购买

在 UDP 控制台 中，通过“我的游戏”页面访问您的游戏。在“游戏信息”页面中，选择“编辑信息”按钮进入编辑模式。要保存更改，请选择“保存”。要丢弃更改，请选择“取消”。本节介绍如何在 UDP 控制台中编辑、创建和删除 IAP 产品。

创建新的 IAP 项目

要在 UDP 控制台中创建新的 IAP 项目

1. 在“游戏信息”页面中选择“编辑信息”。
2. 选择“添加项目”以创建一个新项目。
3. 指定并保存您的 产品信息。
   1. 遵循产品 ID 的要求以确保它们对应用商店有效。
   2. 确保您在游戏中定义的 IAP 产品使用与 IAP 目录中设置的相同的产品 ID。
4. 选择“管理金额和货币”以
   1. 将 IAP 价格从美元转换为外币。
   2. 调整这些货币的定价。
5. 选择“保存”以保存更改。

注意：如果您要创建许多 IAP 项目，请考虑使用 批量 IAP 导入 功能一次创建所有 IAP 项目，包括多种货币的本地化描述和定价。

如果使用 UDP 包，您在控制台中添加的任何新 IAP 项目都会同步到您的 Unity 项目。您无需重建游戏即可包含它们。

编辑 IAP 描述

要编辑 IAP 描述，请按以下步骤操作。

1. 在“游戏信息”页面中选择“编辑信息”。
2. 通过下拉语言选择器选择要编辑描述的语言。
3. 在“应用内购买”部分，选择铅笔图标以编辑现有的 IAP 项目。
4. 编辑您的 IAP 项目信息
   1. 产品名称，IAP 项目的名称
   2. 描述，简洁地描述 IAP 项目
5. 选择“保存”以保存更改。

注意：上述步骤仅编辑您为所选语言的 IAP 项目信息。如果您要支持大量 IAP 项目和语言，请考虑使用 批量 IAP 导入 导入这些信息。

编辑 IAP 价格和货币

1. 在“游戏信息”页面中选择“编辑信息”。
2. 选择 IAP 项目的“管理金额和货币”以
   1. 更改 IAP 价格。
   2. 将其从美元转换为外币。
   3. 调整这些货币的定价。
3. 选择“保存”以保存更改。

提示：要将货币设置为收藏夹货币，请选择其货币代码旁边的星形图标。这会将货币固定到列表顶部。取消选择星形以取消固定。

注意：如果您要支持大量 IAP 项目和货币，您可以使用“转换”功能根据每个 IAP 项目设置的美元金额自动将所有 IAP 价格转换为全球货币。这会覆盖您之前设置的任何本地价格。

或者，使用 批量 IAP 导入 一次导入所有这些信息。

删除 IAP 项目

1. 在“游戏信息”页面中选择“编辑信息”。
2. 选择垃圾桶图标以删除 IAP 项目。
3. 选择“保存”以保存更改。

批量导入 IAP 项目

1. 在“游戏信息”页面中选择“编辑信息”。
2. 在“应用内购买”面板的右上角选择“导入目录”。
   有关此功能的完整介绍，请参阅批量 IAP 导入。
3. 选择“保存”以保存更改。

从 Google Play 导入游戏信息

如果您已在 Google Play 上发布您的游戏，您可以使用您的游戏的 Google Play URL 导入基本信息

1. 选择“从 Google Play 导入”。
2. 将您的游戏的 Google Play URL 粘贴到输入框中。
3. 要指定要导入的特定语言，请使用包含语言后缀的 Google Play URL，例如，对于意大利语，请使用 &hl=it。
   如果您的 Google Play URL 不包含语言后缀，UDP 会获取您当前在 UDP 控制台中编辑的语言的信息（如果它在 Google Play 上设置）。
4. 选择“导入”。
5. 仔细检查结果，因为在某些情况下，您的计算机的 IP 地址最终可能会决定为您提供哪种语言。

批量 IAP 导入

如果您有许多 IAP 项目，批量 IAP 导入功能可以让您更轻松地管理您的 IAP 目录。这使您能够将 UDP 格式和 Google Play 格式的 CSV 文件上传到 UDP 控制台，其中包含您所有 IAP 产品的详细信息，包括多种货币的价格和多种语言的描述。

Unity 建议您仍应在 Unity 编辑器中添加一个 IAP 项目以进行测试，以确保您可以在沙盒环境中购买 IAP 项目。

注意：如果您的 CSV 文件包含多种语言，添加受支持的语言，然后再导入 CSV 文件。

本节介绍如何通过 CSV 批量导入 IAP 项目。

实现要求

要添加新的 IAP 产品

如果您实现了 UDP，则应仅使用批量 IAP 导入功能添加新的 IAP 产品

• 使用 UDP 包
• 使用 Unity IAP（代码实现）

Unity 建议您仍应在 Unity 编辑器中添加一个 IAP 项目以进行测试，以确保您可以在沙盒环境中购买 IAP 项目。

要添加本地化描述和价格

对于所有实现，您可以使用批量 IAP 导入将多种语言的描述和多种货币的价格分配给您现有的 IAP 产品。

使用 UDP 包

您可以使用批量 IAP 导入完全重新定义游戏的 IAP 目录，而无需重新构建游戏。

您只需要一个正常工作的 UDP 实现。

使用 Unity IAP（代码实现）

使用 Unity IAP，您只能将 IAP 目录从编辑器同步到 UDP 控制台。

如果您要通过批量 IAP 上传将游戏的 IAP 目录上传到 UDP 控制台，您应该准备您的游戏从 UDP 控制台而不是从游戏客户端的默认 IAP 目录中获取 IAP 产品信息。

要允许您的游戏从 UDP 控制台获取 IAP 目录，请不要在您的代码中调用任何 IAP 产品检索方法。

有关更多信息，请参阅 查询 IAP 库存。

下载 CSV 模板

UDP 提供了一个 CSV 模板，您可以使用它来批量导入 IAP 产品。该模板采用 UDP 格式的 CSV 文件。

1. 在“游戏信息”页面中选择“编辑信息”。
2. 转到“应用内购买”面板。
3. 选择“导入目录”。
4. 选择“下载模板”。

填写 CSV 文件

CSV 文件使用逗号 (,) 和分号 (;) 来分隔数据值。逗号分隔主要数据值，分号分隔子值。

每个 IAP 项目必须完全出现在 CSV 文件中的单行上。

您必须以模板中提供的完全相同的 格式 输入数据。如果您上传的文件包含错误（例如无效的价格语法或缺少的语言），UDP 控制台会显示一条错误消息。

上传您的 CSV 文件

1. 在“游戏信息”页面中选择“编辑信息”。
2. 转到“应用内购买”部分。
3. 选择“导入目录”。
4. 选择“上传 CSV”或将您的 CSV 文件拖放到指定的框中。
5. 选择“导入”将您的 IAP 目录上传到 UDP 控制台。

注意：上传 CSV 文件会完全覆盖此修订版本的 IAP 目录。UDP 控制台仅使用您的 CSV 文件中包含的信息；您之前通过 UDP 控制台输入的任何其他 IAP 信息都会丢失。

导出 CSV 文件

要重用或修改现有的 IAP 目录

1. 在“游戏信息”页面中选择“编辑信息”。
2. 转到“应用内购买”部分。
3. 选择“导出目录”。
   这会将您现有的 IAP 目录导出为 UDP 格式的 CSV 文件。
4. 修改 CSV 文件。
5. 上传您的 CSV 文件。

仅当您的 IAP 目录中包含 IAP 产品时才会显示“导出目录”按钮，并且该按钮仅在编辑模式下可见。下图显示了“应用内购买”部分中的此按钮。

从 Google Play 格式导入 IAP 产品

UDP 还支持 Google Play 格式的 CSV 文件。

要使用 Google Play CSV 文件导入 IAP 产品

1. 在“游戏信息”页面中选择“编辑信息”。
2. 转到“应用内购买”部分。
3. 点击“导入目录”。
4. 选中“Google Play 格式的 CSV 文件”复选框。
5. 选择“上传 CSV”或将您的 CSV 文件拖放到指定的框中。
   1. 在“Google Play 默认货币”字段中，选择游戏的默认货币。
6. 选择“导入”将您的 IAP 目录上传到 UDP 控制台。

定价

Google Play 按国家/地区设置定价，UDP 按货币设置定价。因此，导入会将国家/地区映射到货币。如果您为一个 IAP 产品使用相同货币（例如，欧洲国家/地区的 EUR）在不同国家/地区设置了不同的价格，UDP 会使用列表中的第一个国家/地区的货币。如果多个国家/地区都列出了 USD，则使用美国区域设置。

UDP 不支持 Google Play 的定价模板。此设置将被忽略。UDP 仅使用 CSV 文件中提供的本地价格。

默认货币

UDP 使用 USD 作为其默认货币。如果您在 Google Play 上没有 USD 定价，UDP 会将您的 Google Play 默认定价和货币转换为 USD，并将其用作 UDP 默认定价。

在您的 CSV 文件中设置的本地价格将以其各自的货币维护。

对于 CSV 文件中未明确设置的国家/地区，UDP 会将您的 Google Play 默认定价和货币转换为其各自的货币。

IAP 产品

无法从您的 CSV 文件中确定 IAP 产品的类型（消耗性/非消耗性）；您需要告诉 UDP 每个 IAP 产品的类型。

UDP 不支持自动翻译。此设置将被忽略。UDP 仅使用 CSV 文件中提供的本地化描述。