베타HubSpot과 AWS S3 연결(베타)

{
 "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>/*"
 ]
 }
 }
 }
 ]
}

• 다음을 클릭합니다.
• 검토 및 만들기 섹션에서 정책 이름과 설명(선택 사항)을 추가합니다.
• 정책 만들기를 클릭합니다.

3. AWS에서 IAM 역할 만들기

AWS 관리 콘솔에서 HubSpot에 대한 액세스 권한을 구성합니다:

• AWS 관리 콘솔에 로그인합니다.
• 홈 대시보드에서 서비스 > 보안, ID 및 규정 준수 > IAM을 클릭합니다.
• 왼쪽 사이드바에서 역할을 클릭합니다.
• 역할 만들기를 클릭합니다.
• 신뢰할 수 있는 엔티티 유형 섹션에서 AWS 계정을 선택합니다.
• AWS 계정 섹션에서 다른 AWS 계정을 선택하고 자신의 AWS 계정 ID를 입력합니다. 나중에 HubSpot에 대한 액세스 권한을 부여하도록 신뢰 관계를 변경합니다.
• 외부 ID 필요를 선택하고 0000과 같은 자리 표시자 ID를 입력합니다. 나중에 IAM 역할에 대한 신뢰 관계를 변경하고 스토리지 통합을 위한 외부 ID를 지정합니다. 외부 ID는 HubSpot과 같은 타사 앱에 AWS 리소스에 대한 액세스 권한을 부여하는 데 사용됩니다.

• 다음을 클릭합니다.
• 1단계에서 만든 정책을 선택하고 다음을 클릭합니다.
• 역할 세부 정보 섹션에서 역할 이름과 설명을 입력하여 역할을 식별합니다.
• 역할 만들기를 클릭합니다.
• 역할 요약 페이지에서 ARN 값을 복사합니다. 다음 단계에서 이 값을 사용합니다.

4. HubSpot과 AWS S3 연결

통합을 설치하기 전에 HubSpot 계정이 AWS S3 베타의 Access HubSpot 데이터에 옵트인되어 있는지 확인하세요.

• HubSpot 계정의 상단 탐색 모음에서 마켓플레이스 아이콘 marketplace을 클릭한 다음 앱 마켓플레이스를 선택합니다. AWS S3를 검색하여 선택합니다. 이 URL을 사용하여 계정에서 직접 연동으로 이동할 수도 있습니다.
• 오른쪽 상단에서 앱 설치를 클릭합니다.
• 3단계에서 구성한 IAM 역할 이름과 데이터를 덤프할 버킷의 S3 URL 경로를 입력합니다.
• 다음을 클릭합니다.
• 다음 단계에서 필요하므로 AWS IAM 사용자 및 AWS 외부 ID 값을 검토하고 복사합니다. 그런 다음 연결된 앱으로 계속을 클릭합니다.

5. 버킷 개체에 액세스할 수 있는 권한을 IAM 사용자에게 부여합니다.

• AWS 관리 콘솔에 로그인합니다.
• 홈 대시보드에서 서비스 > 보안, ID 및 규정 준수 > 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입니다.

객체_x 테이블

사용자 지정 객체를 포함하여 사용 가능한 각 객체 유형에는 고유한 특정 테이블이 있습니다. 이러한 테이블의 이름은 OBJECTS_<object type name> 형식에 따라 지정되며 <object type name> 은 objecttype 의 복수형 레이블입니다(개체 유형에 복수형이 없는 경우 <object type name> 은 개체 유형 이름에 "S"를 연결한 단수형 레이블입니다).

아래는 사용 가능한 HubSpot 개체 유형의 전체 목록, 해당 유형이 나타내는 데이터에 대한 간단한 설명 및 해당 테이블입니다.

HubSpot 개체 유형	객체 유형 ID	설명
연락처	0-1	비즈니스와 상호작용하는 개인에 대한 정보
회사	0-2	개별 기업 또는 조직에 대한 정보
DEAL	0-3	연락처 또는 회사와의 수익 기회에 대한 세부 정보.
참여	0-4	메모, 작업, 이메일, 회의, 통화 등 CRM 작업의 데이터를 저장합니다.
TICKET	0-5	고객의 도움 또는 지원 요청을 나타냅니다.
QUOTE	0-14	잠재적 구매자와 가격 정보를 공유하는 데 사용됩니다.
form_submission	0-15	HubSpot 양식의 개별 제출에 대한 세부 정보입니다.
LINE_ITEM	0-8	거래에서 판매되는 제품의 하위 집합을 나타냅니다. 제품이 거래에 첨부되면 라인 항목이 됩니다.
대화	0-11	여러 채널에서 수신되는 메시지의 세부 정보입니다.
랜딩 페이지	0-25	랜딩 페이지의 세부 정보
TASK	0-27	할 일 목록에 대한 정보 저장
FORM	0-28	방문자 및 연락처에 대한 리드 정보를 수집하는 데 사용됩니다.
마케팅_이메일	0-29	마케팅 허브에서 보낸 이메일에 대한 세부 정보
AD_ACCOUNT	0-30	링크드인, 페이스북, 구글의 광고 계정에 대한 정보를 저장합니다.
AD_CAMPAIGN	0-31	광고 캠페인에 대한 세부 정보. 광고 캠페인에는 하나 이상의 광고가 포함될 수 있습니다.
AD_GROUP	0-32	광고 캠페인 내 광고의 논리적 그룹화
AD	0-33	개별 광고에 대한 세부 정보
캠페인	0-35	관련 마케팅 자산 및 콘텐츠에 대한 정보로, 공동 마케팅 활동의 효과를 쉽게 측정할 수 있습니다.
SITE_PAGE	0-38	웹사이트의 개별 페이지에 대한 데이터
BLOG_POST	0-39	블로그 게시물에 대한 데이터
객체 목록	0-45	속성 또는 활동에 따른 개체 레코드 그룹에 대한 정보
CALL	0-48	다른 CRM 레코드(예: 연락처)에 의해 이루어진 통화
INVOICE	0-53	외부 회계 시스템과 인보이스 관리 및 동기화
MEDIA_BRIDGE	0-57	HubSpot으로 가져온 미디어 자산에 대한 정보
SEQUENCE	0-58	시퀀스는 시간이 지남에 따라 연락처를 육성하기 위한 일련의 타겟팅된 시간 지정 이메일 템플릿입니다.
DEAL_SPLIT	0-72	거래 분할은 여러 사용자 간에 거래 크레딧을 공유하는 데 사용됩니다.
SALES_DOCUMENT	0-83	영업 문서는 전체 팀이 문서를 업로드하고 연락처와 공유할 수 있는 콘텐츠 라이브러리를 구축합니다.
피드백_제출	0-19	피드백 설문조사에 제출된 정보를 저장합니다.
구독	0-69	구독에는 정기결제에 대한 세부 정보가 포함됩니다.
상거래 결제	0-101	고객으로부터 수집한 자금에 대한 데이터가 포함되어 있습니다.

객체_위드_객체_프로퍼티

이 테이블에는 HubSpot 레코드의 데이터가 포함되어 있습니다. 개체 유형 내의 각 레코드에 대해 하나의 행을 가져올 수 있습니다(예: 연락처 개체 유형에 있는 모든 연락처 레코드).

OBJECT_PROPERTIES_HISTORY

이 테이블에는 기록 속성 값이 포함되어 있습니다. 연락처의 경우 가장 최근 45개 값이 포함됩니다. 다른 모든 개체의 경우 가장 최근 20개의 값이 포함됩니다. 이 테이블에는 각 기록 속성 값에 대한 행이 있습니다. 속성의 현재 값은 속성 기록에서 가장 최근의 업데이트된 타임스탬프에 의해 결정됩니다.

연결 쿼리

개체 데이터와 마찬가지로 연결 데이터는 두 가지 방식으로 구성됩니다:

• 개별: 각 연결 유형은 자체 테이블에 저장되며 해당 유형의 레코드만 포함합니다. 예를 들어 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 파일이 있습니다.