1단계: Google API 콘솔 프로젝트 생성 및 BigQuery 사용 설정하기
- Google Cloud 콘솔에 로그인합니다.
- 새 Google Cloud 콘솔 프로젝트를 만들거나 기존 프로젝트를 선택합니다.
- API 표로 이동합니다.
왼쪽 상단의 탐색 메뉴를 열고 API 및 서비스와 라이브러리를 차례로 클릭합니다. - BigQuery를 활성화합니다.
Google Cloud API에서 BigQuery API를 클릭합니다. 다음 페이지에서 사용 설정을 클릭합니다. - 메시지가 표시되면 서비스 약관을 검토하고 이에 동의합니다.
2단계: BigQuery Export를 위한 프로젝트 준비하기
Google 애널리틱스 데이터를 BigQuery 샌드박스에 무료로 내보낼 수 있습니다(샌드박스 한도가 적용됨).
샌드박스에서 업그레이드하는 방법 및 BigQuery 가격 책정에 대해 자세히 알아보세요.
3단계: Google 애널리틱스 4 속성을 BigQuery에 연결하기
처음 두 단계를 완료한 후 애널리틱스 관리에서 BigQuery Export를 사용 설정할 수 있습니다.
BigQuery Export에는 Google 애널리틱스와 같은 수집 및 구성 한도가 적용됩니다. 한도를 늘려야 하는 경우 속성을 360으로 업그레이드할 수 있습니다.
애널리틱스에 로그인할 때 BigQuery 프로젝트에 대한 소유자 액세스 권한(자세한 액세스 요구사항은 아래의 권한 참고) 및 연결하려는 데이터 스트림이 포함된 애널리틱스 속성에 대한 편집자 역할이 모두 있는 이메일 주소를 사용하세요.
- 관리자의 제품 연결에서 BigQuery 링크를 클릭합니다.
- 연결을 클릭합니다.
- 액세스 권한이 있는 프로젝트 목록을 표시하려면 BigQuery 프로젝트 선택을 클릭합니다.
애널리틱스와 Firebase를 연결했거나 연결할 계획이라면 다른 Firebase 데이터와 쉽게 조인할 수 있도록 동일한 Cloud 프로젝트로 내보내는 것이 좋습니다. - 목록에서 프로젝트를 선택한 다음 확인을 클릭합니다.
- 데이터의 위치를 선택합니다. 프로젝트에 이미 애널리틱스 속성에 대한 데이터 세트가 있다면 이 옵션을 구성할 수 없습니다.
- 다음을 클릭합니다.
- 데이터 스트림 및 이벤트 구성을 선택하여 내보내기에 포함할 데이터 스트림 및 내보내기에서 제외할 특정 이벤트를 선택합니다. 추가를 클릭하여 기존 이벤트의 목록에서 선택하거나 이름으로 이벤트 지정을 클릭하여 기존 이벤트의 이름을 선택하거나 속성에서 아직 수집되지 않은 이벤트 이름을 지정하여 이벤트를 제외할 수 있습니다.
- 완료를 클릭합니다.
- 광고 ID를 포함하려면 모바일 앱 스트림의 광고 ID 포함을 선택합니다.
- 매일(매일 한 번) 또는 스트리밍(연속) 데이터 내보내기 중 하나를 선택하거나 둘 다 선택합니다.
- 다음을 클릭합니다.
- 설정을 검토한 다음 제출을 클릭합니다.
권한
프로젝트 getIamPolicy/setIamPolicy 권리, 서비스 권리 가져오기/사용 설정
OWNER는 이러한 권한의 상위 집합입니다.BigQuery 링크를 만들려면 최소한 다음과 같은 권한이 필요합니다.
resourcemanager.projects.get- 프로젝트 가져오기
resourcemanager.projects.getIamPolicy- 권한 목록 가져오기
resourcemanager.projects.setIamPolicy- 사용자에게 이 프로젝트에 링크를 만들 권한이 있는지 확인
serviceusage.services.enable- BigQuery API 사용 설정
serviceusage.services.get- BigQuery API가 사용 설정되어 있는지 확인
서비스 계정 확인
애널리틱스와 BigQuery를 연결하면 이러한 과정을 통해 다음과 같은 서비스 계정이 생성됩니다.
firebase-measurement@system.gserviceaccount.com
계정이 프로젝트의 구성원으로 추가되었고 계정에 BigQuery 사용자(roles/bigquery.user) 역할이 부여되었는지 확인합니다.
이전에 서비스 계정에 Google Cloud 프로젝트를 위한 편집자 역할을 부여하도록 BigQuery Export를 설정한 경우, 해당 역할을 BigQuery 사용자로 줄일 수 있습니다. 서비스 계정에 대한 역할을 변경하려면 애널리틱스 연결을 해제한 후 애널리틱스를 BigQuery 프로젝트에 다시 연결해야 합니다. 첫 단계로 애널리틱스와 BigQuery의 연결을 해제하고, 편집자 역할이 있는 서비스 계정을 삭제합니다. 그다음 위의 안내에 따라 애널리틱스와 BigQuery를 다시 연결하여 프로젝트에 대해 올바른 권한이 있는 새 서비스 계정을 만듭니다.
다시 연결한 후 서비스 계정에 기존 내보내기 데이터 세트에 대한 소유자(bigquery.dataOwner) 역할이 있는지 확인하세요. 데이터 세트의 액세스 정책을 확인하면 됩니다.
지역 변경
지역을 잘못 선택해서 연결을 생성한 후 변경해야 하는 경우:
- BigQuery 연결을 해제합니다(아래 참고).
- BigQuery의 다른 데이터 세트에 데이터를 백업합니다(이동 또는 복사).
- 기존 데이터 세트를 삭제합니다. 다음 단계에서 필요하니 이름을 기록해 둡니다.
- 방금 삭제한 데이터 세트와 동일한 이름으로 새 데이터 세트를 만들고 데이터 위치를 선택합니다.
- 새 데이터 세트를 firebase-measurement@system.gserviceaccount.com과 공유하고, 서비스 계정에 BigQuery 데이터 소유자 역할을 부여합니다.
- 백업 데이터를 새 데이터 세트에 복사합니다.
- 위 절차를 반복하여 BigQuery 연결을 새로 만듭니다.
위치를 변경하면 데이터에 공백이 생깁니다. 기존 연결 해제와 새 연결 생성 사이에 실행된 스트리밍 및 일일 데이터 내보내기는 처리되지 않습니다.
BigQuery 연결 해제하기
- 관리자의 제품 연결에서 BigQuery 링크를 클릭합니다.
- 해당 연결의 행을 클릭합니다.
- 오른쪽 상단에서
> 삭제를 클릭합니다.
> 삭제를 클릭합니다.BigQuery Export 한도
표준 GA4 속성의 일일 (일괄) 내보내기를 위한 BigQuery Export 한도는 이벤트 100만 개입니다. 스트리밍 내보내기의 경우 이벤트 수에 제한이 없습니다. 속성이 내보내기 한도를 지속적으로 초과하는 경우 일일 BigQuery Export가 일시중지되고 지난 날짜의 내보내기가 다시 처리되지 않습니다.
속성 편집자 및 관리자는 관리하는 속성이 일일 한도를 초과할 때마다 이메일 알림을 받습니다. 이 알림은 조치를 취하지 않을 경우 내보내기가 일시중지될 시점을 알려줍니다. 또한 표준 속성이 일일 이벤트 100만 개 한도를 크게 초과하는 경우 애널리틱스에서 즉시 일일 내보내기를 일시중지할 수 있습니다. 알림을 받았다면 일일 내보내기를 계속할 수 있도록 데이터 필터링 옵션(데이터 스트림 내보내기 및 이벤트 제외)을 활용하여 매일 내보내는 이벤트 수를 줄이세요.
360 속성과 함께 사용할 수 있는 더 높은 한도에 대해 자세히 알아보세요.
데이터 필터링
특정 데이터 스트림과 이벤트를 내보내기에서 제외하여 내보내기 크기를 제한하거나 BigQuery에서 원하는 이벤트만 내보낼 수 있습니다.
연결 프로세스에서 데이터 스트림 및 이벤트 제외
연결 프로세스에서 내보낼 데이터 스트림을 선택할 때 내보내기에서 제외할 이벤트도 선택할 수 있습니다. 연결 프로세스의 9단계를 참고하세요.
연결을 구성한 후 데이터 스트림 또는 이벤트 추가 또는 삭제
BigQuery 링크를 구성한 다음 데이터 스트림을 추가하거나 삭제하고 제외 목록에 이벤트를 추가하거나 삭제할 수 있습니다.
- 관리자의 제품 연결에서 BigQuery 링크를 클릭합니다.
- 링크를 수정할 프로젝트 행을 클릭합니다.
- 데이터 스트림 및 이벤트에서 데이터 스트림 및 이벤트 보기를 클릭합니다.
- 내보낼 데이터 스트림에 있는 내보낼 데이터 스트림을 추가로 선택하거나 목록에서 기존 데이터 스트림을 삭제할 수 있습니다.
- 제외할 이벤트 목록에서 추가를 클릭하여 기존 이벤트의 목록에서 선택하거나 이름으로 이벤트 지정을 클릭하여 기존 이벤트의 이름을 선택하거나 속성에서 아직 수집되지 않은 이벤트 이름을 지정합니다.
- 목록에서 이벤트를 삭제하려면 행 끝에 있는 빼기 기호를 클릭합니다.
가격 및 결제 정보
BigQuery에서는 스토리지 및 쿼리 처리라는 2가지 가격 책정 구성요소를 기준으로 사용 요금을 청구합니다. 가격 책정표를 검토하여 양방향 쿼리와 일괄 쿼리의 차이를 알아볼 수 있습니다.
내보내기를 계속하려면 클라우드에 유효한 결제 방법을 등록해야 합니다. 결제 수단이 유효하지 않아서 내보내기가 중단되면 해당 기간의 데이터를 다시 내보낼 수 없습니다.
애널리틱스 데이터를 BigQuery 샌드박스에 무료로 내보낼 수도 있지만 샌드박스 한도가 적용된다는 점에 유의하세요.
데이터 표시가 시작되는 시점
연결이 완료되면 24시간 이내에 데이터가 BigQuery 프로젝트로 전송되기 시작합니다. 일일 내보내기를 사용 설정하면 전날의 데이터가 포함된 1개의 파일이 매일 내보내기됩니다(일반적으로 보고서에 설정한 시간대의 이른 오후에).
연결 실패 이유
다음 두 가지 이유 중 하나로 인해 BigQuery 연결을 만들지 못할 수 있습니다.
- 조직 정책에 따라 미국으로 내보낼 수 없습니다. 데이터 위치로 미국을 선택한 경우 다른 위치를 선택하세요.
- 조직 정책에 따라 데이터를 내보내려는 도메인의 서비스 계정이 금지됩니다. 이 경우 조직 정책을 수정해야 합니다.
내보내기 실패 이유
| 실패 | 원인 | 결과 |
|---|---|---|
| 서비스 계정 없음 | Cloud 프로젝트에 사용자 역할이 있는 서비스 계정이 없습니다. | 애널리틱스에서 테이블을 만들 수 없습니다. 내보내기에 실패합니다. |
| 설치 후 로봇 계정이 삭제됨 | 클라우드 계정의 사용자가 Google 애널리틱스에서 설치한 로봇 서비스 계정을 삭제했습니다. | 애널리틱스에서 더 이상 테이블을 만들 수 없습니다. 모든 내보내기가 중지됩니다. |
| 조직 정책이 BigQuery Export와 충돌함 | 클라우드 프로젝트의 사용자가 애널리틱스에서 데이터를 내보내지 못하도록 하는 조직 정책을 만들었습니다. 이 정책은 BigQuery 테이블을 만들거나 테이블에 쓰는 것을 차단할 수 있습니다. 이 정책은 데이터 스토리지의 리전에도 반대할 수 있습니다. | 테이블이 만들어지지 않거나 만들어진 후에 빠르게 삭제됩니다(30분 이내). |
| 사용자가 결제 설정을 변경함 | 클라우드 프로젝트의 사용자가 무료 BigQuery 사용자에서 유료 BigQuery 사용자로 전환합니다. 이렇게 되면 일반적으로는 작동하지만 프로젝트가 이미 10GB를 초과하는 경우(샌드박스 한도) 오류가 발생할 수 있습니다. 실제로는 내보내기가 실패할 수 있습니다. | 테이블이 채워지지 않습니다. |
| 클라우드 프로젝트 할당량 초과 | 클라우드에는 대부분의 프로젝트에 한정된 리소스가 있습니다. BigQuery 스토리지 할당량을 초과하면 더 많은 데이터가 기록되지 않습니다. 이 할당량은 무료 프로젝트에 비해 작습니다(10GB). | 테이블이 채워지지 않습니다. |
| 사용자가 속성 시간대를 변경함 | 내보내기는 속성 시간대를 기준으로 속성의 24시간 스냅샷을 생성합니다. 시간대가 변경되면 내보내기 기간은 특정 일에 짧아지거나 길어질 수 있습니다(예: 시간대가 미국 동부 표준시에서 미국 태평양 표준시로 변경될 경우 3시간 단축). 두 경우 모두 사용자에게 비정상적인 이벤트 수가 표시됩니다. | 하루 동안의 비정상적인 이벤트 수입니다. 일반적으로 사용자에게 혼란이 발생합니다. |
지원
결제와 같은 BigQuery 관련 문제는 Google Cloud 지원에 문의하세요.
관련 자료
BigQuery Export
샘플 데이터 세트 내보내기 및 액세스 방법을 자세히 알아보려면 BigQuery Export 문서를 참고하세요.