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

# 报告

> 生成和排期分析报告。

**Reports**（`/analytics/reports`）为您选定的一组二维码、文件夹、标签、分类或用户，以及选定的日期范围，生成时间点快照式、可下载的分析和扫描数据文件。它是 [Email reports](/zh/analytics/email-reports) 的一次性对应功能，后者是按定期排期投递报告，而不是按需生成。

<Note>
  Reports 仅对拥有导出权限的账户（Pro 及以上套餐）在侧边栏中显示。
</Note>

<Frame caption="Reports 页面，尚未创建任何报告">
  <img src="https://mintcdn.com/scanova-api/2FTGGTqcp1qRUtvm/images/v2/analytics/reports/reports-list.png?fit=max&auto=format&n=2FTGGTqcp1qRUtvm&q=85&s=736d3088881b3c9aee5414ecdef5fb3a" alt="Scanova Reports 页面显示一个表格，包含 Requested On、Generated On、Requested By、Status 和 Action 列，其中一份报告处于 In Progress 状态" width="1440" height="900" data-path="images/v2/analytics/reports/reports-list.png" />
</Frame>

## 创建报告

<Steps>
  <Step title="打开 Create Report 抽屉">
    在 **Analytics > Reports** 中，选择 **Create Report**。此时会打开一个抽屉，供您配置该报告。

    <Frame caption="Create Report 抽屉">
      <img src="https://mintcdn.com/scanova-api/2FTGGTqcp1qRUtvm/images/v2/analytics/reports/create-report-drawer.png?fit=max&auto=format&n=2FTGGTqcp1qRUtvm&q=85&s=10d62ecb01607c915aec50af48493e4a" alt="Scanova Create Report 抽屉显示实体选择、Exclude Bot Traffic 复选框、时间段日期范围、Analytics Report 与 Scan Data Report 格式选择器，以及一个 Save this report 复选框" width="1440" height="900" data-path="images/v2/analytics/reports/create-report-drawer.png" />
    </Frame>
  </Step>

  <Step title="选择该报告涵盖的内容">
    在 **Select QR Codes, Folders, Tags, Categories or Users** 下，从下拉菜单中选择实体类型，然后在 **View/Edit Selection** 中选择具体项目（或选择 **Select all**）。可选地勾选 **Exclude Bot Traffic** 以过滤掉非人类扫描。
  </Step>

  <Step title="设置时间段">
    选择 **Select Time Period** 打开一个日期范围选择器，并选择该报告应涵盖的起止日期。
  </Step>

  <Step title="选择报告类型与格式">
    在 **Select Reports and Format** 下，您可以请求以下两者之一或两者都要：

    * **Analytics Report** — 可视化摘要，可导出为 **PDF**、**XLS** 或 **XLSX**。
    * **Scan Data Report** — 底层扫描记录，可导出为 **CSV**、**XLS** 或 **XLSX**。

    每种类型都有各自独立的格式下拉菜单，因此您可以在同一次请求中将 Analytics Report 请求为 PDF，同时将 Scan Data Report 请求为 CSV。
  </Step>

  <Step title="可选地保存该配置">
    勾选 **Save this report** 可保留这组实体、筛选条件和格式组合，方便日后无需重新输入即可再次运行——已保存的配置会显示在 **saved reports** 下，可通过抽屉顶部链接打开的 **Select saved reports** 下拉菜单访问。
  </Step>

  <Step title="创建报告">
    选择 **Create New Report**。抽屉会关闭，Reports 表格中会出现一行新记录，带有 **Requested On** 时间戳和 **In Progress** 状态。
  </Step>
</Steps>

## 请求报告之后

已请求的报告会记录在一个表格中，包含以下列：

* **Requested On** — 您提交请求的时间。
* **Generated On** — 报告处理完成的时间（处理过程中显示为 `—`）。
* **Requested By** — 请求该报告的用户。
* **Status** — 进度指示，起始状态为 **In Progress**。
* **Action** — 用于下载已完成的文件，或取消一个待处理的请求。

<Warning>
  在针对真实测试账户验证本页内容期间，一份已请求的报告（涵盖全部二维码的 Analytics Report/PDF + Scan Data Report/CSV）在几分钟内始终停留在 **In Progress** 状态，**Generated On** 仍显示为 `—`，既未完成也没有生成下载链接。这可能是用于验证的测试/开发环境特有的情况，而非生产环境的行为，但如果您看到某份报告长时间停留在 **In Progress** 状态，值得反馈给支持团队。
</Warning>

## 接下来可以做什么

* [Analytics dashboard](/zh/analytics/dashboard) — 这些数据所来源的实时仪表盘，支持即时的屏幕内导出。
* [Email reports](/zh/analytics/email-reports) — 用于按定期排期自动投递报告，而不是按需生成。

## 相关内容

* [Analytics dashboard](/zh/analytics/dashboard) — 此处生成的每一份报告背后的实时视图。
* [Email reports](/zh/analytics/email-reports) — 该一次性报告的定期对应功能。
* [下载最终用户与 RSVP 数据](/zh/leads/downloading-data) — 一种独立的、行为不同的潜客、表单和 RSVP 数据导出机制。
