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

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

重要

ビジュアルマッパーは現在ベータ版です。ビジュアルマッパーは、すべてのクラウドデータ取り込みデータウェアハウスソースからのユーザー属性同期に利用でき、ベータ期間中に追加の同期タイプが利用可能になります。アクセスについては、カスタマーサクセスマネージャーまたはアカウントマネージャーにお問い合わせください。

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

前提条件

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

• アクティブなクラウドデータ取り込みデータウェアハウスソース。まだ設定していない場合は、データウェアハウス連携を参照してください。
• 同期するテーブルまたはビューの名前（データウェアハウスに表示されるとおり）。
• サポートされているユーザー識別子を含むテーブル内のカラムと、Brazeが増分同期に使用できるタイムスタンプを含むカラム。

注

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

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

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

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

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

1. [データ定義] ステップで [ビジュアルマッパー] を選択します。
2. [テーブル] フィールドに、データウェアハウスに表示されるとおりのテーブルまたはビュー名を入力します。
3. [ソーススキーマをマッピング] を選択します。Brazeがテーブルまたはビューのスキーマを読み取り、検出されたデータ型とともにすべてのカラムを一覧表示します。

ステップ3: マッピングを確認する

[マッピングの確認] セクションでは、2つの必須マッピングを追跡します。両方が完了するまで同期を作成できません。

• 1つのカラムをサポートされているユーザー識別子にマッピングします: 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の使用量にどのような影響がありますか？

インポートする各カラムは属性の更新として書き込まれ、データポイントの課金は他のCDIユーザーデータ同期と同じように機能します。不要なカラムを除外することで、同期を効率的に保つことができます。詳細については、クラウドデータ取り込みのベストプラクティスを参照してください。