Google BigQuery 커넥터

1. 원시 텔레메트리를 BigQuery로 내보내는 이유

MousePlayer 대시보드는 즉각적인 세션 재생과 시각적 히트맵을 제공하지만, 기업의 데이터 과학 및 비즈니스 인텔리전스(BI) 팀은 원시 행동 로그에 직접 SQL로 접근해야 합니다. MousePlayer 데이터를 Google BigQuery와 동기화하면 다음이 가능합니다.

• 텔레메트리와 백엔드 데이터 결합: 맞춤 SQL 쿼리로 프런트엔드 사용자 세션을 CRM 레코드, 결제 게이트웨이 로그 및 청구 데이터베이스와 결합합니다.
• 맞춤 AI/ML 모델 학습: 세밀한 마우스 이동 궤적과 분노 클릭 패턴으로 이탈 예측 및 사기 탐지 알고리즘을 학습시킵니다.
• MousePlayer의 저장 비용 없음: 데이터는 GCP 프로젝트로 직접 내보내므로 데이터 소유권을 100% 유지하며 기업 IAM 정책을 준수할 수 있습니다.

2. Business 요금제와 Enterprise 요금제의 기능

BigQuery 커넥터는 Business 및 Enterprise 요금제에서만 이용할 수 있습니다. 요금제에 따라 매일 밤 자동 내보내기에 포함할 데이터 세트를 선택할 수 있습니다.

내보내는 테이블	데이터 내용 & 스키마	Business 요금제	Enterprise 요금제
visitor_sessions_YYYYMMDD	전체 세션 메타데이터(세션 ID, 방문자 ID, IP, 국가, 기기, OS, 브라우저, 지속 시간, 리퍼러, UTM, custom_user_id).	포함	포함
visitor_custom_events_YYYYMMDD	모든 표준 전환 및 맞춤 이벤트(예: purchase, rage_click, error_detected, 양식 제출)와 자료형이 지정된 EAV 매개변수.	포함	포함
mouse_events_YYYYMMDD	녹화된 모든 페이지 조회에 대한 세밀한 좌표 스트림(X, Y, 타임스탬프, 스크롤 깊이, 클릭 대상, 대상 CSS 선택자).	제공되지 않음	Enterprise 전용

3. 설정 안내: GCP 서비스 계정 & IAM 권한

MousePlayer는 개인 Google 로그인 정보를 요구하지 않습니다. 대신 Google Cloud Console에서 최소 권한을 가진 전용 서비스 계정을 만듭니다.

1. Google Cloud Console에서 IAM & 관리자 → 서비스 계정 으로 이동한 다음 서비스 계정 만들기를 클릭하세요.
2. 서비스 계정 이름을 지정하세요(예: mouseplayer-bq-writer).
3. IAM 역할을 정확히 두 개 부여하세요. BigQuery Data Editor 및 BigQuery Job User.
4. 새 서비스 계정의 키 탭으로 이동하여 키 추가 → 새 키 만들기를 클릭한 다음 JSON을 선택하세요.
5. MousePlayer 대시보드를 열고 내 속성 → 설정 → BigQuery로 이동한 다음 GCP 프로젝트 ID, 데이터 세트 ID, 서비스 계정 이메일 및 JSON 키 내용을 붙여 넣으세요.