营销邮件与退订

营销邮件用于推广、活动和订阅资讯。发送营销邮件前，应确认收件人同意接收，并提供清晰、可用且及时生效的退订方式。

营销邮件规则

• 将 messageType 设置为 MARKETING；
• 每个邮件对象必须恰好包含一个 To 收件人；
• Cc 和 Bcc 必须为空；
• 向多位联系人发送时，为每位联系人创建独立邮件对象；
• 在 HTML 和纯文本正文中均提供可读的退订入口；
• 不向已退订、已投诉或明确拒绝接收的联系人继续发送营销邮件。

非模板邮件省略 messageType 时默认按营销邮件处理。不要把营销内容标记为 TRANSACTIONAL 以绕过收件人、抑制或退订规则。

自动退订内容

邮件产品 可以在发送阶段为营销邮件生成平台退订链接。该能力由 API Key 级开关控制，默认关闭，需要联系平台运营启用。

启用后，发送流程会：

1. 将正文中的 {{unsubscribe_url}} 或兼容写法 {{unsubscribe}} 替换为平台生成的链接；
2. 正文中没有占位符时，在 HTML 或纯文本末尾追加退订说明；
3. 添加标准退订邮件头：

List-Unsubscribe: <https://...>
List-Unsubscribe-Post: List-Unsubscribe=One-Click

List-Unsubscribe 提供退订地址，List-Unsubscribe-Post 声明支持 RFC 8058 一键退订。识别该协议的邮箱客户端可以在邮件顶部或列表页显示原生退订按钮。

事务邮件不会自动添加营销退订内容。

使用自己的退订链接

自动退订内容未启用时，你仍应在营销邮件中提供有效的 HTTPS 退订地址，并自行处理退订请求。

模板可以使用：

<a href="{{unsubscribe_url}}">Unsubscribe</a>

调用 API 时，在 variables 或 template.variables 中提供客户自有 HTTPS 链接。如果链接不合法，普通模板发送可能将占位符渲染为空；群发活动可能在发送阶段以 141015 拒绝邮件。

接入时请与平台确认当前 API Key 使用平台托管退订还是客户自有退订，不要根据示例推断开关状态。

自定义退订页面

在客户控制台的抑制名单页面打开退订页面设置，可以配置：

• 品牌名称和 Logo；
• 页面布局、主色和背景色；
• 英文、简体中文和印尼语文案；
• 默认语言；
• 官方网站和支持邮箱；
• 确认、成功、已退订、错误和无效链接状态的预览。

页面支持保存草稿、发布展示配置，以及在满足条件时回滚。发布退订页面配置只改变页面外观，不会启用 API Key 的自动退订开关，也不会清除历史抑制记录。

抑制名单

抑制名单记录平台不应继续投递的地址。客户可以搜索、手工添加和删除当前账户可见的记录。

删除记录前，应先解决地址错误、投诉或拦截的根因。地址再次发生硬退信或投诉时，平台可能重新创建抑制记录。

营销退订用于停止营销投递，不应被用来清除历史事实，也不代表可以绕过收件人的退订意愿。

联系人与活动受众

客户控制台提供联系人和受众管理能力：

• 新增、编辑和删除联系人；
• 创建标签和分组；
• 使用 UTF-8 CSV 导入或导出联系人；
• 按标签和分组筛选群发受众；
• 查看活跃、已退订和退信联系人统计。

CSV 文件最大 1 MB、10,000 行。email 必填，name 可选，tags 使用 JSON 字符串数组。每位联系人最多 10 个标签，可以加入多个分组。

群发活动保存草稿或提交审核时，会保存当时的收件人快照。之后修改联系人标签或分组，不会自动改变已保存的活动名单。

维护投递信誉

• 先向测试地址和小范围活跃受众发送，再逐步扩大规模；
• 保持发件域名、显示名称和内容用途一致；
• 定期清理无效和长期不互动的联系人；
• 及时处理退信、投诉和退订；
• 避免发送量突然增加；
• 遵循主要邮箱服务商的身份验证、退订和发送频率要求。

打开率依赖追踪像素。Apple Mail 隐私保护可能预加载图片并抬高打开率；禁用远程图片的客户端又可能漏记真实打开，因此打开率不等于精确阅读人数。

常见问题

删除抑制记录后，地址是否会重新出现？

可能。后续硬退信、投诉或新的退订事件可以再次形成抑制记录。

退订页面已经发布，为什么邮件没有自动添加退订链接？

退订页面展示配置与 API Key 的自动退订开关是两项独立配置。请联系平台运营确认开关状态。

事务邮件是否需要自动退订链接？

平台不会为事务邮件自动添加营销退订内容。请确保事务邮件确实用于必要的服务通知，而不是推广内容。

相关资源