Brazeクラウドデータ取り込み
Brazeクラウドデータ取り込み(CDI)を使用すると、データストレージソリューションからBrazeへの直接接続を設定して、関連するユーザーデータやその他の非ユーザーデータを同期できます。このデータは、マーケティングユースケースを強化するためのパーソナライゼーションやセグメンテーションに活用できます。クラウドデータ取り込みの柔軟な統合は、ネストされたJSONやオブジェクトの配列を含む複雑なデータ構造をサポートしています。
仕組み
Brazeクラウドデータ取り込み(CDI)を使用すると、データウェアハウスインスタンスとBrazeワークスペース間の連携を設定し、スケジュールまたはオンデマンドでデータを同期できます。各連携にはそれぞれ独自のスケジュールを設定できます。
- スケジュールされた同期: 定期的な同期は5分ごとから月1回まで設定できます。デフォルトでは、ダッシュボードで設定できる最短間隔は15分で、ウェアハウスのコンピューティングコストとリクエスト量を管理するのに役立ちます。5分ごとに同期するには、Brazeサポートまたはカスタマーサクセスマネージャーにお問い合わせください。
- オンデマンド同期: データが変更されたらすぐに同期するには、ウェアハウスの読み込みまたは変換ジョブが完了した際に、連携IDを指定して同期のトリガーエンドポイントを呼び出します。オンデマンド同期は定期的なスケジュールに影響しません。1つの連携につき同時に実行できる同期は1つだけです。
ファイルストレージ連携(Amazon S3、Azure Blob Storage、Google Cloud Storage)はイベント駆動型であり、スケジュールを使用しません。Brazeは新しいファイルがアップロードされると取り込みます。設定の詳細については、ファイルストレージ連携を参照してください。
同期が実行されると、Brazeはデータウェアハウスインスタンスに直接接続し、指定されたテーブルからすべての新しいデータを取得し、Brazeダッシュボード上の対応するデータを更新します。同期が実行されるたびに、更新されたデータがBrazeに反映されます。
ユースケース
Brazeクラウドデータ取り込み機能を使用すると、以下のことが可能です:
- データウェアハウスやファイルストレージソリューションからBrazeへの簡単な連携を、わずか数分で作成できます。
- 属性、イベント、購入を含むユーザーデータを、データウェアハウスからBrazeに安全に同期できます。
- クラウドデータ取り込みをCurrentsやSnowflake Data Sharingと組み合わせることで、Brazeとのデータループを閉じることができます。
さらに、接続されたソースはゼロコピーの代替手段です。Brazeがデータウェアハウスやファイルストレージソリューションに直接クエリを行い、基盤となるデータをBrazeにコピーすることなくCDIセグメントを構築できます。
サポートされるデータソース
クラウドデータ取り込みは、以下からデータを同期できます。
クラウドデータウェアハウス:
- Amazon Redshift
- Databricks
- Google BigQuery
- Microsoft Fabric
- Snowflake
クラウドデータストレージ:
- Amazon S3
- Azure Blob Storage
- Google Cloud Storage
サポートされるデータ型
クラウドデータ取り込みは以下のデータ型をサポートしています:
ユーザーデータ
- ユーザー属性(以下を含む):
- 階層化カスタム属性
- オブジェクトの配列
- 購読ステータス
- カスタムイベント
- 購入イベント
- ユーザー削除リクエスト
非ユーザーオブジェクト
- カタログアイテム
ゼロコピーメッセージング
- キャンバストリガー
- 接続されたソース
データ取り込み用のユーザー識別子
クラウドデータ取り込みを通じてユーザーデータを同期する際、以下の識別子タイプの1つ以上を使用してユーザーを識別できます。ソーステーブルの各行には、一度に1つの識別子タイプの値のみを含める必要がありますが、テーブルには1つ、2つ、3つ、4つ、または5つすべての識別子タイプの列を含めることができます。
| 識別子 | 説明 |
|---|---|
EXTERNAL_ID |
作成または更新するユーザープロファイルを特定するexternal ID。これはBrazeで使用されているexternal_idの値と一致する必要があります。 |
ALIAS_NAMEおよびALIAS_LABEL |
この2つの列はユーザーエイリアスオブジェクトを作成します。alias_nameは一意の識別子であり、alias_labelはエイリアスの種類を指定します。ユーザーは異なるラベルで複数のエイリアスを持つことができますが、alias_labelあたり1つのalias_nameのみ設定できます。 |
BRAZE_ID |
Braze SDKによって生成されるBrazeユーザー識別子です。クラウドデータ取り込みを通じてBraze IDで新しいユーザーを作成することはできません。新しいユーザーを作成するには、external IDまたはユーザーエイリアスを指定してください。 |
EMAIL |
ユーザーのメールアドレス。同じメールアドレスを持つ複数のプロファイルが存在する場合、最後に更新されたプロファイルが優先されます。メールと電話番号の両方を含める場合、メールがプライマリ識別子として使用されます。 |
PHONE |
ユーザーの電話番号。同じ電話番号を持つ複数のプロファイルが存在する場合、最後に更新されたプロファイルが優先されます。 |
テーブル列の設定とペイロードのフォーマット要件の詳細については、Cloud Data Ingestionのテーブル設定を参照してください。
ソース固有の設定手順とSQLの例については、データウェアハウス連携を参照してください。
連携IDの確認
連携IDは、Brazeダッシュボードで連携を表示する際のURLで確認できます。Data Settings > Cloud Data Ingestionに移動し、連携を選択します。連携IDはhttps://[instance].braze.com/integrations/cloud_data_ingestion/[integration_id]の形式でURLに表示されます。たとえば、URLがhttps://dashboard-01.braze.com/integrations/cloud_data_ingestion/abc123xyzの場合、連携IDはabc123xyzです。このIDを使用して、同期のトリガーや同期ステータスの確認のためのAPI呼び出しを行うことができます。
データポイント使用量
データポイントベースの課金をご利用のお客様の場合、クラウドデータ取り込みのデータポイント課金は、/users/trackエンドポイントを通じた更新の課金と同等です。詳細については、データポイントを参照してください。

Brazeクラウドデータ取り込みは利用可能なレート制限にカウントされるため、別の方法でデータを送信している場合、レート制限はBraze APIとクラウドデータ取り込みの間で合算されます。
製品の制限事項
| 制限事項 | 説明 |
|---|---|
| 連携の数 | 設定できる連携の数に制限はありません。 |
| 行数 | デフォルトでは、各実行で最大5億行を同期できます。5億行を超える新しい行を持つ同期は停止されます。これより高い制限が必要な場合は、BrazeカスタマーサクセスマネージャーまたはBrazeサポートにお問い合わせください。 |
| 行あたりの属性数 | PAYLOAD列を使用する同期の場合、各行には1つのユーザーIDと最大250個の属性を含むJSONオブジェクトを含める必要があります。JSONオブジェクト内の各キーは1つの属性としてカウントされます(つまり、配列は1つの属性としてカウントされます)。 |
| ペイロードサイズ | PAYLOAD列を使用する同期の場合、各行のペイロードは最大1 MBまで含めることができます。1 MBを超えるペイロードは拒否され、エラー「Payload was greater than 1MB」が関連するexternal IDおよび切り詰められたペイロードとともに同期ログに記録されます。 |
| データ型 | クラウドデータ取り込みを通じて、ユーザー属性、カスタムイベント、購入イベント、カタログアイテム、ユーザー削除リクエスト、およびキャンバストリガーを同期できます。 |
| Brazeリージョン | この製品はすべてのBrazeリージョンで利用可能です。どのBrazeリージョンからでも、任意のソースデータリージョンに接続できます。 |
| ソースリージョン | Brazeは、任意のリージョンやクラウドプロバイダーのデータウェアハウスまたはクラウド環境に接続します。 |