版本:Unity 6 (6000.0)
语言 : 英语
使用 UDP 构建的 Firebase
UDP API

UDP 参考

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

UDP 控制台参考

本节提供 UDP 控制台信息架构的高级概述。

UDP 控制台包含一个导航栏,允许您在 UDP 控制台的以下部分之间导航

概述

UDP 控制台的“概述”选项卡包含有关如何使用 UDP 控制台的有用信息,包括

  • 教程视频
  • 帮助您跟踪进度的分步指南
  • 商店特定信息
  • 常见问题解答

我的游戏

“我的游戏”选项卡显示您的 UDP 项目。从这里,您可以切换 UDP 项目,创建新游戏,以及存档恢复游戏。

您可以按状态过滤游戏列表,例如

  • 所有游戏
  • 已发布到 UDP
  • 已提交到商店
  • 在商店中上线

如果您选择“已提交到商店”或“在商店中上线”,您还可以按商店过滤游戏列表。

当您选择一个游戏时,以下选项卡可用

  • 游戏信息
  • 发布
  • 状态

每张游戏卡都显示游戏的当前状态。已发布状态表示游戏已完成可用的步骤以重新打包并提交到商店。

游戏信息

使用“游戏信息”页面查看和编辑您的游戏信息。请参阅 在 UDP 控制台上输入游戏信息 要查看游戏的“游戏信息”页面,请在“我的游戏”选项卡中选择该卡片。

“游戏信息”页面包含以下部分

“游戏信息”页面包含一个进度条,用于显示您距离发布游戏还有多远。每个部分在您添加了该部分的必要信息后,都会显示“已完成”状态。

游戏描述

使用“游戏描述”部分输入应用商店将显示的您的游戏信息。

下表描述了所有参与商店需求的超集。并非所有商店都使用所有描述的属性。UDP 控制台会标记哪些字段是必需的,哪些是可选的。UDP 控制台还会指示任何特定于商店的语法需求。

属性 描述
从 Google Play 导入 如果您已经在 Google Play 上发布了您的游戏,您可以使用游戏的 Google Play URL 导入基本信息。
游戏标题 您的游戏的标题(此字段与编辑器同步)。
类型 表示您的游戏所属的类别。您可以从以下类别中选择:动作、冒险、街机、棋盘、纸牌、赌场、休闲、教育、音乐、益智、赛车、角色扮演、模拟、体育、策略、问答和文字。
设备 在智能手机、平板电脑或通用之间选择。
游戏图标 应用商店中显示的游戏图标。
简短描述 您的游戏的简短描述(最大 60 个字符),将在应用商店中显示。
描述 完整描述(4,000 个字符)您的游戏的完整描述,将在应用商店中显示。
游戏横幅 商店用来突出显示您的游戏的一张图像。例如,它可以是轮播中的一个位置。横向横幅是必需的,纵向横幅是可选的。
关键词 定义最多 4 个关键词(每个关键词 30 个字符)。这些关键词用于应用商店中的搜索目的。
特色视频 添加游戏的视频预告片。
注意:对于视频,一些商店只接受 MP4 文件,而另一些商店只接受 YouTube 链接。Unity 建议您同时上传两者。
屏幕截图 添加游戏的屏幕截图,包括封面图像(缩略图),以便在 MP4 视频未播放时叠加在 MP4 视频上。
每个方向至少添加四张图像。
一些应用商店只接受纵向或横向图像,而不是两者。如果您将纵向和横向图像都上传到 UDP,请在“首选方向”字段中选择您首选的方向。如果屏幕截图不符合商店的要求,UDP 会通知您。
对所有语言使用这些屏幕截图 启用此切换以对所有语言使用相同的屏幕截图。如果您要添加特定于语言的屏幕截图,请禁用此切换。
首选方向 某些商店只接受纵向或横向图像。对于此类商店,请指定要使用的图像方向。
评级 选择适合游戏的受众。

您可以为每个支持的语言指定元数据。要添加新语言,请在编辑模式下选择语言下拉菜单,然后选择“管理语言”。

二进制文件

使用“二进制文件”部分上传您的APKUnity 生成的 Android 包格式。当您选择“文件”>“构建并运行”时,APK 会自动部署到您的设备。 更多信息
请参阅 术语表
文件和 OBB 文件,或 AAB 文件

属性 描述
APK 文件(或 AAB) 您的 UDP 游戏构建。如果您通过构建自动化推送了 UDP 构建,则无需再次上传。
为了让 UDP 接受您的 APK 文件,APK 文件
- 必须包含一个 versionName
- 必须有一个 Initialize() 方法
- 必须有一个 Purchase() 方法(对于具有 IAP 的游戏)
如果您上传的新的 APK 版本包含不同的包名称,您将收到错误信息。这也将阻止发布新的 APK 版本。
要上传 Android 应用包 (AAB) 文件,请选择“从 AAB 文件转换”选项。UDP 将 AAB 文件转换为 APK,以便发布到商店。
版本代码 此字段仅在您将游戏上传到 UDP 后显示。
最低支持的 Android 版本 您的游戏支持的最低 Android 版本。此字段仅在您将游戏上传到 UDP 后显示。
新增功能 描述您游戏的此版本的更改内容。UDP 将这些信息发布到商店。
此字段仅在您将游戏上传到 UDP 后显示。
OBB 文件(主文件) 游戏或应用可能需要的附加资源的主要扩展文件。
OBB 文件(补丁) 对主扩展文件进行少量更新的可选文件。
您的游戏是否使用 Google Play 服务? 了解您是否使用 Google Play 服务可以帮助 UDP 在提交阶段更好地指导您。

OBB 文件不会在 构建自动化Unity 项目的持续集成服务,它可以自动化在 Unity 服务器上创建构建的过程。 更多信息
请参阅 术语表
部署期间推送,因此,如果您的游戏使用这些文件,您必须手动将它们上传到 UDP 控制台。

注意:您只能在默认语言视图(英语)中更改 APK 文件和 OBB 文件。

广告

下表描述了“广告”部分。

属性 描述
您的游戏是否包含广告 选择您的游戏是否包含广告。这些信息对于 UDP 在提交期间更好地指导您很有用。
您的游戏使用哪些广告中介解决方案?(可选) 如果您的游戏包含广告,请选择您的游戏使用哪些中介解决方案。
您的游戏使用哪些广告网络?(可选) 如果您的游戏包含广告,请选择您的游戏使用哪些广告网络。

某些商店要求您在提交给他们的游戏中实施其专有的广告网络。

UDP 会询问您的游戏是否包含广告,以便更好地告知您向商店提交的内容,尤其是如果 UDP 可以确定您的提交将因这些原因而被商店拒绝。

可能拒绝您游戏的商店会在“发布”部分显示一个警告图标,以及一个工具提示,以解释可能出现的错误。否则,UDP 不会以任何方式修改您游戏的广告实施。

注意:对最常见的中介层和广告网络的测试表明,针对 UDP 商店重新打包的游戏通常在接收广告活动方面没有问题。请随时与 UDP 支持 联系,了解您的广告设置及其是否适合通过 UDP 分发。请务必告知您的游戏使用哪些中介 SDK 和广告网络,以便更快地获得更准确的答复。

高级价格

高级价格是指玩家下载您的游戏所需的费用。

属性 描述
管理金额和货币 以美元设置游戏的价格。
选择“转换”以自动将美元价格转换为其他列出的货币。您还可以手动编辑特定货币的价格。

注意:您只能将高级游戏提交到支持高级游戏的商店。

应用内购买

使用“应用内购买”部分添加和管理 IAP 项目。

如果使用 UDP 包,UDP 会自动将您的游戏的 IAP 目录同步到 Unity 编辑器和 UDP 控制台之间。

属性 描述
搜索框 通过文本过滤 IAP 项目列表。
类型下拉菜单 按类型过滤 IAP 列表,即消耗型或非消耗型。
排序下拉菜单 选择如何对 IAP 项目列表进行排序。
添加项目 单击以添加新的 IAP 项目。这将打开一个窗口,以便输入 IAP 的详细信息。
管理金额和货币 单击以设置其他货币的价格。
转换 将 IAP 项目的美元价格转换为全球货币。这将覆盖为其他货币设置的任何手动价格。
常用货币 选择以打开“常用货币”窗口。要将货币设置为常用货币,请选择货币代码旁边的星形图标。这会将货币固定到列表顶部。取消选择星形图标以取消固定。
IAP 项目窗口

使用“IAP 项目”窗口添加和编辑 IAP 产品的详细信息。要打开此窗口,请选择“添加项目”。下表描述了“添加 IAP 项目”窗口的窗口。

字段 描述
产品 ID 用于标识 IAP 产品的唯一 ID。
产品 ID 必须符合以下要求
- 以字母或数字开头
- 仅包含字母、数字、点 (.) 和下划线 (_)
- 不得使用大写字母
产品名称 IAP 产品的名称。
货币 显示价格显示的货币。
价格 IAP 产品的美元价格。
您必须指定一个价格,才能让玩家购买游戏中的产品。
消耗型 为消耗型 IAP 项目选择此选项。
描述 IAP 产品的简短描述。

沙盒测试

“沙盒测试”部分显示游戏的测试状态。使用此部分创建用于在沙盒环境中进行测试的用户凭据,并查看测试的状态。下表描述了此部分的字段。

字段 描述
测试状态 显示游戏的测试状态。
UDP 初始化 显示初始化检查的测试状态。这将检查以确保 Initialize() 方法被调用(对于所有游戏)。
IAP 交易 显示 IAP 交易检查的测试状态。Purchase() 方法被调用(仅限于 IAP 游戏)。
沙盒测试帐户 沙盒测试帐户的电子邮件地址。这仅用作 UDP 沙盒环境的登录名。
密码 测试帐户的密码。

应用签名

UDP 使用应用程序签名私钥对提交到商店的重新打包的 APK 文件进行签名。

Unity 建议您选择 **导出并上传密钥和证书** 并使用您自己的应用程序签名私钥。如果您的游戏在 Google Play 上发布,请使用与 Google Play 上相同的密钥。这将大大降低用户安装游戏时 Google Play Protect 标记游戏的可能性。

**注意**:如果您的游戏被标记,您可以在此处向 Google 提出申诉 here.

下表描述了游戏信息选项卡的应用程序签名部分。

属性 描述
导出并上传密钥和证书(推荐) UDP 使用您上传的应用程序签名私钥来对重新打包的版本进行签名。如果您选择此选项,它将应用于您提交游戏的全部商店。
让 UDP 创建和管理应用程序签名私钥 UDP 为游戏重新打包的每个商店生成一个不同的应用程序签名私钥。
此选项会使您的游戏更容易受到 Google Play Protect 警告的影响。

**注意**:应用程序签名生成仅支持 Android SDK 版本 18 及更高版本。如果您的游戏使用低于此版本的 SDK 版本,请使用 RSA 算法签名或提高游戏的最低 API 级别。

更改密钥

您可以随时从使用 UDP 密钥切换到使用您自己的密钥。此更改仅适用于游戏尚未重新打包(并且因此未签名)的商店。如果您之前使用 UDP 密钥为商店重新打包,则该商店将始终使用 UDP 密钥。

只有在您没有为任何商店重新打包游戏(以及您自己的密钥)的情况下,才能从使用您自己的密钥切换到使用 UDP 密钥。

UDP 生成的密钥

在满足以下条件时,UDP 使用公司信息为重新打包的 APK 文件生成密钥库

  • 开发者上传的 APK 文件不包含密钥库文件。
  • 游戏尚未在合作伙伴商店重新打包。

如果未满足这些条件,UDP 将使用现有的 UDP 密钥库(如果可用),或者使用开发者信息生成新的签名文件。

集成信息

此信息与编辑器同步。以下字段可编辑

字段 描述
Unity 项目 ID 链接到 UDP 客户端的 Unity 项目 ID。
要将 Unity 项目与 UDP 客户端解除链接,请删除此字段中的 ID 并选择 **保存**。
**注意**:只有所有者和管理员可以编辑此字段。
回调 URL 游戏服务器的 URL。UDP 使用此 URL 发送有关付款结果的通知。

发布窗口

发布窗口允许您发布游戏的版本。当您在游戏信息页面中选择发布时,将显示此窗口。

发布窗口包含用于指定版本的字段

  • 标签
  • 发行说明

所有修订版本的标签和发行说明将显示在

  • 游戏信息部分,展开修订版下拉菜单时
  • 状态部分,按发布版本进行组织

**注意**:您只能将最新的修订版发布到商店。

详细了解

发布面板

使用发布面板注册商店并发布您的游戏。页面中的每个商店都有自己的部分。

下表描述了发布页面。

字段 描述
发布 发布选定的游戏。
仅显示接受游戏定价模式的商店 从发布页面隐藏不支持您游戏定价模式的商店。
所有商店 选择所有可见商店以进行发布。
商店复选框 选中商店的复选框,仅发布到选定的商店。
高级 对于支持高级游戏的商店,将显示高级标签。
IAP 对于支持 IAP 的商店,将显示 IAP 标签。
信息图标 信息图标说明商店与 UDP 的集成程度是完全集成还是部分集成。
注册 注册到选定的商店。
国家/地区 选择国家/地区以选择要发布游戏的国家/地区。
这将打开一个窗口,其中包含商店支持的国家/地区列表。选中复选框以启用游戏的国家/地区,然后选择保存。
此选项仅在您注册商店后显示。
高级 选择以配置特定商店的高级属性。
此选项仅在您注册商店后显示。

目标步骤

在发布选项卡中,每个商店都包含一个下拉菜单,允许您为给定商店选择目标步骤。以下选项可用

目标步骤 描述
重新打包游戏 UDP 将解压缩通用 UDP 构建并使用选定商店的 SDK 重新打包您的游戏。这将使用您上次提交到商店的构建中的 IAP 目录。
提交到商店 UDP 将重新打包并提交您的游戏、元数据和 IAP 目录到选定商店的生产环境。
首次发布游戏时,您必须将其提交以在商店服务器上创建 IAP 目录。

高级设置

要在提交游戏之前配置特定于商店的设置,请在发布选项卡中选择商店的高级。您可以为商店专门配置以下属性

属性 功能 受影响的商店
目标 SDK 发布游戏的商店 SDK 版本。默认情况下,UDP 将重新打包以用于商店 SDK 的最新版本。 全部
CP ID 华为应用市场 Connect 控制台上的商户 ID。 华为
产品 ID 华为应用市场 Connect 控制台上的产品 ID。 华为
App ID 华为应用市场 Connect 控制台上的应用程序 ID。 华为
华为应用市场 Connect 控制台上的配置版本。 游戏的版本 华为
PubKey 华为应用市场 Connect 控制台上的公钥。 华为
App Secret 华为应用市场 Connect 控制台上的 App 密钥。 华为
privacyPolicy 华为应用市场 Connect 控制台上的隐私声明地址。 华为
高级价格 玩家下载游戏的价格。 所有支持高级游戏的商店
应用内购买 IAP 项目的名称。 全部
来自 SAPPRFT 的审批编号(又称 ISBN) 输入在中国发布的游戏的 SAPPRFT 审批编号。如果您没有此许可证,请从国家/地区列表中取消选中中国。 小米
华为
来自 MCPRC 的注册号 在中国发布的游戏的文化部备案号。 华为
手动启动 设置为在商店手动启动游戏。 华为
在…上启动 指定在商店启动游戏的日期和时间。 华为
更新身份验证 选择以更新选定商店的身份验证令牌。 华为
包名 显示包的名称。注册后,此名称不可编辑。 QooApp
Viveport
隐私政策 URL 输入游戏的隐私政策的 URL。 Viveport
EULA/使用条款 URL 输入游戏的 EULA/使用条款的 URL。 Viveport

详细信息

如果提交内容缺失,UDP 控制台将显示错误或警告消息。选择 **详细信息** 以展开以获取有关问题的更多信息。

错误以红色面板显示。您必须在提交游戏之前修复错误。选择 **修改** 以转到错误区域以修复问题。

您也可以选择只提交到没有错误的商店。

警告以黄色面板显示。您可以忽略您决定忽略的警告。

状态面板

当 UDP 开始处理您的游戏时,请访问 **状态** 面板以监控进度并检查游戏的提交历史记录。

**状态** 面板显示游戏的历史记录概述。

字段 描述
重新打包的修订版 使用 UDP 创建的重新打包的 APK 构建总数。
**注意**:如果游戏为相同的商店重新打包了三次,则计为三次。
提交的修订版 通过 UDP 进行的提交总数。
**注意**:如果游戏提交到商店五次,则计为五次。
已接受的提交 已接受到应用商店的提交数量。
已拒绝的提交 应用商店拒绝的修订版数量。

对于每个游戏修订版,**状态** 面板将显示以下详细信息

字段 描述
商店 游戏提交到的商店。
状态 修订版的状态。
并非所有商店都能提供可见性,直到“实时”状态。状态部分只提供商店可以获取的信息。
国家/地区 每个商店的游戏启用的国家/地区数量。选择此列中的数字以查看国家/地区。
操作 执行其他操作,例如 **下载** 游戏的修订版或 **转到商店** 以完成发布步骤。

您的游戏可以具有以下状态

  • **重新打包**:您的游戏已成功使用选定商店的 SDK 重新打包
  • **已发布**:您的游戏已通过使用选定商店的 SDK 重新打包和提交到该商店时所需的所有步骤
  • **待定**:您的游戏正在使用选定商店的 SDK 重新打包
  • **失败**:您的游戏无法使用选定商店的 SDK 重新打包
  • **已取消**:您或您的组织中的某人取消了您的游戏提交

商店注册

商店注册选项卡显示有关您可以使用 UDP 分发游戏的商店的信息。

选择更多链接以获取有关商店的更多信息,例如概述、常见问题解答以及特定于每个商店的其他有用链接。

要查看所有商店的信息概述,请选择 **比较商店** 以打开合作伙伴商店备忘单。这将比较所有商店的详细信息,包括数据,例如用户数量、商店可用的国家/地区以及商店是否支持高级游戏。

报告仪表板

报告选项卡显示已发布游戏的性能信息。从报告仪表板监控已发布游戏的性能,该仪表板可从顶部导航栏访问。

您可以按游戏和商店筛选报告仪表板中显示的信息。

如果您未在整个报告仪表板的 **所有游戏** 和 **所有商店** 过滤器中选择任何内容,则可以查看单个图表级别的细分(如果适用)。在受支持的图表上,选择 **按商店** 或 **按游戏** 过滤器以查看特定商店或单个游戏的性能。

报表仪表盘分为五个面板,都受游戏和商店过滤器的影响。对于受日期过滤器影响的面板,您可以将图表数据导出为 CSV 文件和图像。要将数据下载为 CSV 文件或图像,请选择图表对应的图标。

注意:华为应用市场仅在您使用 QueryOrder 设置服务器端验证的情况下才会将收入信息返回给 UDP。如果您使用回调通知,则华为将不提供任何与收入相关的图表或信息。

指标和定义

报表仪表盘跟踪来自发布游戏的 UDP 商店的以下数据

指标 描述
总收入 从玩家那里收取的金额,以美元计(例如,如果 IAP 价格 = 0.99,则 = 0.99 美元)。
玩家 下载并启动游戏的唯一用户数。这是通过唯一设备计算的。
付费玩家 付费玩家的数量。也就是说,至少进行过一次成功支付的唯一用户数。
自首次活动以来的天数 游戏在应用商店达到 10 名玩家以来的天数。
新玩家 在选定时间段内首次启动游戏的玩家数量。
DAU(每日活跃用户) 在特定日期启动会话的不同玩家的数量。DAU 包括新玩家和回归玩家。 更多信息
参见 术语表
每日活跃用户。在当天至少启动过一次游戏的唯一用户数量。
MAU(月活跃用户) 在过去 30 天内启动过会话的玩家数量。 更多信息
参见 术语表
月活跃用户。在过去 30 天内至少启动过一次游戏的唯一用户数量。
IAP 收入 来自 IAP 的总收入,以美元计。
每笔交易平均收入 定义为收入 / 交易次数,以美元计。
ARPPU(每付费用户平均收入) 完成过已验证 IAP 交易的用户的平均已验证 IAP 收入。 更多信息
参见 术语表
每付费用户平均收入,以美元计。定义为总收入 / 付费玩家数量。
ARPU 每用户平均收入,以美元计。定义为总收入 / 玩家数量。
付费玩家转化率 定义为付费玩家数量 / 玩家数量。
交易 导致支付的成功交易数量(订单号已成功且已由 UDP 服务器验证)。
按 IAP 分类的收入 按 IAP 分类的总收入,以美元计。
按 IAP 分类的交易量 按 IAP 分类的交易量。
付费游戏收入 付费游戏产生的总收入,以美元计。
会话 游戏在任何设备上启动的次数。
第一天留存率第一次玩游戏后第二天返回游戏的玩家百分比。 更多信息
参见 术语表
(%)
定义为第一次游戏启动后第一天仍然活跃的玩家百分比。
第七天留存率第一次玩游戏后第七天返回游戏的玩家百分比。 更多信息
参见 术语表
(%)
定义为第一次游戏启动后第七天仍然活跃的玩家百分比。
第三十天留存率第一次玩游戏后第三十天返回游戏的玩家百分比。 更多信息
参见 术语表
(%)
定义为第一次游戏启动后第三十天仍然活跃的玩家百分比。

注意:报表仪表盘包含估计数据;您可以直接从商店获取确切数字。显示的数据为 UTC 时间,截至前一天,以显示最准确、最完整的数据。

全部时间

此面板显示以下终身指标

  • 总收入(以美元计)
  • 玩家
  • 付费玩家
  • 自首次活动以来的天数

昨天

此面板显示过去完整的 24 小时内(以 UTC 为准)的以下指标

  • 总收入(以美元计)与前一天相比,显示 $ 或 % 变化
  • 新玩家
  • DAU 与过去 7 天的平均 DAU 值相比,显示 % 变化
  • MAU 与过去 7 天的平均 MAU 值相比,显示 % 变化

IAP 绩效

此面板显示选定日期范围内的以下指标

  • IAP 收入
  • 每笔交易平均收入
  • ARPPU
  • ARPU
  • 付费玩家转化率
  • 交易
  • 按 IAP 分类的收入。您可以在图表中查看最多 5 个 IAP,并通过下拉选择器选择要查看的 IAP。此图表包含以下预设
    • 收入最多
    • 交易次数最多
    • 最高价格点
    • 最低价格点
  • 按 IAP 分类的交易量。您可以在图表中查看最多 5 个 IAP,并通过下拉选择器选择要查看的 IAP。此图表包含以下预设
    • 收入最多
    • 交易次数最多
    • 最高价格点
    • 最低价格点

付费游戏收入

此面板显示选定日期范围内的

  • 付费游戏收入(来自付费下载的收入)

游戏健康

此面板显示选定日期范围内的以下指标

  • DAU - 每天和该期间的平均值
  • MAU - 每天和该期间的平均值
  • 新玩家 - 每天和该期间的总数
  • 会话 - 每天和该期间的总数
  • 第一天留存率 - 每天和该期间的平均值
  • 第七天留存率 - 每天和该期间的平均值
  • 第三十天留存率 - 每天和该期间的平均值

文档

“文档”选项卡显示有助于您入门的有用信息,包括

  • 指向 UDP 文档的链接
  • 不同应用商店的指南
  • 视频教程

资源

“资源”选项卡提供有助于您入门的有用信息,包括

  • 入门指南
  • 教程视频
  • 商店指南
  • 知识库
  • 发行说明

设置

公司信息

使用“公司信息”窗口在应用商店中添加要为您的公司显示的信息。在 UDP 控制台中,选择您的组织并选择铅笔图标以编辑个人资料。

字段 描述
公司名称 您希望玩家看到您的公司名称。
公司图标 上传要为您的公司显示的图像。
位置 您希望将其定义为工作室总部的所在地。
公司规模 使用下拉菜单指定您公司的人员数量。
官方网站 您公司的官方网站。
支持电子邮件地址 玩家可以使用此支持电子邮件与您的公司联系。
介绍 有关您公司/工作室的任何其他信息。

开发者 API

“开发者 API”页面允许您生成和管理用于与 UDP API 一起使用的身份验证令牌。您可以使用 UDP API 将二进制文件上传到 UDP 控制台。请参见 在 UDP 控制台中管理和发布游戏

下表描述了“开发者 API”页面。

字段 描述
令牌 用于允许 UDP API 访问 UDP 控制台的身份验证令牌。选择“复制”将令牌复制到剪贴板。
过期日期 如果指定了身份验证令牌的过期日期。
操作 编辑或删除现有令牌。
新建令牌 选择以创建新令牌。

CSV 参考

CSV 文件的数据值

应用内购买的 CSV 文件中的每一行都可以包含以下值。不要传递空值。

字段 描述
product_id 表示唯一 IAP 产品的 ID。product_id 必须以小写字母或数字开头,并且只能包含小写字母 (a-z)、数字 (0-9)、下划线 (_) 和句点 (.)。
language; product_name; description 设置 language 值时,请使用 TABLE A 中列出的语言代码。
UDP 使用 en-US 作为默认语言。
使用分号 (;) 分隔 language、product_name 和 description。
要包含项目的 product_name 和 description 的本地化版本,请列出默认语言、product_name 和 description,然后列出每个语言环境的语言、product_name 和 description。在以下示例中,该产品使用 en-US(英语)作为默认语言,使用 zh-CN(中文)作为本地化
en-US;Product 1;This is my first product; zh-CN; 产品1; 产品描述1.
注意:UDP 仅导入您在 UDP 控制台的“游戏信息”部分中定义的语言的字段。要支持多种语言,请在导入 IAP 目录之前在 UDP 控制台中定义这些语言。
consumable 设置为 TRUE 或 FALSE(不区分大小写)以定义 IAP 产品是否可消耗。
auto_convert_prices 如果为 true,UDP 会自动将价格转换为其他货币。要从转换中排除货币,请在 currency;price 字段中指定货币及其价格。
currency; price 设置 currency 值时,请使用 TABLE B 中列出的货币代码。价格必须为正数。默认货币为 USD。每个 IAP 产品的价格必须紧跟其对应的货币。例如:USD;0.99;CNY;6

TABLE 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

TABLE B - 货币代码

代码 代码 代码
AED 印尼盾 秘鲁索尔
ARS增强现实 更多信息
参见 词汇表
以色列新谢克尔 菲律宾比索
澳大利亚元 印度卢比 巴基斯坦卢比
保加利亚列弗 伊拉克第纳尔 波兰兹罗提
巴林第纳尔 冰岛克朗 卡塔尔里亚尔
文莱元 约旦第纳尔 罗马尼亚列伊
布隆迪法郎 日元 俄罗斯卢布
巴西雷亚尔 肯尼亚先令 沙特里亚尔
加拿大元 柬埔寨瑞尔 苏丹镑
瑞士法郎 韩元 瑞典克朗
人民币 科威特第纳尔 新加坡元
捷克克朗 老挝基普 泰铢
丹麦克朗 斯里兰卡卢比 突尼斯第纳尔
阿尔及利亚第纳尔 利比亚第纳尔 土耳其里拉
埃及镑 摩洛哥迪拉姆 新台币
欧元 缅甸缅元 坦桑尼亚先令
英镑 墨西哥比索 美元
加纳塞地 马来西亚林吉特 乌拉圭比索
港元 挪威克朗 越南盾
克罗地亚库纳 新西兰元 南非兰特
匈牙利福林 阿曼里亚尔

示例 1

product_id,language; product_name; description,consumable,auto_convert_prices,currency; price
com.mystudio.mygame.product1,en-US;Product 1;This is my first product; zh-CN; 产品1; 产品描述1,TRUE,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,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,TRUE,USD;4.99;CNY;30;EUR;3.99
使用 UDP 构建的 Firebase
UDP API