Google Cloud Storage
Google Cloud Storage는 Google이 클라우드 컴퓨팅 제품군의 일부로 제공하는 비정형 데이터를 위한 대규모 확장 가능한 오브젝트 스토리지입니다.
클라우드 스토리지 제공업체 간에 전환하는 경우, 새로운 통합을 설정하고 검증하는 데 대한 추가 지원을 받으려면 Braze 고객 성공 매니저에게 문의하세요.
Braze와 Google Cloud Storage 통합을 사용하면 Currents 데이터를 Google Cloud Storage로 스트리밍할 수 있습니다. 이후 ETL 프로세스(Extract, Transform, Load)를 사용하여 Google BigQuery 등 다른 위치로 데이터를 전송할 수 있습니다.
사전 요구 사항
| 요구 사항 | 설명 |
|---|---|
| Google Cloud Storage 계정 | 이 파트너십을 활용하려면 Google Cloud Storage 계정이 필요합니다. |
| Currents | 데이터를 Google Cloud Storage로 다시 내보내려면 계정에 Braze Currents를 설정해야 합니다. 메시지 아카이빙만 설정하는 경우에는 Currents가 필요하지 않습니다. |
통합
Google Cloud Storage와 통합하려면 Braze가 기록 중인 스토리지 버킷에 대한 정보를 가져오고(storage.buckets.get) 해당 버킷 내에 객체를 생성할 수 있도록(storage.objects.create) 적절한 자격 증명을 설정해야 합니다.
Workload Identity Federation(WIF)은 Currents의 인증 방법으로 지원되지 않습니다. JSON 비공개 키가 포함된 서비스 계정을 사용해야 합니다.
아래 안내에 따라 역할과 서비스 계정을 생성하면 커런츠 통합에 사용할 비공개 키가 생성됩니다.
1단계: 역할 생성
Google Cloud Platform 콘솔에서 IAM & admin > Roles > + Create Role로 이동하여 새 역할을 생성합니다.
역할에 이름을 지정한 다음 +Add Permissions를 선택하고 다음 권한을 선택합니다:
storage.objects.createstorage.objects.deletestorage.objects.liststorage.objects.getstorage.buckets.get
storage.objects.delete 권한은 선택 사항입니다. 이 권한을 통해 Braze가 불완전한 파일을 정리할 수 있습니다.
드문 경우지만 Google Cloud가 연결을 조기에 종료하여 Braze가 Google Cloud Storage에 불완전한 파일을 기록할 수 있습니다. 대부분의 경우 Braze는 재시도하여 올바른 데이터가 포함된 새 파일을 생성하며, 이전 파일은 Google Cloud Storage에 남아 있게 됩니다.
버킷이 계층적 네임스페이스를 사용하는 경우 storage.folders.create 권한도 추가해야 합니다. 이러한 버킷에서는 폴더가 관리 리소스이므로 Braze가 내보낸 파일의 폴더 구조를 생성하려면 이 권한이 필요합니다. 이 권한이 없으면 Braze가 버킷에 쓸 수 없으며 통합이 데이터를 내보내지 못합니다.
완료되면 Create를 선택합니다.
2단계: 새 서비스 계정 생성
2.1단계: 서비스 계정 생성
Google Cloud Platform 콘솔에서 IAM & admin > Service Accounts로 이동한 다음 Create Service Account를 선택하여 새 서비스 계정을 생성합니다.
다음으로 서비스 계정에 이름을 지정하고 새로 생성한 커스텀 역할에 대한 액세스 권한을 부여합니다.
2.2단계: 키 생성
페이지 하단에서 Create Key 버튼을 사용하여 Braze에서 사용할 JSON 비공개 키를 생성합니다. 키가 생성되면 컴퓨터에 다운로드됩니다.
3단계: Braze에서 Currents 설정
Braze에서 Currents > + Create Current > Google Cloud Storage Data Export로 이동하여 통합 이름과 연락처 이메일을 입력합니다.
통합 오류 알림을 받을 연락처 이메일을 입력하세요. 자격 증명 문제나 연결 문제 등 통합에서 오류가 발생하면 Braze가 이 주소로 알림을 보냅니다. 적절한 담당자가 알림을 받을 수 있도록 배포 목록이나 그룹 이메일 주소를 사용하는 것이 좋습니다.
다음으로 GCS JSON Credentials 아래에 JSON 비공개 키를 업로드하고 GCS 버킷 이름과 GCS 접두사(선택 사항)를 입력합니다. 이전 단계에서 설명한 대로 Google Cloud Platform을 통해 이러한 자격 증명을 생성해야 합니다.
자격 증명 파일을 최신 상태로 유지하는 것이 중요합니다. 커넥터의 자격 증명이 만료되면 커넥터가 이벤트 전송을 중지합니다. 이 상태가 5일 이상 지속되면 커넥터의 이벤트가 삭제되고 데이터가 영구적으로 손실됩니다.
마지막으로 페이지 하단으로 스크롤하여 내보내려는 메시지 인게이지먼트 이벤트 또는 고객 행동 이벤트를 선택합니다. 완료되면 Current를 시작합니다.
4단계: Google Cloud Storage 내보내기 설정
Google Cloud Storage(GCS) 내보내기를 설정하려면 기술 파트너 > Google Cloud Storage로 이동하여 GCS 자격 증명을 입력하고 Make this the default data export destination을 선택합니다.
내보낸 파일의 구성과 내용은 AWS S3, Microsoft Azure 및 Google Cloud Storage 통합 전반에서 동일합니다.
5단계: 서비스 계정 자격 증명 테스트(선택 사항)
Google Cloud IAM 서비스 계정에는 다음 권한이 있어야 합니다:
storage.objects.createstorage.objects.deletestorage.objects.liststorage.objects.getstorage.buckets.get
Braze 대시보드에서 이러한 권한을 확인하려면 Google Cloud Storage 페이지로 이동한 다음 Test Credentials를 선택합니다.
내보내기 동작
클라우드 데이터 스토리지 솔루션을 통합한 사용자가 API, 대시보드 보고서 또는 CSV 보고서를 내보내려고 하면 다음과 같은 동작이 발생합니다:
- 모든 API 내보내기는 응답 본문에 다운로드 URL을 반환하지 않으며, 데이터 스토리지를 통해 검색해야 합니다.
- 모든 대시보드 보고서 및 CSV 보고서는 사용자의 이메일로 전송되어 다운로드할 수 있으며(스토리지 권한 불필요), 데이터 스토리지에 백업됩니다.
JSON 형식 요구 사항: JSON 내보내기의 경우, Braze는 JSONL(줄바꿈으로 구분된 JSON) 형식을 사용하며, 각 줄에 별도의 JSON 객체가 포함됩니다. 이 형식은 단일 JSON 배열 또는 객체인 표준 JSON과 다릅니다. 내보낸 파일의 각 줄은 유효한 JSON 객체이지만, 파일 전체는 단일 유효 JSON 문서가 아닙니다. 이러한 파일을 처리할 때는 전체 파일을 단일 JSON 문서로 파싱하려고 하지 말고, 각 줄을 별도의 JSON 객체로 개별 파싱하세요.
Currents 내보내기는 JSON이 아닌 Apache Avro 형식(.avro 파일)을 사용합니다. 이 JSON 형식 요구 사항은 대시보드 데이터 내보내기 및 JSON 형식을 사용하는 API 내보내기에 적용됩니다.
문제 해결
Google Cloud Storage 자격 증명이 유효하지 않음
자격 증명을 입력하려고 할 때 다음 오류가 표시되는 경우:
Google Cloud Storage Credentials are invalid. Please ensure that your credentials string, bucket name, and prefix are valid. You do not have read permission.
Google Cloud IAM 서비스 계정에 다음 권한이 있는지 확인합니다:
storage.objects.createstorage.objects.deletestorage.objects.liststorage.objects.getstorage.buckets.get
확인한 후 Braze 대시보드에서 자격 증명을 테스트할 수 있습니다.