这些值定义下载中心中使用的数据集。
购置和附加购置
数据集 ID | 说明 |
---|---|
ProductID | 特定游戏或应用的唯一标识符 |
TitleID | Xbox 游戏或应用的 TitleID;用作用于标识这些游戏的唯一键 |
XboxProductID | Xbox 目录中的产品 GUID |
ProductTypeName | 产品类型的子类别、示例 -Game、Add-on 等 |
TitleName | Xbox 游戏或应用的标题名称 |
CatalogID | 指示从中购买的商店,例如零售、私人公司商店或证书交易 |
SandboxID | 产品的沙盒 ID,例如零售、证书 |
SkuID | 产品所属的版本或平台的标识符;一个产品可以有多个 SKU 用于不同的市场或设备,等等 |
SkuTypeName | SkuType 的名称(例如:试用、完整、租赁) |
SkuDisplayName | 库存单位(SKU)的显示名称,例如“免费试用”、“租赁”等 |
AvailabilityID | 指向大目录的可用性的 ID;对于旧版应用,它为 null |
RegionName | 进行收购的用户区域 |
CountryName | 进行收购的用户国家/地区的名称 |
市场 | 设备市场的 ISO 3166 国家/地区代码 |
PaymentType | 定义事务的类型:
|
StoreClientName | 以下字符串之一,指示发生购置的 Microsoft Store 版本:
|
StoreClientCategory | 将客户端分类为 Native Client、Web 客户端、企业存储、测试客户端 |
ParentProductName | 主父产品的名称 |
ParentProductID | 这是主要父产品 |
XboxParentProductID | Xbox 目录中父级的父产品 GUID |
AcquisitionType | 以下字符串之一,指示购置类型:
|
PurchaseTaxType | 已应用的 TAX 的类型 |
LocalCurrencyCode | 标价和购买价格和零售价格的货币代码 |
SupportedPlatform | 支持的设备值包括移动设备、电脑、Xbox One、中心、HoloLens 等 |
Age | 进行购置的用户年龄 用来指定进行购置的用户年龄组的以下字符串之一:
|
性别 | 以下字符串之一,指定进行购置的用户的性别:
|
OsVersion | 发生购置的 OS 版本 用来指定发生购置的 OS 版本的以下字符串之一: |
DeviceType | 用来指定发生购置的设备类型的以下字符串之一:
|
DateStamp | 获取事务 ID |
PurchaseQuantity | 行项数量 |
PurchasePriceUSDAmount | 客户支付的项目金额,转换为美元 |
PurchaseTaxUSDAmount | 应用于项目的税额,转换为 USD |
PurchasePriceLocalAmount | 客户为项目支付的金额 |
PurchaseTaxLocalAmount | 应用于项目的税款金额 |
购置事务
数据集 ID | 说明 |
---|---|
ProductID | 特定游戏或应用的唯一标识符 |
TitleID | Xbox 游戏或应用的 TitleID;用作用于标识这些游戏的唯一键 |
XboxProductID | Xbox 目录中的产品 GUID |
订单 ID | 特定订单的唯一 ID |
ProductTypeName | 产品类型的子类别、示例 -Game、Add-on 等 |
TitleName | Xbox 游戏或应用的标题名称 |
CatalogID | 指示从中购买的商店,例如零售、私人公司商店或证书交易 |
SandboxID | 产品的沙盒 ID,例如零售、证书 |
SkuID | 产品所属的版本或平台的标识符;一个产品可以有多个适用于不同市场、设备等的 SKU |
SkuTypeName | SkuType 的名称(例如:试用、完整、租赁) |
SkuDisplayName | 库存单位(SKU)的显示名称,例如“免费试用”、“租赁”、“租赁” |
AvailabilityID | 指向大目录的可用性的 ID;对于旧版应用,它为 null |
RegionName | 进行收购的用户区域 |
CountryName | 进行收购的用户国家/地区的名称 |
市场 | 设备市场的 ISO 3166 国家/地区代码 |
PaymentType | 定义事务的类型:
|
StoreClientName | 以下字符串之一,指示发生购置的 Microsoft Store 版本:
|
StoreClientCategory | 将客户端分类为 Native Client、Web 客户端、企业存储、测试客户端 |
ParentProductName | 主父产品的名称 |
ParentProductID | 这是主要父产品 |
ParentProductDisplayName | 父产品的显示名称 |
XboxParentProductID | Xbox 目录中父级的父产品 GUID |
AcquisitionType | 以下字符串之一,指示购置类型:
|
AbstractAcquistionType | 以下字符串之一,指示抽象获取的类型: - 推断购买 - 已取消预排序 - 失败的预排序 - 收费预售 -购买 |
PurchaseTaxType | 已应用税的类型 |
LocalCurrencyCode | 标价和购买价格和零售价格的货币代码 |
SupportedPlatform | 支持的设备值包括移动设备、电脑、Xbox One、中心、HoloLens 等 |
Age | 进行购置的用户年龄。 用来指定进行购置的用户年龄组的以下字符串之一:
|
性别 | 以下字符串之一,指定进行购置的用户的性别:
|
OsVersion | 发生购置的 OS 版本 用来指定发生购置的 OS 版本的以下字符串之一: |
DeviceType | 用来指定发生购置的设备类型的以下字符串之一:
|
WishlistID | 已加入 Wishlisted 的特定游戏或应用的唯一 ID |
IsWishlisted | 指示是否列出产品;可能的值为 true(对于希望列表的产品)和 false(对于非加入列表的产品) |
IsGiftPurchase | 指示购买是否在过去 30 天内作为礼物进行;可能的值为 true (对于礼品购买) 和 false (对于常规购买) |
ProductSubTypeName | 产品类型的子类别(例如 Game、Add-on) |
DateStamp | 获取事务 ID |
PurchaseQuantity | 行项数量 |
PurchasePriceUSDAmount | 客户支付的项目金额,转换为美元 |
PurchaseTaxUSDAmount | 应用于项目的税额,转换为 USD |
PurchasePriceLocalAmount | 客户为项目支付的金额 |
PurchaseTaxLocalAmount | 应用于项目的税款金额 |
通道和转换
- 转换意味着客户(使用Microsoft帐户登录)已新获得应用许可证(无论是收取资金还是免费提供)。
- 渠道是指客户到达应用列表页面的方法(例如通过 Microsoft Store 或自定义应用促销活动)。
数据集 ID | 说明 |
---|---|
日期 | 转换数据日期范围内的第一个日期:如果请求指定了一天,则此值为该日期;如果请求指定了一周、月或其他日期范围,则此值是该日期范围内的第一个日期 |
ProductID | 特定游戏或应用的唯一标识符。 |
InAppProductName | 游戏或应用的标题 |
ApplicationID | 特定游戏或应用的唯一标识符 |
ApplicationName | 游戏或应用的标题 |
CustomCampaignID | 为自定义市场活动创建唯一的 CampaignID;与应用关联的自定义应用促销活动的 ID 字符串 |
ReferrerUriDomain | 指定激活具有自定义应用促销市场活动 ID 的应用列表的域 |
ChannelType | 用来指定转换渠道的以下字符串之一:
|
StoreClient | 发生转换的应用商店的版本;目前,唯一受支持的值为 SFC |
DeviceType | 以下字符串之一:
|
市场 | 设备市场的 ISO 3166 国家/地区代码 |
ClickCount | 客户单击应用一览链接的数量 |
ConversionCount | 客户转换数 |
事件参与
玩家参与游戏的方式发生了变化。 游戏游戏从单个购买转移到 具有较长参与期的游戏即服务 模型。 创意者需要一种方法来连接、参与和深化他们与玩家的关系。 玩家需要一种方法来轻松发现、访问和连接他们关心的创意者和游戏。 事件提供了一种可发现、无摩擦、极具吸引力的体验,可以连接和加深创建者与其玩家和潜在玩家的关系。 “事件”体验满足 Xbox 生态系统中所有类型的创建者和玩家的需求。 更重要的是,事件的数据对于了解投资的成功和为未来的参与事件和策略做出数据明智的决策变得更加重要。 下载中心提供对事件参与数据的自助访问,这些数据可通过编程 API 下载一次、计划或访问。 下表列出了我们当前在事件参与数据报告中提供的指标:
数据集 ID | 说明 |
---|---|
DateID | 处理数据的日期 |
ProductID | 用于标识特定产品/游戏标题的引用 ID |
产品名称 | 产品 ID 中引用的游戏标题的名称,属于事件 |
事件 ID | 引用游戏参与的事件的唯一 ID |
EventTitle | 引用游戏参与的事件的唯一名称 |
EventCreatedDate | 工具上创建事件的日期 |
EventPublishDate | 为玩家参与发布活动的日期 |
EventStart | 可以在时间线之前创建事件,并在创建者希望其玩家访问时对其进行配置;EventStart 是实际的预订开始日期 |
EventEndDate | 事件配置为结束玩家参与的日期 |
国家/地区 | 以事件为目标的市场 |
ViewCount | 查看事件的玩家的聚合数量 |
感兴趣 | 通过选择“保存事件”按钮来显示他们感兴趣的玩家 |
ViewStoreCount | 在事件详细信息页上选择了“查看应用商店”按钮的玩家总数,并查看了与控制台应用商店中的事件关联的产品详细信息页游戏 |
InterestedAndViewedStore | 保存事件并选择“查看商店”按钮以查看与事件关联的产品详细信息页的玩家 |
EndPoint | EndPoint 是指玩家从中打开事件的位置。 玩家可以从 XboxEventClient(指 xEvents 应用)或 Mercury(指 XBOX 主机上的应用商店)启动其事件 |
ViewClubCount | 在活动上的“官方俱乐部”按钮上选择的玩家总数,并查看了“产品俱乐部”页面 |
LaunchGameCount | 在事件上选择了“启动游戏”按钮的玩家的聚合数量 |
ViewedEventsAppCount | 来自选择了事件的玩家的聚合视图,并打开了事件详细信息页;玩家可以在 Mercury(Xbox 主机上存储)、主机主页或 xEvents 主机应用上选择事件 |
页面 | 玩家查看或显示参与的源页面:
|
Channel | 这是指玩家可以查看的 xEvents 控制台应用上的通道,其中:
|
GamePassType | 如果玩家具有游戏通行证订阅,则演示参与度 |
ActiveUser30Days | 提供有关过去 30 天内玩家状态的信息 |
WatchCount | 此列跟踪使用实时流配置的所有事件的视频观看计数 |
EventType | 此列定义创建者选择的最佳描述其事件的类型(如“公告”、“GameUpdate”、“GameTournament”、“MultiPlayerSeason”) |
EventTheme | 此列定义发布活动的主题,创建者选择最好地描述活动的主题,并指示用户发布的目的(例如:“假日”、“MajorSportingEvent”、“WorldEvent”、“CulturalMoment”等) |
AdditionalFeatures | 此列定义创建者选择的任何其他功能,以帮助描述其事件超出事件类型和事件主题 - 例如,如果事件具有游戏内商店销售(StoreSale)、官方游戏流(OfficialGameStream)或新的游戏内项目(NewInGameItem) |
TotalCount | 数据集中每个特定行组合的计数 |
游戏通行证:购买
包含作为游戏通行证订阅的一部分购买的产品的信息。 它在订阅级别聚合提供数据,适用于控制台和电脑。
数据集 ID | 说明 |
---|---|
ProductID | 作为游戏通行证一部分购买的特定游戏的唯一 ID |
GamePassTitle | 游戏的标题 |
MonthYear | 之后的月份(例如:Jan-23) |
平台 | 在其中玩游戏的源平台可以是主机或电脑 |
ProductTypeName | 产品类型的子类别(示例:-Game,加载项) |
PurchaseQuantity | 订单中项的数量 |
EstimatedRevenue | 游戏所有者以美元支付的金额,或转换为美元(税前) |
游戏通行证:使用情况
提供有关作为游戏通行证订阅一部分播放的产品(游戏游戏)使用情况的数据报告和见解。 Game Pass 提供订阅级别聚合的数据,并适用于主机和电脑。
数据集 ID | 说明 |
---|---|
ProductID | 作为游戏通行证一部分获取的特定游戏的唯一 ID |
GamePassTitle | 游戏的标题(显示名称) |
MonthYear | 之后的月份(例如:Jan-23) |
平台 | 游戏播放的源平台(主机或电脑) |
UniqueUsers | 唯一的用户是任何人使用 Game Pass 权利玩游戏 |
TotalHours | 用户玩游戏的小时数之和 |
HoursPerUser | 派生为上述列的一部分(计算:TotalHours/UniqueUsers) |
NewUsers | 特定月份或时间段的用户下载数的计数 |
运行状况:崩溃和事件
提供有关与安装了游戏或应用主机和电脑的崩溃和事件相关的运行状况相关信息。
数据集 ID | 说明 |
---|---|
ProductID | 特定游戏或应用的唯一标识符 |
ApplicationName | 游戏或应用的标题 |
日期 | 错误数据的日期范围内的第一个日期;如果请求指定一天,则此值为该日期;如果请求指定更长的日期范围,则此值是该日期范围内的第一个日期 |
FailureHash | 崩溃/错误的唯一标识符 |
FailureName | 失败的名称,由四个部分组成:一个或多个问题类、异常/bug 检查代码、发生故障的图像的名称以及关联的函数名称 |
符号 | 分配给此错误的符号 |
PackageVersion | 与此错误关联的应用包的版本 |
PackageName | 与此错误关联的应用包的唯一名称 |
Praid |
应用范围分析的值包括应用、游戏等 |
OsVersion | 以下字符串之一,用于指定发生错误的操作系统版本: |
OsRelease | 发生错误的 OS 版本或外部测试通道(作为 OS 版本中的子填充)。 以下字符串之一,指定发生错误的 OS 版本或外部测试环(作为 OS 版本中的子填充): 对于 Windows 11:
对于 Windows 10:
对于 Windows Server 1709:
对于 Windows Server 2016:
对于 Windows 8.1:
如果 OS 版本或外部测试通道未知,此字段的值未知 |
OsArchitecture | OS 体系结构值包括 x64、ARM64、x86、ARM |
DeviceType | 以下字符串之一,用于指定发生错误的设备的类型:
|
市场 | 设备市场的 ISO 3166 国家/地区代码 |
EventType | 以下字符串之一:
|
SandboxID | 产品的沙盒 ID,即零售版、证书 |
设备数 | 对应于指定聚合级别的此错误的唯一设备数 |
EventCount | 为指定的聚合级别归因于此错误的事件数 |
安装
数据集 ID | 说明 |
---|---|
ProductID | 特定游戏或应用的唯一标识符 |
ApplicationName | 游戏或应用的标题 |
日期 | 安装数据日期范围内的第一个日期;如果请求指定了一天,则此值为该日期;如果请求指定了一周、月或其他日期范围,则此值是该日期范围内的第一个日期 |
市场 | 用户正在安装的区域/市场 |
年龄组 | 安装程序的年龄组 |
性别 | 安装程序的性别 |
PackageVersion | 已安装的包的版本 |
OsVersion | 安装产品的操作系统版本 |
DeviceType | 用来指定完成安装的设备类型的以下字符串之一:
|
SandboxID | 产品的沙盒 ID,即零售版、证书 |
SuccessfullInstallCount | 指定聚合级别期间成功安装的次数 |
评级
数据集 ID | 说明 |
---|---|
ProductID | 特定游戏或应用的唯一标识符 |
ApplicationName | 游戏或应用的标题 |
日期 | 提交分级的日期 |
市场 | 用户提供评级的区域/市场 |
OsVersion | 从中发布分级的 OS 版本 |
DeviceType | 用于提交分级的设备 |
IsRevised | 客户修订的评级 |
OneStars | 产品提供的一星级分级总数 |
TwoStars | 产品提供的双星级分级总数 |
ThreeStars | 产品提供的三星级分级总数 |
FourStars | 产品提供的四星级分级总数 |
FiveStarts | 产品提供的五星级分级总数 |
审阅
数据集 ID | 说明 |
---|---|
ProductID | 特定游戏或应用的唯一标识符 |
ApplicationName | 游戏或应用的标题 |
日期 | 提交分级的日期 |
市场 | 用户提供评级的区域/市场 |
OsVersion | 从中发布分级的 OS 版本 |
DeviceType | 用于提交分级的设备 |
IsRevised | 客户是否修订分级:指定 true 以筛选已修订的评论;否则为 false |
PackageVersion | 给定条目的数值点分隔格式的应用版本 |
DeviceModel | 发布评审的设备型号 |
产品系列 | 设备所属的产品系列(电脑、手机、主机) |
DeviceRAM | 安装应用/游戏的设备 RAM |
DeviceScreenResolution | 设备的解决方法 |
DeviceStorageCapacity | 设备的存储容量 |
IsTouchEnabled | 如果在设备上启用了触摸 |
ReviewerName | 发布评审的审阅者的名称 |
评级 | 审阅者给出的评分 |
ReviewTitle | 审阅标题 |
ReviewText | 审阅时给出的文本 |
HelpfulCount | 评审标记为有用的次数 |
NotHelpfulCount | 审阅标记为无用的次数 |
ResponseText | 发布者提交的响应 |
ID | 在店面上发布查看 ID |
HighConfidenceTags | 基于查看时提供的标记的置信度计算(如果介于 0.80、1.0 之间则很高) |
MidConfidenceTags | 如果介于 0.70、0.80 之间,则为中 |
LowConfidenceTags | 低(介于 0.60、0.70 之间) |
日期 | 提交评审的日期 |
ResponseDate | 提交响应的日期 |
可持续性 (平均游戏或应用电源, 能源, CO2)
此数据提供与 Xbox 主机游戏和应用相关的可持续性见解。 所有主机软件都根据软件请求的计算性能在游戏设备上运行时使用不同数量的电源。 更多的电力转化为更多的电力从玩家的墙壁套接字。 Xbox 能够测量游戏和应用在主机总体中的估计平均能耗(以瓦数或千瓦为单位)。 一旦将电源乘以时间,电源就会转换为能量(瓦时或千瓦时)。 设备所有者支付更高的能源费用,即使用的能量越多。 电力来自当地能源电网,由碳密集型化石燃料和可再生能源混合产生。 碳密集型能源主要排放温室气体(主要是二氧化碳排放)。 我们能够通过将游戏的整体能源足迹乘以每个能源电网的独特排放因子值(按千瓦时计千克二氧化碳)来衡量温室气体排放潜力。
如果游戏或应用发布者希望监视或向玩家提供节能改进,同时降低用户的能源费用,游戏或应用发布者可以使用这些数据。 游戏或应用发布者可以在采取行动报告或抵消与其产品相关的温室气体排放的同时使用此数据。 若要详细了解开发人员工具和出色的案例研究,请导航到 游戏可持续性 或任何问题(电子邮件 XboxSustainability@Microsoft.com)。
数据集 ID | 说明 |
---|---|
ProductID | 特定游戏或应用的唯一 ID |
ApplicationName | 游戏或应用的标题 |
FiscalYear | 以应用/游戏为重点的会计年度 |
日期 | 游戏活动的度量月份 |
CountryCode | 控制台所在的国家或地区的 ISO 3 字符国家或地区代码(例如:AUS) |
TitleID | 游戏或应用的 TitleID |
TitleName | 标题的特选名称 |
PublisherCurated | 发布者的名称 |
DeveloperCurated | 发布者的开发人员 |
名称 | 焦点中的应用/游戏的流派 |
PrimaryGenre | 焦点中应用/游戏的主要流派 |
SubGenre | 焦点中应用/游戏的子流派 |
RetailName | 月份度量的主机零售名称(例如:Xbox Series S) |
PowerMode | 游戏或应用 |
AverageACPower | 一段时间内游戏或应用的估计平均能耗(例如:100.245778) |
设备数 | 特定月份的设备计数 |
TitleMinutes | 总游戏分钟数的总和 |
TitleCO2e_MetricTon | 游戏生成的 CO2 等效项(MTCO2e)的总指标吨:直接绑定到用于在所有 Xbox 设备上为游戏供电的电力量;派生自国际能源局(IEA)提供的常量,它指定每兆瓦时消耗的二氧化碳2e的指标吨 |
TitleEnergy_MWh | 游戏或应用随时间推移使用的总能量,表示为兆瓦时(MWh):能量是电源 * 时间 |
定向和灵活的产品/服务
目标产品/服务为 Xbox 合作伙伴提供功能和适当的工具,以特定特定客户队列为目标,并提供折扣优惠;在所有 Xbox 图面上,MSOW 当前除外。 此产品/服务类型附带唯一的 Just for You 徽章,总体目标是帮助获取新客户、提升单位销售额和改进购买转换。
灵活的产品/服务为 Xbox 合作伙伴提供了捆绑不同游戏产品(当前:基础游戏、加载项、可下载内容(DLC 和易耗品)的功能,在购买 X 中,Z 可以是 0-100 的任意数字。 此功能目前仅限于主机存储和游戏类别页面。 此功能旨在充当一种车辆,为促销产品/服务启用单位提升。
数据集 ID | 说明 |
---|---|
ProcessDate | 在Microsoft合作伙伴中心处理数据的日期 |
CampaignName | 产品/服务的名称 |
StartDate | 产品/服务启动的日期 |
EndDate | 产品/服务结束日期 |
OfferTypeName | 创建的产品/服务类型(目标、灵活等) |
市场 | 产品/服务已启用的国家/地区 |
ProductID | 特定游戏的唯一 ID |
TotalRevenue | 根据此套餐进行的所有购买的总收入 |
UniqueUser | 通过此产品/服务购买游戏的唯一不同用户数 |
TotalDownloads | 交易不是免费的订单/购买的非重复计数 |
TotalPurchaseCount | Distinct 订单 ID 的总数 |
AutoSearchImpressions | “自动搜索”部分中游戏的用户印象数 |
CompareEditionsImpressions | “比较版本”部分在店面上提供的产品/服务的用户印象数 |
FullSearchImpressions | “完整搜索结果”选项中游戏的产品/服务的用户印象数 |
L1ChannelImpressions | 主页上第 1 级营销渠道中游戏的用户印象数 |
L2ChannelImpressions | 主页上第 2 级营销渠道中游戏的用户印象数 |
PDPImpressions | 产品显示页面中游戏产品/服务的用户印象数 |
PDPL1ChannelImpressions | 产品显示页面上 1 级营销渠道中游戏的用户印象数 |
WishlistImpressions | “愿望列表”部分中游戏的产品/服务的用户印象数 |
SpotlightImpressions | 聚焦部分中游戏产品/服务的用户印象数 |
FlexibleOfferImpressions | 针对该套餐上游戏收到的印象总数的聚焦印象数 |
AvgRevPerUniqueUsers | 按购买唯一用户总数的总收入 |
TotalImpressions | 游戏产品/服务的所有频道中的总印象数 |
TotalUniqueUserImpressions | 游戏产品/服务的所有频道中的总印象数 |
TotalUniqueUserClicks | 为游戏上产品/服务收到的所有印象选择的非重复用户 ID 总数 |
Wishlist
提供有关已使用购置数据指标扩充的店面上已加入愿望列表游戏的玩家的参与指标的见解。
当用户发起购买时,事务具体化。 在接下来的 10 天内,交易可能会经历不同的状态更改,例如取消或更新,然后再被正式确认为收购。
在下面的 Wishlist 数据集中,标识合法获取。 在识别后,将验证获取产品的用户是否在购买当天列出商品。 如果是肯定的,则提供事务 ID(TransactionID)和初始日期(已购买日期)。
注意
仅交易发生在 2023 年 12 月 16 日之后,才会映射到希望列出的产品。
数据集 ID | 说明 |
---|---|
ProductID | 已加入 Wishlisted 的特定游戏或应用的唯一 ID |
ApplicationName | 游戏或应用的标题 |
市场 | 游戏用户希望列出产品的区域/市场 |
HashedOwner | 以哈希格式表示的 Wishlist 所有者的唯一 ID |
SkuID | 产品所属的版本或平台的 ID 值;对于不同的市场或设备,一个产品可以有多个库存单位(SKU) |
AddedDate | 将产品添加为 Wishlist 的日期 |
StorefrontClient | 用户用于希望列表产品的店面(示例:水星(XBOX 主机商店)、Xbox.com(XBOX Web store)) |
PurchasedDate | 购买 Wishlisted 产品时的日期 |
TransactionID | 交易的唯一 ID,即购买结果 |