BrazeAI Decisioning Studioデータの同期

このページでは、Cloud Data Ingestion（CDI）を使用して、データウェアハウスからBrazeAI Decisioning Studio™に直接データを同期する方法について説明します。

CDIのDecisioning Studio宛先を使用すると、CDIはデータウェアハウスのデータをBrazeAI Decisioning Studioに直接同期することもできます。これらの同期からのデータはDecisioning Studioでアクティベーションに利用できますが、ユーザープロファイルとBrazeワークスペースは変更されません。

重要

この機能は早期アクセス段階です。アクセスするには、カスタマーサクセスマネージャーまたはアカウントマネージャーにお問い合わせください。

仕組み

同期を作成する際は、送信先としてDecisioning Studioを選択し、同期したいデータを返すSQLクエリを作成します。CDIは設定したスケジュールでそのクエリを実行し、結果をDecisioning Studioのアセットとして配信します。各同期は1つのアセットに対応するため、複数の同期を同じアセットに向けることはできません。

Braze Data Platformへの同期とは異なり、Decisioning Studioへの同期では、データをユーザープロファイル、イベント、カタログにマッピングしません。

Decisioning Studioでデータを利用できるようにするその他の方法については、データを接続するを参照してください。

前提条件

• BrazeとBrazeAI Decisioning Studioへのアクセス権。
• 有効なCloud Data Ingestionのデータウェアハウスソース。まだ設定していない場合は、Cloud Data Ingestionのソースを参照してください。
• 同期するテーブルまたはビュー。
• そのテーブル内で主キーとして使用する1つ以上の列と、CDIが増分同期に使用できるタイムスタンプ列。

Decisioning Studioの同期を作成する

ステップ1: 同期を作成し、宛先を選択する

1. データ設定 > クラウドデータ取り込み > 同期に移動します。
2. データ同期を作成を選択します。
3. 統合名を入力し、データソースでソースを選択します。
4. 宛先で、データの宛先をBrazeAI Decisioning Studio™に設定します。
5. データカテゴリーで、テーブルに最も合うDecisioning Studioデータのタイプを選択します。ユーザープロファイル、メッセージエンゲージメントイベント、コンバージョンイベント、その他から選択できます。この設定はDecisioning Studio用にデータにタグを付けるもので、CDIによる行の処理方法は変わりません。

ステップ2: SQLクエリを作成する

データ定義ステップで、同期するテーブルまたはビューからデータを返すSQLクエリを作成します。クエリの結果が同期のスキーマになります。

ソースエクスプローラーを使用して利用可能なテーブルやビューを参照したり、AI SQLジェネレーターを使用してクエリ作成のサポートを受けたりできます。

CDIは増分同期と変更トラッキングにUPDATED_ATを使用するため、クエリではUPDATED_AT列を返す必要があります。同期の実行ごとに、CDIはUPDATED_ATが最後に同期された値より新しい行のみを同期します。特定したタイムスタンプ列の名前がまだUPDATED_ATでない場合は、クエリでエイリアスを付けることができます。

1

SELECT *, LAST_MODIFIED AS UPDATED_AT FROM my_table

UPDATED_ATによる増分同期の制御方法（値を過去に戻した場合の動作を含む）について詳しくは、UPDATED_AT列についてを参照してください。

注

サポートされるのは、JOIN句を含む単一ステートメントの読み取り専用クエリのみです。CDIは読み取り専用クエリを実行し、基盤となるテーブルを変更することはありません。

ステップ3: クエリをプレビューして検証する

プレビューと検証を選択してクエリを実行します。クエリのプレビュー（最初の10行）セクションには、ソースから返された最初の10行と、各列で検出されたデータ型が表示されるため、続行する前にデータが正しいことを確認できます。

ステップ4: 主キーを選択する

すべてのDecisioning Studioの同期には、各行を一意に識別する1つ以上の列で構成される主キーまたは複合キーが必要です。検証が成功したら、主キードロップダウンを開き、主キーとして使用する列を選択します。複数の列を選択すると複合キーになります。

ヒント

適切な主キーとは、すべての行で一意であり、空になることがなく、同期の実行間で変化しないものです。UUID()やCURRENT_TIMESTAMPなど、クエリ実行時に生成される値は、行の重複や欠落の原因となるため避けてください。

ステップ5: 通知とスケジュールを設定し、同期を作成する

1. 通知ステップで、同期エラーの通知を受け取る連絡先メールアドレスを1つ以上入力します。行エラーと同期成功の通知をオンにすることもできます。
2. スケジュールステップで、定期同期をオンにすると、スケジュールに従って同期が自動的に実行されます。定期同期がオフの場合、同期はダッシュボードから手動で、または同期をトリガーするエンドポイントを使用して、トリガーしたときにのみ実行されます。
3. 概要を確認し、同期を作成します。

同期の編集

既存の同期を編集する場合、SQLクエリに変更を加えると、保存する前に再検証が必要です。プライマリキーと複合キーは変更できず、引き続きクエリ結果として返される必要があります。

有効な変更は、次回の同期実行時に反映されます。

スキーマ変更の処理

CDIは、ソーススキーマの変更を追加方式で処理します。CDIは同期を実行するたびにソーススキーマを既存のDecisioning Studioアセットと比較し、既存の列を保持したまま新しい列を追加します。

CDIがスキーマ変更を検出すると、その変更は同期の実行詳細と同期の編集ページに表示され、通知先の連絡先にメールアラートが送信されます。配信する列を変更するには、SQLクエリを更新して再検証してください。