跳转到主要内容

​
概述

本指南介绍如何设置和配置 OneSignal WordPress 网页推送插件 v3+。
对于较旧的版本 2.x.x WordPress 文档，请参阅 WordPress 旧版插件。

​
版本 3+ 的新功能

这个版本通过简化设置和配置流程标志着重大升级。使用版本 3+，您可以在一个地方处理所有提示设置——OneSignal 仪表板。
  • 🚀 SDK 升级：将 OneSignal Web SDK 从版本 15 升级到 16
  • 💬 仪表板提示：直接在 OneSignal 仪表板中配置所有权限提示——无需自定义代码
  • ⏩ 一键发布：勾选”发布文章时发送通知”以自动发送推送通知
  • 🧑‍🤝‍🧑 受众定向：选择哪些细分接收每篇文章的通知
  • 📲 移动应用集成：发送给移动应用订阅者，可选深度链接

​
设置

在开始之前，请确保您具备：
  • OneSignal 账户（免费创建）
  • WordPress 管理员访问权限以安装和配置插件
  • 启用 HTTPS 的网站（网页推送通知所需）

​
1. 在 OneSignal 仪表板中配置 WordPress

导航到设置 > 推送和应用内 > 网页 > WordPress 插件或网站构建器

从 OneSignal 仪表板中的网站构建器选项中选择 WordPress

​
站点设置

  • 站点名称：您网站的名称和默认通知标题。
  • 站点 URL：必须匹配您 WordPress 站点的确切 URL（遵循同源策略）
  • 自动重新订阅：启用此选项可在用户清除浏览器数据后返回您的站点时自动重新订阅（无需新的权限提示）
  • 默认图标 URL：用于通知和提示的正方形 256x256px PNG 或 JPG 文件 – MacOS Safari 在没有图标的情况下不会显示通知提示。

输入您的确切站点 URL。https://your-site.com 与 https://www.your-site.com 不同——始终使用一种格式

本地测试？参阅本地测试指南进行 localhost 开发

​
权限提示

为推送、邮件和短信设置您的权限提示。推送滑动提示默认启用，但您可以自定义或添加其他提示。
专业提示：从简单的提示开始，逐步增加复杂性。您可以随时通过 OneSignal 仪表板修改所有提示设置。 在网页权限提示中探索所有可用选项。
  • 基本提示设置
  • 高级：基于类别的细分
1

点击推送滑动提示进行自定义

访问并自定义您的推送滑动提示设置

2

配置时间和文本：

  • 将自动提示设置为 1 次页面浏览和 1 秒进行初始测试
    • 自定义提示文本和外观
    • 根据启动后的用户行为调整时间

配置自动提示时间并自定义提示外观

3

配置完提示后点击完成。

专业提示：从简单的提示开始，逐步增加复杂性。您可以随时通过 OneSignal 仪表板修改所有提示设置。 在网页权限提示中探索所有可用选项。

​
欢迎通知

设置用户首次订阅后立即发送的通知。这将：
  • 感谢用户订阅
  • 演示通知的显示方式
  • 提高参与度并减少退订
配置您的欢迎消息文本和时间，然后向下滚动并点击保存。
暂时跳过高级推送设置部分——这些用于自定义Web SDK 设置。点击保存继续。

​
2. 配置 WordPress 插件

保存仪表板配置后，您将看到应用 ID 和 API 密钥。将这些值复制到您的 WordPress 插件中：

从 OneSignal 仪表板复制您的应用 ID 和 API 密钥

看不到 API 密钥？ 请确保您在上方选择了 WordPress 选项。然后按照我们的密钥和 ID 指南创建一个。
1

在您的 WordPress 管理面板中，导航到 OneSignal 插件设置

2

完全按照仪表板中显示的方式粘贴应用 ID 和 REST API 密钥

确保您的 WordPress 插件应用 ID 和 REST API 密钥与 OneSignal 仪表板完全匹配

​
高级设置

根据您的需要配置附加插件选项：

用于增强功能和分析跟踪的高级设置

URL 参数跟踪 向通知 URL 添加分析参数以进行跟踪。重要： 转义特殊字符——输入内容会原样添加到 URL 中。 Google Analytics 示例： 
utm_medium=push&utm_source=onesignal&utm_campaign=wordpress-plugin
包含特殊字符的示例： 
utm_medium=ppc&utm_source=adwords&utm_campaign=snow%20boots&utm_content=durable%20snow%20boots
其他设置
  • 自定义文章类型：添加来自插件的文章类型以启用通知选项
  • 发布文章时自动发送通知：发布文章时自动勾选通知框，无需手动勾选即可发送通知
  • 更新文章时自动发送通知：更新文章时自动勾选通知框，无需手动勾选即可发送通知
  • 发布页面时自动发送通知：发布页面时自动勾选通知框，无需手动勾选即可发送通知
  • 更新页面时自动发送通知：更新页面时自动勾选通知框，无需手动勾选即可发送通知
  • 从第三方插件发布文章时自动发送推送通知：从外部发布插件自动发送通知
  • 移动应用集成：使用相同的 OneSignal 应用 ID 向移动应用订阅者发送通知

​
3. 完成迁移（仅限升级用户）

新安装可以跳过此步骤。如果您要从 v2+ 升级，请继续阅读…
时间敏感： 尽快完成这些步骤，以避免用户在过渡期间错过通知。
1

保存 OneSignal 仪表板配置后，返回 WordPress

2

在插件设置中点击迁移完成

3

点击保存设置以完成升级

点击迁移完成以完成您的插件升级

设置完成！点击保存设置完成插件配置。

​
测试您的设置

  • 初始测试
  • 验证订阅
  • 发送测试消息
  1. 访问您的网站（避免使用隐身/私人浏览——用户在这些模式下无法订阅）
  2. 查找您配置的滑动提示

您配置的滑动提示应该根据您的时间设置显示

  1. 点击订阅按钮（在此示例中标记为 “订阅”）
  2. 在提示时接受浏览器权限

浏览器权限提示（外观因浏览器而异）是网页推送通知所必需的

  1. 检查欢迎通知（如果已配置）

欢迎通知在成功订阅后立即显示

成功！ 您的 WordPress 站点现在已配置为网页推送通知。用户订阅后将开始在您的订阅中显示。后续步骤：
遇到问题？ 查看我们的WordPress 故障排除指南获取常见解决方案。

​
发布通知

当您安排文章定时发布时，OneSignal 也会安排在定时时间向您的订阅者发送推送通知。如果您重新安排文章时间，推送通知将被取消，并为新时间安排新的推送。 您可以在 OneSignal 仪表板的投递 > 定时消息下查看您的定时和已取消通知。更多详细信息请参阅推送消息报告。

​
基本文章通知

创建或编辑 WordPress 文章时，找到 OneSignal 推送通知 元框（通常位于文章编辑器的底部或侧边栏）。

OneSignal 推送通知元框——如需要可拖拽重新定位

要发送通知：
  • 勾选 “在发布或更新文章时发送通知”
  • 取消勾选以跳过为该文章发送通知

​
受众定向

​
发送给所有订阅者（默认）

默认情况下，通知将发送给所有推送订阅者。

​
发送给特定细分

使用您在 OneSignal 仪表板 > 受众 > 细分中创建的细分定向特定受众。 如果您在第 3 步中设置了类别，请创建相应的细分：
  1. 在 OneSignal 仪表板中转到受众 > 细分
  2. 使用您的标签键创建细分，例如：
    • 新闻细分：标签 news 为 1
    • 优惠细分：标签 deals 为 1

标签区分大小写！'news' 和 'News' 是不同的标签

  1. 创建细分后，刷新您的 WordPress 文章编辑器
  2. 从下拉菜单中选择您的目标细分

选择特定细分以定向相关的用户组

高级细分：根据用户行为、位置、设备类型等创建细分。标签为自定义用户数据和个性化提供最大的灵活性。

​
自定义通知内容

​
默认行为

  • 标题：使用您的 WordPress 站点标题（设置 > 常规）
  • 消息：使用文章标题
  • 图像：使用文章的特色图像（如果已设置）
  • URL：链接到已发布的文章

​
自定义内容

勾选 “自定义通知内容” 以覆盖默认设置：

自定义通知标题、内容和其他元素

示例结果：

自定义推送通知在用户看来的样子

​
移动应用集成

如果您有使用相同 OneSignal 应用 ID 的移动应用：
  1. 在插件设置中启用 “向移动应用订阅者发送通知”
  2. 在文章元框中，添加用于深度链接的移动 URL
  3. 移动用户将被引导到您的应用而不是网页浏览器
准备扩展：探索高级推送策略和自动化旅程，以进行复杂的通知活动。
通知不显示？ 查看我们的网页推送故障排除指南获取解决方案。

​
常见问题

注意：此方法仅适用于滑动和原生权限提示，不适用于铃铛或自定义链接提示。
  1. 在您的 OneSignal 仪表板中，转到设置 > 推送和应用内 > 网页设置
  2. 从权限提示设置表中选择您的提示
  3. 取消勾选自动提示并点击完成

禁用自动提示以手动控制提示出现时间

  1. 向下滚动，点击保存，然后点击完成
  2. 在您希望显示提示的特定页面上添加自定义 JavaScript 代码
这给予您对提示时间和位置的完全控制。参阅网页权限提示获取实现细节。
可以！如果您的移动应用使用相同的 OneSignal 应用 ID：
  1. 在 WordPress 插件设置中启用 “向移动应用订阅者发送通知”
  2. 发布文章时，使用 OneSignal 元框中的移动 URL 字段指定深度链接
  3. 在没有自定义移动 URL 的情况下，用户将被引导到您的网站
此功能可以从单一的 WordPress 界面实现跨平台消息传递。
WordPress 插件目前仅支持推送通知。对于电子邮件和短信：
  1. 电子邮件：遵循我们的电子邮件设置指南，然后使用电子邮件消息工具
  2. 短信：遵循我们的短信设置指南，然后使用短信消息工具
这两个渠道都可以从相同的 OneSignal 仪表板与您的推送通知一起管理。
缓存问题：WordPress 缓存可能会延迟迁移更改。解决方案：
  1. 右键点击您的网站并选择检查
  2. 转到网络选项卡
  3. 勾选 “禁用缓存”

禁用浏览器缓存以强制加载迁移后更新的文件

  1. 刷新您的网站以查看当前配置
  2. 如适用，清除您的 WordPress 缓存插件设置
此错误表示迁移不完整：

浏览器控制台中的 404 错误表示迁移过程不完整

解决方案：
  1. 确保您已保存了 OneSignal 仪表板配置
  2. 在 WordPress 中，在插件设置中点击 “迁移完成”
  3. 点击 保存设置 完成升级
此错误仅影响从 2.x.x 版本升级的用户。
可以，您可以使用 onesignal_send_notification 过滤器。
将自定义 PHP 代码放在 wp-content/mu-plugins/onesignal-custom.php 中。这确保其正确加载，并防止因更新而被覆盖。
<?php

add_filter('onesignal_send_notification', function($fields, $post_id) {

  // 包含创建通知 API 参考中提到的任何属性：
  // https://documentation.onesignal.com/reference/push-notification 例如：

  // 添加操作按钮
  $fields['web_buttons'] = array(
    array(
      "id" => "read-more",
      "text" => "Read More",
      "url" => get_permalink($post->ID)
    )

  // 返回修改后的字段数组
  return $fields;

}, 10, 2);
⌘I