에어브릿지는 구글 클라우드 스토리지(Google Cloud Storage, GCS) 연동을 지원합니다. 연동을 완료하면 에어브릿지 앱, 웹 SDK와 트래킹 링크에서 수집한 이벤트의 원본 데이터를 구글 클라우드 스토리지에서 확인할 수 있습니다. 에어브릿지 이벤트의 원본 데이터는 일별로 구글 클라우드 스토리지에 전송됩니다. 구글 클라우드 스토리지로 전송된 데이터는 목적에 맞게 원하는 형태로 활용할 수 있습니다.

구글 클라우드 스토리지(Google Cloud Storage)와 연동하기 위해서는 아래 정보를 에어브릿지 대시보드에 입력해야 합니다.

• 클라이언트 이메일(Client Email)

• 프라이빗 키(Private Key)

• 버킷 이름(Bucket Name)

클라이언트 이메일과 프라이빗 키는 구글 클라우드 스토리지 대시보드에서 JSON 파일로 다운로드할 수 있습니다. 버킷 이름은 구글 클라우드 스토리지 대시보드에서 버킷을 생성할 때 지정할 수 있습니다.

구글 클라우드 스토리지 대시보드에서 에어브릿지 대시보드에 입력할 클라이언트 이메일과 프라이빗 키를 JSON 파일 형태로 다운로드합니다.

1. 구글 클라우드 콘솔(Console) 대시보드에 로그인하고 [IAM 및 관리자]를 선택합니다.

2. [서비스 계정]에서 ‘서비스 계정 만들기’를 클릭합니다.

3. 서비스 계정을 생성합니다.

4. 생성한 서비스 계정의 ‘작업’에서 ‘키 관리’를 클릭합니다.

5. ‘키 추가’에서 ‘새 키 만들기’를 클릭합니다.

6. JSON 형식으로 키를 다운로드합니다. 해당 키는 클라이언트 이메일과 프라이빗 키를 포함합니다.

구글 클라우드 스토리지 대시보드에서 에어브릿지 이벤트 데이터를 받기 위한 버킷을 생성합니다. 버킷을 생성하는 과정에서 지정한 버킷 이름은 에어브릿지 대시보드에서 동일하게 사용됩니다.

1. 구글 클라우드 콘솔(Console) 대시보드에서 탐색 메뉴 아이콘을 클릭해 [Cloud Storage]>[버킷]을 선택합니다.

2. ‘만들기’ 또는 ‘버킷 만들기’를 클릭합니다.

3. 버킷을 생성합니다. 버킷 만들기에서 지정한 버킷 이름은 에어브릿지 대시보드에서 동일하게 사용되므로 주의해 주세요.

4. 버킷 세부정보의 [권한]에서 ‘액세스 권한 부여’를 클릭합니다.

5. 주 구성원 추가에 새 주 구성원으로 client_email을 입력합니다.

클라이언트 이메일은 구글 클라우드 스토리지에서 연동 정보를 생성하며 다운로드한 JSON 파일에서 확인할 수 있습니다. client_email의 값을 ”, “를 제외하고 입력해 주세요.

6. 새로 추가한 주 구성원에 역할을 지정하기 위해 ‘역할 선택’을 클릭합니다.

7. Cloud Storage에서 저장소 개체 관리자 역할을 지정하고 저장합니다.

에어브릿지 대시보드에 구글 클라우드 스토리지에서 생성한 연동 정보를 입력합니다. 필요한 연동 정보는 아래와 같습니다.

• 클라이언트 이메일(Client Email)

• 프라이빗 키(Private Key)

• 버킷 이름(Bucket Name)

필요한 연동 정보를 모두 준비하지 않았다면 이전 단계부터 진행해 주세요.

1. 에어브릿지 대시보드 [연동]>[서드파티 연동]에서 ‘Google Cloud Storage’를 클릭합니다.

2. 클라이언트 이메일(Client Email)과 프라이빗 키(Private Key)에는 구글 클라우드 스토리지에서 연동 정보를 생성한 후에 다운로드한 JSON 파일에 포함된 값을 입력합니다. 클라이언트 이메일에는 client_email을 입력합니다. 프라이빗 키에는 private_key를 입력합니다. client_email과 private_key 값에 있는 ”, “를 제외하고 입력해야 합니다.

에어브릿지에 입력하는 프라이빗 키에는 ----BEGIN PRIVATE KEY-----\n부터 ----END PRIVATE KEY-----\n까지 포함됩니다. ----BEGIN PRIVATE KEY-----\n부터 ----END PRIVATE KEY-----\n까지 포함되지 않은 프라이빗 키를 입력하면 정상적으로 연동되지 않습니다.

3. 에어브릿지 대시보드에서 버킷 이름(Bucket Name)에는 연동하고 싶은 버킷의 이름을 입력합니다. 구글 클라우드 스토리지 대시보드 [Cloud Storage]>[버킷]에서 버킷 이름을 확인할 수 있습니다. 구글 클라우드 스토리지 대시보드의 버킷 세부정보에서 아래 표시된 아이콘으로 버킷 이름을 복사할 수 있습니다.

4. CSV와 Parquet 방식 중 원하는 연동 포맷을 선택하고 ‘등록’을 클릭합니다.

연동 정보를 수정하거나 삭제하고 싶다면 아래 내용을 확인해 보세요.

데이터 스토리지의 연동 오류 대응하기

연동 정보를 입력하면 데이터 소스별로 연동 상태를 상태 메시지에서 확인할 수 있습니다. 확인할 수 있는 데이터 소스별 상태 메시지와 데이터 스토리지의 연동 주기는 아래와 같습니다.

데이터 스토리지의 데이터 소스별 상태 메시지

데이터 스토리지의 연동 상태 확인하기

아래 사항을 주의해 주세요.