---
metadata:
  - name: generator
    content: Diplodoc Platform v5.63.4
alternate:
  - https://appmetrica.yandex.com/docs/en/mobile-api/datastream/limits.md
  - https://appmetrica.yandex.com/docs/ru/mobile-api/datastream/limits.md
  - https://appmetrica.yandex.com/docs/zh/mobile-api/datastream/limits.md
  - href: https://appmetrica.yandex.com/docs/zh/mobile-api/datastream/limits.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

# Data Stream API 使用条款

使用 Data Stream API 时，每月导出事件数量有限制。 该限制适用于组织中所有的应用程序。

在 **免费** 和 **自定义** 计划中，每月可免费使用 10 亿个 Data Stream API 事件。 在 **Pro** 计划中，每月包含4亿个事件。 如果您需要更高的量，可以在**自定义**和**专业**计划中扩展限制。 有关更多信息，请参阅[价格计划（以美元和阿联酋迪拉姆计价）](https://appmetrica.yandex.com/docs/zh/common/pricing/uae-currency.md)。

如果月度限制已达，Data Stream API 将无法下载新数据。 在限额超出后，事件仍会继续导出7天，但下载API会返回`400` HTTP代码。 如果在此期间没有提高限制，新数据的导出将停止，新数据会丢失。 每月第一天，限制会更新，导出功能会恢复。

数据流中也提供了**允许超限支付**选项。 如果在套餐设置中已启用，数据准备在超出限制后仍不会停止。 同时，超出限制的事件每百万事件会额外收费。

限额的使用量取决于准备的数据量，而不是下载次数。 如果数据已经准备好用于导出，您根本不需要下载它，也不需要多次下载：这不会减少或增加月度限制。

无需启用所有数据类型的导出。 在配置数据流 API 时，您可以仅选择完成任务所需的流，然后随时修改配置：添加新的数据类型或禁用已选中的数据类型。 仅包含启用导出的数据类型在限制范围内，而`收入`、`电子商务`和`广告收入`仍为免费，不包含在限制范围内。

对于自定义事件（数据类型 `event` / `attributed_event`），您可以进一步配置过滤，使用事件的白名单和黑名单。 如果使用了白名单，只会导出指定名称的事件。 如果使用了黑名单，列表中的事件将被排除在导出之外。 这样过滤的事件不会被导出到 Data Stream API，也不计入限额使用。

## 哪些数据类型被包含在限制范围内 {#data-types}

每月 Data Stream API 限制包括以下数据类型：

- `安装`
- `事件`
- `push_token`
- `崩溃`
- `错误`
- `session_start`
- `session_end`
- `点击`
- `attributed_event`
- `深链`

每上传一次这些类型的事件，就会计入总月限额。

## 哪些类型的数据可以免费上传 {#free-export}

上传基本的收入事件不会消耗配额，可免费上传任意数量。 这些数据类型包括：

- `收入`
- `电子商务`
- `广告收入`

这些数据流在计算 Data Stream API 的总费用时不需要考虑。

## 示例计算 {#example}

假设在您激活 Data Stream API 时，已启用了以下数据类型的导出：`安装`、`深链`、`点击`、`崩溃`、`错误`和`电子商务`。 在一个月的时间里，组织中所有应用生成了以下数据：

- 50,000,000 `点击` 事件
- 25,000 `安装`事件
- 150,000 `深链` 事件
- 300,000 `崩溃`事件
- 2,500,000 `错误`事件
- 5,000,000 `电商`事件

总限额使用量将为：

50,000,000 + 25,000 + 150,000 + 300,000 + 2,500,000 = 52,975,000

事件 `ecommerce` 不包含在此计算中，因为收入数据是免费导出的。 这样的量在每月1亿事件的免费限制范围内。

在下一个月，你决定额外启用导出`事件`、`session_start`和`session_end`. 然而，您已选择的数据类型的数量保持不变，本月没有新增数据类型：

- 60,000,000 `事件` 事件
- 18,000,000 `session_start` 事件
- 18,000,000 `session_end` 事件

因此，总限额消耗为：

52,975,000 + 60,000,000 + 18,000,000 + 18,000,000 = 148,975,000

事件 `ecommerce` 仍不会增加限额消耗，但在这种情况下，1亿的免费限额已经不够了。 要继续这样大量的卸载，需要购买 Data Stream API 的付费扩展，选择 **自定义** 或 **专业** 计划，该计划每月包含 4亿个事件。 如果同时上传类型为`revenue`、`ecommerce`或`ad_revenue`的数据，这些数据不会被加入此计算中。

<!-- 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 -->