Implementing IAP products

Unity 建议在 UDP 控制台中添加和管理 IAP 商品。UDP 控制台中的 IAP 目录是提交到商店后端系统的真实信息来源。此外，UDP 控制台可让你：

• Manage multiple IAP prices and currencies
• Add descriptions in multiple languages
• Upload items in bulk via CSV file (multiple currencies and languages supported)

注意：如果仅使用 UDP 包，仍应在 Unity 编辑器中创建至少一个 IAP 商品以测试其是否能够与 UDP 控制台正确同步。 如果使用的是 Unity IAP 包（使用无代码实现方法），必须在 Unity 编辑器中添加每个 IAP 商品，并全部上传到 UDP 控制台。如果使用的是 Unity IAP 包，并且已通过代码实现了 IAP，请在 UDP 控制台中创建 IAP 商品。

如果在游戏客户端中有一个 IAP 目录，则 UDP 可以使它在 Unity 编辑器和 UDP 控制台之间保持同步。

在 UDP 控制台上管理应用内购

在 UDP 控制台中，通过“我的游戏”页面导航到游戏。 在“游戏信息”页面中，选择编辑信息按钮以进入编辑模式。要保存更改，请选择保存。要放弃更改，请选择取消。 此部分涉及如何从 UDP 控制台编辑、创建和删除 IAP 商品。

创建新的 IAP 商品

要在 UDP 控制台中创建新的 IAP 商品，请执行以下操作：

1.在“游戏信息”页面上选择编辑信息。 1.选择添加项目以创建新商品。 1.指定并保存商品信息。 1.遵循商品 ID 的要求，以确保它们对应用商店而言有效。 1.确保在游戏中定义的 IAP 商品使用的是 IAP 目录中设置的产品 ID (Product ID)。 1.选择管理金额和货币以便： 1.将 IAP 价格从 USD 转换为其他货币。 1.调整这些货币的价格。 1.选择保存以保存更改。

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

如果使用 UDP 包，则在控制台中添加的所有新 IAP 商品都将同步到 Unity 项目。你无需重新构建游戏即可包含这些商品。

编辑 IAP 描述

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

1.在“游戏信息”页面上选择编辑信息。 1.通过语言下拉选单选择要编辑描述的语言。 1.在“应用内购”部分中，选择铅笔图标以编辑现有的 IAP 商品。 1.编辑 IAP 商品信息： 1.产品名称：IAP 商品的名称 1.描述：IAP 商品的简要描述 1.选择保存以保存更改。

注意：上述步骤仅针对所选语言编辑 IAP 商品信息。如果要支持大量 IAP 商品和语言，请考虑使用批量 IAP 导入功能导入此信息。

编辑 IAP 价格和货币

1.在“游戏信息”页面上选择编辑信息。 1.针对某个 IAP 商品选择管理金额和货币以便： 1.更改 IAP 价格。 1.将价格从 USD 转换为其他货币。 1.调整这些货币的价格。 1.选择保存以保存更改。

提示：要将货币设置为常用货币，请选择相应货币代码旁边的星形图标。这会将货币固定在列表的顶部。取消选择星形图标即可取消固定。

注意：如果要支持大量 IAP 商品和货币，可使用转换功能根据为每个 IAP 商品设置的美元金额将所有 IAP 价格自动转换为全球货币。此操作将覆盖先前设置的任何本地价格。

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

删除 IAP 商品

1.在“游戏信息”页面上选择编辑信息。 1.选择垃圾桶图标以删除 IAP 商品。 1.选择保存以保存更改。

批量导入 IAP 商品

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

从 Google Play 导入游戏信息

如果你已经在 Google Play 上发布了游戏，可使用游戏的 Google Play URL 导入基本信息：

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

批量 IAP 导入

如果有很多 IAP 商品，可使用批量 IAP 导入功能来简化 IAP 目录的管理。这样，就可以将包含所有 IAP 商品详细信息（包括多种货币的价格和多种语言的描述）的 CSV 文件以常规 UDP 格式和 Google Play 格式上传到 UDP 控制台。

Unity 建议你仍在 Unity 编辑器中添加 IAP 商品以进行测试，从而确保可以在沙盒环境中购买 IAP 商品。

Note: If your CSV file contains multiple languages, add the supported languages before you import the CSV file.

本节介绍如何通过 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 商品检索方法。

For more information, see Querying IAP inventory.

下载 CSV 模板

UDP 提供了一个 CSV 模板用于批量导入 IAP 商品。此模板采用 CSV 文件的常规 UDP 格式。

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

填写 CSV 文件

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

每个 IAP 商品必须完全显示在 CSV 文件内的一行中。

You must enter data in the exact format of the template provided. The UDP console displays an error message if you upload a file that contains errors, such as invalid price syntax or missing languages.

上传 CSV 文件

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

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

导出 CSV 文件

要重用或修改现有的 IAP 目录，请执行以下操作：

1.在“游戏信息”页面上选择编辑信息。 1.找到“应用内购”部分。 1.选择导出目录。
此时会将现有的 IAP 目录导出为常规 UDP 格式的 CSV 文件。 1.修改 CSV 文件。 1.上传 CSV 文件。

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

从 Google Play 格式导入 IAP 商品

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

要使用 Google Play CSV 文件导入 IAP 商品，请执行以下操作：

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

价格

Google Play 按国家/地区设置价格，UDP 按货币设置价格。因此，导入操作会将国家/地区映射到货币。 如果对于一个 IAP 商品，你使用相同的货币（例如，欧洲国家/地区的欧元 EUR）为不同的国家/地区设置了不同的价格，则 UDP 会使用列表中的第一个国家/地区作为货币的国家/地区。如果有多个国家/地区列出美元 (USD)，则会使用美国区域设置。

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

默认货币

UDP 使用美元作为其默认货币。如果未在 Google Play 上设置美元定价，UDP 会将 Google Play 默认定价和货币转换为美元，并以此作为 UDP 的默认定价。

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

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

IAP 商品

无法从 CSV 文件确定 IAP 商品的类型（消耗品/非消耗品）；你需要向 UDP 指定每个 IAP 商品的类型。

UDP 不支持自动转换 (Auto-Translate)。此设置会被忽略。UDP 只使用 CSV 文件中提供的本地化描述。