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は新しいファイルがアップロードされると、そのファイルを取り込みます。設定の詳細については、Amazon S3、Google Cloud Storage、またはAzure Blob Storageを参照してください。
同期が実行されると、Brazeはデータウェアハウスインスタンスに直接接続し、指定されたテーブルからすべての新しいデータを取得して、Brazeダッシュボード上の対応するデータを更新します。同期が実行されるたびに、更新されたデータがBrazeに反映されます。
ユースケース
Brazeクラウドデータ取り込みの機能を使用すると、次のことができます。
- データウェアハウスやファイルストレージソリューションからBrazeへのシンプルな統合を、わずか数分で直接作成できます。
- 属性、イベント、購入などのユーザーデータを、データウェアハウスからBrazeに安全に同期できます。
- クラウドデータ取り込みをCurrentsまたはSnowflakeデータ共有と組み合わせることで、Brazeとのデータループを完結できます。
さらに、接続されたソースはゼロコピーの代替手段です。Brazeにデータウェアハウスやファイルストレージソリューションへ直接クエリを実行させ、CDIセグメントを作成できます—基盤となるデータをBrazeにコピーする必要は一切ありません。
サポートされているデータソース
クラウドデータ取り込みは、以下のソースからデータを同期できます。各ソースには、クラウドデータ取り込みのソースの下に専用の設定ページがあります。
データウェアハウス
ファイルストレージ
サポートされているデータタイプ
クラウドデータ取り込みでは、以下のデータタイプがサポートされています。
ユーザーデータ
- ユーザー属性。以下を含みます。
- 階層化カスタム属性
- オブジェクトの配列
- 購読ステータス
- カスタムイベント
- 購入イベント
- ユーザー削除リクエスト
ユーザー以外のオブジェクト
- カタログアイテム
- データオブジェクト (ユーザーリレーションシップとオブジェクトリレーションシップを含む)
ゼロコピーメッセージング
- キャンバストリガー
- 接続されたソース
データ取り込みのユーザー識別子
クラウドデータ取り込みでユーザーデータを同期する場合、以下の識別子タイプの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の例については、クラウドデータ取り込みのソースを参照してください。
統合IDを確認する
統合IDは、Brazeダッシュボードで統合を表示したときのURLで確認できます。データ設定 > クラウドデータ取り込みに移動し、統合を選択します。統合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とクラウドデータ取り込みの間で合算されます。
製品の制限事項
| 制限事項 | 説明 |
|---|---|
| 統合の数 | 設定できる統合の数に制限はありません。 |
| 行数 | デフォルトでは、1回の実行で最大5億行を同期できます。新しい行が5億行を超える同期は停止されます。これより高い上限が必要な場合は、Brazeのカスタマーサクセスマネージャーまたは Brazeサポートにお問い合わせください。 |
| 行あたりの属性数 | PAYLOAD列を使用する同期では、各行に1つのユーザー IDと最大250個の属性を含むJSONオブジェクトを含める必要があります。JSONオブジェクト内の各キーは1つの属性としてカウントされます (つまり、配列は1つの属性としてカウントされます)。 |
| データオブジェクトあたりのフィールド数 | 1つのデータオブジェクトタイプには最大500個のフィールドを含めることができます。2つのタイプ間のリレーションシップには最大25個のフィールドを含めることができます。 |
| ペイロードサイズ | PAYLOAD列を使用する同期では、各行に最大1 MBのペイロードを含めることができます。1 MBを超えるペイロードは拒否され、エラー「Payload was greater than 1MB」が、関連するexternal IDと切り詰められたペイロードとともに同期ログに記録されます。 |
| データタイプ | クラウドデータ取り込みを使用して、ユーザー属性、カスタムイベント、購入イベント、ユーザー削除リクエスト、キャンバストリガー、カタログアイテム、データオブジェクト、データオブジェクトのリレーションシップを同期できます。 |
| Brazeリージョン | この製品はすべてのBrazeリージョンで利用できます。どのBrazeリージョンからでも、任意のソースデータリージョンに接続できます。 |
| ソースリージョン | Brazeは、任意のリージョンまたはクラウドプロバイダーにあるデータウェアハウスやクラウド環境に接続します。 |