自訂事件可讓您定義和追蹤您的業務特有的事件。自訂事件可以與事件屬性相關聯，然後您可以在 HubSpot 的工具中使用這些屬性。
建立自訂事件有三種不同的方法：
- 透過 API 傳送：使用自訂事件定義端點來建立事件。從那裡，使用您的事件 ID 和傳送自訂事件端點將事件完成傳送到 HubSpot。
- 不使用 API 從您的網站擷取資料：
- Javascript 程式碼：使用自訂 Javascript，您可以使用程式碼編輯器將自訂程式碼插入 HubSpot 追蹤腳本中。
- 使用事件視覺化工具（僅限Marketing Hub Enterprise ）：透過在網站上選擇來追蹤頁面視圖或點擊的元素。了解有關使用事件視覺化工具建立自訂事件的更多資訊。
- 匯入電子表格：上傳事件資料電子表格以擷取離線活動、回填資料或手動將任何工具與 HubSpot 整合。
請注意：自訂事件工具取代了先前的事件遺留工具。在舊版工具中建立的任何事件都將繼續有效，您仍然可以在舊版工具中管理和分析這些事件。
事件創建過程涉及兩個部分：
透過API建立事件
如果您透過 API 將資料傳送至 HubSpot，則需要使用自訂事件定義端點來建立事件。然後，您需要定義 API 呼叫來觸發事件。了解如何在HubSpot 的開發人員文件中定義 API 呼叫。
您的 API 呼叫需要一些信息，您可以從 HubSpot 內部獲取這些信息：
- 事件名稱：事件的內部名稱。
- 屬性名稱：您將向其發送資料的屬性的內部名稱。
要完成建立事件以透過 API 發送資料：
- 選擇將資料傳送至 HubSpot並複製追蹤 ID 。
- 按一下“建立”。
若要尋找現有事件的內部事件名稱和屬性名稱：
- 按一下自訂事件。
- 按一下事件的名稱。然後您將被帶到活動詳細資訊頁面。
- 在頂部，找到內部名稱下的事件名稱。
- 若要尋找要更新的屬性的內部名稱，請按一下屬性的名稱。
- 在右側面板中，按一下程式碼圖標，然後在內部名稱下查看名稱。
請注意：
向您的活動發送資料時，適用以下限制：
- 屬性名稱限制為 50 個字元。
- URL 和引薦來源網址屬性最多可以接收 1024 個字符，而所有其他屬性最多可以接收 256 個字元。
- 每個事件完成最多可以包含 50 個屬性的資料。
- 屬性內部名稱必須以字母開頭，並且僅包含小寫字母 az、數字 0-9 和底線。小寫後具有相同內部名稱的屬性被視為重複，並且在完成後僅使用其中一個屬性。
如果發出 HTTP API 請求時超出這些限制，請求將會失敗。如果在發出 JS API 請求時超出這些限制，HubSpot 會將任何屬性名稱值截斷為允許的長度和/或每次事件完成時僅更新 50 個屬性。
使用 Javascript 程式碼片段建立事件
- 點選右上角的「建立活動」 。
- 選擇JavaScript 程式碼。
- 按一下“下一步” 。
- 輸入事件名稱並可選擇提供您的事件描述。
- 選擇一個關聯對象。這允許您將活動完成情況與 HubSpot 中的不同物件相關聯，包括聯絡人、公司、交易和門票。
新增屬性
建立事件後，預設事件屬性將可用。您也可以建立自己的自訂屬性。事件屬性與其他 CRM 屬性分開存儲，並且對於事件是唯一的（即您無法從帳戶設定中編輯這些屬性）。
若要為事件建立屬性：
- 透過點選屬性的欄位類型來選擇屬性類型。選項包括：
- 自訂字串屬性：建立純文字字串屬性。
- 自訂數字屬性：建立一個數字值的屬性。
- 自訂時間戳屬性：建立一個日期值屬性。您必須以紀元毫秒或 ISO8601 的形式傳送資料。
- 自訂枚舉屬性：使用一組預定義值建立屬性。
- 選擇屬性後，在右側面板中配置此屬性：
- 輸入屬性的名稱並輸入屬性的描述。
- 對於枚舉屬性，按一下下一步並輸入屬性標籤和值。您必須在向它們發送資料之前設定值和標籤。如果在傳送不在清單中的資料之前未完成此步驟，則該資料將無法使用。若要透過 API 傳送多個值，請用分號分隔它們。
請注意：無法匯入多選枚舉屬性。
- 按一下“下一步”。
- 設定事件及其屬性後，您可以透過選擇 Javascript 程式碼片段將此事件新增至您網站的追蹤程式碼。
使用 Javascript 程式碼片段建立事件可讓您自動將 Javascript 新增至 HubSpot 追蹤程式碼。這可用於擷取追蹤程式碼預設情況下不擷取的更複雜的事件資料。
- 選擇Javascript 程式碼片段。使用右側面板中的程式碼片段追蹤 HubSpot 中的事件。創建的任何自訂屬性都將在程式碼片段中預先定義。
- 透過在右側面板中輸入文字來根據需要修改片段。您新增的任何程式碼都將自動包含在您的 HubSpot 追蹤程式碼中。
- 完成後，按一下“建立”以完成活動並自動開始追蹤。
導入事件數據
上傳來自現場活動的出席數據、來自未與 HubSpot 整合的應用程式的時間戳數據、來自供應商的一次性潛在客戶或活動數據，或電子表格形式的任何其他活動數據。事件允許您捕獲行為，然後在 HubSpot 上使用該行為。
進口可以
建立並更新
聯繫記錄。
事件導入只能用於已經發生的事件。
自訂事件匯入文件中必須包含以下內容：
範例文件
導入自訂事件：
- 按一下“下一步” 。
- 輸入事件名稱並可選擇提供您的事件描述。
- 選擇一個關聯對象。目前，透過匯入建立的事件只能與聯絡人關聯。
- 將列對應到事件和聯絡人屬性，然後按一下「下一步」 。
- 確認導入文件的名稱。
- 點擊該複選框即表示同意聯絡人希望收到您的來信，並且您的匯入文件不包含購買的清單。了解更多有關HubSpot 可接受使用政策的資訊。
- 選擇發生於屬性的日期格式。
- 按一下完成導入。
使用自訂事件數據
可以透過 HubSpot 的工具檢視和使用自訂事件資料。下面，了解在哪裡查看事件完成情況以及如何將該資料合併到其他工具中。
您可以使用事件清單中的操作下拉清單、單一事件檢視或分析標籤中圖表的右上角直接在選定的 HubSpot 工具中開啟所選事件。
報告自訂事件
可以透過自訂事件工具分析自訂事件完成情況，且事件資料也將在自訂報告產生器和歸因報告中提供。
了解有關分析自訂事件的更多資訊。
在聯絡時間線上查看事件完成情況
事件完成情況以及已填寫的任何屬性將顯示在聯絡人記錄時間軸上。
若要查看聯絡時間線上的事件詳細資訊：
在工作流程中使用自訂事件
在工作流程中，您可以使用「延遲直到事件發生」操作或事件註冊觸發器，根據自訂事件完成情況進行延遲。
- 點選工作流程的名稱。或者，了解如何建立新的工作流程。
- 若要新增觸發器：
- 在工作流程編輯器中，按一下設定觸發器。
- 在左側面板中，選擇「事件發生時」 。設定觸發器，然後按一下「套用過濾器」 。
- 若要進一步細化觸發器，請按一下「新增細化濾鏡」 。您可以選擇其他屬性來細化要在工作流程中註冊的物件。
- 預設情況下，記錄僅在第一次滿足註冊觸發器時才會註冊到工作流程中。若要啟用重新註冊，請在「是否應該在此工作流程中重新註冊[物件]？」下。部分，選擇是，每次觸發發生時重新註冊。
- 新增延遲：
- 在工作流程編輯器中，按一下+ 加號圖示以新增工作流程操作。
- 在右側面板中，選擇「延遲直至事件發生」 。
- 配置延遲：
- 按一下事件下拉式選單，然後選擇自訂事件。
- 然後，選擇您想要延遲的事件屬性。
- 選擇事件屬性的篩選器。
- 點選應用過濾器。
- 按一下「儲存」 。
請注意：所有事件註冊觸發器將使用 OR 運算子分隔。這意味著只需發生其中一個事件註冊觸發器即可使記錄註冊到工作流程中。
然後，工作流程將延遲註冊記錄，直到它們滿足指定的自訂事件條件或在事件發生時觸發。