베타HubSpot을 Google BigQuery에 연결하기

Google BigQuery의 데이터를 HubSpot CRM의 연락처, 기업, 거래, 연관 관계 등의 객체 및 계정의 기타 데이터와 동기화하세요.

아래 섹션에서는 Google BigQuery 앱을 인증하고, Google Cloud 계정과 HubSpot 간의 동기화 설정을 구성하는 방법을 단계별로 안내합니다.

Google BigQuery 연동 연결 및 구성

Google BigQuery 계정을 HubSpot에 연결하려면:

1. HubSpot 계정에서 상단 탐색 모음의 마켓플레이스 아이콘 를 클릭한 다음 HubSpot 마켓플레이스를 선택합니다.
2. 검색 창 을 클릭하고 'Google BigQuery'를 입력하세요.
3. 목록 페이지 에서 Google BigQuery를 클릭하세요.
4. '설치'를 클릭합니다.
5. '설정 계속'을 클릭하세요.

데이터 통합 도구로 이동하게 되며, 여기에서는 동기화하려는 방향에 따라 사이드 패널을 통해 HubSpot 계정과 BigQuery 계정 간의 데이터 동기화 과정을 안내해 드립니다:

• Google BigQuery → HubSpot: BigQuery에서 HubSpot으로의 동기화를 구성합니다.
• HubSpot → Google BigQuery: HubSpot에서 BigQuery로의 동기화를 구성합니다.

Google BigQuery 데이터를 HubSpot 계정으로 동기화하세요

Google BigQuery 데이터를 HubSpot으로 전송하려면 BigQuery 계정에서 필요한 역할을 가진 새 사용자를 추가하고 구성하세요:

1. 오른쪽 창에서 Google BigQuery → HubSpot을 선택합니다.
2. HubSpot에서 생성한 Google 서비스 계정 이메일을 복사합니다.

3. Google Cloud 계정에서 프로젝트의 IAM 설정으로 이동하여, HubSpot에서 복사한 서비스 계정 이메일 주소를 사용하여 새 사용자를 생성한 다음, 새로 생성된 사용자에게 BigQuery 데이터 뷰어 및 BigQuery 작업 사용자 역할을 할당합니다.

4. Google Cloud 계정에서 프로젝트 ID 를 복사하세요.
5. HubSpot으로 돌아가서 프로젝트 ID를 붙여넣은 다음, ‘연결 테스트’를 클릭하세요.
6. 연결이 확인되면 ‘다음’을 클릭하여 설정을 완료하세요 .

HubSpot 데이터를 Google BigQuery 계정에 동기화하세요

HubSpot 데이터를 Google BigQuery로 전송하려면 Google Cloud 계정에서 필요한 권한을 가진 사용자를 구성하고, 관련 GCP 프로젝트 및 GCS 버킷 URI를 지정해야 합니다.

참고: BigQuery 데이터 세트가 저장될 GCP 프로젝트에 대한 Google Cloud 관리자 액세스 권한과, HubSpot이 Parquet 파일을 임시 저장할 Google Cloud Storage(GCS) 버킷이 필요합니다.

1. 오른쪽 창에서 HubSpot → Google BigQuery를 선택합니다.
2. HubSpot에서 생성한 Google 서비스 계정 이메일을 복사합니다.

3. Google Cloud 계정에서 프로젝트의 IAM 설정으로 이동하여, HubSpot에서 복사한 서비스 계정 이메일 주소를 사용하여 새 사용자를 생성한 다음, 새로 생성된 사용자에게 BigQuery 데이터 뷰어, BigQuery 작업 사용자 및 스토리지 객체 소유자 역할을 추가하십시오.

4. Google Cloud 계정에서 프로젝트 ID 를 복사합니다.
5. HubSpot으로 돌아가서 프로젝트 ID를 붙여넣으세요.
6. Google Cloud Storage(GCS) 버킷 URI를 추가하세요:
   • GCS 버킷의 URI는 다음 구조를 따라야 합니다: gs://{bucket}/hubspot-dataout/{portalId}/{runId}/{tableName}/
   • BigQuery 외부 테이블은 GCP 프로젝트 내의 전용 데이터셋에 생성되며 다음 형식을 따릅니다: hubspot_data_set_{hubId}
   • 데이터는 GCS 버킷에 기록되며, 관련 테이블은 GCS에 있는 Parquet 파일을 참조합니다.
   • GCS 버킷 생성에 대한 자세한 내용은 Google 문서에서 확인하세요.
7. '연결 테스트'를 클릭합니다.
8. 연결이 확인되면 '다음'을 클릭하세요.
9. 동기화할 데이터 소스(예: 연락처, 연관 정보, 이벤트 등) 옆에 있는 확인란 을 선택합니다.
10. 동기화 빈도와 일정을 설정하세요.
11. '동기화 시작'을 클릭합니다.

동기화 상태 확인

계정 간 동기화를 설정한 후에는 동기화 세부 정보 페이지에서 동기화 상태와 내역을 확인할 수 있습니다:

1. HubSpot 계정에서 더 보기를 클릭한 다음 데이터 관리 > 데이터 통합으로 이동하세요. 더 보기가 계정에 표시되지 않으면 바로 데이터 관리 > 데이터 통합으로 이동하세요.
2. '가져오기 및 동기화 모니터링' 아래에서 '앱 동기화 ' 탭을 클릭합니다.
3. 검색 창 을 클릭하고 ‘Google BigQuery’를 검색하세요.
4. 'Google BigQuery'를 클릭하세요. 양방향 동기화를 설정한 경우 여러 항목이 표시될 수 있습니다.
5. 동기화 세부 정보 페이지에서 동기화 설정 및 내역을 관리하고 확인할 수 있습니다.
   • 동기화 내역을 보관하거나 편집하려면 오른쪽 상단의 '작업'을 클릭한 다음 해당 옵션을 선택하세요.
   • 동기화를 즉시 실행하려면 오른쪽 상단의 '지금 동기화'를 클릭하세요.
   • 동기화된 레코드, 연관 관계 및 오류는 페이지 상단에 요약되어 표시됩니다.
   • 최근 동기화 내역은 표에 표시됩니다. ‘동기화 내역’ 탭을 클릭하여 특정 동기화 시도 및 완료 내역을 확인하세요. 특정 날짜 범위나 동기화 상태별로 필터링할 수 있습니다.

동기화 상태 및 오류 처리

아래 표에는 가능한 동기화 상태가 요약되어 있습니다:

동기화가 실패한 경우:

• 동기화 세부 정보 페이지에 '실패' 상태가 표시되며, 어떤 테이블의 동기화가 성공했는지 또는 실패했는지에 대한 정보도 함께 제공됩니다.
• 동기화 실패 시 데이터가 부분적으로 기록되지 않습니다. BigQuery 테이블은 동기화가 성공적으로 완료된 경우에만 업데이트됩니다.
• 다음 예약된 동기화 시점에 전체 동기화가 자동으로 다시 시도됩니다.
• 동기화 세부 정보 페이지에서 언제든지 수동으로 재동기화를 실행할 수 있습니다.

네트워크 허용 목록

HubSpot 데이터를 BigQuery와 같은 타사 서비스 제공업체로 동기화할 때는 HubSpot의 프록시 IP를 통해 라우팅됩니다. 이러한 IP 범위는 데이터 동기화 및 웹훅과 같은 다른 HubSpot 통합 기능에서도 사용됩니다.

조직에서 GCP 리소스에 대한 인바운드 액세스를 제한하는 경우, 사용 중인 HubSpot 허블릿에 따라 다음 CIDR 범위를 허용 목록에 추가해야 합니다:

HubSpot 계정 데이터가 어디에 호스팅되어 있는지 확인하는 방법을 알아보세요.

베타 버전 제한 사항

이번 베타 기간 동안 다음 제한 사항을 유의해 주십시오:

• 동기화 빈도: 1회, 6시간마다, 12시간마다, 매일, 매주, 매월 등 제한된 동기화 빈도만 사용할 수 있습니다. HubSpot의 동기화 세부 정보 페이지에서 언제든지 수동으로 재동기화를 실행할 수 있습니다.
• 데이터 유형당 하나의 내보내기: 각 객체 유형, 이벤트 유형 또는 연관 쌍은 HubSpot 계정당 하나의 동기화 구성에서만 내보낼 수 있습니다.
  
  • 예를 들어, 연락처가 이미 하나의 BigQuery 대상에 내보내지고 있는 경우, 원래 대상이 보관 처리될 때까지 두 번째 구성에 해당 연락처를 추가할 수 없습니다.
  • 이를 통해 데이터 파이프라인의 중복을 방지하고, 데이터 웨어하우스 내 각 데이터 유형에 대해 단일 신뢰 소스를 보장합니다.
• 민감 데이터 지원 제한: HubSpot 계정에 민감 데이터를 저장하고 동기화할 수는 있지만, BigQuery 계정으로 민감 데이터를 동기화할 수는 없습니다.
• object_x_views 미지원: 현재 object_x_views 개체는 BigQuery와의 동기화에서 지원되지 않습니다. object_with_object_properties 을 사용하거나, objects 을 object_properties 과 조인하여 레코드별 뷰에 상응하는 결과를 얻으십시오.

다음 단계

BigQuery 연동을 연결하고 동기화 설정을 완료한 후에는 BigQuery에서 동기화된 테이블의 스키마에 대해 알아보세요.