瞭解自訂報表建立工具中的通訊訂閱事件
上次更新時間: 2026年5月26日
HubSpot 會追蹤兩項通訊訂閱事件,您可以在自訂報表建立工具中使用這些事件,以分析聯絡人的訂閱與同意偏好隨時間的變化。
每個事件皆記錄特定時間點的變更,因此若某位聯絡人先透過偏好設定頁面取消訂閱,之後又透過工作流程被取消訂閱,系統將分別記錄兩項獨立事件——每項操作各對應一項事件。
應用案例:訂閱者流失根本原因分析與管道疲勞審計
問題
在季度績效評估期間,某組織發現資料庫流失率與退訂率急遽上升,卻缺乏歸因數據來釐清原因。
團隊無法判斷流失是源於受眾與內容的匹配度不佳、工作流程問題,還是來自 SMS 等高接觸頻率媒介所造成的管道疲勞。這種有限的可視性阻礙了針對性的留存措施與系統修正,使長期營收與潛在客戶開發面臨風險。
解決方案
透過即時事件追蹤,行銷營運經理可建立自訂報告,精準診斷受眾流失的技術或策略根源。
相較於依賴靜態且易被覆寫的聯絡人記錄,此報表能完整捕捉退訂的歷史軌跡,提供可追溯的時序線,清晰呈現偏好設定的變更原因與過程。
從「通訊訂閱」範本建立報告
可用的報告範本包括:
- 按月劃分的通訊訂閱活動
- 過去 6 個月的通訊同意活動
- 過去一年按來源劃分的通訊訂閱活動
- 過去 6 個月的通訊訂閱活動
要根據這些範本建立報告:
- 在你的 HubSpot 帳戶中,瀏覽「報告」>「報告」。
- 在右上角,點擊「建立」。接著,選擇「建立報告」。
- 在左側邊欄選單中,點擊「範本報告庫」。接著,點擊「下一步」。
- 在左側邊欄選單中,點擊「資料來源」下拉式選單,並選擇「通訊訂閱」。
- 選擇其中一個可用範本,並繼續自訂報表設定。設定可能因報表而異。
- 完成報表自訂後,請點擊「儲存報表」。該報表現在將可在您的報表庫中查看。
了解事件類型與來源值
以下將進一步說明各事件類型與來源值屬性的代表意義:
事件 1:通訊訂閱狀態更新
當聯絡人的特定訂閱類型(例如「行銷資訊」)的訂閱狀態發生變更時,此事件即會觸發。
| 屬性 | 代表內容 |
| 訂閱類型 (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) | 更新聯絡人訂閱狀態的匯入作業(如適用)。 |
事件 2:通訊管道同意狀態更新
當聯絡人對特定通訊管道(電子郵件、簡訊或 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 工作流程動作變更了訂閱或同意狀態。 |
| 外部 API |
外部 API |
透過外部整合,經由 HubSpot API 進行了更新。 |
| LIST_UNSUBSCRIBE |
清單取消訂閱 |
該聯絡人透過電子郵件中的清單層級取消訂閱標頭取消訂閱。 |
| PREFERENCE_PAGE |
偏好設定頁面 |
聯絡人透過電子郵件訂閱偏好設定頁面更新了其偏好設定。 |
| ONE_CLICK_UNSUBSCRIBE |
一鍵取消訂閱 |
聯絡人使用了電子郵件標頭中的「一鍵取消訂閱」機制。 |
| 表單提交 |
表單提交 |
訂閱變更是由表單提交所引發的。 |
| CONTACT_RECORD |
聯絡人記錄 |
某位 HubSpot 使用者手動從 CRM 中的聯絡人記錄更新了訂閱狀態。 |
| 舊系統 |
舊系統 |
此更新來自舊版 HubSpot 系統。 |
| DATA_SYNC |
資料同步 |
此更新是透過資料同步整合功能(例如 Salesforce)套用的。 |
| 匯入 |
匯入 |
訂閱狀態是透過檔案匯入而變更的。 |
| HUBSPOT_MIGRATION |
由 HubSpot 發起的遷移 |
此更新是 HubSpot 發起的資料遷移的一部分。 |
| SPAM_REPORT |
垃圾郵件通報 |
該聯絡人將一封電子郵件標記為垃圾郵件,這觸發了自動取消訂閱。 |
| 對話 |
對話 |
此更新是透過 HubSpot 對話/收件匣動作執行的。 |
| 未識別 |
來源不支援 |
無法識別更新來源,或該來源類型不受支援。 |
重要注意事項
在建立包含通訊事件的報表前,請先檢視以下關鍵技術行為與結構差異:
- 不可變的歷史記錄:訂閱狀態或管道同意權限的每次變更,都會產生一個獨特且獨立的事件。HubSpot 絕不會更新或覆寫現有的事件。若聯絡人多次修改偏好設定,或透過不同的操作來源進行修改,每項獨立的操作都會產生專屬的事件記錄,從而保留完整的歷史稽核軌跡。
- 以聯絡人為中心的架構:這些追蹤事件以聯絡人為中心,並直接綁定至個別聯絡人記錄。
- 訂閱類型與管道:在設定自訂報告時,請注意這兩個主要屬性之間的區別:
- 訂閱類型(狀態事件):代表貴組織所發佈的特定內容類別(例如「行銷資訊」、「產品更新」)。
- 管道(同意事件):代表通訊媒介本身(例如:電子郵件、簡訊、WhatsApp)。