永続型およびゼロコピー型データ取り込みオプションの比較
取り込みパイプラインを設計する前に、ウェアハウスやアプリケーションからのデータをBrazeにどのように届けるか（ユーザープロファイルにコピーするか、セグメンテーションのためにその場でクエリするか、キャンバスに一時的に渡すか）を選択します。
この例について
MovieCanonは架空の映画ストリーミングサービスです。顧客データ、チケットデータ、視聴データをデータウェアハウスに集約しています。データチームは、以下の3つの一般的なニーズに対してBrazeにデータを供給する方法を決定する必要があります。
- プロファイルデータ: Brazeユーザープロファイルに永続化されるロイヤルティティア、生涯価値、ジャンルやフォーマットの嗜好属性。
- オーディエンス構築: すべてのカラムをBrazeにコピーすることなく、ウェアハウステーブルからSQLで駆動するセグメント。
- トリガーメッセージング: プロファイルに保存する必要のない行固有のパーソナライゼーションを持ち、キャンバスにエントリするウェアハウスの行。
Brazeには4つの主要な取り込みパスがあります。標準のクラウドデータ取り込み（CDI）同期と/users/track APIは、どちらもプロファイルにデータを永続化します。CDIセグメント（接続ソース）とCDIキャンバストリガーはゼロコピーオプションです。ウェアハウスデータはウェアハウスに留まり、Brazeユーザープロファイルには書き込まれません。
この比較は、アーキテクチャの計画、スループットの見積もり、または開発チームやマーケティングチームの関係者にトレードオフを説明する際にご活用ください。各オプションの統合セットアップガイドに代わるものではありません。
考慮事項
- クラウドデータ取り込みは包括的な機能です。標準のCDI同期はBrazeプロファイルにデータをコピーします（
/users/trackと同様）。CDIセグメントとCDIキャンバストリガーは、Brazeユーザープロファイルにデータを書き込むことなく、ウェアハウス内にデータを保持します。 - CDI定期同期は、最短5分間隔から最長月1回まで実行できます。デフォルトでは、ダッシュボードで設定可能な最短間隔は15分です。これにより、ウェアハウスのコンピューティングコストとリクエスト量を管理しやすくなります。5分間隔で同期するには、Brazeサポートまたはカスタマーサクセスマネージャーにお問い合わせください。データが変更されたらすぐに同期するには、ウェアハウスの読み込みが完了した時点で同期をトリガーするエンドポイントを呼び出してください。Brazeクラウドデータ取り込みを参照してください。
- CDIキャンバストリガーは、
/canvas/trigger/sendREST APIレート制限を、そのエンドポイントへの他のトラフィックと共有します。/users/trackには独自の制限とバッチ処理ルールがあります。デフォルトの制限は引き上げることができます。設定 > APIと識別子 > API制限に移動し、APIレート制限を参照してください。 - 接続ソースとCDIセグメントエクステンションは、ウェアハウスでクエリを実行します。ウェアハウスのコンピューティングコストが発生しますが、Brazeはそれらのクエリに対してデータポイントを記録しません。接続ソースを参照してください。
設定
ステップ1:ユースケースを取り込みパスにマッピングする
目標を推奨の取り込みパスと照合し、そのパスがBrazeプロファイルに書き込むかどうかを確認します。
| 目標 | 推奨パス | プロファイルへの書き込み |
|---|---|---|
| ウェアハウスから属性、イベント、購入、またはカタログアイテムを永続化する | 標準CDI同期 | あり（データはBrazeプロファイルまたはカタログにコピーされます） |
| ソーステーブルをBrazeにコピーせずにウェアハウスSQLからオーディエンスを構築する | CDIセグメント（Connected Sources） | なし（メンバーシップのみ） |
| プロファイルに永続化すべきでないウェアハウスの行コンテキストでユーザーをキャンバスにエントリさせる | CDIキャンバストリガー | なし（一時的なキャンバスコンテキストプロパティ） |
| アプリ、サーバー、またはストリーミングパイプラインからほぼリアルタイムでデータをプッシュする | /users/track（またはSDK） |
あり（データはプロファイルに永続化されます） |
ステップ2:永続性、レイテンシー、スループットを比較する
各パスがデータレジデンシー、レイテンシー、スループット、およびユーザー作成をどのように処理するかを比較します。
| 項目 | 標準CDI同期 | CDIセグメント | CDIキャンバストリガー | /users/track |
|---|---|---|---|---|
| 機能 | ウェアハウステーブルのスケジュール読み取り。属性、イベント、購入、ユーザー削除、またはカタログを書き込みます | Brazeがウェアハウスにクエリしてセグメントエクステンションを構築します | ウェアハウスの行がキャンバスエントリをトリガーし、行コンテキストをキャンバスコンテキストプロパティとして渡します | アプリ、サーバー、またはストリーミングパイプラインが属性、イベント、購入をプロファイルに書き込みます |
| データレジデンシー | Brazeプロファイルにコピーされ永続化されます | ウェアハウスに残ります。プロファイルには何も書き込まれません | キャンバスコンテキストプロパティは一時的です。プロファイルには永続化されません | Brazeプロファイルにコピーされ永続化されます |
| 一般的なレイテンシー | スケジュールに基づいて実行されます（最短5分間隔、デフォルトは15分間隔）。または同期トリガーエンドポイント経由でオンデマンドで実行できます。ウェアハウスの鮮度も影響します。 | セグメントエクステンションのスケジュールに基づいてリフレッシュされます。メンバーシップは最終リフレッシュ時点のウェアハウスデータを反映します。 | 同期スケジュールに基づいて実行されます（最短5分間隔、デフォルトは15分間隔）。 | ほぼリアルタイム（非同期処理） |
| スループットに関する注記 | 同期ごとに完全なクエリ結果。Brazeが内部的に/users/track、/users/delete、またはカタログエンドポイントにバッチ処理します |
Connected Sourceあたりのクエリ実行時間上限は60分。リクエストあたりのオブジェクト上限はありません | /canvas/trigger/sendのレート制限を共有します。同期実行あたり約375万件のキャンバスエントリ |
リクエストあたり最大75の結合オブジェクト。APIレート制限を参照してください |
| バッチサイズ | CDI側のウェアハウス読み取りにはオブジェクトごとの上限はありません | N/A（クエリ出力がメンバーシップを定義します） | 同期実行あたり、ウェアハウスの行ごとに1件のキャンバスエントリ | リクエストあたり属性、イベント、購入を合わせて75件（デフォルト） |
| ユーザー作成 | あり（既存のみ更新が設定されていない場合） | なし（クエリ結果の不明なユーザーは無視されます） | なし（既存のBrazeユーザーのみ） | あり（_update_existing_onlyがtrueでない場合） |
ステップ3:スキーマと識別子の要件を比較する
各パスで必要な列とサポートされている識別子を比較します。標準CDI同期ごとに1つのデータタイプを設定します（例：ある統合では属性、別の統合ではイベント）。
| 項目 | 標準CDI同期 | CDIセグメント | CDIキャンバストリガー | /users/track |
|---|---|---|---|---|
| 必須カラム/形式 | ユーザー識別子 + UPDATED_AT + PAYLOAD（JSON）（行ごと） |
SQLはexternal_user_idのみを出力する必要があります |
識別子 + UPDATED_AT + PROPERTIES（JSON。空の場合は{}を使用） |
標準の/users/trackリクエストボディ |
| サポートされる識別子 | external_id、ユーザーエイリアス、braze_id、メール、または電話番号 |
external_user_idのみ（文字列） |
external_idまたはユーザーエイリアスのみ |
external_id、ユーザーエイリアス、braze_id、メール、または電話番号 |
ステップ4:選択したパスを実装する
- 標準CDI同期： ウェアハウステーブルまたはビューを作成し、Cloud Data Ingestion統合とテーブル設定に従います。
- CDIセグメント： Connected Sourceを追加し、CDIセグメントエクステンションを作成します。
- CDIキャンバストリガー：
PROPERTIESを含むソーステーブルを設定し、宛先キャンバスを構築して起動した後、CDIを使用したゼロコピーパーソナライゼーションに従って同期を作成します。 /users/track： アプリケーションまたはミドルウェアからリクエストを送信します。POST: ユーザーの作成と更新に従ってペイロードをフォーマットします。
MovieCanonの一般的なパターンは次のとおりです：夜間のプロファイルエンリッチメントに標準CDI同期、ウェアハウスのみのオーディエンスルールにCDIセグメント、行レベルのコンテキストを含むチケットステータスや視聴ジャーニーにキャンバストリガー、リアルタイムのアプリイベントに/users/trackを使用します。