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

# 推送频率限制

> 限制推送通知的发送频率

OneSignal 帮助您有效地触达用户，而不会让他们感到不堡重负。发送过多消息可能导致退订、取消互动或用户体验不佳。频率限制允许您通过设置每分钟、每小时、每天或每周发送的消息数量限制来控制用户从您的应用程序接收推送通知的频率。

<Note>
  频率限制在精选的[付费计划](https://onesignal.com/pricing)中可用。
</Note>

***

## 频率限制如何工作

示例：设置**24 小时期间内 3 个通知**的频率上限

**日历第 1 天：**

* 上午 9:00：发送通知 1。用户收到通知 1。（计数：1）✅
* 下午 1:00：发送通知 2。用户收到通知 2。（计数：2）✅
* 下午 5:00：发送通知 3。用户收到通知 3。（计数：3）✅

用户现在已达到他们滚动 24 小时窗口的 3 个通知限制，该窗口从第 1 天上午 9:00 开始。

**日历第 2 天：**

* 上午 8:00：发送通知 4。用户被限制，未收到通知 4，因为从第 1 天上午 9:00 开始的 24 小时窗口尚未过期。计数仍为 3。
* 上午 9:00：从通知 1（第 1 天上午 9:00）开始的 24 小时窗口重置。计数降至 2。用户现在可以接收另一个通知。
* 上午 9:01：发送通知 5。用户收到通知 5。（计数：3）✅
* 上午 10:00：发送通知 6。用户被限制，未收到通知 6。
* 上午 11:00：发送通知 7。用户被限制，未收到通知 7。
* 下午 1:00：从通知 2（第 1 天下午 1:00）开始的 24 小时窗口重置。计数降至 2。
* 下午 2:00：发送通知 8。用户收到通知 8。（计数：3）✅

在此示例中，通知 4、6 和 7 将被限制且不会传递给用户，而通知 1、2、3、5 和 8 将被传递。

***

## 何时使用频率限制

频率限制在消息量可能变得过多的情况下特别有用：

* **复杂的活动环境**：拥有多个团队或重叠营销活动的大型组织。
* **高频率触发器**：基于频繁事件发送通知的系统（例如，股价更新或自动新闻警报）。

***

## 如何启用频率限制

您可以通过 OneSignal 仪表板在应用程序级别配置频率限制：

<Steps>
  <Step>
    导航到**设置 > 推送和应用内 > 频率限制**。
  </Step>

  <Step>
    设置用户在给定时间段内可以接收的最大消息数。

    <Frame caption="通知可以在任何时间框内被限制为 x 个通知。">
      <img src="https://mintcdn.com/onesignal/9_Q1FZLh6C0BFLq-/images/docs/ca59ff47b3c7bd4fe834d818299d7365957de85d86b1b5577b111dcbbef4bfdd-Screenshot_2025-04-16_at_12.07.24_PM.png?fit=max&auto=format&n=9_Q1FZLh6C0BFLq-&q=85&s=d2d6528f4b6cc767fca4c20eef01dfe1" width="2394" height="1520" data-path="images/docs/ca59ff47b3c7bd4fe834d818299d7365957de85d86b1b5577b111dcbbef4bfdd-Screenshot_2025-04-16_at_12.07.24_PM.png" />
    </Frame>
  </Step>
</Steps>

### 重要说明

* 限制适用于所有推送消息，无论来源如何（API、Journeys 或手动发送）。
* 因限制而被阻止的消息会被丢弃，而不是排队等待后续处理。

例如，如果限制设置为每天 2 条，用户已经收到 2 条 API 消息，除非覆盖限制，否则 Journey 消息将被丢弃。

***

## 覆盖频率限制

在某些情况下，您可能希望即使超过了限制也要发送消息。您可以按消息覆盖频率限制：

<Tabs>
  <Tab title="Dashboard">
    在消息的**传递计划**中，选择**覆盖频率限制设置**。

    <Frame>
      <img src="https://mintcdn.com/onesignal/0qspEXXeJ8zJbkJ-/images/docs/81e1bd0-Screenshot_2022-11-16_at_3.14.52_PM.png?fit=max&auto=format&n=0qspEXXeJ8zJbkJ-&q=85&s=876b3661b21dbdcb5ec1c00920b2912d" width="2102" height="642" data-path="images/docs/81e1bd0-Screenshot_2022-11-16_at_3.14.52_PM.png" />
    </Frame>
  </Tab>

  <Tab title="API">
    使用[创建推送通知 API](/reference/push-notification)，您可以使用参数覆盖频率限制：

    * 将 `enable_frequency_cap` 设置为 `false`
  </Tab>
</Tabs>

### 关于覆盖的说明

* 必须在 OneSignal 仪表板中启用频率限制。
* 被覆盖的消息仍然计入限制中。这会影响未来消息是否被传递。

***

## 报告

启用限制时，您可以通过仪表板消息报告或查看消息 API 监控它对您通知的影响。

启用限制的每条消息都将显示以下状态：

* **被限制**：应用程序已启用频率限制以及被限制的数量。
* **被覆盖**：应用程序已启用频率限制，但通知被覆盖。

***