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