Braze のクラウドデータ取り込み

Braze クラウドデータ取り込み（CDI）を使用すると、データストレージソリューションから Braze への直接接続を設定して、関連するユーザーデータやその他の非ユーザーデータを同期できます。このデータは、マーケティングユースケースを強化するためのパーソナライゼーションやセグメンテーションに活用できます。クラウドデータ取り込みの柔軟な統合は、ネストされた JSON やオブジェクトの配列を含む複雑なデータ構造をサポートしています。

仕組み

Braze のクラウドデータ取り込み（CDI）では、データウェアハウスインスタンスと Braze ワークスペースとの統合を設定して、定期的にデータを同期します。この同期は設定したスケジュールで実行され、統合ごとに異なるスケジュールを設定できます。同期は最大頻度で 15 分ごと、最小頻度で月に 1 回実行できます。同期を 15 分より高い頻度で実行する必要がある場合は、カスタマーサクセスマネージャーに連絡するか、リアルタイムデータ取り込みに REST API コールを使用することを検討してください。

同期が実行されると、Braze はデータウェアハウスインスタンスに直接接続し、指定されたテーブルからすべての新しいデータを取得し、Braze ダッシュボードの対応するデータを更新します。同期が実行されるたびに、更新されたデータはすべて Braze に反映されます。

統合 ID を見つける

Braze ダッシュボードで統合を表示している際の URL に、統合 ID が表示されています。データ設定 > クラウドデータ取り込みに移動し、統合を選択します。統合 ID は URL に https://[instance].braze.com/integrations/cloud_data_ingestion/[integration_id] の形式で表示されます。例えば、URL が https://dashboard-01.braze.com/integrations/cloud_data_ingestion/abc123xyz の場合、統合 ID は abc123xyz です。この ID は、同期をトリガーしたり同期ステータスを確認したりする API 呼び出しの際に使用できます。

ユースケース

Braze のクラウドデータ取り込み機能を使用すると、以下のことができます。

• お使いのデータウェアハウスやファイルストレージソリューションから Braze へのシンプルな直接統合を、わずか数分で構築できます。
• データウェアハウスから Braze へ、属性、イベント、購入履歴を含むユーザーデータを安全に同期できます。
• クラウドデータ取り込みをCurrentsまたは Snowflake データ共有と組み合わせることで、Braze でデータループを閉じることができます。

さらに、接続されたソースはゼロコピーの代替手段です。Braze がデータウェアハウスやファイルストレージソリューションに直接クエリを実行して CDI セグメントを構築できます。基盤となるデータを Braze にコピーする必要は一切ありません。

サポートされるデータソース

クラウドデータ取り込みは、以下のデータソースからデータを同期できます。

• Amazon Redshift
• Databricks
• Google BigQuery
• Microsoft Fabric
• Snowflake
• Amazon S3

サポートされるデータタイプ

クラウドデータ取り込みは、次のデータタイプをサポートしています。

ユーザーデータ

• ユーザー属性（以下を含む）：
  • 階層化カスタム属性
  • オブジェクト配列
  • サブスクリプションステータス
• カスタムイベント
• 購入イベント
• ユーザー削除リクエスト

非ユーザーオブジェクト

• カタログ項目

ゼロコピーメッセージング

• 接続されたソース

データ取り込み用のユーザー識別子

クラウドデータ取り込みを通じてユーザーデータを同期する際、以下の識別子タイプの 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 ごとに alias_name を 1 つしか持つことができません。
BRAZE_ID	Braze SDK によって生成される Braze ユーザー識別子です。クラウドデータ取り込みを通じて Braze ID を使用して新規ユーザーを作成することはできません。新規ユーザーを作成するには、外部ユーザー ID またはユーザーエイリアスを指定してください。
EMAIL	ユーザーのメールアドレスです。同じメールアドレスを持つ複数のプロファイルが存在する場合、最も最近更新されたプロファイルが優先されます。メールと電話番号の両方を含める場合、メールが主要な識別子として使用されます。
PHONE	ユーザーの電話番号です。同じ電話番号を持つ複数のプロファイルが存在する場合、最も最近更新されたプロファイルが優先されます。

テーブル列の設定やペイロードのフォーマット要件の詳細については、クラウドデータ取り込みのテーブル設定を参照してください。

ソース固有の設定手順や SQL の例については、データウェアハウスの統合を参照してください。

データポイント使用量

データポイントベースの課金をご利用の場合、クラウドデータ取り込みのデータポイント課金は、/users/track エンドポイント経由の更新に対する課金と同等です。詳細については、データポイントを参照してください。

製品の制限事項

制限	説明
統合の数	設定できる統合の数に制限はありません。ただし、テーブルまたはビューごとに設定できる統合は 1 つだけです。
行数	デフォルトでは、1 回の実行で最大 5 億行まで同期できます。新規行が 5 億を超える同期は停止されます。これよりも高い制限が必要な場合は、Braze カスタマーサクセスマネージャーまたは Braze サポートにお問い合わせください。
行ごとの属性	各行には単一のユーザー ID と最大 250 の属性を持つ JSON オブジェクトが含まれている必要があります。JSON オブジェクトの各キーは 1 つの属性としてカウントされます（つまり、配列は 1 つの属性としてカウントされます）。
ペイロードサイズ	各行に最大 1 MB のペイロードを含めることができます。1 MB を超えるペイロードは拒否され、同期ログには「ペイロードが 1 MB を超えた」というエラーが、関連する external ID と切り詰められたペイロードとともに記録されます。
データタイプ	クラウドデータ取り込みを通じて、ユーザー属性、イベント、および購入を同期できます。
Braze リージョン	この製品はすべての Braze リージョンで利用可能です。任意の Braze リージョンを任意のソースデータリージョンに接続できます。
ソースリージョン	Braze は、どのリージョンやクラウドプロバイダーであっても、データウェアハウスやクラウド環境に接続します。