베타HubSpot과 Google BigQuery 연결(베타)

HubSpot과 Google BigQuery를 연결하여 HubSpot 데이터를 Google BigQuery 인스턴스에 동기화하는 방법을 알아보세요.

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

HubSpot과 BigQuery 연결

HubSpot과 Google BigQuery를 연결하려면 다음 단계를 순서대로 실행해야 합니다:

1. HubSpot 앱 마켓플레이스에서 Google BigQuery를 설치합니다.
2. Google Cloud Platform에서 사용자 지정 IAM 역할 만들기
3. Google 서비스 계정에 사용자 지정 역할 할당하기
4. HubSpot에서 생성한 Google BigQuery 계정에 BigQuery 테이블을 수정할 수 있는 권한을 부여합니다.
5. HubSpot에서 설정 완료

1. HubSpot 앱 마켓플레이스에서 Google BigQuery를 설치합니다.

두 앱을 연결할 때는 HubSpot 계정과 Google BigQuery 계정을 별도의 탭에 열어 두는 것이 좋습니다.

• HubSpot 계정이 이 베타 버전에 옵트인되어 있는지 확인하세요: Google BigQuery에서 HubSpot 데이터에 액세스하세요.
• 이 링크로 이동하여 HubSpot 계정을 선택합니다.
• 오른쪽 상단에서 앱 설치를 클릭합니다.
• 버킷 URI와 프로젝트 ID를 입력합니다.
• 다음을 클릭합니다.

• 다음 단계에서 필요하므로 Google 서비스 및 BigQuery 계정을 검토하고 메모해 두세요. 그런 다음 Google 클라우드 콘솔로 이동하여 다음 단계를 완료합니다.

2. Google Cloud Platform에서 사용자 지정 IAM 역할 만들기

• Google 클라우드 콘솔에 로그인합니다.
• 왼쪽 탐색 메뉴를 클릭하고 IAM 및 관리자 > 역할을 선택합니다.
• 상단에서 역할 만들기를 클릭합니다.
• 역할의 제목, 설명(선택 사항), ID를 입력합니다.
• 권한 추가를 클릭합니다.

• 표에서 다음 권한을 선택하고 추가를 클릭합니다:

bigquery.datasets.create
bigquery.datasets.get
bigquery.datasets.getIamPolicy
bigquery.jobs.create
bigquery.tables.create
bigquery.tables.createIndex
bigquery.tables.createSnapshot
bigquery.tables.createTagBinding
bigquery.tables.delete
bigquery.tables.deleteIndex
bigquery.tables.deleteSnapshot
bigquery.tables.update
bigquery.tables.get
storage.buckets.get
storage.objects.create
storage.objects.delete
storage.objects.get
storage.objects.list

• 만들기를 클릭합니다.

3. 클라우드 스토리지 버킷에 액세스할 수 있는 Google 서비스 계정 권한을 부여합니다.

• 왼쪽 탐색 메뉴를 클릭하고 클라우드 스토리지 > 버킷을 선택합니다.
• 구성할 버킷을 선택합니다.
• 권한 탭을 클릭합니다.
• 담당자별 보기 탭에서 액세스 권한 부여를 클릭합니다 .

• 오른쪽 패널의 새 교장 필드에 1단계의 Google 서비스 계정 이름을 입력합니다.

참고: BigQuery 계정이 아닌 Google 서비스 계정을 지정해야 합니다.

• 역할 할당 섹션에서 드롭다운 메뉴를 클릭하고 사용자 지정 > <역할>을 선택합니다. 여기서 <역할>은 2단계에서 만든 사용자 지정 IAM 역할입니다.
• 저장을 클릭합니다. Google 서비스 계정이 저장소 개체 뷰어 역할에 추가됩니다.

4. HubSpot에서 생성한 Google BigQuery 계정에 BigQuery 테이블을 수정할 수 있는 권한을 부여합니다.

• 왼쪽 탐색 메뉴를 클릭하고 IAM 및 관리자 > IAM을 선택합니다.
• 액세스 권한 부여를 클릭합니다.
• 오른쪽 패널의 새 교장 필드에 1단계에서 HubSpot에서 생성한 Google BigQuery 계정을 입력합니다.
• 역할 할당 섹션에서 드롭다운 메뉴를 클릭하고 사용자 지정 > <역할>을 선택합니다. 여기서 <역할>은 2단계에서 만든 사용자 지정 IAM 역할입니다.

5. HubSpot에서 설정 완료

• HubSpot 계정에서 연결된 앱으로 계속을 클릭합니다.

• 대화 상자에서 확인란을 선택한 다음 허용 및 설치를 클릭합니다.

HubSpot과 Google BigQuery 간의 동기화를 위한 데이터 형식

동기화할 수 있는 데이터

다음 데이터를 HubSpot에서 Google BigQuery로 동기화할 수 있습니다:

• 개체: 연락처, 회사, 티켓, 제품 등의 표준 및 사용자 지정 개체입니다.
• 레코드: 개별 개체 레코드입니다.
• 연결: 모든 연결 유형 및 연결된 레코드입니다.
• 이벤트: 표준 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 계정에서 사용할 수 있는 모든 개체 및 이벤트에 대한 정의가 포함되어 있습니다.

동기화 빈도 및 데이터 정리

데이터는 매일 09:00 UTC +0에 HubSpot과 Google BigQuery 간에 동기화됩니다. 데이터가 동기화되는 날마다 각 테이블에 대해 여러 개의 하위 폴더가 있는 폴더가 생성됩니다. 마지막 7번의 동기화는 Google Cloud 플랫폼에서 사용할 수 있으며 BigQuery의 테이블은 최신 버킷 덤프를 가리키도록 업데이트됩니다.

다음 표는 각각 Parquet 형식 파일로 제공됩니다:

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