クラウドデータ取り込み: ビジュアルマッパー

このページでは、ビジュアルマッパーを使用して、SQLを記述したりデータを再構成したりせずに、データウェアハウスのテーブルまたはビューをBrazeに同期する方法について説明します。

ビジュアルマッパーは、すべてのクラウドデータ取り込みデータウェアハウスソースで、属性、カスタムイベント、およびキャンバストリガーの同期に利用できます。その他の同期タイプについては、データ定義オプションを選択するを参照してください。

ビジュアルマッパーを使用すると、SQLを記述したりデータをアップストリームで再構成したりせずに、データウェアハウスの既存のテーブルまたはビューを同期できます。EXTERNAL_ID、UPDATED_AT、PAYLOAD カラムを持つBraze専用のテーブルを作成する代わりに、既存のテーブルのカラムをダッシュボードで直接Brazeフィールドにマッピングします。

前提条件

ビジュアルマッパーで同期を作成する前に、次のものが必要です。

• アクティブな Cloud Data Ingestion データウェアハウスソース。まだ設定していない場合は、Cloud Data Ingestion ソースを参照してください。
• 同期するテーブルまたはビューの名前 (データウェアハウスに表示されているとおりのもの)。
• サポートされているユーザー識別子を含むテーブル内の列と、Braze が変更トラッキングに使用できるタイムスタンプを含む列。

注

Braze はデータに対して読み取り専用クエリのみを実行し、基盤となるテーブルを変更することはありません。クエリの実行中に一時オブジェクトが作成される場合がありますが、保持されることはありません。

ビジュアルマッパーで同期を作成する

ステップ 1: 同期を設定する

1. データ設定 > クラウドデータ取り込み > 同期に移動し、データ同期を作成を選択します。
2. 同期の名前を決め、アクティブなデータソースを選択します。使用できるのはアクティブなソースのみです。
3. データ宛先で、Braze Data Platform を選択します。
4. データタイプを選択します。
5. 次へ: データ定義を選択します。

ステップ 2: ソーススキーマをマッピングする

1. データ定義ステップで、ビジュアルを選択します。
2. データウェアハウスに表示されているとおりにテーブル名またはビュー名を入力します。
3. ソーススキーマをマッピングを選択します。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 つ入力します。必要に応じて、行エラーアラート (一定の割合の行の更新に失敗した場合に送信) と同期成功通知をオンにすることもできます。
2. スケジュールステップで、スケジュールに沿って同期を実行するには定期同期をオンにします。1 回限りの同期にする場合はオフのままにします。
3. 概要ステップを確認します。このステップには、設定内容、新規属性と既存属性の区別、データ型の問題または選択によってインポートから除外された列が一覧表示されます。
4. 同期を作成を選択します。いずれのステップでも下書きとして保存を選択して、後で完了することもできます。

スキーマ変更の処理

ビジュアルマッパーは、同期の実行ごとにテーブルまたはビューのスキーマをチェックし、変更の種類に応じて次のように対応します。

列の削除後に一時停止された同期を再開するには、同期を編集を選択し、マッピングを確認します。削除された列にはフラグが付けられ、マッパーには表示されなくなります。マッピングを保存すると、その列なしで同期を継続することが確定します。または、データが別の列に移動した場合は、保存する前に新しい列をマッピングしてください。

よくある質問

同期の作成後にマッピングを編集できますか？

はい。同期を編集し、マッピングを表示して編集を選択します。ソーステーブルの現在のスキーマが読み込まれ、同期の作成時に設定した以前のマッピングも保存された状態で表示されます。そこからマッピングを編集できます。

ビジュアルマッパーでデータを変換できますか？

いいえ。ビジュアルマッパーは、ソースに表示されているとおりの列の値をそのまま同期します。変換、条件ロジック、テーブル間の結合には対応していません。これらのユースケースでは、データ定義ステップで SQL オプションを使用し、クエリでデータを整形してください。詳細については、クラウドデータ取り込み: SQL エディターを参照してください。

既存の CDI 同期は変更されますか？

いいえ。EXTERNAL_ID、UPDATED_AT、PAYLOAD の列を持つ既存のテーブル形式を使用した同期は引き続き機能し、今後も作成できます。

Braze の使用量にはどのような影響がありますか？

インポートしてマッピングした各列は Braze のフィールド更新として書き込まれ、データポイントの課金は他の CDI ユーザーデータ同期と同じように扱われます。不要な列を除外すると、同期を効率的に保てます。詳細については、クラウドデータ取り込みのベストプラクティスを参照してください。