创建自定义偏好或取消订阅页面

OneSignal提供了默认的邮件合规取消订阅体验，将链接注入到您的邮件模板中，让用户可以轻松取消订阅，其偏好设置也会实时更新。如果您想完全控制品牌、文案和字段（如类别退订），您可以用自己的自定义页面替换默认链接，并使用OneSignal API来取消订阅或更新用户偏好。自定义取消订阅页面允许：

品牌视觉效果（标志、颜色、字体）
多语言支持
使用标签进行偏好管理（退订特定邮件类别而不是全部）
额外组件如调查以收集反馈

先决条件

在构建自定义页面之前，确保您具备：

**熟悉Liquid**用于个性化。
OneSignal API访问权限 – 根据您的需求，您可能使用：
- 通过Token更新订阅 – 通过邮件地址更新或取消订阅。
- 使用Token取消订阅邮件 – 跟踪特定邮件消息ID的取消订阅。
- 更新用户 – 更新个人资料、标签和偏好。
- Web和移动SDK – 实时管理偏好。

移除OneSignal的默认取消订阅链接

OneSignal会自动在您的邮件模板中插入[unsubscribe_url]。此URL会取消用户在OneSignal中的所有邮件订阅。要使用您自己的页面：

移除OneSignal的默认取消订阅链接

OneSignal会自动在您的邮件模板中插入[unsubscribe_url]。此URL会取消用户的邮件订阅以免收到OneSignal中的进一步邮件。有关详细信息，请参阅邮件取消订阅链接。要使用您自己的页面，在模板中找到并移除默认链接。

<a href="[unsubscribe_url]">取消订阅</a>

在块编辑器中，默认链接可能显示为嵌套形式：

添加您的自定义取消订阅链接

用您自己的URL替换默认链接。使用Liquid变量将OneSignal数据传递给您的页面。常用参数：

参数	描述
`app.id`	OneSignal应用ID
`message.id`	邮件通知的ID
`subscription.email`	订阅者的邮件地址
`subscription.external_id`	用户的外部ID
`subscription.language`	首选语言（用于本地化）
`subscription.unsubscribe_token`	用于API验证的安全令牌

示例HTML块：

HTML

  <div style="text-align: center;">
    <a
      href="https://examplesite.com/unsubscribe?app_id={{app.id}}&notification_id={{message.id}}&email={{subscription.email}}&language={{subscription.language}}&token={{subscription.unsubscribe_token}}"
      data-disable-tracking="true"
      style="display: inline; text-decoration: none;"
    >
      取消订阅
    </a>
    <p style="display: inline;">我们的邮件</p>
  </div>

禁用点击跟踪

取消订阅点击不应用于参与度指标。为您的发送服务添加适当的无跟踪属性：

HTML

  <a
    href="https://www.examplesite.com/unsubscribe?app_id={{app.id}}&notification_id={{message.id}}&email={{subscription.email}}&language={{subscription.language}}&token={{subscription.unsubscribe_token}}"
    data-disable-tracking="true"
  >
    取消订阅
  </a>

特定提供商属性：

提供商	属性
OneSignal	`data-disable-tracking="true"`
Mailgun	`disable-tracking=true`
SendGrid	`clicktracking=off`
Mandrill	`mc:disable-tracking`

托管您的自定义取消订阅页面

部署一个网页，它：

从取消订阅链接读取查询参数。
显示用户友好的退订或偏好选项。
通过API向OneSignal发送取消订阅或更新请求。

我们提供一个可用的GitHub示例项目，您可以复制并部署。

调用OneSignal API

根据您的用例，您可以使用以下API来取消订阅或更新用户偏好：

通过Token更新订阅
使用Token取消订阅邮件
更新用户

当您有用户的邮件地址并只想让他们订阅或取消订阅所有邮件时，最常用此API。必需的查询参数：

app_id
token

需要身份验证

从您的服务器调用此API。

当用户确认取消订阅时，调用使用Token取消订阅邮件 API。必需的查询参数：

app_id
notification_id
token

可选参数：

email
language

JavaScript示例：

JavaScript

const unsubscribeURL = (href) => {
  const unsubscribeURL = new URL(href)
  const appID = unsubscribeURL.searchParams.get("app_id")
  const notificationID = unsubscribeURL.searchParams.get("notification_id")
  const unsubscribeToken = unsubscribeURL.searchParams.get("token")
  const language = unsubscribeURL.searchParams.get("language")
  const email = unsubscribeURL.searchParams.get("email")
  return {
    unsubscribeURL: `https://api.onesignal.com/apps/${appID}/notifications/${notificationID}/unsubscribe?token=${unsubscribeToken}`,
    meta: { language, email },
  }
}

使用更新用户 API更新用户的偏好。必需的查询参数：

app_id
alias_id - 推荐使用用户的外部ID。

需要身份验证

从您的服务器调用此API。

开始使用和设置

消息渠道

旅程

受众和自定义事件

分析和集成

隐私和安全

创建自定义偏好或取消订阅页面

先决条件

移除OneSignal的默认取消订阅链接

禁用点击跟踪

托管您的自定义取消订阅页面

调用OneSignal API

​先决条件

​移除OneSignal的默认取消订阅链接

​禁用点击跟踪

​托管您的自定义取消订阅页面

​调用OneSignal API

先决条件

移除OneSignal的默认取消订阅链接

禁用点击跟踪

托管您的自定义取消订阅页面

调用OneSignal API