Google Cloud Storage
Google Cloud Storage は、Google が Cloud Computing 製品群の一部として提供する、非構造化データのための大規模拡張可能オブジェクトストレージソリューションです。
Braze と Google Cloud Storage の統合により、Currents データを Google Cloud Storage にストリーミングできます。その後、ETL プロセス (抽出、変換、読み込み) を使用して、データを Google BigQuery などの他の場所に転送できます。
前提条件
必要条件 | 説明 |
---|---|
Google Cloud Storage アカウント | このパートナーシップを活用するには、Google Cloud Storage アカウントが必要です。 |
Currents | Google Cloud Storage にデータを再度エクスポートするには、アカウントに Braze Currents を設定する必要があります。 |
統合
Google Cloud Storage と統合するには、Braze が書き込み先のストレージバケット (storage.buckets.get
) に関する情報を取得し、そのバケット (storage.objects.create
) 内にオブジェクトを作成できるように、適切な認証情報を設定する必要があります。
これを行うには次の手順に従います。この手順では、Currents 統合で使用する秘密キーを生成するロールとサービスアカウントを作成する手順を説明します。
ステップ1:役割を作成する
[IAM & admin] > [Roles] > [+ Create Role] に移動して、Google Cloud Platform Console に新しいロールを作成します。
次に、ロールに名前を付け、[+Add Permissions] を選択し、storage.buckets.get
、storage.objects.create
、storage.objects.get
を追加します。次に [Create] を選択します。
必要に応じて storage.objects.delete
権限を追加して、Braze が不完全なファイルをクリーンアップできるようにします。まれに Google Cloud が接続を早期に終了し、Braze が Google Cloud Storage に不完全なファイルを書き込むことがあります。通常の状況では、Braze は再試行し、正しいデータを含む新しいファイルを作成しますが、古いファイルは Google Cloud Storage に残ります。
ステップ2:サービスアカウントを作成する
[IAM & admin] > [Service Accounts] に移動し、[Create Service Account] を選択して、Google Cloud Platform Console で新しいサービスアカウントを作成します。
次に、サービスアカウントに名前を付け、新しく作成したカスタムロールへのアクセス権を付与する。
キーを作成する
ページ下部の「Create Key」ボタンで、Brazeで使用するJSON秘密鍵を作成する。キーが作成されると、あなたのマシンにダウンロードされる。
ステップ3:Braze で Currents を設定する
Braze で [Currents] > [+ Current を作成] > [Google Cloud Storage データのエクスポート] に移動し、統合名と連絡先メールを入力します。
次に [GCS JSON 認証情報] で JSON 秘密キーをアップロードし、GCS バケット名と GCS 接頭辞 (オプション) を指定します。
認証情報ファイルを最新の状態に維持することが重要です。コネクターの認証情報の有効期限が切れると、コネクターはイベントの送信を停止します。この状態が48時間以上続くと、コネクタのイベントは削除され、データは永久に失われる。
最後に、ページの一番下までスクロールし、エクスポートしたいメッセージ・エンゲージメント・イベントまたは顧客行動イベントを選択する。完了したら、Current を起動します。
ステップ4:Google Cloud Storage (GCS) エクスポートを設定する
Google Cloud Storage (GCS) エクスポートを設定するには、[Technology Partners] > [Google Cloud Storage] に移動し、GCS 認証情報を入力し、[Make this the default data export destination] を選択します。
GCS JSON 認証情報は、Google Cloud ドキュメント の手順に従って生成されます。必ず、生成されたJSON値全体を入力すること。
対応するGoogle Cloud IAMサービスアカウントには、以下の権限が必要である(これは、BrazeのGoogle Cloud StorageページでTest Credentialsボタンを選択することで確認できる):
storage.objects.create
storage.objects.delete
storage.objects.get
storage.objects.list
エクスポートされたファイルの構成と内容は、AWS S3、Microsoft Azure、および Google Cloud Storage の各統合で同一です。
エクスポートの動作
クラウドデータストレージソリューションを統合しており、API、ダッシュボードレポート、または CSV レポートをエクスポートする場合、次のような状況が発生します。
- すべての API エクスポートでは、応答本文でダウンロード URL が返されないため、データストレージから取得する必要があります。
- すべてのダッシュボードレポートと CSV レポートは、ダウンロード用のメールでユーザーに送信され (保存権限は不要です)、Data Storage にバックアップされます。