구글 클라우드 스토리지

에어브릿지는 구글 클라우드 스토리지(Google Cloud Storage, GCS) 연동을 지원합니다. 연동을 완료하면 에어브릿지 앱·웹 SDK와 트래킹 링크로 수집된 이벤트의 원본 데이터를 구글 클라우드 스토리지에서 확인할 수 있습니다. 구글 클라우드 스토리지로 전송할 이벤트와 프로퍼티를 직접 선택할 수 있으며, 전날 수집된 데이터는 매일 KST(한국표준시) 오전 4시 경에 전송됩니다. 

주의하세요

2026년 5월 28일 이후 새로 생성되거나 수정된 커넥션은 폴더 경로의 ${VERSION} 값이 3.0으로 고정됩니다. 기존에 연동되어 있던 커넥션의 경우, 변경사항이 없으면 버전 값이 유지됩니다.

구글 클라우드 콘솔에서 서비스 계정, 키, 버킷을 생성할 수 있는 권한이 필요합니다.

구글 클라우드 스토리지 연동은 4단계로 진행됩니다.

1. 커넥션 설정: 연동 정보를 입력하고 커넥션을 테스트합니다.

2. 이벤트 선택: 구글 클라우드 스토리지로 전송할 이벤트를 선택합니다.

3. 프로퍼티 선택: 전송할 이벤트의 프로퍼티를 선택합니다.

4. 요약 확인 및 커넥션 추가: 선택한 이벤트와 프로퍼티를 확인하고 커넥션을 추가합니다. 

커넥션을 생성하려면 구글 클라우드 콘솔에서 아래 정보를 확인해야 합니다.

• 클라이언트 이메일

• 프라이빗 키

• 버킷 이름

클라이언트 이메일과 프라이빗 키는 구글 클라우드 콘솔 서비스 계정을 만들고 JSON 파일을 다운로드해 확인합니다. 버킷 이름은 버킷을 생성할 때 지정합니다.

서비스 계정을 만들고 JSON 파일을 다운로드해서 클라이언트 이메일과 프라이빗 키를 확보합니다.

1. 구글 클라우드 콘솔에 로그인하고 [IAM 및 관리자]를 선택하세요.

2. [서비스 계정]에서 '서비스 계정 만들기'를 클릭하세요.

3. 서비스 계정을 생성하세요.

4. 생성한 서비스 계정의 [작업]에서 '키 관리'를 클릭하세요.

5. [키 추가]에서 '새 키 만들기'를 클릭하고 JSON 형식으로 파일을 다운로드하세요. 다운로드한 JSON 파일에는 클라이언트 이메일(client_email)과 프라이빗 키(private_key)가 포함되어 있습니다.

에어브릿지 데이터를 전송 받을 버킷을 생성하고, 서비스 계정에 접근 권한을 부여합니다.

1. 구글 클라우드 콘솔에서 탐색 메뉴 아이콘을 클릭해 [Cloud Storage]>[버킷]을 선택하세요.

2. '만들기' 또는 '버킷 만들기'를 클릭하세요.

3. 버킷을 생성하세요. 버킷 이름은 에어브릿지 대시보드에서 동일하게 사용됩니다.

4. 버킷 세부 정보의 [권한]에서 '액세스 권한 부여'를 클릭하세요.

5. 다운로드한 JSON 파일의 client_email 값을 [주 구성원 추가]에 새로운 주 구성원으로 큰따옴표(") 없이 입력하세요.

6. [역할 선택]을 클릭하고, 새로 추가한 주 구성원의 역할을 Cloud Storage > 저장소 개체 관리자로 지정하고 저장하세요.

구글 클라우드 콘솔에서 확인한 연동 정보를 에어브릿지 대시보드에 입력합니다.

1. 에어브릿지 대시보드의 [연동]>[서드파티 연동]에서 'Google Cloud Storage'를 클릭하세요.

2. '커넥션 추가'를 클릭하세요.

3. [클라이언트 이메일]에 다운로드한 JSON 파일의 client_email 값을, [프라이빗 키]에 private_key 값을 큰따옴표(") 없이 입력하세요.

   주의하세요

   프라이빗 키는 -----BEGIN PRIVATE KEY-----\n부터 -----END PRIVATE KEY-----\n까지 전체를 포함해야 합니다. 일부가 누락되면 정상적으로 연동되지 않으니 주의하세요.

4. 구글 클라우드 콘솔에서 확인한 버킷 이름을 입력하세요.

5. CSV와 Parquet 중 원하는 연동 포맷을 선택하고 '등록'을 클릭하세요.

입력한 정보로 구글 클라우드 스토리지와 연동할 수 있는지 테스트합니다.

1. 에어브릿지 대시보드에서 '커넥션 테스트'를 클릭하세요.

2. 연결에 성공하면 오른쪽 하단의 '다음'을 클릭해서 이벤트 선택 단계로 이동하세요.

커넥션 테스트에 실패하면 입력한 정보가 올바른지 확인하고 다시 테스트해 주세요. 커넥션 테스트를 완료하지 않고 페이지를 떠나면 모든 연동 과정을 처음부터 다시 진행해야 합니다.

구글 클라우드 스토리지로 전송할 이벤트를 선택합니다. 에어브릿지에 한 번이라도 수집된 이벤트만 선택할 수 있습니다.

1. 전송할 이벤트를 앱, 웹, 트래킹 링크 등 카테고리별로 선택하세요.

2. 오른쪽 하단의 '다음'을 클릭하세요.

알립니다

커넥션을 생성한 이후 최초로 발생한 이벤트는 전송 대상으로 추가하기 전까지는 전송되지 않습니다.

선택한 이벤트에 대해 구글 클라우드 스토리지로 전송할 프로퍼티를 선택합니다.

1. 전송할 프로퍼티를 카테고리별로 선택하세요.

2. 오른쪽 하단의 '다음'을 클릭하세요.

알립니다

필수 프로퍼티는 선택을 해제할 수 없습니다.

선택한 이벤트와 프로퍼티를 확인하고 커넥션을 추가합니다.

1. [전송 이벤트 목록]과 [전송 프로퍼티 목록]을 확인하세요. 수정이 필요하면 오른쪽 끝에 있는 '수정하러 가기'를 클릭하세요.

2. [데이터 전송 상태]에서 데이터 소스별 전송 상태를 확인하세요.

3. 오른쪽 하단의 '적용'을 클릭하면 커넥션이 생성됩니다.

데이터 전송 상태는 에어브릿지 대시보드의 아래 페이지에서 확인할 수 있습니다.

데이터 전송 상태 메시지의 구체적인 의미는 아래 표를 참고하세요.

에어브릿지는 항상 KST(한국표준시) 오전 4시 경에 앱 타임존 기준 전날 데이터를 전송합니다. 구글 클라우드 스토리지 연동 설정을 완료하면 다음 날부터 데이터가 연동한 버킷의 아래 위치로 전송됩니다.

• 앱 이벤트:

  ${YOUR-BUCKET-NAME}/${YOUR-APP-NAME}/app/${VERSION}/date=${year}-${month}-${day}/

• 웹 이벤트:

  ${YOUR-BUCKET-NAME}/${YOUR-APP-NAME}/web/${VERSION}/date=${year}-${month}-${day}/

• 트래킹 링크 이벤트:

  ${YOUR-BUCKET-NAME}/${YOUR-APP-NAME}/tracking-link/${VERSION}/date=${year}-${month}-${day}/

전송되는 파일에는 선택한 프로퍼티만 포함됩니다. 프로퍼티 선택을 변경하면 파일의 열 순서가 변경될 수 있으므로, 항상 열 이름을 기준으로 데이터를 확인하세요. 

주의하세요

2026년 5월 28일 이후 새로 생성되거나 수정된 커넥션은 폴더 경로의 ${VERSION} 값이 3.0으로 고정됩니다. 기존에 연동되어 있던 커넥션의 경우, 변경사항이 없으면 버전 값이 유지됩니다.

연동 정보를 수정하거나 삭제하려면 아래 내용을 참고하세요.

구글 클라우드 스토리지 연동 정보가 변경됐다면 아래 순서에 따라 수정해야 합니다.

1. 에어브릿지 대시보드의 [연동]>[서드파티 연동]에서 'Google Cloud Storage'를 클릭하세요.

2. 구글 클라우드 스토리지 연동 정보가 변경된 커넥션을 클릭하세요.

3. 수정하고 싶은 연동 정보를 클릭하고 새로운 값을 입력하세요.

4. 입력을 마치면 '수정 완료'를 클릭하세요.

클라이언트 이메일, 프라이빗 키, 버킷 이름, 연동 포맷을 수정한 경우 커넥션 테스트를 다시 진행해야 합니다.

1. 에어브릿지 대시보드의 [연동]>[서드파티 연동]에서 'Google Cloud Storage'를 클릭하세요.

2. 삭제할 커넥션의 삭제 아이콘을 클릭하세요.

3. 확인 문구를 입력하고 '삭제'를 클릭하세요.

커넥션을 삭제하면 즉시 데이터 전송이 중단됩니다. 단, 커넥션을 삭제해도 이미 구글 클라우드 스토리지로 전송된 데이터는 구글 클라우드 스토리지에서 삭제되지 않습니다.

연동 설정 상태는 에어브릿지 대시보드 [연동]>[연동 현황]에서 확인할 수 있습니다. 연동 설정에 오류가 발생한 경우 연동 상태 확인하기 가이드를 참고해 조치해 주세요.

에어브릿지가 기본으로 연동을 지원하는 데이터 스토리지 개수는 1개입니다. 2개 이상 스토리지에 연동하려면 추가 비용이 발생합니다.

이벤트와 프로퍼티를 포함한 데이터 전송 조건을 수정하면, 구글 클라우드 스토리지 저장 경로의 ${VERSION} 값이 3.0으로 변경되어 기존 위치에서 데이터를 추출할 수 없게 됩니다. 새로운 경로인 3.0을 사용해도 문제가 없는지 사내 구글 클라우드 스토리지 담당자와 사전에 확인하세요.