CDI セグメントエクステンション
Brazeのクラウドデータ取り込み（CDI）を使用すると、データウェアハウスまたはファイルストレージシステムからBrazeへの直接接続を設定し、関連するユーザーデータやカタログデータを定期的に同期できます。
CDI セグメントエクステンションはデータウェアハウスに直接クエリを実行するため、データウェアハウスでこれらのクエリを実行する際に発生するすべてのコストが課金されます。CDI セグメントエクステンションはSQL Segmentクレジットを消費せず、セグメントエクステンションの上限にもカウントされず、データポイントも記録されません。
前提条件
Brazeワークスペース内でセグメンテーションにデータウェアハウスのデータを使用するには、接続済みソースを作成してから、セグメントエクステンション内でCDI Segmentを作成する必要があります。CDI セグメントエクステンションを使用すると、CDI接続を通じて利用可能になったデータを使用して、独自のデータウェアハウスに直接クエリを実行するSQLを記述し、Braze内でターゲティングできるユーザーグループを作成できます。
CDI Segmentの作成
ステップ 1: ソースを設定する
最初のCDI セグメントエクステンションを作成する前に、接続済みソースの手順に従って、データウェアハウスとの新しい接続済みソースを設定します。
ステップ 2: Segmentを作成する
まず、新しいセグメントエクステンションを作成し、Full refresh を選択します。
データソースとして CDI Data Tables を選択します。
CDI設定の一環として、CDI セグメントエクステンションで使用するさまざまな接続を選択できます。各接続には特定のデータテーブルのセットがあります。開発チームがCDI設定時に接続とデータテーブルを構成できます。
利用可能なデータテーブル（スキーマや利用可能な説明を含む）を表示するには、参照を選択します。準備ができたら、接続を選択します。
次に、Braze SQL構文を使用してSegmentのSQLを記述します。
すべてのCDI セグメントエクステンションでは、選択カラムとして external_user_id を使用する必要があり、external_user_id はBrazeでユーザーに設定されたものと一致する必要があることに注意してください。
external_user_id は文字列値である必要があります。ソースIDが数値として保存されている場合（例えば、client_id が整数の場合）、Brazeの external_id 型と一致するようにSQLで文字列にキャストしてください。
クエリ結果にBrazeに存在しないユーザーが含まれている場合、それらのユーザーは無視されます。BrazeはCDI セグメントエクステンションの出力に基づいて新しいユーザーを作成しません。
セグメントエクステンションのプレビュー方法、セグメントエクステンションの管理方法、自動メンバーシップ更新の実行方法については、SQL セグメントエクステンションを参照してください。
最後に、Braze Segment内でこのセグメントエクステンションを使用して、このオーディエンスにCampaignまたはCanvasを送信できます。
考慮事項
- セグメントエクステンションは、複数ではなく1つの接続からのデータのみを参照できます。
- セグメントエクステンションは、データソースとしてCDIデータまたはBraze Snowflake（Currents）データのいずれかを使用できます。セグメントエクステンション内でデータソースを混在させることはできませんが、Segment内で一緒に参照する複数のセグメントエクステンションを作成できます。
トラブルシューティング
- クエリは、クラウドデータ取り込みページで各接続同期に設定された最大実行時間に達するとタイムアウトする場合があります。許可される最大実行時間は60分です。
- SQLがデータウェアハウスに適した構文で記述されていることを確認してください。