베타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 클라우드 스토리지(GCS) 버킷 URI를 추가합니다:
   • GCS 버킷의 URI는 다음 구조를 따라야 합니다: gs://{bucket}/hubspot-dataout/{portalId}/{runId}/{tableName}/
   • BigQuery 외부 테이블은 GCP 프로젝트의 전용 데이터 집합에 생성되며 형식을 따릅니다: hubspot_data_set_{hubId}
   • 데이터는 GCS 버킷에 기록되며, 연결된 테이블은 GCS의 쪽모이 세공 파일을 참조합니다.
   • Google 설명서에서 GCS 버킷을 만드는 방법에 대해 자세히 알아보세요.
7. 연결 테스트를 클릭합니다.
8. 연결이 확인되면 다음을 클릭합니다.
9. 동기화하려는 데이터 소스 옆의 확인란 (예: 연락처, 연결, 이벤트 등)을 선택합니다.
10. 동기화 빈도 및 일정을 구성합니다.
11. 동기화 시작을 클릭합니다.

동기화 모니터링

계정 간 동기화를 구성한 후에는 동기화 세부정보 페이지에서 동기화 상태 및 기록을 검토할 수 있습니다:

1. HubSpot 계정에서 데이터 관리 > 데이터 통합으로 이동합니다.
2. 가져오기 및 동기화 모니터링에서 앱 동기화 탭을 클릭합니다.
3. 검색창을 클릭하고 Google BigQuery를 검색합니다.
4. Google BigQuery를 클릭합니다. 양방향 동기화를 구성한 경우 여러 항목이 표시될 수 있습니다.
5. 동기화 세부정보 페이지에서 동기화 설정 및 기록을 관리하고 검토할 수 있습니다:
   • 동기화 세부정보를 보관하거나 수정하려면 오른쪽 상단에서 작업을 클릭한 다음 해당 옵션을 선택합니다.
   • 동기화를 즉시 트리거하려면 오른쪽 상단에서 지금 동기화를 클릭합니다.
   • 동기화된 기록, 연결 및 오류가 페이지 상단에 요약되어 표시됩니다.
   • 최근 동기화 활동이 표에 표시됩니다. 동기화 기록 탭을 클릭하여 특정 동기화 시도 및 완료를 검토합니다. 특정 날짜 범위 또는 동기화 상태를 기준으로 필터링할 수 있습니다.

동기화 상태 및 오류 처리

아래 표에는 가능한 동기화 상태가 간략하게 나와 있습니다:

동기화에 실패한 경우:

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

네트워크 허용 목록

BigQuery와 같은 타사 제공업체와 HubSpot 데이터를 동기화하는 작업은 HubSpot의 프록시 IP를 통해 라우팅됩니다. 이러한 IP 범위는 데이터 동기화 및 웹후크와 같은 다른 HubSpot 연동 서비스에서 사용됩니다.

조직에서 GCP 리소스에 대한 인바운드 액세스를 제한하는 경우에는 HubSpot 허브렛을 기준으로 다음 CIDR 범위를 허용 목록에 추가해야 합니다:

HubSpot 계정 데이터가 호스팅되는 위치를 찾는 방법을 알아보세요.

베타 제한 사항

이 베타 버전에서는 다음 제한 사항을 염두에 두세요:

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

다음 단계

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