知識庫

建立自訂事件

作者：HubSpot Support | Dec 14, 2022 4:05:18 PM

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

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

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

 

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

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

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

透過 API 建立事件

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

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

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

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

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

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

  1. 按一下活動名稱。接著您會進入活動詳細資訊頁面。
  2. 在頂端，找到內部名稱下的活動名稱。若要複製內部名稱，請按一下名稱旁的複製圖示。

  3. 若要尋找您要更新的內容的內部名稱，請按一下內容的名稱。
  4. 在右側面板中，按一下代碼圖示，然後檢視內部名稱下的名稱。
請注意：
傳送資料至您的活動時，適用下列限制：
  • 屬性名稱限制為 50 個字元。
  • URL 和 Referrer 屬性最多可接收 1024 個字元，而所有其他屬性最多可接收 256 個字元。
  • 每個事件完成最多可包含 50 個屬性的資料。
  • 屬性內部名稱必須以字母開頭，且只包含小寫字母 a-z、數字 0-9 和底線。內部名稱小寫後相同的屬性會被視為重複，完成時只會使用其中一個屬性。
如果在進行 HTTP API 請求時超出這些限制，請求將會失敗。如果在進行 JS API 請求時超出這些限制，HubSpot 會將任何屬性名稱的值截斷至允許的長度，和/或每個事件完成時僅更新 50 個屬性。

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

  1. 在右上方，按一下建立事件。
  2. 選取程式碼 Javascript。
  1. 輸入事件名稱，並選擇提供事件描述。
  2. 選擇關聯物件。這可讓您將事件完成與 HubSpot 中的不同物件關聯，包括聯絡人、公司、交易和票券。

  1. 按一下下一步。

新增屬性

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

  1. 在右上方，按一下建立事件。
  2. 選擇代碼 Javascript。
  3. 輸入事件名稱，並可選擇提供事件描述。
  4. 若要關閉預設事件屬性的建立，請將預設事件屬性切換為關閉。
  5. 若要建立自訂屬性，請按一下屬性的欄位類型，選擇屬性類型。選項包括
    • 自訂字串屬性：建立純文字字串的屬性。
    • 自訂數字屬性：建立一個數字值的屬性。
    • 自訂時間戳屬性：建立屬於日期值的屬性。您必須以年代毫秒或 ISO8601 的形式傳送資料。
    • 自訂日期屬性：建立日期值的屬性。
    • 自訂布林屬性：建立一個布林值的屬性。
    • 自訂枚數屬性：建立具有一組預定義值的屬性。
  6. 選取屬性後，在右側面板設定屬性：

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

      • 在傳送資料之前，您必須先設定數值和標籤。如果在傳送不在清單中的資料前沒有完成這個步驟，該資料將無法使用。若要透過 API 傳送多個值，請用分號分隔它們。
請注意： 無法匯入多重選擇枚舉屬性。
  1. 按一下下一步。
  2. 設定事件及其屬性後，您可以選擇 Javascript 代碼片段，將此事件新增至網站追蹤代碼。
  3. 按一下完成。

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

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

匯入事件資料

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

進口可以 建立與更新 聯絡記錄。 事件匯入只能用於已發生的事件。 自訂事件匯入檔案必須包含下列內容：

範例檔案

若要匯入自訂事件：

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

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

  1. 上傳檔案。選擇匯入物件的方式和檔案語言，然後按一下下一步。
  2. 將列對應到事件和聯絡人內容，然後按一下下一步。
  3. 確認匯入檔案的名稱。
  4. 按一下核取方塊，同意聯絡人期望收到您的訊息，以及您的匯入檔案不包含已購買的清單。進一步了解HubSpot 的可接受使用政策。
  5. 選擇Occurred at 屬性的日期格式。
  6. 按一下完成匯入。

透過 API 建立事件

  1. 在右上方，按一下建立事件。
  2. 選取透過 API 傳送。
  1. 輸入活動名稱，並可選擇提供活動描述。
  1. 若要新增自訂事件屬性：
    • 輸入屬性名稱。此名稱也將應用於內部名稱 。
    • 按一下欄位類型下拉式功能表，並選擇欄位類型。
    • 可選擇新增說明。
    • 如果要新增更多自訂屬性，請按一下+ 新增自訂屬性。
    • 按一下下一步。
  1. 連結物件：
    • 按一下選擇主要物件下拉式功能表，然後選擇關聯物件。這可讓您將事件完成與不同的物件連結，包括連絡人、公司、交易和門票。
    • 按一下自訂匹配，並選擇您的事件和物件記錄之間的匹配 ID。只有當兩者的匹配 ID 相同時，事件才會連結至物件記錄。如果您使用自訂匹配 ID，您選擇的物件屬性必須要求唯一值。
  2. 按一下下一步。
  3. 若要在 HubSpot 中追蹤事件，請按追蹤 ID 旁的「複製」。
  4. 按一下建立事件。

請注意：

  • 您只能匹配相同資料類型的事件屬性和物件屬性。
  • 如果需要，您可以稍後編輯自訂的匹配，但不能變更選取的主要物件。

設定 webhooks

設定觸發 webhook 的條件。

  1. 在右上方，按一下建立事件。
  2. 選擇設定 webhooks。
  3. 輸入事件名稱，並選取關聯物件。

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

使用自訂事件資料

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

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

報告自訂事件

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

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

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

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

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

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

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

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

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

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

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