跳到內容
請注意：：這篇文章的翻譯只是為了方便而提供。譯文透過翻譯軟體自動建立，可能沒有經過校對。因此，這篇文章的英文版本應該是包含最新資訊的管理版本。你可以在這裡存取這些內容。

如何使用 HubSpot 的程式碼精靈建立自訂行為事件

上次更新時間： 2025年11月26日

可搭配下列任何訂閱使用，除非另有註明：

自訂事件讓您能定義並追蹤專屬您業務的獨特事件。自訂事件可與事件屬性綁定，您隨後便能在 HubSpot 的各項工具中使用這些屬性。 

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

  • 透過 API 發送：使用 自訂事件定義端點建立事件。接著透過發送自訂事件端點，使用事件 ID 將事件發生記錄傳送至 HubSpot。
  • 無需 API 即可擷取網站數據：
    • 編寫 JavaScript：透過自訂 JavaScript 功能，您可使用程式碼編輯器將自訂程式碼嵌入 HubSpot 追蹤腳本中。
    • 使用事件視覺化工具（僅限行銷中心企業版）：透過網站直接選取頁面檢視或點擊元素進行追蹤。深入了解如何運用事件視覺化工具建立自訂事件。
  • 匯入試算表：上傳事件資料試算表以擷取離線活動、補填歷史數據，或手動整合任何工具與 HubSpot。
  • 設定 webhook（僅限DataHub Professional與 Enterprise 方案）：自訂 觸發 webhook 的條件及傳送的資料內容。 

 

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

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

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

透過 API 建立事件

若您透過 API 將資料傳送至 HubSpot，可使用「透過 API 發送」選項 或使用 自訂事件定義端點 建立事件。請參閱HubSpot 開發人員文件，深入瞭解如何定義 API 呼叫。

API呼叫需準備以下資訊，可於HubSpot平台內取得：

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

完成事件建立以透過 API 傳送資料：

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

查詢現有事件的內部事件名稱與屬性名稱：

  1. 在您的 HubSpot 帳戶中，導覽至「資料管理」>「事件管理」。
  2. 點擊事件名稱，系統將導向事件詳細資訊頁面。
  3. 在頂部找到「內部名稱」欄位下的事件名稱。若要複製內部名稱，請點擊名稱旁的複製圖示。 

    custom-events-internal-ID-name
  4. 若需查找即將更新屬性的內部名稱，請點擊屬性名稱。
  5. 於右側面板點擊程式碼圖示，即可在「內部名稱」欄位查看對應名稱。
請注意：
向事件傳送資料時，適用以下限制：
  • 屬性名稱限制為 50 個字元。 
  • URL 和來源網址屬性最多可接收 1024 個字元，其餘所有屬性最多可接收 256 個字元。
  • 每次事件發生最多可包含50個屬性資料。
  • 屬性內部名稱必須以字母開頭，且僅可包含小寫字母 a-z、數字 0-9 及底線。若屬性內部名稱轉換為小寫後相同，則視為重複，發生後僅會採用其中一個屬性。
若HTTP API請求超出上述限制，該請求將失敗。若JS API請求超出限制，HubSpot將截斷任何屬性名稱值至允許長度，並/或每事件發生僅更新50個屬性。

使用 JavaScript 程式碼片段建立事件

  1. 在您的 HubSpot 帳戶中，導航至「資料管理」>「活動管理」。
  2. 在右上角點擊建立事件，然後選擇建立自訂事件。
  3. 選擇程式碼類型為 JavaScript。
custom-event-code-javascript
  1. 輸入事件名稱，並可選擇性提供事件描述。
  2. 選擇關聯物件。此功能可讓您將事件發生狀況與 HubSpot 中的不同物件關聯，包括聯絡人、公司、交易和 票證。 
custom-event-event-name
  1. 點擊「下一步」。

新增屬性

建立事件時，預設事件屬性將自動提供。您亦可建立自訂屬性。事件屬性與其他 CRM 屬性分開儲存，且專屬該事件（即無法透過帳戶設定編輯這些屬性）。 

  1. 若要關閉預設事件屬性的建立功能，請將「預設事件屬性」切換至關閉狀態。
  2. 若要建立自訂屬性，請點擊屬性欄位類型選擇屬性類型。選項包含： 
    • 自訂字串屬性：建立純文字字串屬性。 
    • 自訂數字屬性：建立數值型屬性。
    • 自訂時間戳記屬性：建立日期值屬性。資料必須以紀元毫秒或 ISO8601 格式傳送。
    • 自訂日期屬性：建立日期值屬性。
    • 自訂布林屬性：建立布林值屬性。 
    • 自訂枚舉屬性：建立具有預定義值集的屬性。
  3. 選取屬性後，請於右側面板進行設定：

custom-event-create-a-custom-property

  1. 輸入屬性名稱及屬性說明。
    • 若為枚舉屬性，請點擊「下一步」並輸入屬性標籤與 數值。
      • 枚舉屬性可設定為單選或多選。若需啟用多選功能，請開啟「支援多值」切換按鈕。
custom-event-enumeration-form
      • 在傳送資料至值與標籤前，您必須先設定這些值與標籤。若未完成此步驟便傳送清單中不存在的資料，該資料將無法使用。透過 API 傳送多個值時，請以分號分隔。
請注意：無法匯入多選枚舉型屬性。
  1. 點擊「下一步」。
  2. 設定完事件及其屬性後，可透過選擇「JavaScript 程式碼片段」將此事件新增至網站追蹤程式碼。
  3. 點擊完成。

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

  1. 選擇「JavaScript 程式碼片段」。使用右側面板中的片段在 HubSpot 中追蹤事件。任何自訂屬性皆會預先定義於程式碼片段中。 
  2. 若需修改片段，請於右側面板輸入文字。您新增的任何程式碼將自動納入HubSpot追蹤程式碼中。
  3. 完成後點擊建立 ，即可 完成事件設定並自動啟動追蹤。
     
    custom-event-javascript-code-snippet

匯入活動資料

上傳實體活動的出席資料、未與 HubSpot 整合應用程式的時間戳記資料、供應商提供的一次性潛在客戶或行銷活動資料，或其他任何以試算表形式呈現的活動資料。活動功能可協助您捕捉行為軌跡，並將這些行為數據應用於 HubSpot 各模組。 

匯入功能可 建立與更新 聯絡人記錄。 活動匯入僅適用於已發生的活動。 自訂活動匯入檔案必須包含以下內容：

same-custom-events-file

範例檔案

匯入自訂事件：

  1. 在您的 HubSpot 帳戶中，導航至「資料管理」>「事件管理」。
  2. 在右上角點擊「建立活動」，然後選擇「建立自訂活動」。
  3. 選擇「匯入試算表」。
  4. 輸入事件名稱，並可選擇性提供事件描述。
  5. 選擇關聯物件。目前透過匯入建立的事件僅能與聯絡人關聯。
  6. 上傳檔案。選擇物件匯入方式與檔案語言，然後點擊「下一步」。
  7. 將欄位對應至事件與聯絡人屬性，然後點擊「下一步」。
  8. 確認匯入檔案名稱。
  9. 勾選核取方塊以確認聯絡人預期收到您的訊息，且匯入檔案未包含購買名單。瞭解更多關於HubSpot 可接受使用政策。
  10. 選擇「發生時間」屬性的日期格式。
  11. 點擊完成匯入。

透過 API 建立事件

  1. 在您的 HubSpot 帳戶中，導覽至「資料管理」>「活動管理」。
  2. 於右上角點擊「建立活動」，接著選擇「建立自訂活動」。
  3. 選擇透過 API 傳送。
  1. 輸入事件名稱，並可選擇性提供事件描述。 
  1. 若要新增自訂事件屬性：
    • 輸入屬性名稱。此名稱亦將套用至內部名稱。
    • 點擊「欄位類型」下拉式選單，選擇欄位類型。
    • 可選擇性添加描述。
    • 若需新增更多自訂屬性，請點擊「+ 新增自訂屬性」。
    • 點擊「下一步」。
  1. 連結物件：
    • 點擊「選擇主要物件」下拉式選單，然後選取關聯物件。此功能可讓您將事件發生次數與不同物件關聯，包括聯絡人、公司、交易和票證。
    • 點擊「自訂比對規則」，並選擇事件與物件記錄間的比對識別碼。僅當比對識別碼完全一致時，事件才會與物件記錄建立關聯。若使用自訂比對識別碼，所選物件屬性必須要求唯一值。
  2. 點擊「下一步」。
  3. 若要在 HubSpot 中追蹤事件，請點擊追蹤 ID 旁的「複製」。
  4. 點擊建立事件。

請注意：

  • 您只能匹配相同資料類型的事件屬性與物件屬性。
  • 如有需要，您可於稍後編輯自訂匹配規則，但無法變更已選取的主要物件。

設定 webhook

設定觸發 webhook 的條件。

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

unique-property-webhook

使用自訂事件資料

自訂事件資料可在 HubSpot 各工具中檢視與運用。以下說明事件發生紀錄的檢視位置，以及將資料整合至其他工具的方法。

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

自訂事件報表

自訂事件發生狀況可透過自訂事件工具進行分析，相關事件數據亦會顯示於自訂報表建構器與歸因報表中。

深入瞭解自訂事件分析方法。

聯絡人時間軸上的事件發生記錄檢視

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

在聯絡人時間軸檢視事件詳情：

  1. 導覽至發生自訂事件的聯絡人記錄。
  2. 若要依事件發生次數篩選聯絡人時間軸，請點擊「篩選活動」，然後選擇「自訂事件」。
  3. 在聯絡人時間軸中，點擊展開事件以顯示事件詳情。

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

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

在工作流程中，可透過 延遲至事件發生 動作 或事件註冊觸發器來延遲執行。

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

請注意：所有事件註冊觸發器將透過 OR 運算子分離。這意味著僅需其中一個事件註冊觸發器發生，記錄即可註冊至工作流程。

工作流程將延遲已註冊記錄直至其滿足指定自訂事件條件，或於事件發生時觸發。
這篇文章有幫助嗎？
此表單僅供記載意見回饋。了解如何取得 HubSpot 的協助。
目錄

相關內容

New call-to-action