> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 邮件取消订阅链接和标头

> 了解如何在 OneSignal 中管理邮件取消订阅行为，包括取消订阅链接、List-Unsubscribe 标头、抑制规则和重新订阅工作流程。

管理用户如何取消订阅您的邮件对于遵守邮件标准（如 CAN-SPAM）、确保在 Gmail 和 Yahoo 等提供商处具有强大的投递能力以及与您的受众建立信任至关重要。

OneSignal 支持可见的取消订阅链接和 List-Unsubscribe 标头，确保您的邮件完全合规，同时让您控制用户何时以及如何选择退出。

## 订阅状态和抑制逻辑

邮件[订阅](./subscriptions)有以下状态：

* **已订阅** – 有资格接收邮件消息。
* **已取消订阅** – 除非明确覆盖，否则将从大多数邮件发送中排除。

要在您的邮件中包含已取消订阅的订阅（例如，用于交易消息）：

* 在仪表板中：发送邮件时启用**高级设置 > 包括向已取消订阅的用户发送**。
* 在 API 中：在[创建邮件通知 API](/reference/email)中使用 `include_unsubscribed` 属性。

<Frame caption="启用向已取消订阅的用户发送">
  <img src="https://mintcdn.com/onesignal/jBdBk5XvQR5eKOks/images/docs/72d0ed1-f246c05-Screenshot_2023-01-18_at_10.06.54_AM.png?fit=max&auto=format&n=jBdBk5XvQR5eKOks&q=85&s=5bddf440aae0717dc518b8a43789d3da" width="906" height="616" data-path="images/docs/72d0ed1-f246c05-Screenshot_2023-01-18_at_10.06.54_AM.png" />
</Frame>

***

## 用户如何取消订阅

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

* 用户点击取消订阅链接或 List-Unsubscribe 标头
* 您[导入邮件地址 CSV](./import)并将 `subscribed` 设置为 `no`。
* 您通过[创建用户](/reference/create-user)、[更新用户](/reference/update-user)或[更新订阅](/reference/update-subscription) API 设置 `enabled : false`。
* 您从**受众 > 订阅 > 选项 > 取消邮件订阅**手动取消订阅

***

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

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

### List-Unsubscribe 标头行为

OneSignal 在所有邮件中包含 `List-Unsubscribe` 标头，**除非您启用"包括向已取消订阅的用户发送"**。这有助于：

* 防止您的邮件被标记为垃圾邮件
* 遵守 [Gmail/Yahoo 2024 规则](https://onesignal.com/blog/guide-to-2024-gmail-and-yahoo-requirements-for-email-senders/)。

<Warning>
  如果您启用"包括向已取消订阅的用户发送"，则**不会包含** List-Unsubscribe 标头。

  除非您满足某些发送量阈值，否则某些收件箱提供商可能不会显示此标头。请参阅 [Gmail](https://support.google.com/a/answer/81126?visit_id=638683263663552218-2680312485\&rd=1#requirements-5k\&zippy=%2Crequirements-for-sending-or-more-messages-per-day) 和 [Yahoo](https://senders.yahooinc.com/best-practices/) 的要求。
</Warning>

如果用户点击此项，他们的邮件订阅将在您的 OneSignal 应用中被标记为已取消订阅。

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

OneSignal 提供 `[unsubscribe_url]` 令牌，它在您的邮件内容中插入可见的取消订阅链接。

您也可以使用自己的取消订阅页面创建品牌化体验。请参阅[创建自定义取消订阅页面](./create-custom-unsubscribe-page)。

#### HTML 编辑器

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

<Frame caption="带默认取消订阅链接的 HTML 编辑器">
  <img src="https://mintcdn.com/onesignal/0qspEXXeJ8zJbkJ-/images/docs/8b10e10-default_code.png?fit=max&auto=format&n=0qspEXXeJ8zJbkJ-&q=85&s=0c996973cd6335a81dd8854c8e0e355d" width="1309" height="562" data-path="images/docs/8b10e10-default_code.png" />
</Frame>

手动添加（例如通过带有 `email_body` 的 API）：

```html HTML theme={null}
<a href="[unsubscribe_url]">Unsubscribe</a>
```

#### 拖放编辑器

在文本块中：

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

<Frame caption="拖放编辑器中的取消订阅链接">
  <img src="https://mintcdn.com/onesignal/0qspEXXeJ8zJbkJ-/images/docs/7f78d2e-Screenshot_2023-01-18_at_9.59.12_AM.png?fit=max&auto=format&n=0qspEXXeJ8zJbkJ-&q=85&s=46180061304abd272dbcef4c85b3b710" width="1114" height="230" data-path="images/docs/7f78d2e-Screenshot_2023-01-18_at_9.59.12_AM.png" />
</Frame>

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

***

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

您可以将 `[unsubscribe_url]` 替换为您自己的取消订阅着陆页面。

要这样做：

* 按照[创建自定义取消订阅页面](./create-custom-unsubscribe-page)中的步骤操作。
* 将您邮件中的 `[unsubscribe_url]` 替换为您自定义取消订阅页面的 URL。

<Warning>
  如果使用自定义链接，OneSignal 将不会自动将用户标记为已取消订阅。您必须通过 API 或页面行为来处理。
</Warning>

***

## 常见问题

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

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

一旦您的域名通过验证，取消订阅链接将正常渲染和运行。

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

用户可以通过三种方式重新订阅：

1. 仪表盘：转到**受众 > 订阅 > 选项 > 重新订阅邮件**
2. API：在 [Create User](/reference/create-user) 或 [Update subscription](/reference/update-subscription) API 中设置 `enabled: true`
3. CSV 导入：导入邮件地址时设置 `subscribed = yes`

<Warning> 如果您使用第三方邮件服务提供商 (ESP)，请检查其抑制列表并也在那里移除该地址。 </Warning>

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

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

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

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

***

## 相关文章

* [创建自定义取消订阅页面](./create-custom-unsubscribe-page)
* [邮件消息](./email-messaging)
* [邮件 API](/reference/email)
* [URL、链接和深链接](./links)

***