測試版連接 HubSpot 和 AWS S3 (BETA)

{
 "Version": "2012-10-17",
 "Statement": [
 {
 "Effect": "Allow",
 "Action": [
 "s3:PutObject",
 "s3:GetObject",
 "s3:GetObjectVersion",
 "s3:DeleteObject",
 "s3:DeleteObjectVersion"
 ],
 "Resource": "arn:aws:s3:::<bucket>/<prefix>/*"
 },
 {
 "Effect": "Allow",
 "Action": [
 "s3:ListBucket",
 "s3:GetBucketLocation"
 ],
 "Resource": "arn:aws:s3:::<bucket>",
 "Condition": {
 "StringLike": {
 "s3:prefix": [
 "<prefix>/*"
 ]
 }
 }
 }
 ]
}

• 按一下下一步。
• 在Review and create（檢閱和建立）部分中，新增Policy name（政策名稱）和可選的description（說明）。
• 按一下建立政策。

3.在 AWS 中建立 IAM 角色

在 AWS 管理主控台中為 HubSpot 設定存取權限：

• 登入AWS 管理主控台。
• 在主控制台中，按一下服務>安全、身分與合規性 >IAM。
• 在左側欄上，按一下角色。
• 按一下建立角色。
• 在受信任的實體類型部分，選擇AWS 帳戶。
• 在「一個 AWS 帳戶」部分，選取另一個 AWS 帳戶，然後輸入您自己的 AWS 帳戶 ID。您稍後將變更信任關係，以給予 HubSpot 存取權。
• 選擇需要外部 ID，然後輸入占位符 ID，如 0000。您稍後將變更 IAM 角色的信任關係，並指定儲存整合的外部 ID。外部 ID 用於授權 HubSpot 等第三方應用程式存取您的 AWS 資源。

• 按一下下一步。
• 選擇在步驟 1 中建立的政策，然後按一下下一步。
• 在角色詳細資訊部分，輸入角色名稱和說明，以識別角色。
• 按一下建立角色。
• 在角色摘要頁面上，複製ARN值。您將在下一步中使用此值。

4.連接 HubSpot 和 AWS S3

在安裝整合之前，請確定您的 HubSpot 帳戶已選擇加入 AWS S3 beta 中的 Access HubSpot 資料 。

• 在你的 HubSpot 帳戶中，點擊頂端導覽列中的「Marketplace 圖示」marketplace，然後選取「App Marketplace」。搜尋並選擇AWS S3。您也可以使用此 URL 直接在您的帳戶中導航至整合。
• 在右上方，按一下安裝應用程式。
• 輸入在步驟 3 中設定的IAM 角色名稱 ，以及要將資料轉儲到的儲存桶的S3 URL 路徑。
• 按一下下一步。
• 檢視並複製AWS IAM 使用者和 AWS 外部 ID 值，因為您在下一步中需要這些值。 然後按一下「繼續連結至連結的應用程式」。

5.授予 IAM 使用者存取資料桶物件的權限

• 登入AWS 管理主控台。
• 在主控制台中，按一下服務>安全、身分與法規遵循 >IAM。
• 在左側側邊欄中，按一下角色。
• 選取您在步驟 3 中建立的角色。
• 選擇信任關係索引標籤，然後按一下編輯信任政策。
• 使用您在步驟 3 中記錄的值修改政策文件。

{
 "Version": "2012-10-17",
 "Statement": [
 {
 "Sid": "",
 "Effect": "Allow",
 "Principal": {
 "AWS": "<hubspot_user_arn>"
 },
 "Action": "sts:AssumeRole",
 "Condition": {
 "StringEquals": {
 "sts:ExternalId": "<hubspot_external_id>"
 }
 }
 }
 ]
}

在上述政策中，將下列兩個欄位變更為您在步驟 4 中記錄的值：

• hubspot_user_arn改為STORAGE_AWS_IAM_USER_ARN值
• hubspot_external_id改為STORAGE_AWS_EXTERNAL_ID 值

完成以上步驟後，HubSpot 就可以將資料同步到 AWS S3。

HubSpot 與 AWS S3 之間同步的資料格式

可用於同步的資料

您可以將下列資料從 HubSpot 同步至 AWS S3：

• 物件：標準和自訂物件，例如聯絡人、公司、票券或產品。
• 記錄：個別物件記錄。
• 關聯： 所有關聯類型和關聯記錄。
• 事件：標準 HubSpot 事件和自訂行為事件的事件資料。
• 清單： HubSpot 聯絡人和公司清單。
• 所有者： 記錄所有者。
• 管道： 交易和票據管道以及管道階段。
• 屬性： 物件記錄上的屬性及其值，包括屬性歷史。

不同類型的物件資料以兩種方式組織與提供：

• 個別： 每個物件類型都儲存在自己的表中，並且只有相同物件類型的記錄。例如，objects_contacts 只包含聯絡人記錄。
• 合併：所有物件類型的所有記錄都合併為一個資料庫物件。因此，在查詢時，您需要指定類似 "WHERE objectTypeId='0-1'" 的篩選條件。

自訂物件會在建立時指定一個 ID，並識別為2-unique_ID。例如，2-12345。

objects_x 表

每個可用的物件類型，包括自訂物件，都有自己特定的表格。這些表格依據OBJECTS_<object type name> 的格式命名，其中<object type name> 是objecttype 的複數形式標籤。（請注意，如果物件類型沒有複數形式，則<object type name> 將是物件類型名稱與 "S" 連結的單數形式標籤）。

以下是可用 HubSpot 物件類型的完整清單、它們所代表資料的簡短說明，以及相對應的表格。

HubSpot 物件類型	物件類型Id	說明
聯繫	0-1	與您的企業互動的個人資訊
公司	0-2	個別企業或組織的相關資訊
交易	0-3	有關聯絡人或公司的收入機會的詳細資訊。
參與	0-4	儲存 CRM 動作的資料，包括備註、任務、電子郵件、會議和通話。
票券	0-5	代表客戶要求協助或支援。
引用	0-14	用於與潛在買家分享定價資訊。
提交表單	0-15	HubSpot 表單個別提交的詳細資料。
項目	0-8	代表交易中銷售產品的子集。當產品被附加到交易時，它會變成一個細列項目。
交談	0-11	來自多個管道的傳入訊息的詳細資訊。
頁面	0-25	登陸頁面的詳細資訊
任務	0-27	儲存待辦事項的相關資訊
表格	0-28	用於收集訪客和聯絡人的線索資訊
行銷郵件	0-29	來自行銷中心的電子郵件詳細資料
AD_ACCOUNT	0-30	儲存您在 Linkedin、Facebook 和 Google 上的廣告帳戶資訊
廣告	0-31	廣告系列的詳細資訊。一個廣告系列可以包含一個或多個廣告
廣告群組	0-32	廣告系列內廣告的邏輯群組
廣告	0-33	個別廣告的詳細資訊
廣告系列	0-35	相關行銷資產與內容的資訊，方便您衡量整體行銷工作的成效。
網站頁面	0-38	有關您網站上個別頁面的資料
部落格文章	0-39	關於部落格文章的資料
項目 清單	0-45	根據物件的屬性或活動，將物件記錄分組的資訊
呼叫	0-48	其他 CRM 記錄撥打的電話，例如聯絡人
發票	0-53	管理發票並與外部會計系統同步
媒體橋樑	0-57	匯入 HubSpot 的媒體資產資訊
序列	0-58	序列是一系列有針對性、定時的電子郵件範本，用來培養聯繫人。
訂單	0-72	交易分拆用於在多位使用者之間分享交易額度
銷售文件	0-83	銷售文件建立一個內容庫，供整個團隊上傳文件，並與聯絡人分享文件。
回饋提交	0-19	儲存提交至回饋意見調查的資訊。
訂閱	0-69	訂閱包含定期付款的詳細資訊
商業付款	0-101	包含從客戶收取資金的相關資料

有物件屬性的物件

此表包含 HubSpot 記錄的資料。您可以為物件類型中的每筆記錄取得一列資料 (例如：聯絡人物件類型中的所有聯絡人記錄)。

object_properties_history

此表包含歷史屬性值。對於聯絡人，它包含最近的 45 個值。對於所有其他物件，則包含最近的 20 個值。該表的每一個歷史屬性值都有一列。屬性的目前值由該屬性歷史中最近的 UPDAT 時間戳決定。

關聯查詢

與物件資料一樣，關聯資料也以兩種方式組織：

• 個別：每種關聯類型儲存在自己的表中，並且只包含該類型的記錄。例如，associations_contacts_to_deals 只包含聯絡人和交易物件之間的關聯記錄。T
• 合併：所有關聯類型的所有記錄都合併到一個資料表。

關聯_x_to_y

每個關聯類型都有自己的檢視，標示為associations_<association type name> ，例如associations_contacts_to_deals 。

關聯定義

此表包含 HubSpot 物件之間所有可用關聯類型的資訊，每個關聯類型有一列。

屬性定義

此表包含 HubSpot 帳戶中物件屬性和事件屬性的相關資訊。事件屬性包括標準事件，例如電子郵件開啟和點擊，以及自訂行為事件屬性。這些資訊有助於定義object_properties 和事件資料中的值。

事件

事件包括標準 HubSpot 事件和自訂行為事件。每個事件都有自己的表格，標示為events_eventname 。

object_and_event_type_definitions

此表包含 HubSpot 帳戶中所有物件和事件的定義。

同步頻率與資料組織

HubSpot 和 AWS S3 之間的資料每日同步。資料同步的每一天都會建立一個資料夾。以下每個表格都會以資料夾的形式提供，並包含壓縮後的 CSV 檔案：

ASSOCIATIONS
ASSOCIATION_DEFINITIONS
EVENTS_[Event name]
LISTS
LIST_MEMBERSHIPS
OBJECTS
OBJECT_AND_EVENT_TYPE_DEFINITIONS
OBJECT_PROPERTIES
OBJECT_PROPERTIES_HISTORY
OBJECT_WITH_OBJECT_PROPERTIES
OWNERS
OWNER_TEAM
PIPELINES
PIPELINE_STAGES
PROPERTY_DEFINITIONS
TEAMS

每個資料表都會有數個子資料夾。如果表格大小超過 15MB，每個表格資料夾下會有多個壓縮 CSV 檔案。