如何建立自訂活動

摘要

在 HubSpot 中使用自訂事件，可定義並追蹤您企業獨有的事件。自訂事件可與事件屬性綁定，您隨後可在 HubSpot 的各項工具中運用這些屬性。例如，您可能希望追蹤線下活動，例如參加實體產品發表會的出席情況。

瞭解建立自訂事件的三種不同方法。您可以透過 API 發送自訂事件、上傳活動資料的試算表，或使用 Webhooks（僅限Data HubProfessional 和 Enterprise版本）。

設定自訂事件後，您可在不同工具中檢視相關數據。您可以建立包含自訂事件數據的報表、在聯絡人的時間軸上檢視自訂事件發生紀錄，並在工作流程中使用自訂事件。

最後，請在自訂事件管理工具中追蹤自訂事件的表現。您可能還需要在自訂事件管理工具中解決未知屬性錯誤。

建立自訂事件有哪些不同的方法？

事件建立流程包含兩個部分：

• 在 HubSpot 中定義該事件，包括任何自訂事件屬性。
• 建立 JavaScript 程式碼片段，或定義 將觸發該事件的 API 呼叫 。

建立自訂事件有以下幾種方式： 

• 透過 API 傳送：使用「自訂事件定義」端點建立您的事件。接著，使用您的事件 ID 搭配「傳送自訂事件」端點，將事件發生記錄傳送至 HubSpot。
• 不使用 API 從您的網站擷取資料：
  • 編寫 JavaScript：透過自訂 JavaScript，您可以使用程式碼編輯器將自訂程式碼插入 HubSpot 追蹤腳本中。
  • 使用事件視覺化工具：透過在網站上選取目標項目，追蹤頁面瀏覽量或點擊元素。進一步了解如何使用事件視覺化工具建立自訂事件。
• 匯入試算表：上傳包含事件資料的試算表，以擷取離線活動、補入資料，或手動將任何工具與 HubSpot 整合。
• 設定 Webhooks(資料中心 僅限Professional和Enterprise版本）：自訂觸發 webhook 的條件以及將傳送的資料。 

請注意：在舊版「自訂事件」工具中建立的任何事件，將於 2025 年 8 月 1 日後停止運作。

如何透過 API 建立自訂事件？

若您是透過 API 將資料傳送至 HubSpot，可使用「透過 API 傳送」選項 ，或使用 自訂事件定義端點來建立事件 。請參閱HubSpot 開發者文件，進一步了解如何定義您的 API 呼叫。

您需要為 API 呼叫準備幾項資訊，這些資訊可從 HubSpot 內部取得：

• 事件名稱：該事件的內部名稱。 
• 屬性名稱：您將傳送資料至的屬性之內部名稱。

完成事件建立並透過 API 傳送資料的步驟：

• 選擇「將資料傳送至 HubSpot」，並 複製追蹤 ID。
• 點擊「建立」。

若要查詢現有事件的內部事件名稱及屬性名稱：

1. 在您的 HubSpot 帳戶中，前往「資料管理」>「事件管理」。
2. 點擊事件名稱。您將被導向至事件詳細資訊頁面。
3. 在頁面上方，於「內部名稱」欄位下找到事件名稱。若要複製內部名稱，請點擊名稱旁的複製圖示。 
   
   
4. 若要查找您將要更新的屬性的內部名稱，請點擊某個屬性的名稱。
5. 在右側面板中，點擊程式碼圖示，然後查看「內部名稱」下的名稱。

如何使用 JavaScript 程式碼建立自訂事件？

1. 在您的 HubSpot 帳戶中，前往「資料管理」>「事件管理」。
2. 在右上角，點擊「建立事件」，然後選擇「建立自訂事件」。
3. 選擇「JavaScript 程式碼」。

4. 輸入「事件名稱」，並可選擇填寫事件說明。
5. 選擇「關聯物件」。此功能可讓您將事件發生記錄與 HubSpot 中的不同物件（包括聯絡人、公司、商機和 服務單）建立關聯。 

6. 點擊「下一步」。

如何向事件新增屬性？

建立事件時，將提供預設的事件屬性。您也可以建立自己的自訂屬性。事件屬性與其他 CRM 屬性分開儲存，且專屬於該事件（即您無法從帳戶設定中編輯這些屬性）。 

1. 若要停用預設事件屬性的建立，請將「預設事件屬性」切換為關閉。
2. 若要建立自訂屬性，請點擊屬性的「欄位類型」以選擇屬性類型。選項包括： 
   • 自訂字串屬性：建立一個純文字字串的屬性。 
   • 自訂數字屬性：建立一個數值屬性。
   • 自訂時間戳記屬性：建立一個日期值的屬性。您必須以紀元毫秒或 ISO8601 格式傳送資料。
   • 自訂日期屬性：建立一個日期值的屬性。
   • 自訂布林屬性：建立一個布林值的屬性。 
   • 自訂枚舉屬性：建立一個包含一組預定義值的屬性。
3. 選取屬性後，請在右側面板中設定該屬性：

8. 為屬性輸入名稱，並輸入屬性說明。
   • 對於枚舉型屬性，請點擊「下一步」，並輸入屬性的「標籤」與「值」。
     • 枚舉屬性可設定為單選或多選。若要啟用多選功能，請將「支援多值」開關切換為開啟狀態。

• • • 您必須在傳送資料前先設定相關值與標籤。若在傳送未列於清單中的資料前未完成此步驟，該資料將無法使用。若要透過 API 傳送多個值，請以分號分隔。

9. 點擊「下一步」。
10. 設定完事件及其屬性後，您可以透過選取「JavaScript 程式碼片段」將此事件新增至網站的追蹤程式碼中。
11. 點擊「完成」。

透過 JavaScript 程式碼片段建立事件，可讓您自動將 JavaScript 加入 HubSpot 追蹤程式碼中。此功能可用於擷取追蹤程式碼預設無法擷取的較複雜事件資料。 

1. 選擇「JavaScript 程式碼片段」。使用右側面板中的程式碼片段，即可在 HubSpot 中追蹤該事件。任何建立的自訂屬性都將預先定義在程式碼片段中。 
2. 請在右側面板中輸入文字，依需求修改程式碼片段。您所新增的任何程式碼都會自動納入您的 HubSpot 追蹤程式碼中。
3. 完成後，請點擊「建立」以 完成事件設定並自動開始追蹤。
    
   

如何從試算表匯入自訂事件資料？

您可以上傳實體活動的出席資料、來自未與 HubSpot 整合之應用程式的帶時間戳記資料、來自供應商的單次潛在客戶或活動資料，或任何其他以試算表形式呈現的活動資料。透過活動功能，您可以擷取使用者行為，並將這些行為應用於整個 HubSpot 系統中。 

匯入功能可 建立及更新以下 記錄：

• 聯絡人

• 企業
• 交易
• 票券
• 服務
• 專案
• 預約
• 課程
• 列表 
• 訂單
• 自訂物件

所需屬性會因物件類型而異。

事件匯入功能僅適用於已發生的事件。 自訂事件匯入檔案必須包含以下內容：

• 聯絡電子郵件地址。
• 發生於時間戳記。進一步了解匯入檔案中日期屬性的格式設定。

範例檔案

要匯入自訂事件：

1. 在你的 HubSpot 帳戶中，瀏覽「資料管理」>「事件管理」。
2. 在右上角，點擊「建立活動」，然後選擇「建立自訂活動」。
3. 選擇「匯入試算表」。
4. 點擊「建立新活動」或「匯入至現有活動」。
   • 若選擇「匯入至現有活動」，請使用下拉式選單選擇現有活動，然後繼續執行上傳試算表的步驟。
   • 若您選擇「建立新活動」，請繼續執行以下步驟。
5. 輸入活動名稱，並可選擇填寫活動說明。
6. 選擇「關聯物件」。目前，透過匯入建立的活動僅能與聯絡人關聯。
7. 上傳您的試算表或直接從試算表貼上內容。選擇物件的匯入方式及檔案語言，然後按一下「下一步」。
8. 將欄位映射至活動和聯絡人屬性，然後按一下「下一步」。
9. 確認匯入檔案的名稱。
10. 勾選核取方塊，以同意聯絡人預期收到您的聯繫，且您的匯入檔案不包含購買的清單。進一步了解HubSpot 的可接受使用政策。
11. 選擇「發生時間」屬性的日期格式。
12. 點擊「完成匯入」。

如何透過 API 端點發送自訂事件？

1. 在您的 HubSpot 帳戶中，導航至「資料管理」>「活動管理」。
2. 在右上角，點擊「建立活動」，然後選擇「建立自訂活動」。
3. 選擇「透過 API 發送」。

4. 輸入「事件名稱」，並可選擇填寫事件說明。 

5. 若要新增自訂事件屬性：
   • 輸入屬性名稱。此名稱亦將作為內部名稱使用。
   • 點擊「欄位類型」下拉式選單，並選擇欄位類型。
   • 可選擇性地新增說明。
   • 若要新增更多自訂屬性，請點擊「+ 新增自訂屬性」。
   • 點擊「下一步」。

6. 若要連結物件：
   • 點擊「選擇主要物件」下拉式選單，然後選取相關聯的物件。這讓您可以將事件發生記錄與不同的物件建立關聯，包括聯絡人、公司、商機和服務單。
   • 點擊「自訂配對」，並在活動與物件記錄之間選擇您的配對 ID。只有當配對 ID 完全相同時，活動才會與該物件記錄建立連結。若您使用自訂配對 ID，所選的物件屬性必須要求值為唯一。
7. 點擊「下一步」。
8. 若要在 HubSpot 中追蹤該活動，請點擊追蹤 ID 旁的「複製」。
9. 點擊「建立活動」。

如何使用 webhook 建立自訂事件？

設定將觸發 webhook 的條件。

1. 在您的 HubSpot 帳戶中，前往「資料管理」>「事件管理」。
2. 在右上角，點擊「建立事件」，然後選擇「建立自訂事件」。
3. 選擇「設定 Webhook」。
4. 輸入「事件名稱」並選擇「關聯物件」。
5. 點擊「下一步」。
6. 設定測試事件：
   • 複製Webhook URL。 
   • 前往您要整合的第三方應用程式中的Webhook 設定頁面。
   • 貼上複製的網址。
   • 點擊「傳送測試事件」。
7. 點擊「下一步」。
8. 檢視您的 Webhook 屬性。點擊「屬性類型」下拉式選單以選擇屬性類型。 

9. 點擊「下一步」。
10. 從您的第三方 Webhook 中選取一個與 HubSpot 物件屬性完全相符的屬性。 

在 HubSpot 中，我可以在哪裡查看和使用自訂事件資料？

您可以在 HubSpot 的各項工具中檢視並使用自訂事件資料。以下將說明如何查看事件發生紀錄，以及如何將這些資料整合至其他工具中。

您可透過事件清單中的動作下拉選單、單一事件檢視，或「分析」分頁中圖表的右上角，直接在指定的 HubSpot 工具中開啟選定的事件。

如何使用自訂事件資料建立報表

您可透過「自訂事件」工具分析自訂事件發生情況，且事件資料亦會顯示於自訂報表建構器及歸因報表中。

進一步了解如何分析您的自訂事件。

如何在聯絡人時間軸上檢視事件發生紀錄？

事件發生記錄將顯示於聯絡人記錄的時間軸上，並附帶已填入的任何屬性。

要在聯絡人時間軸上查看事件詳細資訊：

1. 導航至發生了自訂事件的聯絡人記錄。
2. 若要根據事件發生情況篩選聯絡人時間軸，請點擊「篩選活動」，然後選擇「自訂事件」。
3. 在聯絡人時間軸中，點擊展開該事件以顯示事件詳細資訊。

請注意：您無法檢視透過 webhooks 建立的自訂事件之時間軸活動。

如何在工作流程中使用自訂事件？

在工作流程中，您可以使用 「延遲至事件發生」 動作 或事件加入觸發器，根據自訂事件的發生來設定延遲。

1. 在你的 HubSpot 帳戶中，瀏覽「自動化」>「工作流程」。
2. 點擊工作流程的名稱。或者，瞭解如何建立新的工作流程。
3. 要新增觸發器：
   • 在工作流程編輯器中，點擊「設定觸發器」。
   • 在左側面板中，選取「當事件發生時」。設定觸發器後，點擊「套用篩選條件」。
   • 若要進一步精確設定觸發器，請點擊「新增精確篩選條件」。您可以選取其他屬性，以精確指定要納入工作流程的物件。
   • 預設情況下，記錄僅會在首次滿足加入觸發條件時加入工作流程。若要啟用重新加入功能，請在「[物件] 應重新加入此工作流程嗎？」區段中，選取「是，每次觸發發生時重新加入」。
4. 若要新增延遲：
   • 在工作流程編輯器中，點擊+ 加號圖示以新增工作流程動作。
   • 在右側面板中，選擇「延遲至事件發生」。
   • 設定延遲：
     • 點擊「事件」下拉式選單，然後選取自訂事件。
     • 接著，選擇您要根據其觸發延遲的事件屬性。
     • 為該事件屬性選擇篩選條件。
     • 點擊「套用篩選條件」。
   • • 選擇最大等待時間，或勾選「盡可能延遲」核取方塊 。
5. 點擊「儲存」。

請注意：所有事件加入觸發器皆會使用「或」運算子進行區隔。這表示只需其中一個事件加入觸發器發生，該記錄就會加入工作流程。

工作流程將延遲已加入的記錄，直到它們符合指定的自訂事件條件，或在事件發生時觸發。

如何管理追蹤自訂事件的狀態並監控傳送錯誤？

為確保您的資料保持準確且整合功能運作如預期，您可以使用「事件管理」工具中的「監控」分頁。

如何在自訂事件管理工具中追蹤效能？

• 完成趨勢：在你的 HubSpot 帳戶中，瀏覽「資料管理」>「事件管理」。 點擊「監控」標籤頁，比較不同時間段的活動完成量。

• 疑難排解傳送錯誤：在你的 HubSpot 帳戶中，瀏覽「資料管理」>「事件管理」。 在「監控」標籤頁的左側邊欄中，選取「傳送錯誤」。此表格會標示同步失敗的事件，並提供失敗的具體原因（例如：資料類型不符或架構違規）。

如何在自訂事件管理工具中解決「未知屬性」錯誤？

若透過 API 傳送的資料涉及在 HubSpot 中從未定義的屬性，該錯誤將顯示於錯誤日誌中。您可以快速解決此問題：

1. 將游標懸停在「錯誤日誌」表格中的事件上。

2. 點擊「動作」，然後選擇「新增屬性至事件」。

3. 確認建議的欄位類型，以便 HubSpot 能立即開始接收該資料。