# UDP 参考 > Reference for the Unity Distribution Portal console, a service that shut down in February 2025. | **重要提示** | | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Unity Distribution Portal (UDP) 将于 2025 年 2 月 17 日关闭。自该日起，Unity Distribution Portal (UDP) 网页控制台及相关服务将永久停用。要下载密钥库以及如何将游戏直接重新发布到应用商店的说明，请访问 [UDP 概述](https://api-udp.unity.com/overview)页面。如果您对帐户有任何疑问，请向 [Unity 客户支持](https://support.unity.com/hc/en-us/requests/new?ticket_form_id=360000323692)部门提交工单。 | ## UDP 控制台参考 本节提供有关 UDP 控制台的信息架构的简要概述。 UDP 控制台包含一个导航栏，可在 UDP 控制台的以下部分之间进行导航： * [概述 (Overview)](#start) * [我的游戏 (My Games)](#games) * [商店注册 (Store Sign-Ups)](#partner) * [报告 (Reporting)](#reporting) * [文档 (Documentation)](#docs) * [资源 (Resources)](#resources) * [设置 (Settings)](#settings) * [开发者 API (Developer API)](#dev-api) ### 概述 UDP 控制台的概述 (Overview) 选项卡包含有关如何使用 UDP 控制台的有用信息，包括： * 教程视频 * 一个可帮助跟踪进度的概要指南 * 特定于商店的信息 * 常见问题解答 ### 我的游戏 我的游戏 (My Games) 选项卡显示您的 UDP 项目。在此处可以在 UDP 项目之间切换，[创建新游戏](/engine/6000.0/manual/unity-services/udp/distribution.md#create)，以及[存档](/engine/6000.0/manual/unity-services/udp/managing-and-publishing.md#archive)和[恢复](/engine/6000.0/manual/unity-services/udp/managing-and-publishing.md#restore)游戏。 您可以按状态过滤游戏列表，例如： * **所有游戏 (All Games)** * **发布到 UDP (Published to UDP)** * **提交到商店 (Submitted to stores)** * **已在商店上线 (Live on stores)** 如果您选择**提交到商店 (Submitted to stores)** 或者**已在商店上线 (Live on stores)**，您还可以按商店过滤游戏列表。 选择一个游戏后，可看到以下选项卡： * 游戏信息 (Game Info) * 发布 (Publish) * 状态 (Status) 每张游戏卡都会显示游戏的状态。已发布 (Published) 状态表示游戏已完成重新打包和提交至商店所需的所有步骤。 #### 游戏信息 使用游戏信息 (Game Info) 页面查看和编辑游戏信息。请参阅[在 UDP 控制台输入游戏信息](/engine/6000.0/manual/unity-services/udp/distribution.md#edit) 如要查看游戏的游戏信息页面，请在我的游戏 (My Games) 选项卡中选择游戏卡。 游戏信息页面包含以下部分： * [游戏描述 (Game Description)](#desc) * [二进制文件 (Binary)](#binary) * [广告 (Ads)](#ads) * [付费价格 (Premium Price)](#premium) * [应用内购 (In-App Purchases)](#iap) * [沙盒测试 (Sandbox Testing)](#sandbox) * [应用签名 (App Signature)](#app-sign) * [集成信息 (Integration Information)](#integrate) **Frame:** ![](/api/media?file=/engine/6000.0/media/images/UDPManagingGame_01.png) 游戏信息页面包含一个进度条，显示距离游戏发布目标的进度。当您为每个部分添加了必要信息后，该部分会显示**已完成 (Completed)** 状态。 #### 游戏描述 使用游戏描述 (Game Description) 部分输入应用商店将会显示的游戏信息。 下表介绍了所有目标商店的要求超集。并非所有商店都使用表中介绍的所有属性。UDP 控制台会标记哪些字段是必填字段，哪些是可选字段。UDP 控制台还指示特定于各个应用商店特有的语法要求。 | 属性 | 描述 | | ------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **Import from Google Play** | 如果已经在 Google Play 上发布了游戏，可使用游戏的 Google Play URL 导入基本信息。 | | **Game Title** | 游戏名称（该字段与编辑器同步）。 | | **Genre** | 指示游戏所属的类别。选项包括：动作游戏、冒险游戏、街机游戏、棋盘游戏、卡牌游戏、博彩游戏、休闲游戏、教育游戏、音乐游戏、解谜游戏、竞速游戏、角色扮演游戏、模拟经营游戏、体育游戏、策略游戏、益智问答游戏和文字游戏。 | | **Device** | 选项包括：智能手机、平板电脑或通用。 | | **Game Icon** | 要在应用商店中显示的游戏图标。 | | **Short Description** | 要在应用商店中显示的游戏简短描述（最多 60 个字符）。 | | **Description** | 要在应用商店中显示的游戏完整描述（4,000 个字符）。 | | **Game Banners** | 商店用来推荐游戏的图像。例如，可以是轮播中的一个展示位置。横向横幅是必选项，纵向横幅是可选项。 | | **Keywords** | 最多定义 4 个关键字（每个关键字最多 30 个字符）。这些关键字用于在应用商店中进行搜索。 | | **Feature Video** | 为游戏添加视频预告片。**注意**：对于视频，一些商店仅接受 MP4 文件，而其他商店仅接受 Youtube 链接。Unity 建议两种格式都上传。 | | **Screenshots** | 添加游戏的屏幕截图，包括封面图像（缩略图），在 MP4 视频不播放时，这张封面图片（缩略图）会显示出来。对于所使用的屏幕方向，至少添加四张图像。有些应用商店仅接受纵向或横向图像，不能两者都接受。如果同时将纵向和横向图像上传到 UDP，请在**偏好 (Preference)** 字段中选择偏好方向。如果屏幕截图不符合商店的要求，UDP 会进行通知。 | | **Use these screenshots for all languages** | 启用此开关可为所有语言使用相同的屏幕截图。如果要添加特定于语言的屏幕截图，请禁用此开关。 | | **Preference** | 某些商店仅接受纵向或横向图像。对于此类商店，请指定要使用的图像方向。 | | **Ratings** | 选择游戏适合的受众。 | 可为每种支持的语言指定元数据。要添加新语言，请在编辑模式下选择语言下拉选单，然后选择管理语言 (Manage Languages)。 **Frame:** ![](/api/media?file=/engine/6000.0/media/images/UDPManagingGame_02.png) #### 二进制文件 使用二进制文件 (Binary) 部分上传您的 APK 文件和 OBB 文件或 AAB 文件： | 属性 | 描述 | | -------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **APK Files (or AAB)** | UDP 游戏构建。如果您通过 Build Automation 推送了 UDP 构建，则无需再次上传。为了使 UDP 接受 APK 文件，APK 文件：- 必须包含 `versionName`- 必须具有 `Initialize()` 方法- 必须具有 `Purchase()` 方法（适用于具有 IAP 的游戏）如果上传的新 APK 版本包含不同的包名称，则会收到一条错误提示信息。这也会阻止发布新的 APK 版本。要上传 Android App Bundle (AAB) 文件，请选择 **从 AAB 文件转换 (Convert from AAB file)** 选项。UDP 将 AAB 文件转换为 APK 以发布到商店。 | | **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 在提交阶段更好地为您提供指导。 | 在 Build Automation 部署期间不会推送 OBB 文件，因此，如果游戏使用了 OBB 文件，则必须手动将它们上传到 UDP 控制台。 **注意**：只能在默认语言视图（英语）中更改 APK 文件和 OBB 文件。 #### 广告 下表介绍了广告 (Ads) 部分。 | 属性 | 描述 | | ------------------------------------------------------- | --------------------------------------- | | **Does your game contain ads** | 选择游戏是否包含广告。此信息可由 UDP 用于在提交过程中更好地为您提供指导。 | | **What ad mediation solutions does your game use?**（可选） | 如果游戏包含广告，请选择游戏使用哪种聚合解决方案。 | | **What ad networks does your game use?**（可选） | 如果游戏包含广告，请选择游戏使用哪种广告网络。 | 某些商店希望您在提交给他们的游戏中采用他们专有的广告网络。 UDP 会询问游戏中是否包含广告，以便更好地了解提交到商店的内容，尤其是 UDP 可以确定所提交内容将因此被商店拒绝的情况下。 可能拒绝游戏的商店会在发布 (Publish) 部分中显示警告图标，并提供工具提示以说明可能发生的问题。否则，UDP 不会以任何方式修改游戏的广告实现。 **注意**：对最常见的聚合层和广告网络的测试表明，为 UDP 商店重新打包的游戏通常在接收广告活动方面没有问题。请随时向 [UDP 支持部门](https://support.unity.com/hc/en-us/requests/new?ticket_form_id=360000323692)询问广告设置及其是否适合通过 UDP 分发。为了更快获得更可靠的答案，务必提及您的游戏使用哪种聚合 SDK 和广告网络。 #### 付费价格 付费价格 (Premium price) 是玩家下载游戏时所需支付的价格。 | 属性 | 描述 | | --------------------------------- | ---------------------------------------------------------------- | | **Manage amounts and currencies** | 以美元设置游戏价格。选择**转换 (Convert)** 可将美元价格自动转换为其他列出的货币。您还可以手动编辑特定货币的价格。 | **注意**：只能将付费游戏提交到支持付费游戏的商店。 #### 应用内购 在应用内购 (In-App Purchases) 部分中可添加和管理 IAP 商品。 如果使用 UDP 包，UDP 会自动使游戏的 IAP 目录在 Unity 编辑器和 UDP 控制台之间保持同步。 | 属性 | 描述 | | --------------------------------- | ------------------------------------------------------------------------------------------------ | | Search box | 按文本筛选 IAP 商品列表。 | | Type dropdown | 按类型（即消耗品或非消耗品）筛选 IAP 列表。 | | Sort dropdown | 选择如何对 IAP 商品列表进行排序。 | | **Add Item** | 单击此项可添加新的 IAP 商品。此时将打开一个窗口以输入 IAP 详细信息。 | | **Manage amounts and currencies** | 单击此项可设置其他货币的价格。 | | **Convert** | 将 IAP 商品的美元价格转换为全球货币。这将覆盖手动设置的任何其他货币价格。 | | **Favourite Currencies** | 选择此项可打开常用货币 (Favourite currencies) 窗口。要将货币设置为常用货币，请选择相应货币代码旁边的星形图标。这会将货币固定在列表的顶部。取消选择星形图标即可取消固定。 | ##### IAP 项目窗口 在 IAP 项目 (IAP Item) 窗口中可添加和编辑 IAP 商品的详细信息。要打开此窗口，请选择**添加项目 (Add Item)**。下表介绍了**添加 IAP 项目 (Add IAP Item)** 窗口中的字段。 | 字段 | 描述 | | ---------------- | ------------------------------------------------------------------------------- | | **Product ID** | 用于标识 IAP 商品的唯一 ID。商品 ID 必须遵循以下要求：- 以字母或数字开头- 仅包含字母、数字、点 (.) 和下划线 (\_)- 不得使用大写字母 | | **Product Name** | IAP 商品的名称。 | | Currency | 显示价格所用的货币。 | | Price | IAP 商品的价格（美元 USD）。必须指定一个价格，玩家才能在游戏中购买商品。 | | **Consumable** | 选择此选项表示 IAP 商品为消耗品。 | | **Description** | IAP 商品的简短描述。 | #### 沙盒测试 沙盒测试 (Sandbox Testing) 部分显示游戏的测试状态。在此部分中可创建用于在沙盒环境中进行测试的用户凭据，并会显示测试状态。下表介绍了此部分的字段。 | 字段 | 描述 | | ------------------------ | --------------------------------------------------- | | **Test status** | 显示游戏的测试状态。 | | **UDP Initialization** | 显示初始化检查的测试状态。这项检查旨在确保调用 Initialize() 方法（适用于所有游戏）。 | | **IAP Transaction** | 显示 IAP 交易检查的测试状态。此情况下会调用 Purchase() 方法（仅适用于 IAP 游戏） | | **Sandbox Test Account** | 沙盒测试帐户的电子邮件地址。这仅用作 UDP 沙盒环境的登录名。 | | **Password** | 测试帐户的密码。 | #### 应用签名 UDP 使用应用签名私钥对提交到商店的重新打包的 APK 文件进行签名。 Unity 建议选择**导出并上传密钥和证书**，并使用自己的应用签名私钥。如果在 Google Play 上发布了游戏，请使用与 Google Play 上相同的密钥。这样可以大大降低当用户安装游戏时，游戏被 Google Play Protect 标记的可能性。 **注意**：如果游戏被标记，您可以在[此处](https://support.google.com/googleplay/android-developer/answer/2992033?hl=en)向 Google 求助。 下表介绍了游戏信息 (Game Info) 选项卡的应用签名 (App Signature) 部分。 | 属性 | 描述 | | ----------------------------------------------------------- | ----------------------------------------------------------------------- | | **Export and upload the key and certificate (recommended)** | UDP 使用上传的应用签名私钥对重新打包的构建版本进行签名。如果选择此选项，则会应用于将游戏提交到的所有商店。 | | **Let UDP create and manage App signing private key** | UDP 为每个需要重新打包游戏的商店生成一个不同的应用签名私钥。此选项会使游戏更容易受到 Google Play Protect 警告的影响。 | **注意**：只有 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 并选择**保存 (Save)**。**注意**：只有所有者和管理员才能编辑此字段。 | | **Callback URL** | 游戏服务器的 URL。UDP 使用此 URL 发送有关付款结果的通知。 | #### 发布窗口 在发布 (Release) 窗口中可以发布游戏的版本。在游戏信息 (Game Info) 页面中选择发布 (Release) 时，将显示此窗口。 发布窗口中包含用于指定以下版本信息的字段： * 标签 * 发行说明 所有修订版的标签和发行说明在以下位置可见： * 游戏信息 (Game Info) 部分（展开修订 (Revision) 下拉选单时） * 状态 (Status) 部分（由发布 (Release) 进行组织） **注意**：只能将最新的修订版发布到商店。 了解更多信息： * [编辑修订版](/engine/6000.0/manual/unity-services/udp/managing-and-publishing.md#release) * [向不同的商店提交不同的修订版](/engine/6000.0/manual/unity-services/udp/managing-and-publishing.md#select-target) ### 发布面板 在发布 (Publish) 面板中可向商店注册并发布游戏。每个商店在此页面中都有自己对应的部分。 **Frame:** ![](/api/media?file=/engine/6000.0/media/images/UDPManagingGame_11.png) 下表介绍了发布页面。 | 字段 | 描述 | | --------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- | | **Publish** | 发布选定的游戏。 | | **Only show stores that accept the game’s pricing model** | 在发布 (Publish) 页面中隐藏不支持游戏定价模型的商店。 | | **All Stores** | 选择所有可见的商店进行发布。 | | Store checkbox | 选中商店的复选框表示仅发布到选定的商店。 | | **Premium** | 支持付费游戏的商店将显示付费 (Premium) 标签。 | | **IAP** | 支持 IAP 的商店将显示 IAP 标签。 | | Info icon | 信息图标 (Info icon) 指明商店是与 UDP 完全集成还是部分集成。 | | **Sign up** | 注册到选定的商店。 | | **Countries** | 选择国家/地区 (Countries) 以选择要将游戏发布到的国家/地区。此时将打开一个窗口，其中包含商店支持的国家/地区列表。选中要为某个国家/地区启用游戏的复选框，然后选择保存 (Save)。此选项仅在注册商店时才会显示。 | | **Advanced** | 选择此项可配置特定商店的高级属性。此选项仅在注册商店时才会显示。 | #### 目标步骤 在发布 (Publish) 选项卡中，每个商店都有一个下拉选单，允许选择给定商店的目标步骤。可用的选项如下： | 目标步骤 | 描述 | | ---------- | -------------------------------------------------------------------------- | | **重新打包游戏** | UDP 将通用 UDP 构建版本解包，并使用选定商店中的 SDK 重新打包游戏。此过程将使用提交到商店的上一个构建版本中的 IAP 目录。 | | **提交到商店** | UDP 重新打包游戏，并将游戏、元数据和 IAP 目录提交到选定商店的生产环境。首次发布游戏时，必须提交游戏才能在商店的服务器上创建 IAP 目录。 | ### 高级设置 要在提交游戏之前配置特定于商店的设置，请在发布 (Publish) 选项卡中为商店选择高级 (Advanced)。您可以为商店专门配置以下属性： | 属性 | 功能 | 影响的商店 | | ------------------------------------------------------------------- | ------------------------------------------------------- | -------------- | | **Target SDK** | 将游戏发布到的商店 SDK 版本。默认情况下，UDP 会针对最新版本的商店 SDK 进行重新打包。 | 所有 | | **CP ID** | 华为 AppGallery Connect 控制台上的商家 ID。 | Huawei | | **Product ID** | 华为 AppGallery Connect 控制台上的商品 ID。 | Huawei | | **App ID** | 华为 AppGallery Connect 控制台上的应用程序 ID。 | Huawei | | **Configuration version on the Huawei AppGallery Connect console.** | 游戏的版本 | Huawei | | **PubKey** | 华为 AppGallery Connect 控制台上的公钥。 | Huawei | | **App Secret** | 华为 AppGallery Connect 控制台上的应用密码。 | Huawei | | **privacyPolicy** | 华为 AppGallery Connect 控制台上的隐私声明地址。 | Huawei | | **Premium Price** | 玩家下载游戏时所需支付的价格。 | 所有支持付费游戏的商店 | | **In-App Purchases** | IAP 商品的名称。 | 所有 | | **Approval Number from SAPPRFT (aka ISBN)** | 输入在中国发行游戏的 SAPPRFT 批准文号。如果未获得中国发行许可，请从国家/地区列表中取消选中“中国”。 | XiaomiHuawei | | **Registration Number from MCPRC** | 输入您在中国发行游戏的文化部备案号。 | Huawei | | **Launch Manually** | 设置为在商店中手动发布游戏。 | Huawei | | **Launch on** | 指定在商店中发布游戏的日期和时间。 | Huawei | | **Renew authentication** | 选择此项可为选定的商店续订身份验证令牌。 | Huawei | | **Package Name** | 显示包的名称。一旦登记，便无法编辑。 | QooAppViveport | | **URL for Privacy Policy** | 输入游戏隐私政策的 URL。 | Viveport | | **URL for EULA/Terms of Use** | 输入游戏 EULA/使用条款的 URL。 | Viveport | #### 细节 如果提交中缺少任何内容，UDP 控制台会显示错误或警告消息。选择**细节 (Detail)** 可展开有关该问题的更多信息。 错误显示在红色面板中。必须先修正错误，然后才能提交游戏。选择**修改 (Modify)** 可进入错误区域以解决相关问题。 也可以选择只提交到没有错误的商店。 警告显示在黄色面板中。您可以关闭决定忽略的警告。 ### 状态面板 UDP 开始处理游戏时，请访问**状态 (Status)** 面板来监控进度以及查看游戏的提交历史记录。 **状态**面板会显示游戏历史记录的概览。 | 字段 | 描述 | | ------------------------ | ---------------------------------------------------------- | | **Revisions repacked** | 使用 UDP 创建的重新打包的 APK 构建版本总数。**注意**：如果游戏已针对相同商店重新打包三次，则计为三次。 | | **Revisions submitted** | 通过 UDP 提交的总次数。**注意**：如果向商店提交了游戏五次，则计为五次。 | | **Submissions accepted** | 应用商店已接受的提交次数。 | | **Submissions rejected** | 应用商店已拒绝的修订版数量。 | 对于每个游戏修订版，**状态**面板显示以下详细信息： | 字段 | 描述 | | ------------- | ---------------------------------------------- | | **Store** | 将游戏提交到的商店。 | | **Status** | 修订版状态。并非所有商店都可以在游戏“上线”前提供可见性。状态部分仅提供可从商店获得的信息。 | | **Countries** | 对于每个应用商店，游戏所面向开放的国家/地区数量。选择此列中的数字可查看相应的国家/地区。 | | **Action** | 执行其他操作，例如**下载**游戏的修订版或**转到商店**以完成发布步骤。 | 游戏可以具有以下状态： * **已重新打包 (Repacked)**：已成功使用选定商店的 SDK 将游戏重新打包 * **已发布 (Published)**：游戏已完成了将游戏重新打包并提交到商店时该商店所需的所有步骤 * **待处理 (Pending)**：正在使用选定商店的 SDK 将游戏重新打包 * **失败 (Failed)**：无法使用选定商店的 SDK 将游戏重新打包 * **已取消 (Canceled)**：您或所属组织中的某个人取消了您提交的游戏 ### 商店注册 商店注册 (Store Sign-Up) 选项卡显示有关您可以使用 UDP 将游戏分发到的商店的信息。 **Frame:** ![](/api/media?file=/engine/6000.0/media/images/UDPSettingUp_07.png) 选择更多 (More) 链接可获取有关商店的更多信息，例如概览、常见问题解答以及每个商店特有的其他有用链接。 要查看所有商店的信息概览，请选择**比较商店 (Compare stores)** 以打开合作伙伴商店备忘单。这会比较所有商店的详细信息，包括用户数量、商店涵盖的国家/地区以及商店是否支持付费游戏等数据。 ### 报告控制面板 报告 (Reporting) 选项卡显示已发布的游戏的性能信息。您可以从报告控制面板监控已发布的游戏的性能（可从顶部导航栏访问该控制面板）。 **Frame:** ![](/api/media?file=/engine/6000.0/media/images/UDPReportingDashboard_01.png) 您可以按游戏和按商店筛选报告 (Reporting) 控制面板上显示的信息。 **Frame:** ![](/api/media?file=/engine/6000.0/media/images/UDPReportingDashboard_02.png) 如果没有在**所有游戏 (All Games)** 和**所有商店 (All Stores)** 筛选条件中为整个报告控制面板进行任何选择，则可以查看单个图表级别的细分内容（如果适用）。在支持的图表上，选择**按商店**或**按游戏**筛选条件可查看特定商店或单个游戏的表现。 报告控制面板分为五个面板，所有面板均受游戏 (Games) 和商店 (Stores) 筛选条件的约束。对于受日期筛选条件约束的面板，可以将图表数据导出为 CSV 文件和图像。要将数据下载为 CSV 文件或图像，请选择图表的相应图标。 **注意**：仅当使用 QueryOrder 设置了服务器端验证时，华为 AppGallery 才向 UDP 返回收入信息。如果使用了回调通知，则华为没有与收入相关的图表或信息。 #### 指标和定义 **报告**控制面板会跟踪发布游戏的 UDP 商店中的以下数据： | 指标 | 描述 | | ----------------- | -------------------------------------------- | | **总收入** | 从玩家处收取的金额（美元）（例如，如果 IAP 价格为 0.99，则此处为 $0.99） | | **玩家** | 下载并启动游戏的唯一身份用户数。这是按照唯一设备计算的。 | | **付费者** | 付费玩家的数量。也就是至少进行了一次成功付款的唯一身份用户数。 | | **自第一次活动以来的天数** | 自游戏在应用商店中达到 10 位玩家以来的天数。 | | **新玩家** | 在选定时间段内首次启动游戏的玩家数量。 | | **DAU** | 日活跃用户。在当天至少启动过一次该游戏的独立用户数量。 | | **MAU** | 月活跃用户。过去 30 天至少启动了一次游戏的唯一身份用户数。 | | **IAP 收入** | IAP 的总收入（美元）。 | | **每笔交易的平均收入** | 定义为收入/交易数量（美元）。 | | **ARPPU** | 付费用户的平均收入（美元）。定义为总收入/付费玩家数量。 | | **ARPU** | 用户的平均收入（美元）。定义为总收入/玩家数量。 | | **付费者转化率** | 定义为付费玩家数量/玩家数量。 | | **交易** | 产生付款的成功交易数量（OrderID 成功并已由 UDP 服务器验证）。 | | **IAP 收入** | 按 IAP 对总收入进行细分（美元）。 | | **IAP 交易量** | 按 IAP 对交易进行细分。 | | **游戏销售收入** | 付费游戏产生的总收入（美元）。 | | **会话** | 在任何设备上启动游戏的次数。 | | **第 1 天留存率 (%)** | 定义为首次启动游戏 1 天后仍活跃的玩家百分比。 | | **第 7 天留存率 (%)** | 定义为首次启动游戏 7 天后仍活跃的玩家百分比。 | | **第 30 天留存率 (%)** | 定义为首次启动游戏 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) 选项卡显示有助于您入门的有用信息，包括： * UDP 文档的链接 * 不同应用商店的指南 * 视频教程 ### 资源 资源 (Resources) 选项卡提供了一些有用的信息来帮助您快速入门，其中包括： * 入门指南 * 教程视频 * 应用商店指南 * 知识库 * 发行说明 ### 设置 #### 公司信息 在公司信息 (Company Information) 窗口中可添加信息，以便在应用商店中显示公司的信息。在 UDP 控制台上，选择贵组织，然后选择铅笔图标以编辑简介信息。 | 字段 | 描述 | | ------------------------- | ---------------------- | | **Company Name** | 希望玩家看到的公司名称。 | | **Company Icon** | 上传一张代表公司进行显示的图像。 | | **Location** | 希望定义为工作室总部的所在地。 | | **Company Size** | 使用下拉选单指定公司人数。 | | **Official Website** | 贵公司的官方网站。 | | **Support Email Address** | 玩家可以用来与贵公司联系的支持电子邮件地址。 | | **Introduction** | 有关公司/工作室的任何其他信息。 | #### 开发者 API 开发者 API (Developer API) 页面允许您生成和管理身份验证令牌以用于 [UDP API](/engine/6000.0/manual/unity-services/udp/reference/api.md)。您可以使用 UDP API 将二进制文件上传到 UDP 控制台。参见[在 UDP 控制台上管理和发布游戏](/engine/6000.0/manual/unity-services/udp/managing-and-publishing.md#api-upload) 下表描述了开发者 API 页面。 | 字段 | 描述 | | --------------- | ----------------------------------------------------- | | **Token** | 用于让 UDP API 访问 UDP 控制台的身份验证令牌。选择复制 (COPY) 以将令牌复制到剪贴板。 | | **Expiry date** | 身份验证令牌的到期日期（如果已指定）。 | | **Operations** | 编辑或删除现有令牌。 | | **NEW TOKEN** | 选择以创建新令牌。 | ## CSV 参考 ### CSV 文件的数据值 应用内购的 CSV 文件中的每一行都可以包含以下值。不要传递空值。 | 字段 | 描述 | | ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `product_id` | 代表唯一 IAP 商品的 ID。product\_id 需要以小写字母或数字开头，并且只能由小写字母 (a-z)、数字 (0-9)、下划线 (\_) 和句点 (.) 组成。 | | `language; product_name; description` | 设置语言值时，请使用表 A 中列出的语言代码。UDP 使用 en-US 作为默认语言。使用分号 (;) 分隔语言、商品名称和描述。要包含商品名称和描述的本地化版本，请列出默认语言、商品名称和描述，然后列出每个区域的语言、商品名称和描述。在以下示例中，商品以 en-US (ENGLISH) 作为默认语言，以 zh-CN (CHINESE) 作为本地化语言：en-US;Product 1;This is my first product; zh-CN; 产品1; 产品描述1。注意：UDP 仅导入您在 UDP 控制台的**游戏信息 (Game Info)** 部分中定义的语言的字段。要支持多种语言，请在导入 IAP 目录之前在 UDP 控制台上对其进行定义。 | | `consumable` | 设置为 TRUE 或 FALSE（不区分大小写）可定义 IAP 商品是否可消耗。 | | `auto_convert_prices` | 如果为 true，UDP 会自动将价格转换为其他货币。要从转换中排除货币，请在 `currency;price` 字段中指定货币及其价格。 | | `currency; price` | 设置货币值时，请使用表 B 中列出的货币代码。价格必须为正值。默认货币为美元 (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,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 ```