请注意：：本文仅为方便您阅读而提供。

了解自定义报告生成器中的通信订阅事件

上次更新时间： 2026年5月26日

HubSpot 会跟踪两类通信订阅事件，您可以在自定义报告生成器中使用这些事件，以分析联系人订阅和同意偏好随时间的变化情况。

每个事件记录的是某个时间点的变更，因此，如果某位联系人先通过偏好设置页面取消订阅，随后又通过工作流被取消订阅，系统将分别记录这两个独立事件——每个操作对应一个事件。

用例：订阅者流失根本原因分析与渠道疲劳审计

在季度绩效审查期间，某组织发现数据库流失率和退订率急剧上升，但缺乏归因数据来确定原因。

团队无法判断流失是由于受众与内容匹配度低、工作流问题，还是因短信等高接触媒介导致的渠道疲劳所致。这种有限的可见性阻碍了有针对性的留存工作和系统修复，使长期收入和潜在客户生成面临风险。

通过使用特定时间点的事件追踪，营销运营经理可以构建一份自定义报告，以诊断受众流失的精确技术或战略根源。

该报告不再依赖静态且易被覆盖的联系人记录，而是完整记录退订的历史轨迹，提供可追溯的时间线，清晰展示用户偏好变化的具体原因及过程。

可用的报告模板包括：

要基于这些模板创建报告：

请参阅下文，了解每种事件类型和来源值属性的含义：

当某联系人的特定订阅类型（例如“营销信息”）的订阅状态发生变化时，将触发此事件。

属性	所代表的含义
订阅类型 (hs_subscription)	联系人订阅或取消订阅的内容类别（例如，新闻通讯、产品更新）。
订阅状态 (hs_subscription_status)	联系人的订阅状态：已订阅 (`OPT_IN`)、已取消订阅 (`OPT_OUT`) 或未指定 (`NOT_OPTED`)。
来源 (hs_source)	订阅更新的来源。请参阅下方的“来源值”表。
品牌 (hs_business_unit_id)	更新时与该订阅关联的品牌。
电子邮件地址 (hs_subscriber_email_address)	与订阅更新关联的电子邮件地址。
电话号码 (hs_subscriber_phone_number)	与订阅更新关联的电话号码。
用户 (hs_user)	更改订阅状态的 HubSpot 用户（如适用）。
工作流 (hs_workflow_id)	触发此事件的工作流（如果来源是“工作流”）。
邮件名称 (hs_email_id)	导致订阅更新的具体电子邮件（如适用）。
表单 (hs_form_id)	与订阅更新相关的表单（如适用）。
导入 (hs_import_id)	更新了联系人订阅状态的导入操作（如适用）。

当联系人对特定渠道（电子邮件、短信或 WhatsApp）接收通信的同意状态发生更新时，将触发此事件。

属性	所代表的含义
订阅类型 (hs_subscription)	通信渠道：电子邮件、WhatsApp 或短信。
订阅状态 (hs_subscription_status)	联系人的同意状态。目前仅跟踪“已退订”（`OPT_OUT`）。
来源 (hs_source)	同意状态更新的来源。请参阅下方的来源值表。
品牌（hs_business_unit_id）	此同意状态适用的品牌。
電子郵件地址 (hs_subscriber_email_address)	与同意更新相关的电子邮件地址。
电话号码 (hs_subscriber_phone_number)	与同意更新相关的电话号码。
用户 (hs_user)	更改同意设置的 HubSpot 用户（如适用）。
工作流 (hs_workflow_id)	触发此事件的工作流（如果来源是“工作流”）。
电子邮件名称 (hs_email_id)	导致同意状态更新的具体电子邮件（如适用）。
表单 (hs_form_id)	与同意更新相关的表单（如适用）。
导入 (hs_import_id)	更新了联系人同意状态的导入操作（如适用）。

这两个事件共享相同的 Source 属性值。具体含义如下：

值	标签	描述
BULK_UPDATE	批量订阅更新	使用批量操作一次性更新了多个联系人的订阅状态。
工作流	工作流	HubSpot 工作流操作更改了订阅或同意状态。
EXTERNAL_API	外部 API	通过外部集成经由 HubSpot API 进行了更新。
LIST_UNSUBSCRIBE	列表退订	该联系人通过电子邮件中的列表级退订标头退订。
PREFERENCE_PAGE	偏好设置页面	联系人通过电子邮件订阅偏好设置页面更新了其偏好设置。
ONE_CLICK_UNSUBSCRIBE	一键退订	联系人使用了电子邮件标题中的“一键退订”机制。
FORM_SUBMISSION	表单提交	订阅变更是由表单提交引起的。
CONTACT_RECORD	联系人记录	某 HubSpot 用户在 CRM 的联系人记录中手动更新了订阅。
旧系统	旧系统	该更新来自一个旧版 HubSpot 系统。
DATA_SYNC	数据同步	该更新是通过数据同步集成（如 Salesforce）应用的。
IMPORT	导入	订阅状态已通过文件导入进行更改。
HUBSPOT_MIGRATION	由 HubSpot 发起的迁移	此更新是作为 HubSpot 发起的迁移的一部分进行的。
SPAM_REPORT	垃圾邮件报告	该联系人将一封电子邮件标记为垃圾邮件，从而触发了自动退订。
对话	对话	该更新是通过 HubSpot 对话/收件箱操作完成的。
未识别	不支持该来源	无法识别更新来源，或该来源类型不受支持。

在使用通信事件构建报告前，请先了解以下关键技术行为和结构差异：

不可变的历史日志记录：订阅状态或渠道同意的每次变更都会生成一个独特且独立的事件。HubSpot 绝不会更新或覆盖现有事件。如果联系人多次修改其偏好设置，或通过不同的操作来源进行修改，每次不同的操作都会产生独立的事件记录，从而保留完整的历史审计轨迹。
以联系人为中心的架构：这些跟踪事件以联系人为中心，并直接关联到单个联系人记录。
订阅类型与渠道：配置自定义报告时，请注意以下两个主要属性的区别：
- 订阅类型（状态事件）：代表贵组织分发的特定内容类别（例如，“营销信息”、“产品更新”）。
- 渠道（同意事件）：代表沟通媒介本身（例如，电子邮件、短信、WhatsApp）。

这篇文章有帮助吗？

此表单仅供记载反馈。了解如何获取 HubSpot 帮助。