> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XBOX Game Publisher Insights FAQ

> 关于 XBOX Game Publisher Insights 的常见问题，涵盖上线、报告、调度、Downloads Hub 和分析 API。

本文提供有关 Store 分析各方面的常见问题的综合答案，包括报告、调度、上线、API 等。无论你是在寻找详细说明还是快速提示，你都能在这里找到所需信息。

### 上线

**问：** Partner Center 中是否有关于 Insights 的上线文档？例如操作方法概述和数据定义？<br />**答：** 有，请前往 [Partner Center Insights 概述](https://learn.microsoft.com/partner-center/insights/insights-overview)

### Downloads Hub

**问：** 我如何更多地了解报告的内容？<br />**答：** 从 [Downloads Hub 数据集](https://learn.microsoft.com/partner-center/insights/downloads-hub-datasets) 了解更多关于报告及其内容的信息。

**问：** 是否有基于日历日期安排报告的方法？（示例：每月的第一个星期一）。<br />**答：** 合作伙伴可以在 Partner Center 上的 Downloads Hub Insights 中安排报告。Downloads Hub 允许根据需要灵活地安排所有数据集。报告将在 Partner Center 的报告部分下载，并自下载日起 7 天内供合作伙伴访问。你可以从 [Downloads Hub 中的报告安排](https://learn.microsoft.com/partner-center/insights/apps-games-download-reports#reports-scheduled) 了解更多信息。

**问：** 对于采用 Downloads Hub API 的合作伙伴，是否有可外部分享供参考的示例应用/解决方案？合作伙伴可以在其中插入自己的 ID 和密钥以加速上线时间。<br />**答：** 有，请前往 [用于访问 Apps and Games API 的示例应用程序](https://learn.microsoft.com/partner-center/insights/apps-games-sample-application)

**问：** XDP Analytics 与 Windows Desktop Application Downloads Hubs 有何区别？<br />**答：** XPD Analytics 是非向后兼容 XBOX 360 游戏的获取报告的下载报告部分，而在 Downloads Hub 中你可以找到所有其他报告。

### 报告

#### 获取报告

**问：** 获取报告数据库的刷新节奏和频率（计划或即时）是什么？<br />**答：** 目前，获取 Acquisition 数据的作业每天运行两次：太平洋标准时间上午 5 点和下午 5 点。作业通常需要 6 到 10 小时完成，但在某些特殊情况下，可能需要长达 24 小时。对于任何实时数据获取相关数据集，可以使用每小时聚合，每小时提供最新数据。

**问：** 如果安排了报告，从开始生成到能生成需要多长时间？<br />**答：** 调度会在合作伙伴设置的实际计划时间之前一小时开始生成，以避免任何延迟导致收到报告变慢。尽管有这种预防措施，队列流量等因素仍可能导致数据交付超出计划时间。

**问：** 数据是否在 upsert？如果是，upsert 使用的键是什么？<br />**答：** 是的，数据按所描述的过程 upsert。upsert 操作使用唯一键，例如 OrderID 或 OrderID 与 State 的组合，以确保每个状态变化都被正确跟踪。此键允许系统更新现有记录（如果状态变化）或插入新记录（如果是新交易或新状态）。

**问：** 预售状态的更改是更新原始记录还是添加新记录？<br />**答：** 如果系统设计为反映订单的最新状态，预售状态的更改可能会更新原始记录。这意味着 OrderID 保持不变，但状态和其他相关字段将被更新以反映新状态，例如 'charged pre-order' 或 'cancelled pre-order'。

**问：** 如果记录是 upsert 的，且某记录有一笔总销售被退款，记录会显示购买数量等于 0，还是记录会直接消失？<br />**答：** 在此场景中，如果系统设计为跟踪净购买，记录不会简单地消失。相反，原始购买记录可能会保留，并添加相应的退款记录。净购买数量将通过从购买记录中的 PurchaseQuantity 中减去退款记录中的 RefundQuantity 来计算。如果记录以相同的键 upsert，PurchaseQuantity 可能会更新以反映净数量（如果完全退款，可能为 0）。

**问：** 是否可以在为 Purchase 数据集安排报告时将时间跨度限制为少于 30 天？<br />**答：** 不可以，此功能仅在 executeNow = true 时可用，在安排报告时不可用。

**问：** 在 Acquisitions - Customer Demographics 报告中：如果玩家选择不共享数据，他们会出现在 "Unknown" 类别中吗？<br />**答：** 是的，如果玩家选择不共享，且我们无法确定年龄组或性别，则获取被归类为 "Unknown"。要了解更多，请前往 [Acquisitions Report - GDK or XBOX Games Report](https://learn.microsoft.com/partner-center/insights/acquisitions-report#app-page-views-and-conversions-by-channel)

**问：** 有没有办法访问历史获取数据？<br />**答：** 有，Downloads Hub 中提供长达 4 年的获取数据。要通过 API 访问历史数据，请参阅 [进行第一次 API 调用 - Partner Center](https://learn.microsoft.com/partner-center/insights/apps-games-make-your-first-api-call) 报告名称：Acquisition API 中的数据集名称：Acquisitions

**问：** 在 Channel Conversion 数据集的 "App Page Views & Conversions by Channel" 部分中，Store Traffic 与 Custom campaign 的定义是什么？<br />**答：** Store Traffic 指的是通过商店本身到达应用页面的访问者，例如在商店内浏览或搜索。Custom Campaign 涉及通过开发者或合作伙伴发起的特定营销活动产生的流量，通常使用自定义链接或 UTM 参数来跟踪流量来源。从 [Acquisitions Report - GDK or XBOX Games Report](https://learn.microsoft.com/partner-center/insights/acquisitions-report#app-page-views-and-conversions-by-channel) 了解更多。

**问：** 在通道和转化部分，合作伙伴可以看到来自特定商店部分的流量吗？<br />**答：** 可以，在通道和转化部分中，合作伙伴可以看到来自特定商店部分的流量。要查找更多信息，请前往 [Acquisitions Report - Analyze Performance](https://learn.microsoft.com/partner-center/insights/view-acquisitions-report#campaign-performance-by-channel)

## 另请参阅

* [应用和游戏概述](https://learn.microsoft.com/partner-center/insights/apps-and-games-overview)
* [Downloads Hub 概述](https://learn.microsoft.com/partner-center/insights/apps-games-download-reports)
* [Downloads Hub 数据集](https://learn.microsoft.com/partner-center/insights/downloads-hub-datasets)


## Related topics

- [Insights 最佳实践](/zh-CN/services/playfab/data-analytics/legacy/insights/best-practices.md)
- [Insights](/zh-CN/services/playfab/data-analytics/legacy/insights/overview.md)
- [Insights 导出](/zh-CN/services/playfab/data-analytics/legacy/insights/export.md)
- [Insights 定价](/zh-CN/services/playfab/data-analytics/legacy/insights/pricing.md)
- [将 Grafana 连接到 Insights](/zh-CN/services/playfab/data-analytics/legacy/connectivity/connecting-grafana-to-insights.md)
