跳转到主要内容
管理用户如何取消订阅您的邮件对于遵守邮件标准（如 CAN-SPAM）、确保在 Gmail 和 Yahoo 等提供商处具有强大的投递能力以及与您的受众建立信任至关重要。 OneSignal 支持可见的取消订阅链接和 List-Unsubscribe 标头，确保您的邮件完全合规，同时让您控制用户何时以及如何选择退出。

​
订阅状态和抑制逻辑

邮件订阅有以下状态：
  • 已订阅 – 有资格接收邮件消息。
  • 已取消订阅 – 除非明确覆盖，否则将从大多数邮件发送中排除。
要在您的邮件中包含已取消订阅的订阅（例如，用于交易消息）：
  • 在仪表板中：发送邮件时启用高级设置 > 包括向已取消订阅的用户发送。
  • 在 API 中：在创建邮件通知 API中使用 include_unsubscribed 属性。

启用向已取消订阅的用户发送

​
用户如何取消订阅

邮件订阅状态通过以下方式更新：

​
取消订阅标头与取消订阅链接

  • List-Unsubscribe 标头：收件箱提供商用于显示原生”取消订阅”按钮（例如 Gmail、Yahoo）的隐藏邮件标头。
  • 取消订阅链接：使用 [unsubscribe_url] 令牌放置在邮件内容中的可见可点击 URL。

​
List-Unsubscribe 标头行为

OneSignal 在所有邮件中包含 List-Unsubscribe 标头，除非您启用”包括向已取消订阅的用户发送”。这有助于：
如果您启用”包括向已取消订阅的用户发送”，则不会包含 List-Unsubscribe 标头。除非您满足某些发送量阈值，否则某些收件箱提供商可能不会显示此标头。请参阅 Gmail 和 Yahoo 的要求。
如果用户点击此项，他们的邮件订阅将在您的 OneSignal 应用中被标记为已取消订阅。

​
在邮件中添加取消订阅链接

OneSignal 提供 [unsubscribe_url] 令牌，它在您的邮件内容中插入可见的取消订阅链接。 您也可以使用自己的取消订阅页面创建品牌化体验。请参阅创建自定义取消订阅页面。

​
HTML 编辑器

如果使用我们的 HTML 编辑器，默认模板会自动包含取消订阅链接：

带默认取消订阅链接的 HTML 编辑器

手动添加（例如通过带有 email_body 的 API）：
HTML
<a href="[unsubscribe_url]">Unsubscribe</a>

​
拖放编辑器

在文本块中：
  1. 点击特殊链接 > 抑制 > 取消订阅
  2. 将插入 [unsubscribe_url] 占位符
  3. 您可以在插入前高亮文本以将其转为链接

拖放编辑器中的取消订阅链接

始终让取消订阅链接高度可见，使用可读的字体大小（至少 12px）和强对比度。隐藏或难以找到的链接可能导致用户将您的消息标记为垃圾邮件，损害未来的投递能力。

​
自定义取消订阅链接目标

您可以将 [unsubscribe_url] 替换为您自己的取消订阅着陆页面。 要这样做：
如果使用自定义链接，OneSignal 将不会自动将用户标记为已取消订阅。您必须通过 API 或页面行为来处理。

​
常见问题

​
为什么我的测试邮件中的取消订阅链接不起作用？

如果您的 OneSignal 邮件发送域名尚未验证，测试邮件中的取消订阅链接将无法正常工作。您将看到占位符文本，但没有真正的链接。 一旦您的域名通过验证，取消订阅链接将正常渲染和运行。

​
如何重新订阅邮件地址？

用户可以通过三种方式重新订阅：
  1. 仪表盘：转到受众 > 订阅 > 选项 > 重新订阅邮件
  2. API：在 Create User 或 Update subscription API 中设置 enabled: true
  3. CSV 导入：导入邮件地址时设置 subscribed = yes
如果您使用第三方邮件服务提供商 (ESP)，请检查其抑制列表并也在那里移除该地址。

​
为什么我的邮件中有两个取消订阅链接？

如果您使用 Mailgun 或 SendGrid 等邮件服务提供商，它们可能会插入自己的取消订阅链接。您可以在 ESP 设置中禁用此功能以避免重复。

​
取消订阅点击是否计入分析？

  • 点击 OneSignal 自定义的 [unsubscribe_url] 不会计入点击分析。
  • 点击自定义取消订阅 URL 将被计为一次点击。有关更多详细信息，请参阅 URL、链接和深链接。

​
相关文章

⌘I