HubSpot個連線
HubSpot是CRM平台,包含您連線行銷、銷售、內容管理及客戶服務所需的所有軟體、整合及資源。 它可讓您在一個CRM平台上連線您的資料、團隊和客戶。
此Adobe Experience Platform 目的地利用HubSpot 連絡人API,在啟用後從現有的Experience Platform對象更新HubSpot內的連絡人。
向目的地驗證區段中進一步說明如何向您的HubSpot執行個體進行驗證。
使用案例 use-cases
為協助您更清楚瞭解您應如何及何時使用HubSpot目的地,以下是Adobe Experience Platform客戶可藉由使用此目的地解決的範例使用案例。
HubSpot個連絡人儲存與您業務互動之個人的相關資訊。 您的團隊使用HubSpot中存在的連絡人來建立Experience Platform對象。 將這些對象傳送至HubSpot後,其資訊會更新,並且會為每個連絡人指派屬性,其值做為對象名稱,指出該連絡人屬於哪個對象。
先決條件 prerequisites
請參閱以下各節,瞭解在Experience Platform和HubSpot中需要設定的任何先決條件,以及使用HubSpot目的地之前必須收集的資訊。
Experience Platform必要條件 prerequisites-in-experience-platform
在啟用資料至HubSpot目的地之前,您必須在Experience Platform中建立結構描述、資料集和對象。
如果您需要對象狀態的指引,請參閱對象成員資格詳細資料結構描述欄位群組的Experience Platform檔案。
HubSpot目的地的先決條件 prerequisites-destination
若要將資料從Platform匯出至您的HubSpot帳戶,請注意下列必要條件:
您必須擁有HubSpot帳戶 prerequisites-account
若要將資料從Platform匯出至您的Hubspot帳戶,您必須擁有HubSpot帳戶。 如果您還沒有帳戶,請造訪設定HubSpot帳戶頁面,並依照指引註冊及建立帳戶。
收集HubSpot私人應用程式存取權杖 gather-credentials
您需要您的HubSpot Access token
允許HubSpot目的地透過HubSpot帳戶內的HubSpot私人應用程式進行API呼叫。 當您驗證目的地時,Access token
將用作Bearer token
。
如果您沒有私人應用程式,請依照檔案操作,在 HubSpot🔗中建立私人應用程式。
crm.objects.contacts.write
,crm.objects.contacts.read
crm.schemas.contacts.write
,crm.schemas.contacts.read
Bearer token
pat-na1-11223344-abcde-12345-9876-1234a1b23456
護欄 guardrails
HubSpot個私人應用程式受限於速率限制。 您的私人應用程式可撥打的次數取決於您的HubSpot帳戶訂閱,以及您是否購買了API附加元件。 另外也請參閱其他限制。
支援的身分 supported-identities
HubSpot支援下表中描述的身分更新。 深入瞭解身分。
email
test@test.com
支援的對象 supported-audiences
本節說明您可以匯出至此目的地的所有對象。
此目的地支援啟動所有透過Experience Platform細分服務產生的對象。
此目的地也支援下表所述的對象啟用。
匯出型別和頻率 export-type-frequency
請參閱下表以取得目的地匯出型別和頻率的資訊。
- 您正在匯出對象的所有成員,以及所需的結構描述欄位 (例如:電子郵件地址、電話號碼、姓氏) (根據您的欄位對應)。
- 此外,在HubSpot中會使用對象名稱建立新屬性,而且其值會與每個所選對象來自Platform的對應對象狀態一致。
連線到目標 connect
若要連線到此目的地,請依照目的地組態教學課程中所述的步驟進行。 在設定目標工作流程中,填寫以下兩個區段中列出的欄位。
在 目的地 > 目錄 內,搜尋HubSpot。 或者,您可以在 CRM 類別下找到它。
驗證目標 authenticate
填寫以下必填欄位。 如需任何指引,請參閱收集 HubSpot 私人應用程式存取權杖區段。
- 持有人權杖:您HubSpot私人應用程式的存取權杖。
若要驗證到目的地,請選取 連線到目的地。
如果提供的詳細資料有效,UI會顯示帶有綠色勾號的 已連線 狀態。 然後您可以繼續下一步驟。
填寫目標詳細資訊 destination-details
若要設定目的地的詳細資訊,請填寫下方的必填和選用欄位。 UI中欄位旁的星號表示該欄位為必填欄位。
- 名稱:您日後可辨識此目的地的名稱。
- 描述:可協助您日後識別此目的地的描述。
啟用警示 enable-alerts
您可以啟用警報以接收有關傳送到您目的地的資料流狀態的通知。 從清單中選取警報以訂閱接收有關資料流狀態的通知。 如需警示的詳細資訊,請參閱使用UI訂閱目的地警示的指南。
當您完成提供目的地連線的詳細資訊後,請選取 下一步。
啟動此目標的對象 activate
閱讀將設定檔和對象啟用至串流對象匯出目的地,以瞭解啟用此目的地對象的指示。
對應屬性和身分 map
若要將對象資料從Adobe Experience Platform正確傳送至HubSpot目的地,您必須完成欄位對應步驟。 對應包括在Platform帳戶中的Experience Data Model (XDM)結構描述欄位與來自目標目的地的對應對應專案之間建立連結。
若要將您的XDM欄位正確對應到HubSpot目的地欄位,請遵循下列步驟:
對應Email
身分
Email
識別是這個目的地的必要對應。 請依照下列步驟進行對應:
- 在 對應 步驟中,選取 新增對應。 您現在可以在畫面上看到新的對應列。
- 在 選取來源欄位 視窗中,選擇 選取身分名稱空間 並選取身分。
- 在 選取目標欄位 視窗中,選擇 選取屬性 並選取
email
。
IdentityMap: Email
Identity: email
具有身分對應的範例如下所示:
對應 選用的 屬性
若要在XDM設定檔結構描述與HubSpot帳戶之間新增任何其他要更新的屬性,請重複下列步驟:
- 在 對應 步驟中,選取 新增對應。 您現在可以在畫面上看到新的對應列。
- 在 選取來源欄位 視窗中,選擇 選取屬性 類別並選取XDM屬性。
- 在 選取目標欄位 視窗中,選擇 選取屬性 類別,並從自動從您的HubSpot帳戶填入的屬性清單中選取。 目的地使用HubSpot 屬性 API來擷取此資訊。 已擷取HubSpot 預設屬性及任何自訂屬性,以選取為目標欄位。
以下是您的XDM設定檔結構描述與Hubspot之間的一些可用對應:
xdm: person.name.firstName
Attribute: firstname
xdm: person.name.lastName
Attribute: lastname
xdm: workAddress.street1
Attribute: address
xdm: workAddress.city
Attribute: city
xdm: workAddress.country
Attribute: country
以下顯示使用這些屬性對應的範例:
當您完成提供目的地連線的對應時,請選取 下一步。
驗證資料匯出 exported-data
若要驗證您是否已正確設定目的地,請遵循下列步驟:
-
登入HubSpot網站,然後導覽至 連絡人 頁面以檢查對象狀態。 此清單可設定為顯示以對象名稱建立之自訂屬性的欄,其值為對象狀態。
-
或者,您可以向下鑽研至個別 人員 頁面,並導覽至顯示對象名稱和對象狀態的屬性。
資料使用與控管 data-usage-governance
處理您的資料時,所有Adobe Experience Platform目的地都符合資料使用原則。 如需Adobe Experience Platform如何強制資料控管的詳細資訊,請參閱資料控管概觀。
其他資源 additional-resources
HubSpot檔案中的其他實用資訊如下:
Changelog
本節擷取此目的地聯結器的功能和重要檔案更新。
table 0-row-3 1-row-3 layout-auto | ||
---|---|---|
發行月份 | 更新型別 | 說明 |
2023 年 9 月 | 首次發行 | 初始目的地版本和檔案發佈。 |