CDIセグメントエクステンション
Braze クラウドデータ取り込みを使用すると、データウェアハウスやファイルストレージシステムから Braze への直接接続を設定して、関連するユーザーデータやカタログデータを定期的に同期できます。
CDIセグメントエクステンションはデータウェアハウスを直接クエリするため、これらのクエリをデータウェアハウスで実行する際の全コストが発生する。CDIセグメントエクステンションはSQLセグメントクレジットを消費せず、セグメントエクステンションの制限にカウントされず、データポイントをログに記録しない。
前提条件
データウェアハウスデータを Braze ワークスペース内のセグメンテーションに使用するには、接続されたソースを作成し、セグメントエクステンション内に CDI セグメントを作成する必要があります。CDIセグメントエクステンションを使えば、CDI接続を通じて利用可能なデータを活用し、自社データウェアハウスを直接クエリするSQLを記述できる。さらに、Braze内でターゲティング可能なユーザーグループを作成できる。
CDIセグメントを作成する
ステップ 1: ソースを設定する
最初のCDIセグメントエクステンションを作成する前に、接続済みソースの設定ステップに従い、データウェアハウスとの新しい接続済みソースを設定せよ。
ステップ 2:セグメントを作成する
まず、新しいセグメントエクステンションを作成し、[完全に更新] を選択します。

データソースには [CDI データテーブル] を選択します。

CDIの設定の一環として、CDIセグメントエクステンションで使用する接続を複数の中から選択できる。各接続は特定のデータテーブルのセットを持っている。開発チームは、CDI のセットアップ中に接続とデータテーブルを設定することができます。
利用可能なデータテーブル(スキーマや説明を含む)を表示するには、[リファレンス]を選択する。準備ができたら、接続を選択する。

次に、Braze SQL の構文を使ってセグメント用の SQL を書きます。
覚えておいてほしいのは、すべてのCDIセグメントエクステンションでは、選択された列としてexternal_user_idを使用する必要があるということだ。そして、あなたの列は、Brazeでユーザーに対してexternal_user_id設定されたものと一致しなければならない。
external_user_id 文字列の値でなければならない。ソースIDが数値(例えば整数)として保存されている場合、SQLclient_id内で文字列に変換せよ。そうすればBrazeのexternal_id型と一致する。
クエリの結果にBrazeに存在しないユーザーが含まれている場合、それらのユーザーは無視される。Brazeは、CDIセグメントエクステンションの出力に基づいて新しいユーザーを作成しない。
セグメントエクステンションをプレビューする方法、管理する方法、自動化されたメンバーシップ更新を実行する方法については、SQLセグメントエクステンションを参照せよ。
最後に、Brazeセグメント内でこのSegment Extensionを使用して、このオーディエンスにキャンペーンまたはCanvasを送信することができる。
考慮事項
- セグメントエクステンションは、複数の接続ではなく、1 つの接続からのみデータを参照できます。
- セグメントエクステンションは、以下のいずれかをデータソースとして使用できます: CDIデータまたはBraze Snowflake(電流)データ。セグメントエクステンション内でデータソースを混在させることはできませんが、セグメント内で一緒に参照する複数のセグメントエクステンションを作成することはできます。
トラブルシューティング
- クエリが最大実行時間に達するとタイムアウトする可能性がある。この最大実行時間は、Cloud Data Ingestionページで接続シンクごとに設定される。最大実行時間は 60 分です。
- SQLがデータウェアハウスに適した構文で書かれていることを確認する。
GitHub でこのページを編集