Google Cloud Storage

Google Cloud Storage is massively scalable object storage for unstructured data offered by Google as part of the Cloud Computing product suite.

The Braze and Google Cloud Storage integration allows you to stream Currents data to Google Cloud Storage. You can later use an ETL process (Extract, Transform, Load) to transfer your data to other locations, such as Google BigQuery.

Prerequisites

통합

To integrate with Google Cloud Storage, you must set up the appropriate credentials that allow Braze to get information about the storage buckets being written to (storage.buckets.get) and create objects within that bucket (storage.objects.create).

This can be done using the following instructions, which will walk you through creating a role and service account that will generate a private key to use in your Currents integration.

1단계: Create role

IAM & 관리자 > 역할 > + 역할 만들기로 이동하여 Google Cloud Platform 콘솔에서 새 역할을 만듭니다.

Give the role a name, then select +Add Permissions and choose the following:

• storage.objects.create
• storage.objects.delete
• storage.objects.list
• storage.objects.get
• storage.buckets.get

When you’re finished, select Create.

2단계: Create a new service account

2.1 단계: Create the service account

IAM & 관리자 > 서비스 계정으로 이동하여 서비스 계정 만들기를 선택하여 Google Cloud Platform 콘솔에서 새 서비스 계정을 만듭니다.

Next, give the service account a name and grant it access to your newly created custom role.

2.2 단계: Create a key

At the bottom of the page, use the Create Key button to create a JSON private key to use in Braze. After the key is created, it will download onto your machine.

3단계: Set up Currents in Braze

In Braze, navigate to Currents > + Create Current > Google Cloud Storage Data Export and provide your integration name and contact email.

그런 다음 GCS JSON 자격 증명 아래에 JSON 비공개 키를 업로드하고 GCS 버킷 이름과 GCS 접두사(선택 사항)를 입력합니다. 이전 단계에서 설명한 대로 Google Cloud Platform을 통해 이러한 자격 증명을 생성해야 한다는 점에 유의하세요.

마지막으로 페이지 하단으로 스크롤하여 내보내려는 메시지 참여 이벤트 또는 고객 행동 이벤트를 선택합니다. When completed, launch your Current.

4단계: Set up Google Cloud Storage exports

To set up Google Cloud Storage (GCS) exports, go to Technology Partners > Google Cloud Storage, enter your GCS credentials, and select Make this the default data export destination.

Keep in mind that the organization and contents of any exported files will be identical across AWS S3, Microsoft Azure, and Google Cloud Storage integrations.

5단계: Test your service account credentials (optional)

Your Google Cloud IAM service account must have the following permissions:

• storage.objects.create
• storage.objects.delete
• storage.objects.list
• storage.objects.get
• storage.buckets.get

To verify these permissions in the Braze dashboard, go to the Google Cloud Storage page, then select Test Credentials.

Export behavior

클라우드 데이터 스토리지 솔루션을 통합하고 API, 대시보드 보고서 또는 CSV 보고서를 내보내려고 하는 사용자는 다음과 같은 경험을 하게 됩니다:

• All API exports will not return a download URL in the response body and must be retrieved through data storage.
• 모든 대시보드 보고서와 CSV 보고서는 다운로드할 수 있도록 사용자의 이메일로 전송되며(저장 권한 필요 없음) 데이터 스토리지에 백업됩니다.

문제 해결

Google Cloud Storage Credentials are invalid

If you receive the following error when attempting enter your credentials:

1
Google Cloud Storage Credentials are invalid. Please ensure that your credentials string, bucket name, and prefix are valid. You do not have read permission.

Ensure that your Google Cloud IAM service account has the following permissions:

• storage.objects.create
• storage.objects.delete
• storage.objects.list
• storage.objects.get
• storage.buckets.get

After verifying, you can test your credentials in the Braze dashboard.