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🔗中建立私人應用程式。

IMPORTANT
私人應用程式應獲指派以下範圍:
crm.objects.contacts.writecrm.objects.contacts.read
crm.schemas.contacts.writecrm.schemas.contacts.read
認證
說明
範例
Bearer token
HubSpot私人應用程式的Access token
若要取得您的HubSpot Access token,請依照HubSpot檔案操作,以使用您應用程式的存取權杖進行API呼叫
pat-na1-11223344-abcde-12345-9876-1234a1b23456

護欄 guardrails

HubSpot個私人應用程式受限於速率限制。 您的私人應用程式可撥打的次數取決於您的HubSpot帳戶訂閱,以及您是否購買了API附加元件。 另外也請參閱其他限制

支援的身分 supported-identities

HubSpot支援下表中描述的身分更新。 深入瞭解身分

目標身分
範例
說明
考量事項
email
test@test.com
連絡人的電子郵件地址。
強制

支援的對象 supported-audiences

本節說明您可以匯出至此目的地的所有對象。

此目的地支援啟動所有透過Experience Platform細分服務產生的對象。

此目的地也支援下表所述的對象啟用。

客群類型
說明
自訂上傳
對象從CSV檔案匯入至Experience Platform。

匯出型別和頻率 export-type-frequency

請參閱下表以取得目的地匯出型別和頻率的資訊。

項目
類型
附註
匯出類型
以設定檔為基礎
  • 您正在匯出對象的所有成員,以及所需的結構描述欄位​ (例如:電子郵件地址、電話號碼、姓氏) (根據您的欄位對應)。
  • 此外,在HubSpot中會使用對象名稱建立新屬性,而且其值會與每個所選對象來自Platform的對應對象狀態一致。
匯出頻率
串流
  • 串流目的地是「一律開啟」的API型連線。 一旦根據對象評估在Experience Platform中更新了設定檔,聯結器就會將更新傳送至下游的目的地平台。 深入瞭解串流目的地

連線到目標 connect

IMPORTANT
若要連線到目的地,您需要​ 檢視目的地 ​和​ 管理目的地 存取控制許可權。 閱讀存取控制總覽或連絡您的產品管理員以取得必要的許可權。

若要連線到此目的地,請依照目的地組態教學課程中所述的步驟進行。 在設定目標工作流程中,填寫以下兩個區段中列出的欄位。

在​ 目的地 > 目錄 ​內,搜尋HubSpot。 或者,您可以在​ CRM ​類別下找到它。

驗證目標 authenticate

填寫以下必填欄位。 如需任何指引,請參閱收集 HubSpot 私人應用程式存取權杖區段。

  • 持有人權杖:您HubSpot私人應用程式的存取權杖。

若要驗證到目的地,請選取​ 連線到目的地
平台UI熒幕擷圖顯示如何驗證。

如果提供的詳細資料有效,UI會顯示帶有綠色勾號的​ 已連線 ​狀態。 然後您可以繼續下一步驟。

填寫目標詳細資訊 destination-details

若要設定目的地的詳細資訊,請填寫下方的必填和選用欄位。 UI中欄位旁的星號表示該欄位為必填欄位。
顯示目的地詳細資訊的平台UI熒幕擷取畫面。

  • 名稱:您日後可辨識此目的地的名稱。
  • 描述:可協助您日後識別此目的地的描述。

啟用警示 enable-alerts

您可以啟用警報以接收有關傳送到您目的地的資料流狀態的通知。 從清單中選取警報以訂閱接收有關資料流狀態的通知。 如需警示的詳細資訊,請參閱使用UI訂閱目的地警示的指南。

當您完成提供目的地連線的詳細資訊後,請選取​ 下一步

啟動此目標的對象 activate

IMPORTANT
若要啟用資料,您需要​ 檢視目的地啟用目的地檢視設定檔 ​和​ 檢視區段 存取控制許可權。 閱讀存取控制總覽或連絡您的產品管理員以取得必要的許可權。

閱讀將設定檔和對象啟用至串流對象匯出目的地,以瞭解啟用此目的地對象的指示。

對應屬性和身分 map

若要將對象資料從Adobe Experience Platform正確傳送至HubSpot目的地,您必須完成欄位對應步驟。 對應包括在Platform帳戶中的Experience Data Model (XDM)結構描述欄位與來自目標目的地的對應對應專案之間建立連結。

若要將您的XDM欄位正確對應到HubSpot目的地欄位,請遵循下列步驟:

對應Email身分

Email識別是這個目的地的必要對應。 請依照下列步驟進行對應:

  1. 在​ 對應 ​步驟中,選取​ 新增對應。 您現在可以在畫面上看到新的對應列。
    Platform UI熒幕擷取畫面,其中反白顯示新增對應按鈕。
  2. 在​ 選取來源欄位 ​視窗中,選擇​ 選取身分名稱空間 ​並選取身分。
    平台UI熒幕擷圖選取電子郵件作為來源屬性,以對應為身分。
  3. 在​ 選取目標欄位 ​視窗中,選擇​ 選取屬性 ​並選取email
    Platform UI熒幕擷圖選取電子郵件作為目標屬性,以對應為身分。
來源欄位
目標欄位
強制
IdentityMap: Email
Identity: email

具有身分對應的範例如下所示:
具有電子郵件身分對應的平台UI熒幕擷圖範例。

對應​ 選用的 ​屬性

若要在XDM設定檔結構描述與HubSpot帳戶之間新增任何其他要更新的屬性,請重複下列步驟:

  1. 在​ 對應 ​步驟中,選取​ 新增對應。 您現在可以在畫面上看到新的對應列。
    Platform UI熒幕擷取畫面,其中反白顯示新增對應按鈕。
  2. 在​ 選取來源欄位 ​視窗中,選擇​ 選取屬性 ​類別並選取XDM屬性。
    Platform UI熒幕擷圖選取名字作為來源屬性。
  3. 在​ 選取目標欄位 ​視窗中,選擇​ 選取屬性 ​類別,並從自動從您的HubSpot帳戶填入的屬性清單中選取。 目的地使用HubSpot 屬性 API來擷取此資訊。 已擷取HubSpot 預設屬性及任何自訂屬性,以選取為目標欄位。
    Platform UI熒幕擷圖選取名字作為目標屬性。

以下是您的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

以下顯示使用這些屬性對應的範例:
具有屬性對應的平台UI熒幕擷圖範例。

當您完成提供目的地連線的對應時,請選取​ 下一步

驗證資料匯出 exported-data

若要驗證您是否已正確設定目的地,請遵循下列步驟:

  1. 登入HubSpot網站,然後導覽至​ 連絡人 ​頁面以檢查對象狀態。 此清單可設定為顯示以對象名稱建立之自訂屬性的欄,其值為對象狀態。
    HubSpot UI熒幕擷圖顯示「連絡人」頁面,該頁面具有顯示對象名稱和儲存格對象狀態的欄標題

  2. 或者,您可以向下鑽研至個別​ 人員 ​頁面,並導覽至顯示對象名稱和對象狀態的屬性。
    HubSpot UI熒幕擷圖顯示「連絡人」頁面,該頁面具有顯示對象名稱和對象狀態的自訂屬性。

資料使用與控管 data-usage-governance

處理您的資料時,所有Adobe Experience Platform目的地都符合資料使用原則。 如需Adobe Experience Platform如何強制資料控管的詳細資訊,請參閱資料控管概觀

其他資源 additional-resources

HubSpot檔案中的其他實用資訊如下:

Changelog

本節擷取此目的地聯結器的功能和重要檔案更新。

檢視變更記錄檔
table 0-row-3 1-row-3 layout-auto
發行月份 更新型別 說明
2023 年 9 月 首次發行 初始目的地版本和檔案發佈。
recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6