建立自訂事件

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

有不同的方式來建立自訂事件：

• 透過 API 傳送： 使用自訂事件定義端點建立您的事件。從那裡，使用您的事件 ID 與傳送自訂事件端點，將事件完成傳送至 HubSpot。
• 從您的網站擷取資料，無需 API：
  • 編碼 Javascript：使用 Custom Javascript，您可以使用代碼編輯器在 HubSpot 追蹤腳本中插入自訂代碼。
  • 使用事件可視化器（僅限Marketing Hub 企業版）：透過在您的網站上選擇頁面檢視或點擊元素來追蹤。了解更多關於使用事件可視化器建立自訂事件的資訊。
• 匯入試算表：上傳活動資料試算表以擷取離線活動、補充資料，或手動將任何工具與 HubSpot 整合。
• 設定 webhooks（僅限Operations Hub 專業版和企業版）： 自訂觸發啟動webhooks 的 條件以及將傳送的資料。

請注意：自訂事件工具取代先前的事件傳統工具。在舊有工具中建立的任何事件將繼續運作，您仍可在舊有工具中管理和分析這些事件。

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

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

透過 API 建立事件

如果您要透過 API 將資料傳送至 HubSpot，您可以使用Send via API 選項 或使用 Custom event definition endpoint 來建立您的事件。在HubSpot 的開發人員文件中了解更多關於定義 API 調用的資訊。

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

• 事件名稱：事件的內部名稱。
• Property names（屬性名稱）：您要傳送資料的屬性內部名稱。

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

• 選擇「傳送資料到 HubSpot 」並複製追蹤 ID。
• 按一下建立。

若要尋找現有事件的內部事件名稱和屬性名稱：

• 在你的 HubSpot 帳戶中，瀏覽「資料管理」>「自訂事件」。
• 按一下自訂事件。
• 按一下活動名稱。接著您就會進入活動詳細資訊頁面。
• 在頂端，找到「內部名稱」下的事件名稱。
  
  
  

• 若要尋找您要更新的內容的內部名稱，請按一下內容的名稱。
• 在右側面板中，按一下代碼圖示，然後檢視內部名稱下的名稱。

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

• 在你的 HubSpot 帳戶中，瀏覽「資料管理」>「自訂事件」。
• 在右上方，按一下建立事件。
• 選擇代碼 Javascript。

• 輸入活動名稱，並可選擇提供活動描述。
• 選擇關聯物件。這可讓您將活動完成度與 HubSpot 中的不同物件關聯，包括連絡人、公司、交易和票券。

• 按一下下一步。

新增屬性

建立事件時，預設事件屬性將會可用。您也可以建立自己的自訂屬性。事件屬性與其他 CRM 屬性分開儲存，並且是事件的唯一屬性（即您無法從帳戶設定中編輯這些屬性）。

• 若要關閉預設事件屬性的建立，請將Default event properties（預設事件屬性）切換為關閉。
• 若要建立自訂屬性，請按一下屬性的欄位類型，選擇屬性類型。選項包括
  • 自訂字串屬性：建立純文字字串的屬性。
  • 自訂數字屬性：建立一個數字值的屬性。
  • 自訂時間戳屬性：建立屬於日期值的屬性。您必須以年代毫秒或 ISO8601 的形式傳送資料。
  • 自訂枚數屬性：建立具有一組預定義值的屬性。
    
    
    
  • 選擇屬性後，在右側面板設定屬性：

• • 輸入性質名稱，並輸入性質說明。
  • 針對枚举屬性，按一下下一步，然後輸入您的屬性標籤和值。
    • 枚舉屬性可以是單選或多選。若要啟用多選值，請開啟支援多選值切換。

• • • 在傳送資料之前，您必須先設定數值和標籤。如果在傳送不在清單中的資料前沒有完成這個步驟，該資料將無法使用。若要透過 API 傳送多個值，請用分號分隔它們。

• • 按一下完成。
• 按一下下一步。
• 設定事件及其屬性後，您可以選擇 Javascript 程式碼片段，將此事件加入網站的追蹤程式碼。

使用 Javascript 程式碼片段建立事件可讓您自動將 Javascript 加入 HubSpot 追蹤程式碼。這可用於擷取更複雜的事件資料，而追蹤代碼預設是不會擷取這些資料的。

• 選擇Javascript 程式碼片段。使用右側面板中的程式碼片段在 HubSpot 中追蹤事件。任何建立的自訂屬性都會在程式碼片段中預先定義。
• 在右側面板輸入文字，根據需要修改片段。您新增的任何程式碼都會自動包含在 HubSpot 追蹤程式碼中。
• 完成後，按一下建立 即可完成事件並自動開始追蹤。
  
  

匯入事件資料

上傳來自個人活動的出席資料、來自未與 HubSpot 整合的應用程式的時間戳資料、來自供應商的一次性潛在客戶或活動資料，或任何其他試算表形式的活動資料。活動可讓您捕捉行為，然後在 HubSpot 中使用這些行為。

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

範例檔案

若要匯入自訂事件：

• 在你的 HubSpot 帳戶中，瀏覽「資料管理」>「自訂事件」。

• 在右上方，按一下建立事件。
• 選取匯入試算表。

• 輸入活動名稱，並可選擇提供活動描述。
• 選擇關聯物件。目前，透過匯入建立的事件只能與連絡人相關聯。

• 上傳檔案。選取匯入物件的方式和檔案語言，然後按一下下一步。

• 將列對應到事件和連絡人內容，然後按一下下一步。

• 確認匯入檔案的名稱。
• 點選核取方塊，同意聯絡人期望收到您的回覆，以及您的匯入檔案不包含已購買的清單。進一步瞭解HubSpot 的可接受使用政策。
• 選擇Occurred at（發生於）屬性的日期格式。
• 按一下完成匯入。

透過 API 建立事件

• 在你的 HubSpot 帳戶中，瀏覽「資料管理」>「自訂事件」。
• 在右上方，按一下建立事件。
• 選擇透過 API 傳送。

• 輸入活動名稱，並選擇提供活動描述。按一下下一步。
• 使用下列步驟新增屬性。確保建立自訂事件屬性，以代表您的匹配 ID。按一下下一步。
• 連結物件：
  • 按一下選擇主要物件下拉式功能表，然後選擇關聯物件。這可讓您將事件完成與不同的物件連結，包括連絡人、公司、交易和門票。
  • 按一下自訂匹配，並選擇您的事件和物件記錄之間的匹配 ID。只有當兩者的匹配 ID 相同時，事件才會連結至物件記錄。如果您使用自訂匹配 ID，您選擇的物件屬性必須要求唯一值。
• 按一下下一步。

設定 webhooks

設定觸發 webhook 的條件。

• 在你的 HubSpot 帳戶中，瀏覽「資料管理」>「自訂事件」。
• 在右上方，按一下建立事件。
• 選取設定 webhooks。
• 輸入事件名稱，並選擇關聯物件。

• 按一下下一步。
• 設定測試事件：
  • 複製Webhook URL。
  • 導覽到您要整合的第三方應用程式中的Webhook 設定頁面。
  • 貼入複製的 URL。
  • 按一下傳送測試事件。
• 按一下下一步。
• 檢視 webhook 的屬性。按一下Property type（屬性類型） 下拉式功能表，以選擇屬性類型 。

• 按一下下一步。
• 從第三方 webhook 中選擇與 HubSpot 物件屬性完全匹配的屬性。

使用自訂事件資料

自訂活動資料可以在 HubSpot 的工具中檢視和使用。以下是檢視活動完成度的位置，以及將資料納入其他工具的方法。

您可以使用事件清單中的動作下拉式選單、單一事件檢視或分析索引標籤中圖表的右上角，直接在選定的 HubSpot 工具中開啟您選取的事件。

報告自訂事件

自訂事件完成度可從自訂事件工具進行分析，事件資料也將可在自訂報告建立工具和歸屬報告中使用。

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

在聯絡人時間軸上檢視事件完成情形

事件完成將顯示在連絡人記錄時間軸上，以及任何已填入的屬性。

要檢視聯絡時間線上的活動詳細資訊：

• 導覽到已完成自訂事件的聯絡人記錄。
• 若要依已完成的事件篩選聯絡人時間軸，請按一下篩選活動，然後選擇自訂事件。
• 在聯絡人時間軸中，按一下以展開事件，以顯示事件詳細資訊。

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

在工作流程中，您可以使用「延遲直到事件發生」 動作或事件註冊觸發器，根據自訂事件的完成時間進行延遲。

• 在你的 HubSpot 帳戶中，瀏覽「自動化」>「工作流程」。
• 按一下工作流程的名稱。或學習如何建立新的工作流程。
• 若要新增觸發器：
  • 在工作流程編輯器中，按一下設定觸發器。
  • 在左側面板中，選擇事件發生時。設定觸發器，然後按一下套用篩選器。
  • 若要進一步精細觸發器，請按一下新增精細篩選器。您可以選擇其他屬性，以精簡要加入工作流程的物件。
  • 根據預設，記錄只有在第一次符合註冊觸發器時才會註冊到工作流程中。若要啟用重新註冊，請在[object] should bere-enrolledin this workflow? （應否 將 [object] 重新註冊到此工作流程中）一節中，選擇Yes（是），每次觸發時都重新註冊。
• 要增加延遲：
  • 在工作流程編輯器中，按一下+ 加號圖示來新增工作流程動作。
  • 在右側面板中，選擇延遲直到事件發生。
  • 設定延遲：
    • 按一下事件下拉式功能表，然後選擇自訂事件。
    • 然後選擇要延遲的事件屬性。
    • 選取事件屬性的篩選器。
    • 按一下套用篩選器。
  • • 選取最長等待時間，或選取盡可能延遲 核取方塊。
• 按一下儲存。

請注意：所有事件註冊觸發器將使用 OR 運算符號分開。這表示只有一個事件註冊觸發器必須發生，記錄才能註冊到工作流程中。

然後，工作流程會延遲註冊記錄，直到它們符合指定的自訂事件條件，或在事件發生時觸發。