このページはAIにより自動翻訳されており、不正確な内容が含まれている可能性があります。翻訳の誤りを報告するには、ページ右側の目次の下にあるフィードバックをご利用ください。
CDI セグメントエクステンション
Brazeのクラウドデータ取り込み（CDI）を使用すると、データウェアハウスまたはファイルストレージシステムからBrazeへの直接接続を設定し、関連するユーザーデータやカタログデータを定期的に同期できます。
警告
CDI セグメントエクステンションはデータウェアハウスに直接クエリを実行するため、データウェアハウスでこれらのクエリを実行する際に発生するすべてのコストが課金されます。CDI セグメントエクステンションはSQLセグメントクレジットを消費せず、セグメントエクステンションの上限にもカウントされず、データポイントも記録されません。
前提条件
ワークスペース内でデータウェアハウスのデータをセグメンテーションに使用するには、接続ソースを作成し、次にセグメントエクステンション内で CDI セグメントを作成する必要があります。CDI セグメントエクステンションを使用すると、CDI 接続を通じて利用可能になったデータを使って、自社のデータウェアハウスに直接クエリを実行する SQL を記述し、Braze 内でターゲティングできるユーザーグループを作成できます。
CDI セグメントの作成
ステップ1: ソースを設定する
最初の CDI セグメントエクステンションを作成する前に、接続ソースの手順に従って、データウェアハウスとの新しい接続ソースを設定します。
ステップ2: セグメントを作成する
- オーディエンス > セグメントエクステンションに移動し、新しいエクステンションを作成を選択します。
- セグメントエクステンション作成エクスペリエンスの選択メニューで、フルリフレッシュ (CDI セグメントを含む)を選択します。
- このセグメントエクステンションのデータソースを選択メニューで、CDI データテーブルを選択します。このメニューは、少なくとも1つの接続ソースを設定した後にのみ表示されます。
- 使用する接続を選択し、クエリを記述します。各接続には固有のデータテーブルセットがあります。開発チームは CDI 設定時に接続とデータテーブルを構成できます。
- ソースエクスプローラーを選択すると、スキーマや利用可能な説明を含む、使用可能なデータテーブルを確認できます。
- Braze SQL 構文を使用して、セグメント用の SQL を記述します。すべての CDI セグメントエクステンションでは、選択カラムとして
external_user_idを使用する必要があり、external_user_idはBrazeでユーザーに設定されたものと一致する必要があります。
クエリ結果にBrazeに存在しないユーザーが含まれている場合、それらのユーザーは無視されます。Brazeは CDI セグメントエクステンションの出力に基づいて新しいユーザーを作成しません。
重要
external_user_id は文字列値である必要があります。ソース ID が数値として格納されている場合（例：client_id が整数型の場合）、Brazeの external_id 型と一致するように SQL で文字列にキャストしてください。
- Brazeセグメント内でこのセグメントエクステンションを使用して、このオーディエンスにキャンペーンまたはキャンバスを送信します。
考慮事項
- セグメントエクステンションは、1つの接続からのデータのみを参照でき、複数の接続からは参照できません。
- セグメントエクステンションは、データソースとして CDI データまたは Braze Snowflake（Currents）データのいずれかを使用できます。セグメントエクステンション内でデータソースを混在させることはできませんが、複数のセグメントエクステンションを作成してセグメント内で一緒に参照することができます。
トラブルシューティング
- クエリは、クラウドデータ取り込みページで各接続同期に設定された最大実行時間に達するとタイムアウトする場合があります。許可される最大実行時間は60分です。
- SQLがデータウェアハウスに適した構文で記述されていることを確認してください。
New Stuff!