- 品牌视觉效果(标志、颜色、字体)
- 多语言支持
- 使用标签进行偏好管理(退订特定邮件类别而不是全部)
- 额外组件如调查以收集反馈
先决条件
在构建自定义页面之前,确保您具备:- **熟悉Liquid**用于个性化。
- OneSignal API访问权限 – 根据您的需求,您可能使用:
- 通过Token更新订阅 – 通过邮件地址更新或取消订阅。
- 使用Token取消订阅邮件 – 跟踪特定邮件消息ID的取消订阅。
- 更新用户 – 更新个人资料、标签和偏好。
- Web和移动SDK – 实时管理偏好。
移除OneSignal的默认取消订阅链接
OneSignal会自动在您的邮件模板中插入[unsubscribe_url]
。此URL会取消用户在OneSignal中的所有邮件订阅。
要使用您自己的页面:
1
移除OneSignal的默认取消订阅链接
OneSignal会自动在您的邮件模板中插入在块编辑器中,默认链接可能显示为嵌套形式:
[unsubscribe_url]
。此URL会取消用户的邮件订阅以免收到OneSignal中的进一步邮件。有关详细信息,请参阅邮件取消订阅链接。要使用您自己的页面,在模板中找到并移除默认链接。
块编辑器取消订阅链接
2
添加您的自定义取消订阅链接
用您自己的URL替换默认链接。使用Liquid变量将OneSignal数据传递给您的页面。常用参数:
示例HTML块:
参数 | 描述 |
---|---|
app.id | OneSignal应用ID |
message.id | 邮件通知的ID |
subscription.email | 订阅者的邮件地址 |
subscription.external_id | 用户的外部ID |
subscription.language | 首选语言(用于本地化) |
subscription.unsubscribe_token | 用于API验证的安全令牌 |
HTML

添加自定义取消订阅链接
禁用点击跟踪
取消订阅点击不应用于参与度指标。 为您的发送服务添加适当的无跟踪属性:HTML
提供商 | 属性 |
---|---|
OneSignal | data-disable-tracking="true" |
Mailgun | disable-tracking=true |
SendGrid | clicktracking=off |
Mandrill | mc:disable-tracking |
托管您的自定义取消订阅页面
部署一个网页,它:- 从取消订阅链接读取查询参数。
- 显示用户友好的退订或偏好选项。
- 通过API向OneSignal发送取消订阅或更新请求。
我们提供一个可用的GitHub示例项目,您可以复制并部署。

示例取消订阅页面UI
调用OneSignal API
根据您的用例,您可以使用以下API来取消订阅或更新用户偏好:- 通过Token更新订阅
- 使用Token取消订阅邮件
- 更新用户
当您有用户的邮件地址并只想让他们订阅或取消订阅所有邮件时,最常用此API。必需的查询参数:
app_id
token
- 从您的服务器调用此API。
现在您应该具备了创建自定义取消订阅页面所需了解的一切。