Skip to main content
高级部分涵盖了为有特定需求或自定义实施的客户提供的专业配置和通知行为。

网页推送 Webhooks

OneSignal 为处理通知事件提供专用的网页推送 Webhooks。请查看网页推送 Webhooks获取完整的实施详情。 重要:网页推送 Webhooks 是与事件 Webhooks分开的实施,不能互换使用。

Service Worker 配置

OneSignal 默认情况下会自动检查根范围的 service workers。但是,我们强烈廊议自定义您的集成以使用非根范围,以获得更好的安全性并避免与现有 service workers 发生冲突。 请遵循我们的 OneSignal Service Worker 设置 指南来实施自定义范围配置。 为什么使用非根范围?
  • 防止与现有 service workers 发生冲突
  • 通过限制 OneSignal 的范围来提高安全性
  • 对您网站的 service worker 架构提供更好的控制

本地开发和测试

对于开发和测试目的,请查看我们的综合本地测试指南,其中涵盖:
  • 设置 localhost 环境
  • 在没有 SSL 证书的情况下测试通知
  • 调试常见开发问题

通知点击行为

OneSignal 支持用户点击通知时的多种浏览器行为。对于高级 URL 处理和完全禁用点击操作等选项,请查看深度链接和 URL

默认行为

当用户点击通知且没有打开您的网站时,浏览器会打开一个新的标签页并导航到通知的 URL。

网站已打开时

当用户在一个或多个浏览器标签页中打开了您的网站时,您可以配置浏览器的响应方式: 精确导航(默认)
  • 将通知的精确 URL(例如 example.com/product)与打开的标签页进行匹配
  • 在该匹配的标签页中导航到通知的 URL
  • 最适合特定页面定向
源导航
  • 将通知的源(例如 example.com)与您网站的任何打开的标签页进行匹配
  • 在匹配的标签页中导航到通知的 URL
  • 对于一般网站导航很有用
精确聚焦
  • 将通知的精确 URL 与打开的标签页进行匹配
  • 聚焦到该标签页而不刷新页面
  • 当您不希望打扰用户当前页面状态时的理想选择
源聚焦
  • 将通知的源与您网站的任何打开的标签页进行匹配
  • 聚焦到该标签页而不刷新页面
  • 最适合在不进行导航的情况下将注意力吸引到您的网站

通知持久性

默认情况下,通知会显示约 5 秒钟,然后移到通知历史记录中,在操作系统自动删除之前保留 1 周。

启用持久性通知

您可以使 Chrome 和 Edge 浏览器订阅者的通知在屏幕上持续显示直到用户交互。
不是所有浏览器和操作系统都支持持久性通知。启用后,它仅影响符合条件的用户,并可能通过减少字符数和影响图像/按钮显示来影响通知外观。
重要考虑事项:
  • 当前订阅者必须在启用此设置后重新访问您的网站才能看到更改
  • 持久性通知如果过度使用可能会让用户反感
  • 仅建议用于高重要性通知(例如任务管理应用)
  • 用户可以将鼠标悬停在通知上以保持其可见以供阅读

实施方法

1

仪表板配置

在您的 OneSignal 仪表板中使用“持久性”切换按钮来启用/禁用此功能。

通知持久性切换

2

自定义代码实施

persistNotification 属性添加到您的 Web Push SDK 初始化中:
persistNotification: true,
在您的 OneSignal 初始化代码中包含此内容,以为支持的浏览器和操作系统启用持久性。

浏览器兼容性

支持的浏览器:
  • Chrome(完全支持)
  • Edge(完全支持)
不支持的浏览器:
  • Firefox(设置无效)
  • Safari(设置无效)

最佳实践

  • 谨慎使用:仅对真正重要的通知启用,以避免用户反感
  • 充分测试:验证不同浏览器和设备上的行为
  • 监控用户反馈:注意退订率的增加,这可能表明通知疲劳
  • 考虑上下文:持久性通知最适合时间敏感或可操作的内容
下一步:
  • 查看您的通知策略以确定持久性是否适合
  • 在全面部署之前先在小用户群体中测试此功能
  • 实施后监控参与度指标
  • 考虑为不同类型的通知实施不同的持久性设置
I