UDP 参考
UDP 控制台参考
本节提供有关 UDP 控制台的信息架构的简要概述。
UDP 控制台包含一个导航栏，可让你在 UDP 控制台的以下部分之间进行导航：
Overview
The Overview tab of the UDP console contains useful information on how to use the UDP console, including:
- 教程视频
- 一个可帮助你跟踪进度的概要指南
- 特定于商店的信息
- 常见问题解答
我的游戏
“我的游戏”选项卡显示你的 UDP 项目。在这里，你可以在 UDP 项目之间切换、创建新游戏以及存档和恢复游戏。
You can filter the list of games by status, for example:
- All Games
- Published to UDP
- Submitted to stores
- Live on stores
If you select Submitted to stores or Live on stores, you can also filter the list of games by store.
选择一个游戏后，可看到以下选项卡：
- 游戏信息
- 发布
- 状态
Each game card displays the status of the game. The Published status indicates the game has completed all of the available steps to be repacked and submitted to the store.
游戏信息
Use the Game Info page to view and edit your game information. See Entering game information on the UDP console To view the Game Info page for a game, select the card in the My Games tab.
“游戏信息”页面包含以下部分：
“游戏信息”页面包含一个进度条，显示离游戏发布目标还有多远。此外，为该部分添加了必要的信息时，侧边菜单中的选项卡将显示为勾选状态。
游戏描述
在“游戏描述”部分中可输入将在应用商店中显示的游戏信息。
下表介绍了所有目标商店的要求超集。并非所有商店都使用表中介绍的所有属性。UDP 控制台会标记哪些字段是必填字段，哪些是可选字段。此外，某些商店有特定的语法要求。这些信息在 UDP 控制台中有相应指示。
| 属性 | 描述 |
|---|---|
| Import from Google Play | 如果你已经在 Google Play 上发布了游戏，可使用游戏的 Google Play URL 导入基本信息。 |
| Game Title | 游戏名称（该字段与编辑器同步）。 |
| Genre | 表示游戏所属的类别。选项包括：动作游戏、冒险游戏、街机游戏、棋盘游戏、卡牌游戏、博彩游戏、休闲游戏、教育游戏、音乐游戏、解谜游戏、竞速游戏、角色扮演游戏、模拟经营游戏、体育游戏、策略游戏、益智问答游戏和文字游戏。 |
| Device | 选项包括：智能手机、平板电脑或通用。 |
| Game Icon | 要在应用商店中显示的游戏图标。 |
| Short Description | 要在应用商店中显示的游戏简短描述（最多 60 个字符）。 |
| 描述 | 要在应用商店中显示的游戏完整描述（4,000 个字符）。 |
| Game Banners | 商店用来推荐游戏的图像。例如，可以是轮播中的一个展示位置。横向横幅是必选项，纵向横幅是可选项。 |
| Keywords | 最多定义 4 个关键字（每个关键字最多 30 个字符）。这些关键字用于在应用商店中进行搜索。 |
| Feature Video | 为游戏添加视频预告片。 注意：对于视频，某些商店仅接受 MP4 文件，而其他商店仅接受 Youtube 链接。Unity 建议两种形式都上传。 |
| Screenshots | 添加游戏的屏幕截图，包括封面图像（缩略图，用于在 MP4 视频无法播放时覆盖视频）。 每个使用方向至少添加四张图像。 一些应用商店仅接受纵向图像，或仅接受横向图像，而不接受同时两种方向的图像。如果将纵向图像和横向图像都上传到 UDP，请在偏好设置字段中选择首选方向。如果屏幕截图不符合商店的要求，UDP 将通知你。 |
| Use these screenshots for all languages | Enable this toggle to use the same screenshots for all languages. Disable this toggle if you want to add language-specific screenshots. |
| Preference | 某些商店仅接受纵向或横向图像。对于此类商店，请指定要使用的图像方向。 |
| Ratings | 选择游戏适合的受众。 |
可为每种支持的语言指定元数据。要添加新语言，请在编辑模式下选择语言下拉选单，然后选择“管理语言”。
二进制文件
Use the Binary section to upload your APK file and OBB files, or AAB files:
| 属性 | 描述 |
|---|---|
| APK Files (or AAB) | Your UDP game build. If you pushed your UDP build via Cloud Build, you don’t need to upload it again. For UDP to accept your APK file, the APK file: - Must contain a versionName- Must have an Initialize() method- Must have a Purchase() method (for games with IAP)If you upload a new APK version which contains a different package name, you will receive an error. This also prevents publishing the new APK version. To upload an Android App Bundle (AAB) file, select the Convert from AAB file option. UDP converts AAB files to APK for publishing to stores. |
| Version code | 仅当游戏已上传到 UDP 后，才会显示此字段。 |
| Minimum Android Version Support | 游戏支持的最低 Android 版本。仅当游戏已上传到 UDP 后，才会显示此字段。 |
| What’s New | 描述此游戏版本的变化。UDP 会在商店中发布此信息。 仅当游戏已上传到 UDP 后，才会显示此字段。 |
| OBB File (Main) | 游戏或应用程序可能需要的其他资源的主扩展文件。 |
| OBB File (Patch) | 这是一个可选文件，用于对主扩展文件进行小更新。 |
| Does your game use Google Play Services? | 了解 Google Play 服务使用情况有助于 UDP 在提交阶段更好地为你提供指导。 |
在 CloudBuild 部署期间不会推送 OBB 文件，因此，如果游戏使用了 OBB 文件，则必须手动将它们上传到 UDP 控制台。
注意：只能在默认语言视图（英语）中更改 APK 文件和 OBB 文件。
广告
下表介绍了“广告”部分。
| 属性 | 描述 |
|---|---|
| Does your game contain ads | 选择你的游戏是否包含广告。此信息可由 UDP 用于在提交过程中更好地为你提供指导。 |
| What ad mediation solutions does your game use? (Optional) | 如果游戏包含广告，请选择游戏使用哪种聚合解决方案。 |
| What ad networks does your game use? (Optional) | 如果游戏包含广告，请选择游戏使用哪种广告网络。 |
某些商店希望你在提交给他们的游戏中采用他们专有的广告网络。
UDP 会询问你的游戏中是否包含广告，以便更好地了解你提交到商店的内容，尤其是 UDP 可以确定你的提交内容将因此被商店拒绝的情况下。
可能拒绝游戏的商店会在“发布”部分中显示警告图标，并提供工具提示以说明可能发生的问题。 否则，UDP 不会以任何方式修改游戏的广告实现。
对最常见的聚合层和广告网络的测试表明，为 UDP 商店重新打包的游戏通常在接收广告活动方面没有问题。请随时向 UDP 支持部门询问你的广告设置及其是否适合通过 UDP 分发。为了更快获得更可靠的答案，务必提及你的游戏使用哪种聚合 SDK 和广告网络。
付费价格
“付费价格”是玩家下载游戏时所需支付的价格。
| 属性 | 描述 |
|---|---|
| Manage amounts and currencies | 设置游戏费用（美元）。 选择转换可自动将美元价格转换为其他列出的货币。你还可以手动编辑特定货币的价格。 |
注意：只能将付费游戏提交到支持付费游戏的商店。
应用内购
在“应用内购”部分中可添加和管理 IAP 商品。
如果使用 UDP 包，UDP 会自动使游戏的 IAP 目录在 Unity 编辑器和 UDP 控制台之间保持同步。
| 属性 | 描述 |
|---|---|
| 搜索框 | 按文本筛选 IAP 商品列表。 |
| “类型”下拉选单 | 按类型（即消耗品或非消耗品）筛选 IAP 列表。 |
| “排序”下拉选单 | 选择如何对 IAP 商品列表进行排序。 |
| Add Item | 单击此项可添加新的 IAP 商品。此时将打开一个窗口以输入 IAP 详细信息。 |
| Manage amounts and currencies | 单击此项可设置其他货币的价格。 |
| Convert | 将 IAP 商品的美元价格转换为全球货币。这将覆盖手动设置的任何其他货币价格。 |
| Favourite Currencies | 选择此项可打开“常用货币”窗口。要将货币设置为常用货币，请选择相应货币代码旁边的星形图标。这会将货币固定在列表的顶部。取消选择星形图标即可取消固定。 |
“IAP 项目”窗口
在“IAP 项目”窗口中可添加和编辑 IAP 商品的详细信息。要打开此窗口，请选择添加项目。 下表介绍了添加 IAP 项目窗口中的字段。
| 字段 | 描述 |
|---|---|
| Product ID | 用于标识 IAP 商品的唯一 ID。 “产品 ID”必须满足以下要求： - 以字母或数字开头 - 仅包含字母、数字、点 (.) 和下划线 (_) - 不得使用大写字母 |
| Product Name | IAP 商品的名称。 |
| 货币 | 显示价格所用的货币。 |
| 价格 | IAP 商品的价格（美元 USD）。 必须指定一个价格，才能让玩家在游戏中购买商品。 |
| Consumable | 选择此选项表示 IAP 商品为消耗品。 |
| 描述 | IAP 商品的简短描述。 |
沙盒测试
“沙盒测试”部分显示游戏的测试状态。在此部分中可创建用于在沙盒环境中进行测试的用户凭据，并会显示测试状态。 下表介绍了此部分的字段。
| 字段 | 描述 |
|---|---|
| Test status | 显示游戏的测试状态。 |
| UDP Initialization | 显示初始化检查的测试状态。这项检查旨在确保调用 Initialize() 方法（适用于所有游戏）。 |
| IAP Transaction | 显示 IAP 交易检查的测试状态。此情况下会调用 Purchase() 方法（仅适用于 IAP 游戏） |
| Sandbox Test Account | 沙盒测试帐户的电子邮件地址。仅用作 UDP 沙盒环境的登录名。 |
| Password | 测试帐户的密码。 |
应用签名
UDP 使用应用签名私钥对提交到商店的重新打包的 APK 文件进行签名。
Unity 建议选择导出并上传密钥和证书，并使用你自己的应用签名私钥。如果在 Google Play 上发布了游戏，请使用与 Google Play 上相同的密钥。这样，当用户安装游戏时，游戏被 Google Play 保护机制标记的可能性将大大降低。
注意：如果游戏被标记，可在此处向 Google 提出申诉。
下表介绍了“游戏信息”选项卡的“应用签名”部分。
| 属性 | 描述 |
|---|---|
| Export and upload the key and certificate (recommended) | UDP 使用你上传的应用签名私钥对重新打包的构建版本进行签名。如果选择此选项，则会应用于你将游戏提交到的所有商店。 |
| Let UDP create and manage App signing private key | UDP 为每个需要重新打包游戏的商店生成一个不同的应用签名私钥。 此选项会使你的游戏更容易受到 Google Play 保护警告的影响。 |
注意：只有 Android SDK 版本 18 及更高版本才支持生成应用签名。如果游戏使用的 SDK 版本低于此版本，请使用 RSA 算法签名或提高游戏的最低 API 级别 (Minimum API Level)。
更改密钥
你可以随时从使用 UDP 密钥切换到你自己的密钥。此更改仅适用于尚未重新打包游戏（因此未签名）的商店。如果先前已使用 UDP 密钥为某个商店重新打包了游戏，则该商店将始终使用 UDP 密钥。
仅当你还没有为任何商店重新打包游戏（使用你自己的密钥）时，才能从使用你自己的密钥切换为 UDP 密钥。
UDP 生成的密钥
满足以下条件时，UDP 使用公司信息为重新打包的 APK 文件生成密钥库：
- 开发者上传的 APK 文件不包含密钥库文件。
- 该游戏尚未在合作伙伴商店中重新打包。
如果不满足上述条件，则 UDP 会使用现有的 UDP 密钥库（如果可用），或者使用开发者信息来生成新的签名文件。
集成信息
此信息与编辑器同步。以下字段是可编辑的字段：
| 字段 | 描述 |
|---|---|
| Unity Project ID | 链接到 UDP 客户端的 Unity 项目 ID。 要取消 Unity 项目与 UDP 客户端的链接，请删除此字段中的 ID，然后选择保存。 注意：只有所有者和管理员可以编辑此字段。 |
| Callback URL | 游戏服务器的 URL。UDP 使用此 URL 发送有关付款结果的通知。 |
“发布”窗口
在“发布”窗口中可以发布游戏的版本。在“游戏信息”页面中选择“发布”时，将显示此窗口。
“发布”窗口中包含用于指定以下版本信息的字段：
- 标签
- 发行说明
所有修订版的标签和发行说明在以下位置可见：
- “游戏信息”部分（展开“修订”下拉选单时）
- “状态”部分（由“发布”进行组织）
注意：只能将最新的修订版发布到商店。
了解更多信息：
“发布”面板
在“发布”面板中可向商店注册并发布游戏。每个商店在此页面中都有自己对应的部分。
下表介绍了“发布”页面。
| 字段 | 描述 |
|---|---|
| Publish | 发布选定的游戏。 |
| Only show stores that accept the game’s pricing model | 在“发布”页面中隐藏不支持你的游戏定价模型的商店。 |
| All Stores | 选择所有可见的商店进行发布。 |
| 商店复选框 | 选中商店的复选框表示仅发布到选定的商店。 |
| Premium | 支持付费游戏的商店将显示“付费”标签。 |
| IAP | 支持 IAP 的商店将显示 IAP 标签。 |
| 信息图标 | 信息图标指明商店是与 UDP 完全集成还是部分集成。 |
| Sign up | 注册到选定的商店。 |
| Countries | 选择“国家/地区”以选择要将游戏发布到的国家/地区。 此时将打开一个窗口，其中列出商店支持的国家/地区。选中相应的复选框以表示游戏发布到相应的国家/地区，然后选择“保存”。 仅当已在商店中注册后才会显示此选项。 |
| Advanced | 选择此项可配置特定商店的高级属性。 仅当已在商店中注册后才会显示此选项。 |
目标步骤
在“发布”选项卡中，每个商店都有一个下拉选单，允许选择给定商店的目标步骤。可用的选项如下：
| 目标步骤 | 描述 |
|---|---|
| Repack Game | UDP 将通用 UDP 构建版本解包，并使用选定商店中的 SDK 重新打包游戏。此过程将使用你提交到商店的上一个构建版本中的 IAP 目录。 |
| Submit to Store | UDP 重新打包游戏，并将游戏、元数据和 IAP 目录提交到选定商店的生产环境。 首次发布游戏时，必须提交游戏才能在商店的服务器上创建 IAP 目录。 |
高级设置
要在提交游戏之前配置特定于商店的设置，请在“发布”选项卡中为商店选择“高级”。 你可以为商店专门配置以下属性：
| 属性 | 功能 | 影响的商店 |
|---|---|---|
| Target SDK | 将游戏发布到的商店 SDK 版本。默认情况下，UDP 会针对最新版本的商店 SDK 进行重新打包。 | 所有 |
| CP ID | 华为 AppGallery Connect 控制台上的商家 ID。 | 华为 |
| Product ID | 华为 AppGallery Connect 控制台上的商品 ID。 | 华为 |
| App ID | 华为 AppGallery Connect 控制台上的应用程序 ID。 | 华为 |
| Configuration version on the Huawei AppGallery Connect console. | 游戏的版本 | 华为 |
| PubKey | 华为 AppGallery Connect 控制台上的公钥。 | 华为 |
| App Secret | 华为 AppGallery Connect 控制台上的应用密码。 | 华为 |
| privacyPolicy | 华为 AppGallery Connect 控制台上的隐私声明地址。 | 华为 |
| Premium Price | 玩家下载游戏时所需支付的价格。 | 所有支持付费游戏的商店 |
| In-App Purchases | IAP 商品的名称。 | 所有 |
| GRAC certificate | 在韩国发行分级为 18+ 的游戏需要获得 GRAC 证书。如果需要该证书，请在此处上传。 | 三星 |
| Approval Number from SAPPRFT (aka ISBN) | 输入你在中国发行游戏的 SAPPRFT 批准文号。如果未获得中国发行许可，请从国家/地区列表中取消选中“中国”。 | 小米 华为 |
| Registration Number from MCPRC | 输入你在中国发行游戏的文化部备案号。 | 华为 |
| Launch Manually | 设置为在商店中手动发布游戏。 | 三星 华为 |
| Launch on | 指定在商店中发布游戏的日期和时间。 | 三星 华为 |
| Renew authentication | 选择此项可为选定的商店续订身份验证令牌。 | 华为 |
| Package Name | 显示包的名称。一旦登记，便无法编辑。 | QooApp Viveport |
| URL for Privacy Policy | 输入游戏隐私政策的 URL。 | Viveport |
| URL for EULA/Terms of Use | 输入游戏 EULA/使用条款的 URL。 | Viveport |
细节
如果提交中缺少任何内容，UDP 控制台会显示错误或警告消息。选择细节可展开有关该问题的更多信息。
错误显示在红色面板中。必须先修正错误，然后才能提交游戏。选择修改可进入错误区域以解决相关问题。
也可以选择只提交到没有错误的商店。
警告显示在黄色面板中。你可以关闭决定忽略的警告。
“状态”面板
UDP 开始处理你的游戏时，请访问状态面板来监控进度以及查看游戏的提交历史记录。
状态面板会显示游戏历史记录的概览。
| 字段 | 描述 |
|---|---|
| Revisions repacked | 使用 UDP 创建的重新打包的 APK 构建版本总数。 注意：如果针对同一家商店已将游戏重新打包三次，则计数为三次。 |
| Revisions submitted | 通过 UDP 提交的总次数。 注意：如果将游戏提交到商店五次，则计数为五次。 |
| Submissions accepted | 应用商店已接受的提交次数。 |
| Submissions rejected | 应用商店已拒绝的修订版数量。 |
对于每个游戏修订版，状态面板显示以下详细信息：
| 字段 | 描述 |
|---|---|
| Store | 将游戏提交到的商店。 |
| Status | 修订版状态。 并非所有商店都可以在进入“上线”状态之前提供可见性。“状态”部分仅提供可从商店获取的信息。 |
| Countries | 每个商店支持你游戏的国家/地区数量。选择此列中的数字可查看相应的国家/地区。 |
| Action | 执行其他操作，例如下载游戏的修订版或转到商店以完成发布步骤。 |
你的游戏可以具有以下状态：
- 已重新打包：已成功使用选定商店的 SDK 将游戏重新打包
- 已发布：游戏已完成了将游戏重新打包并提交到商店时该商店所需的所有步骤
- 待处理：正在使用选定商店的 SDK 将游戏重新打包
- 失败：无法使用选定商店的 SDK 将游戏重新打包
- 已取消：你或你组织中的某个人取消了你提交的游戏
Store Sign-Ups
The Store Sign-Ups tab displays information about the stores you can distribute your game to using UDP.
选择“更多”链接可获取有关商店的更多信息，例如概览、常见问题解答以及每个商店特有的其他有用链接。
For an overview of information for all stores, select Compare stores to open the Partner Stores cheatsheet. This compares details for all stores, including data such as number of users, countries in which the store is available, and whether or not the store supports premium games.
“报告”控制面板
“报告”选项卡显示已发布的游戏的表现信息。 你可以从“报告”控制面板监控已发布的游戏的性能（可从顶部导航栏访问该控制面板）。
你可以按游戏和/或按商店筛选“报告”控制面板上显示的信息。
如果没有在整个“报告”控制面板的所有游戏和所有商店筛选条件中选择任何选项，则可以查看单个图表级别的细分内容（如果适用）。在支持的图表上，选择按商店或按游戏筛选条件可查看特定商店或单个游戏的表现。
“报告”控制面板分为五个面板，所有面板均受“游戏”和“商店”筛选条件的约束。对于受日期筛选条件约束的面板，你可以将图表数据导出为 CSV 文件和图像。要将数据下载为 CSV 文件或图像，请选择图表的相应图标。
注意：仅当你使用 QueryOrder 设置了服务器端验证时，华为 AppGallery 才向 UDP 返回收入信息。如果你使用了回调通知，则华为没有与收入相关的图表或信息。
指标和定义
报告控制面板会跟踪发布游戏的 UDP 商店中的以下数据：
| 指标 | 描述 |
|---|---|
| Gross revenue | 从玩家处收取的金额（美元）（例如，如果 IAP 价格为 0.99，则此处为 $0.99） |
| Players | 下载并启动游戏的唯一身份用户数。这是按照唯一设备计算的。 |
| Spenders | 付费玩家的数量。也就是至少进行了一次成功付款的唯一身份用户数。 |
| Days since 1st activity | 自游戏在应用商店中达到 10 位玩家以来的天数。 |
| New Players | 在选定时间段内首次启动游戏的玩家数量。 |
| DAU | 日活跃用户。当天至少启动了一次游戏的唯一身份用户数。 |
| MAU | 月活跃用户。过去 30 天至少启动了一次游戏的唯一身份用户数。 |
| IAP Revenue | IAP 的总收入（美元）。 |
| Average Revenue per Transaction | 定义为收入/交易数量（美元）。 |
| ARPPU | 付费用户的平均收入（美元）。定义为总收入/付费玩家数量。 |
| ARPU | 用户的平均收入（美元）。定义为总收入/玩家数量。 |
| Spender Conversion Rate | 定义为付费玩家数量/玩家数量。 |
| Transactions | 产生付款的成功交易数量（OrderID 成功并已由 UDP 服务器验证）。 |
| Revenue by IAP | 按 IAP 对总收入进行细分（美元）。 |
| Transaction Volume by IAP | 按 IAP 对交易进行细分。 |
| Premium Revenue | 付费游戏产生的总收入（美元）。 |
| Sessions | 在任何设备上启动游戏的次数。 |
| Day 1 Retention (%) | 定义为首次启动游戏 1 天后仍活跃的玩家百分比。 |
| Day 7 Retention (%) | 定义为首次启动游戏 7 天后仍活跃的玩家百分比。 |
| Day 30 Retention (%) | 定义为首次启动游戏 30 天后仍活跃的玩家百分比。 |
注意：“报告”控制面板包含一些估计数据；你可以直接从商店获取确切的数字。显示的数据采用 UTC 时间，并且截止到前一天，旨在显示最准确的完整数据。
所有时间
此面板显示以下生命周期指标：
- 总收入（美元）
- 玩家
- 付费者
- 自第一次活动以来的天数
昨天
此面板显示最近 24 小时（基于 UTC）的以下指标：
- 总收入（美元），与前一天进行金额或百分比的比较
- 新玩家
- DAU，与最近 7 天的平均 DAU 值进行百分比的比较
- MAU，与最近 7 天的平均 MAU 值进行百分比的比较
IAP 表现
此面板显示选定日期范围的以下指标：
- IAP 收入
- 每笔交易的平均收入
- ARPPU
- ARPU
- 付费者转化率
- 交易
- IAP 收入。最多可以在图表中查看 5 个 IAP，并可通过下拉选择功能选择要查看的 IAP。此图表包含以下各项的预设：
- 最高收入
- 最多交易
- 最高价位
- 最低价位
- IAP 交易量。最多可以在图表中查看 5 个 IAP，并可通过下拉选择功能选择要查看的 IAP。此图表包含以下各项的预设：
- 最高收入
- 最多交易
- 最高价位
- 最低价位
游戏销售收入
此面板显示选定日期范围的以下指标：
- 游戏销售收入（付费下载收入）
游戏运行情况
此面板显示选定日期范围的以下指标：
- DAU - 每天的值以及一段时间的平均值
- MAU - 每天的值以及一段时间的平均值
- 新玩家 - 每天的值以及一段时间的总值
- 会话 - 每天的值以及一段时间的总值
- 第 1 天留存率 - 每天的值以及一段时间的平均值
- 第 7 天留存率 - 每天的值以及一段时间的平均值
- 第 30 天留存率 - 每天的值以及一段时间的平均值
Documentation
The Documentation tab displays useful information to help you get started, including:
- Links to the UDP documentation
- 不同应用商店的指南
- Video tutorials
Developer API
The Developer API tab lets you generate and manage authentication tokens for use with the UDP API. You can use the UDP API to upload binary files to the UDP console. See Managing and publishing your game on the UDP console
The table below describes the Developer API tab.
| 字段 | 描述 |
|---|---|
| Token | The authentication token to use to let the UDP API access the UDP console. Select COPY to copy the token to your clipboard. |
| Expiry date | The expiry date of the authentication token, if specified. |
| Operations | Edit or delete existing tokens. |
| NEW TOKEN | Select to create a new token. |
Company information
在“公司信息”窗口中可添加信息，以便在应用商店中显示你公司的信息。 在 UDP 控制台上，选择你的组织，然后选择铅笔图标以编辑简介信息。
| 字段 | 描述 |
|---|---|
| Company Name | 你希望玩家看到的公司名称。 |
| Location | 你希望定义为工作室总部的所在地。 |
| Company Size | 使用下拉选单指定公司人数。 |
| Official Website | 你公司的官方网站。 |
| Support Email Address | 玩家可以用来与你公司联系的支持电子邮件地址。 |
| About | 有关公司/工作室的任何其他信息。 |
CSV 参考
CSV 文件的数据值
应用内购的 CSV 文件中的每一行都可以包含以下值。不要传递空值。
| 字段 | 描述 |
|---|---|
| product_id | 代表唯一 IAP 商品的 ID。product_id 需要以小写字母或数字开头，并且只能由小写字母 (a-z)、数字 (0–9)、下划线 (_) 和句点 (.) 组成。 |
| language; product_name; description | 设置 language 值时，请使用表 A 中列出的语言代码。 UDP 使用 en-US 作为默认语言。 使用分号 (;) 来分隔 language、product_name 和 description。 要包含商品的本地化商品名称和描述，必须列出默认 language、product_name 和 description，然后列出每种区域设置的 language、product_names 和 description。在以下示例中，商品的默认语言为 en-US (ENGLISH)，本地化语言为 zh-CN (CHINESE)： en-US;Product 1;This is my first product; zh-CN; 产品1; 产品描述1。 注意：上传文件后，只会导入与“游戏信息”部分中已定义的语言相对应的字段。如果要支持多种语言，请在 UDP 控制台上定义这些语言，然后再导入 IAP 目录。 |
| consumable | 此值必须设置为 TRUE 或 FALSE（不区分大小写）。 |
| currency; price | 设置 currency 值时，请使用表 B 中列出的货币代码。price 必须为正。默认货币为美元 (USD)。每个 IAP 商品的价格必须直接列在相应的货币后面。例如：USD;0.99;CNY;6 |
表 A - 语言代码
| 语言 | 代码 |
|---|---|
| 南非荷兰语 | af |
| 阿姆哈拉语 | am |
| 保加利亚语 | bg |
| 加泰罗尼亚语 | ca |
| 中文 | zh-CN |
| 中文（中国香港） | zh-HK |
| 中文（中国台湾） | zh-TW |
| 克罗地亚语 | hr |
| 捷克语 | cs |
| 丹麦语 | da |
| 荷兰语 | nl |
| 英语（英国） | en-GB |
| 英语 | en-US |
| 爱沙尼亚语 | et |
| 菲律宾语 | fil |
| 芬兰语 | fi |
| 法语（加拿大） | fr-CA |
| 法语 | fr-FR |
| 德语 | de |
| 希腊语 | el |
| 印地语 | hi |
| 匈牙利语 | hu |
| 印尼语 | id |
| 意大利语 | it |
| 日语 | ja |
| 韩语 | ko |
| 拉脱维亚语 | lv |
| 立陶宛语 | lt |
| 马来语 | ms |
| 挪威语 | no |
| 波兰语 | pl |
| 葡萄牙语（巴西） | pt-BR |
| 葡萄牙语（葡萄牙） | pt-PT |
| 罗马尼亚语 | ro |
| 俄语 | ru |
| 塞尔维亚语 | sr |
| 斯洛伐克语 | sk |
| 斯洛文尼亚语 | sl |
| 西班牙语（拉丁美洲） | es |
| 西班牙语 | es-ES |
| 斯瓦希里语 | sw |
| 瑞典语 | sv |
| 泰语 | th |
| 土耳其语 | tr |
| 乌克兰语 | uk |
| 越南语 | vi |
| 祖鲁语 | zu |
表 B - 货币代码
| 代码 | 代码 | 代码 |
|---|---|---|
| AED | IDR | PEN |
| ARS | ILS | PHP |
| AUD | INR | PKR |
| BGN | IQD | PLN |
| BHD | ISK | QAR |
| BND | JOD | RON |
| BIF | JPY | RUB |
| BRL | KES | SAR |
| CAD | KHR | SDG |
| CHF | KRW | SEK |
| CNY | KWD | SGD |
| CZK | LAK | THB |
| DKK | LKR | TND |
| DZD | LYD | TRY |
| EGP | MAD | TWD |
| EUR | MMK | TZS |
| GBP | MXN | USD |
| GHS | MYR | UYU |
| HKD | NOK | VND |
| HRK | NZD | ZAR |
| HUF | OMR | |
示例 1
product_id,language; product_name; description,consumable,currency; price com.mystudio.mygame.product1,en-US;Product 1;This is my first product; zh-CN; 产品1; 产品描述1,TRUE,USD;0.99;CNY;6;EUR;0.79 com.mystudio.mygame.product2,en-US;Product 2;This is my second product; zh-CN; 产品2; 产品描述2,FALSE,USD;1.99;CNY;12;EUR;1.59 com.mystudio.mygame.product3,en-US;Product 3;This is my third product; zh-CN; 产品3; 产品描述3,TRUE,USD;4.99;CNY;30;EUR;3.99
示例 2
product_id,language; product_name; description,consumable,currency; price com.mystudio.mygame.product1,en-US;Product 1;This is my first product,TRUE,USD;0.99 com.mystudio.mygame.product2,en-US;Product 2;This is my second product,FALSE,USD;1.99 com.mystudio.mygame.product3,en-US;Product 3;This is my third product,TRUE,USD;4.99