クラウドデータ取り込み: ビジュアルマッパー
このページでは、ビジュアルマッパーを使用して、SQLを記述したりデータを再構成したりせずに、データウェアハウスのテーブルまたはビューをBrazeに同期する方法について説明します。
ビジュアルマッパーは、すべてのクラウドデータ取り込みデータウェアハウスソースに対して、属性、カスタムイベント、およびキャンバストリガーの同期で利用できます。その他の同期タイプについては、データ定義オプションを選択するを参照してください。
ビジュアルマッパーを使用すると、SQLを記述したりデータを再構成したりせずに、データウェアハウスの既存のテーブルまたはビューを同期できます。EXTERNAL_ID、UPDATED_AT、PAYLOAD カラムを持つBraze専用テーブルを作成する代わりに、既存のテーブルのカラムをダッシュボードで直接Brazeフィールドにマッピングします。
前提条件
ビジュアルマッパーで同期を作成する前に、以下が必要です。
- アクティブな Cloud Data Ingestion データウェアハウスソース。まだ設定していない場合は、データウェアハウス連携を参照してください。
- データウェアハウスに表示されている、同期するテーブルまたはビューの名前。
- サポートされているユーザー識別子を含むテーブル内の列と、Brazeが変更トラッキングに使用できるタイムスタンプを含む列。
Brazeはデータに対して読み取り専用のクエリのみを実行し、基になるテーブルを変更することはありません。クエリの実行中に一時オブジェクトが作成される場合がありますが、永続化されません。
ビジュアルマッパーによる同期の作成
ステップ1:同期を設定する
- データ設定 > Cloud Data Ingestion > 同期に移動し、データ同期を作成を選択します。
- 同期の名前を選択し、アクティブなデータソースを選択します。アクティブなソースのみ使用できます。
- データの宛先で、Braze Data Platformを選択します。
- データタイプを選択します。
- 次へ：データ定義を選択します。
ステップ2:ソーススキーマをマッピングする
- データ定義ステップで、ビジュアルを選択します。
- データウェアハウスに表示されているとおりにテーブルまたはビューの名前を入力します。
- ソーススキーマをマッピングを選択します。Brazeはテーブルまたはビューのスキーマを読み取り、検出されたデータタイプとともにすべてのカラムを一覧表示するので、Brazeフィールドにマッピングできます。
ステップ3:マッピングを確認する
マッピングの確認セクションでは、2つの必須マッピングを追跡します。両方が完了するまで同期は作成できません。
- 1つのカラムをBrazeが受け入れるユーザー識別子にマッピングします：
external_id、braze_id、email、phone、またはユーザーエイリアス。識別子のオプションは、宛先フィールドドロップダウンの識別子の下に表示されます。 - 1つのカラムを
updated_atにマッピングします。Brazeはこのタイムスタンプを変更トラッキングに使用し、各同期の実行時にupdated_atが最後に同期された値よりも後の行をインポートします。
残りの各カラムについては、以下の操作が可能です。
- デフォルトのマッピングを維持する。 各カラムは同じ名前のBrazeフィールドにマッピングされます。ワークスペースにまだフィールドが存在しない場合、新しい属性としてマークされ、同期の初回実行時に作成されます。
- 既存のフィールドにマッピングする。 宛先フィールドドロップダウンを検索して、ワークスペース内の既存のデフォルト属性またはカスタム属性にカラムをマッピングします。
- 新しいフィールドにマッピングする。 宛先フィールドドロップダウンに直接入力して、カラムを新しいカスタム属性にマッピングします。
- カラムを除外する。 インポートチェックボックスをオフにして、カラムを同期から除外します。
新しい属性を作成する前に、宛先ドロップダウンで既存の属性を検索してください。たとえば、テーブルにfav_colorカラムがあるが、ワークスペースですでにfavorite_colorをトラッキングしている場合は、別の属性を作成するのではなく、fav_colorをfavorite_colorにマッピングすることを検討してください。
データタイプがカラムの検出されたタイプと一致しないフィールドには、タイプの不一致の警告が表示されます。続行することは可能ですが、不一致の値は行エラーとして同期に失敗する場合があります。行エラーは同期の実行の詳細で確認できます。
ステップ4:プレビューと検証
プレビューと検証を選択して、テーブルまたはビューに対して読み取り専用のチェックを実行します。プレビューでは、マッピングされたフィールド名を使用して最初の10行が表示され、インポートするカラムのみが含まれます。
ステップ5:同期の作成を完了する
- 通知ステップで、同期エラー通知用の連絡先メールアドレスを少なくとも1つ入力します。オプションで行エラーアラート（行の更新に失敗した割合が一定に達した場合に送信）と同期成功通知を有効にできます。
- スケジュールステップで、定期的な同期を有効にしてスケジュールに従って同期を実行するか、オフのままにして1回限りの同期とします。
- サマリーステップを確認します。設定内容、新規属性と既存属性の区別、データタイプの問題や選択によりインポートから除外されたカラムが一覧表示されます。
- 同期を作成を選択します。任意のステップで下書きとして保存を選択して、後で完了することもできます。
スキーマ変更の処理
ビジュアルマッパーは、同期の実行ごとにテーブルまたはビューのスキーマをチェックし、変更の種類に応じて対応します。
| ソーステーブルの変更 | 同期の動作 |
|---|---|
| 新しいカラムが追加された | 同期は続行されますが、新しいカラムは自動的には同期されません。含めるには、同期を編集してマッピングしてください。 |
| マッピングされたカラムが削除された | 同期の実行が失敗し、同期が一時停止されます。スキーマの変更は同期の実行詳細に表示され、通知先の連絡先にメールアラートが送信されます。 |
| マッピングされたカラムの名前が変更された | カラムの削除と新しいカラムの追加として処理されます。 |
| カラムのデータ型が変更された | スキーマの変更としては検出されません。互換性のない値は、同期ログで行エラーとしてレポートされます。 |
カラムが削除された後に一時停止された同期を再開するには、同期を編集を選択してマッピングを確認します。削除されたカラムにはフラグが付けられ、マッパーには表示されなくなります。マッピングを保存すると、そのカラムなしで同期を続行することが確定されます。または、データが別のカラムに移動した場合は、保存する前に新しいカラムをマッピングしてください。
よくある質問
同期の作成後にマッピングを編集できますか？
はい。同期を編集し、マッピングを表示・編集を選択します。ソーステーブルの現在のスキーマが読み込まれ、同期作成時の以前のマッピングが保存されています。そこからマッピングを編集できます。
ビジュアルマッパーでデータを変換できますか？
いいえ。ビジュアルマッパーは、ソースに表示されているとおりにカラムの値をそのまま同期します。変換、条件分岐ロジック、テーブル間の結合には対応していません。これらのユースケースについては、データ定義ステップの SQL オプションを使用して、クエリでデータを整形してください。詳細については、クラウドデータインジェスション：SQL エディターを参照してください。
既存の CDI 同期は変更されますか？
いいえ。EXTERNAL_ID、UPDATED_AT、PAYLOAD カラムを含む既存のテーブル形式を使用した同期は引き続き動作し、新たに作成することもできます。
Braze の利用状況にどのような影響がありますか？
インポートしてマッピングした各カラムは Braze のフィールド更新として書き込まれ、データポイントの課金は他の CDI ユーザーデータ同期と同様に機能します。不要なカラムを除外することで、同期を効率的に保つことができます。詳細については、クラウドデータインジェスションのベストプラクティスを参照してください。