Google Cloud Storage
Google Cloud Storage は、Google が Cloud Computing 製品群の一部として提供する、非構造化データのための大規模拡張可能オブジェクトストレージソリューションです。
クラウドストレージプロバイダーを切り替える場合は、Brazeカスタマーサクセスマネージャーに連絡し、新しい統合の設定と検証についてさらにサポートを受けてください。
Braze と Google Cloud Storage の統合により、Currents データを Google Cloud Storage にストリーミングできます。その後、ETL プロセス (抽出、変換、読み込み) を使用して、データを 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) 内にオブジェクトを作成できるように、適切な認証情報を設定する必要があります。
ワークロード ID フェデレーション（WIF）は、カレントの認証方法としてサポートされていない。JSON秘密キーを持つサービス・アカウントを使用しなければならない。
これを行うには次の手順に従います。この手順では、Currents 統合で使用する秘密キーを生成するロールとサービスアカウントを作成する手順を説明します。
ステップ1:役割を作成する
Google Cloud Platform Consoleで、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 に残します。
完了したら、[Create] を選択します。
ステップ 2: 新しいサービスアカウントを作成する
ステップ 2.1: サービスアカウントを作成する
Google Cloud Platform Consoleで、IAM& admin>Service Accountsに移動し、Create Service Accountを選択して新しいサービスアカウントを作成する。
次に、サービスアカウントに名前を付け、新しく作成したカスタムロールへのアクセス権を付与する。
ステップ 2.2:キーを作成する
ページ下部の「Create Key」ボタンで、Brazeで使用するJSON秘密鍵を作成する。キーが作成されると、あなたのマシンにダウンロードされる。
ステップ 3:Braze で Currents を設定する
Braze で [Currents] > [+ Current を作成] > [Google Cloud Storage データのエクスポート] に移動し、統合名と連絡先メールを入力します。
次に、GCS JSON認証情報の下にJSON秘密キーをアップロードし、GCSバケット名とGCSプレフィックス（オプション）を入力する。この認証情報は、前のステップで説明したように、Google Cloud Platformを通じて生成する必要がある。
認証情報ファイルを最新の状態に維持することが重要です。コネクターの認証情報の有効期限が切れると、コネクターはイベントの送信を停止します。この状態が5日以上続くと、コネクタのイベントは削除され、データは永久に失われる。
最後に、ページの一番下までスクロールし、エクスポートしたいメッセージ・エンゲージメント・イベントまたは顧客行動イベントを選択する。完了したら、Current を起動します。
ステップ 4: Google Cloud Storage のエクスポートの設定
Google Cloud Storage (GCS) エクスポートを設定するには、[Technology Partners] > [Google Cloud Storage] に移動し、GCS 認証情報を入力し、[Make this the default data export destination] を選択します。
エクスポートされたファイルの構成と内容は、AWS S3、Microsoft Azure、Google Cloud Storage の統合間で同一であることに留意します。
必ず、Google Cloud で生成された JSON の値をすべて入力してください。
ステップ 5: サービスアカウントの認証情報のテスト (オプション)
Google Cloud IAM サービスアカウントには必要な権限は以下のとおりです。
storage.objects.createstorage.objects.deletestorage.objects.liststorage.objects.getstorage.buckets.get
Braze ダッシュボードでこれらの権限を確認するには、[Google Cloud Storage] ページに移動して、[認証情報のテスト] を選択します。
エクスポートの動作
クラウド・データ・ストレージ・ソリューションを統合し、API、ダッシュボード・レポート、CSVレポートをエクスポートしようとしているユーザーには、次のような問題が発生する：
- すべての API エクスポートでは、応答本文でダウンロード URL が返されないため、データストレージから取得する必要があります。
- すべてのダッシュボード・レポートとCSVレポートは、ユーザーのメールに送信されてダウンロードされ（保存権限不要）、データ・ストレージにバックアップされる。
JSONフォーマットの要件：JSONエクスポートでは、BrazeはJSONL（改行区切りのJSON）フォーマットを使用し、各行に個別のJSONオブジェクトが含まれる。このフォーマットは、単一のJSON配列またはオブジェクトである標準的なJSONとは異なる。エクスポートされたファイルの各行は有効なJSONオブジェクトだが、ファイル全体としては1つの有効なJSONドキュメントではない。これらのファイルを処理するときは、ファイル全体を1つのJSONドキュメントとしてパースするのではなく、各行を個別のJSONオブジェクトとしてパースする。
カレントのエクスポートは、JSONではなく、Apache Avroフォーマット（.avro ファイル）を使用する。このJSONフォーマットの要件は、JSONフォーマットを使用するダッシュボード・データ・エクスポートおよびAPIエクスポートに適用される。
トラブルシューティング
Google Cloud Storage の認証情報が無効である。
認証情報を入力しようとすると、以下のエラーが表示される
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.
Google Cloud IAM サービスアカウントに以下の権限があることを確認してください。
storage.objects.createstorage.objects.deletestorage.objects.liststorage.objects.getstorage.buckets.get
認証後に、Braze ダッシュボードで認証情報をテストできます。
GitHub でこのページを編集