---
metadata:
  - name: generator
    content: Diplodoc Platform v5.63.4
alternate:
  - https://appmetrica.yandex.com/docs/en/mobile-api/datastream/about.md
  - https://appmetrica.yandex.com/docs/ru/mobile-api/datastream/about.md
  - https://appmetrica.yandex.com/docs/zh/mobile-api/datastream/about.md
  - href: https://appmetrica.yandex.com/docs/zh/mobile-api/datastream/about.md
    type: text/markdown
    title: Markdown version
  - href: https://appmetrica.yandex.com/docs/zh/llms.txt?revision=r21698989
    rel: describedby
---
> **Documentation Index:** Fetch the complete configuration index at https://appmetrica.yandex.com/docs/zh/llms.txt?revision=r21698989

# 介绍

数据流是从应用传来并由 AppMetrica 处理的数据流。 该数据流可导出为 CSV（遵循 [RFC 4180](https://tools.ietf.org/html/rfc4180) 标准）或 JSON 文件。 您可以通过发送[API 请求](https://appmetrica.yandex.com/docs/zh/mobile-api/datastream/ref/settings-post.md)来设置导出字段的列表。

数据流由一系列5分钟的数据窗口组成。 您可以调用 API，将每个窗口下载为在设置时指定的格式的文件。 所有流数据保留7天。 您可以通过API请求了解数据大小和字段组成。

未聚合的应用数据可以用于创建自定义报告或形成再目标广告的受众。 以下数据可供导出：

- Events
- 安装
- Session starts
- Push tokens
- Crashes
- Errors
- 点击和展示次数
- Revenue
- 购买
- Ad Revenue
- 转换
- Deeplink

Data Stream API 遵循 REST 原则。 使用[修改设置](https://appmetrica.yandex.com/docs/zh/mobile-api/datastream/ref/settings-post.md)请求来配置数据流导出，包括事件类型、字段集和过滤器。 配置流后，新数据会写入文件，您可以通过发送 [下载数据](https://appmetrica.yandex.com/docs/zh/mobile-api/datastream/ref/data.md) 请求来下载这些文件。

{% note info "" %}

修改的设置仅应用于新数据。 已生成的文件不会改变。

{% endnote %}

## 何时使用数据流 API {#audiencs}

Data Stream API 可能会有用，如果：

- 您需要定期导出数据。
- 您的应用程序或项目包很大。
- 导出量一次超过500,000条记录。
- 您需要频繁导出，且没有限制。

## 实时数据 {#real-time-data}

通常，最后两个五分钟窗口会逐渐变大，因为会不断添加新数据。 因此，我们建议您至少下载具有10分钟延迟的流。 要检查下载后数据是否已更新，可以查看`update_timestamp`字段，该字段位于“[Stream status](https://appmetrica.yandex.com/docs/zh/mobile-api/datastream/ref/status.md)”请求的响应中。 请注意，当数据流服务出现故障时，窗口可能会被跳过。 在这种情况下，数据不会丢失，但第一个窗口的数据量会更大。

{% note info "" %}

当 Data Stream 服务在维护期间，数据将被写入在维护完成后生成的文件中。 因此它们的大小可能会更大。 尽管如此，所有数据都已保存，且 `event_timestamp` 在所有记录中都是准确的。

{% endnote %}

## Data Stream API 与 Logs API 对比 {#compare}

#|
|| **功能** | **数据流 API** | **日志 API** ||
|| Use case | 进行中的分析 | 根据需要导出历史数据 ||
|| 导出数据可用性 | 从配置流开始可用；历史数据不可用。 文件保留期 — 7 天 | 历史数据可用于任何时间段 ||
|| 实时数据传输 | 最多延迟 10 分钟以稳定最后一对 5 分钟窗口 | 实时数据不可用 ||
|| 数据准备等待时间 | 文件立即可用 | Yes ||
|| 导出字段配置 | Yes | Yes ||
|| 可用字段数量 | 大于（例如，事件中为41，安装中为52等） | 较少（例如，事件为32，安装为42等） ||
|| 按事件名称过滤 | 是的，使用白名单和黑名单 | 只支持严格相等，一次只能按一个字段过滤 ||
|| 导出格式 | CSV, JSON | CSV, JSON ||
|| 压缩支持 | 是的，使用 gzip 编解码 | 是的，使用 gzip 编解码 ||
|| 请求处理队列 | 否 | 是（最多同时3个请求） ||
|| 日请求限制 | 最多 50,000 | 每个用户最多 5000 个 ||
|| 同时下载请求的数量 | 最多10 | 如果文件已准备好 — 无限制；否则应用队列限制 ||
|#


<!-- source: zh/_includes/feedback-button-2.md -->
如果您没有找到所需答案，可以通过反馈表单提交您的问题。 请尽可能详细地描述问题。 如果可能，请附上截图。

<a href="../troubleshooting/feedback-new">
  <span class="button">联系支持</span>
</a>

<a href="../troubleshooting/feedback-docs">
  <span class="button">建议改进文档</span>
</a>
<!-- endsource: zh/_includes/feedback-button-2.md -->