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データウェアハウスソース。まだ設定していない場合は、データウェアハウス連携を参照してください。
• 同期したいテーブルまたはビュー。
• プライマリキーとして使用するテーブル内のカラム（1つまたは複数）、およびCDIが増分同期に使用できるタイムスタンプカラム。

Decisioning Studio同期の作成

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

1. Data Settings > Cloud Data Ingestion > Syncs に移動します。
2. Create data sync を選択します。
3. Integration Name を入力し、Data sources でソースを選択します。
4. Destination で、Data destination を BrazeAI Decisioning Studio™ に設定します。
5. Data category で、テーブルに最も適した Decisioning Studio data タイプを選択します。Customer profile、Message engagement events、Conversion events、または Other から選択してください。これはDecisioning Studio用にデータにタグ付けするもので、CDIの行処理方法は変わりません。

ステップ2:SQLクエリを記述する

Data definition ステップで、同期したいテーブルまたはビューからデータを返すSQLクエリを記述します。クエリの結果が同期のスキーマになります。

Source Explorerを使用して利用可能なテーブルやビューを参照したり、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:クエリをプレビューして検証する

Preview and validate を選択してクエリを実行します。Query preview (first 10 rows) セクションに、ソースから返された最初の10行と各カラムの検出されたデータ型が表示されるため、続行する前にデータが正しいことを確認できます。

ステップ4:プライマリキーを選択する

すべてのDecisioning Studio同期には、各行を一意に識別する1つまたは複数のカラムであるプライマリキーまたは複合キーが必要です。検証が成功したら、Primary key ドロップダウンを開き、プライマリキーとして使用するカラムを選択します。複数のカラムを選択すると複合キーが形成されます。

ヒント

適切なプライマリキーは、すべての行で一意であり、空でなく、同期実行間で安定しています。UUID()やCURRENT_TIMESTAMPなど、クエリ実行時に生成される値は、行の重複や欠落を引き起こす可能性があるため避けてください。

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

1. Notifications ステップで、同期エラー通知を受け取る Contact Email(s) を1つ以上入力します。Row Error および Sync success 通知をオンにすることもできます。
2. Schedule ステップで、Recurring sync をオンにすると、スケジュールに従って同期が自動的に実行されます。Recurring sync をオフにすると、ダッシュボードから手動で、または同期のトリガーエンドポイントを通じてトリガーした場合にのみ同期が実行されます。
3. Summary を確認し、同期を作成します。

同期の編集

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

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

スキーマ変更の処理

CDIはソーススキーマの変更を追加的に処理します。同期実行のたびに、CDIはソーススキーマを既存のDecisioning Studioアセットと比較し、既存のカラムを保持しながら新しいカラムを追加します。

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