베타HubSpot과 AWS S3 연결

HubSpot과 AWS S3를 연결하여 HubSpot 데이터를 S3 버킷에 동기화하세요. 앱을 연결한 후 HubSpot은 개체, 레코드, 연결, 이벤트 및 세그먼트를 포함한 CRM 데이터를 AWS S3에 동기화하여 저장, 보고 및 분석할 수 있습니다. 

예를 들어 연락처 및 회사 데이터를 S3 버킷에 동기화하여 조직의 데이터 웨어하우스, 비즈니스 인텔리전스 도구 또는 데이터 처리 워크플로에서 사용할 수 있습니다.

참고: HubSpot은 HIPAA 데이터를 AWS S3에 공유하지 않습니다 .

시작하기 전에

통합을 설정하기 전에, AWS S3 베타의 Access HubSpot 데이터에 HubSpot 계정을 선택해야 합니다.

HubSpot과 AWS S3 연결

HubSpot과 AWS S3를 연결하려면 아래 단계를 순서대로 따라야 합니다: 

1. AWS S3 버킷에 대한 액세스 권한을 구성합니다. 
2. IAM 정책을 만듭니다. 
3. AWS에서 IAM 역할을 생성합니다. 
4. HubSpot과 AWS S3를 연결합니다. 
5. IAM 사용자에게 S3 버킷 개체에 액세스할 수 있는 권한을 부여합니다. 

1. S3 버킷에 대한 액세스 권한 구성하기

HubSpot이 폴더 및 하위 폴더의 파일에 액세스하려면 AWS S3 버킷 및 폴더에 대해 다음 권한이 필요합니다:

• s3:GetBucketLocation
• s3:GetObject
• s3:GetObjectVersion
• s3:ListBucket
• s3:PutObject
• s3:삭제객체

2. IAM 정책 만들기

1. AWS 관리 콘솔에 로그인합니다.
2. 홈 대시보드에서 서비스 > 보안, ID, & 규정 준수 > IAM을 클릭합니다.
3. 왼쪽 사이드바에서 계정 설정을 클릭합니다.
4. STS(보안 토큰 서비스) 섹션에서 AWS 계정이 위치한 지역에 해당하는 AWS 리전을 찾습니다. 클릭하여 스위치를 켜면 해당 지역이 활성화됩니다.
5. 왼쪽 패널에서 정책을 클릭합니다. 
6. 정책 생성을 클릭합니다. 
7. JSON 탭에서 새 문 추가를 클릭합니다. 
8. 아래에 정책 문서를 추가하여 단일 버킷 및 폴더 경로를 사용하여 데이터를 로드하거나 언로드하는 데 필요한 권한을 HubSpot에 부여하세요. 복사본 삭제 옵션을 사용하여 데이터 파일을 삭제할 수도 있습니다. 

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

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

3. AWS에서 IAM 역할 생성

AWS 관리 콘솔에서 HubSpot에 대한 액세스 권한을 구성하려면 다음과 같이 하세요:

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

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

4. HubSpot과 AWS S3 연결

1. HubSpot 계정에서 상단 탐색 모음의 마켓플레이스 아이콘 를 클릭한 다음 HubSpot 마켓플레이스를 선택합니다.
2. AWS S3를 검색하여 선택합니다. 
3. 설치를 클릭합니다. 
4. 3단계에서 구성한 IAM 역할 이름과 데이터를 저장할 버킷의 S3 URL 경로를 입력합니다.
5. 다음을 클릭합니다.
6. 다음 단계에서 필요하므로 AWS IAM 사용자 및 AWS 외부 ID 값을 검토하고 복사합니다. 그런 다음 연결된 앱으로 계속을 클릭합니다.

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

1. AWS 관리 콘솔에 로그인합니다.
2. 홈 대시보드에서 서비스 > 보안, ID, & 규정 준수 > IAM을 클릭합니다.
3. 왼쪽 사이드바에서 역할을 클릭합니다.
4. 3단계에서 만든 역할을 선택합니다. 
5. 신뢰 관계 탭을 선택하고 신뢰 정책 편집을 클릭합니다. 
6. 3단계에서 기록한 값으로 정책 문서를 수정합니다. 

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

7. 위 정책에서 다음 두 필드를 4단계에서 기록한 값으로 변경합니다:

• • hubspot_user_arn을 STORAGE_AWS_IAM_USER_ARN 값으로 설정합니다
  • 허브스팟_외부_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 기록의 데이터가 포함되어 있습니다. 개체 유형 내의 각 레코드에 대해 하나의 행을 가져올 수 있습니다(예: 연락처 개체 유형의 모든 연락처 레코드). 

객체_프로퍼티_역사

이 표에는 과거 속성 값이 포함되어 있습니다. 연락처의 경우 가장 최근 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.

객체_및_이벤트_유형_정의

이 표에는 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 파일이 생성됩니다.