データウェアハウスストレージの連携

1. 同期する Redshift テーブルへの Braze のアクセスが許可されていることを確認します。Braze はインターネット経由で Redshift に接続します。
2. Redshift インスタンスで、Braze と同期するテーブルまたはビューを設定します。
3. Braze ダッシュボードで新しい連携を作成します。
4. 連携のテストを行い、同期を開始します。

ステップ 1:テーブルの設定

オプションで、ソーステーブルを保持する新規データベースとスキーマを設定します。

1
2
CREATE DATABASE BRAZE_CLOUD_PRODUCTION;
CREATE SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION;

CDI 連携に使用するテーブル (またはビュー) を作成します。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
CREATE TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.USERS_ATTRIBUTES_SYNC (
   updated_at timestamptz default sysdate,
   --at least one of external_id, alias_name and alias_label, or braze_id is required
   external_id varchar,
   --if using user alias, both alias_name and alias_label are required
   alias_label varchar,
   alias_name varchar,
   --braze_id can only be used to update existing users created through the Braze SDK
   braze_id varchar,
   --If you include both email and phone, we will use the email as the primary identifier
   email varchar,
   phone varchar,
   payload varchar(max)
)

データベース、スキーマ、テーブルには任意の名前を付けることができますが、列名は先行する定義と一致する必要があります。

• UPDATED_AT - テーブルで、この行が更新された時刻、または追加された時刻。最後の同期以降に追加されたか、更新された行のみを同期します。
• ユーザー識別子の列。テーブルには、ユーザー識別子列が 1 列以上含まれている場合があります。各行は、識別子 (external_id 単独か、alias_name と alias_label または braze_id の組み合わせ) を 1 つのみ含まなければなりません。ソーステーブルには、1 つ、2 つ、または 3 つすべての識別子タイプの列が含まれる場合があります。
  • EXTERNAL_ID - 更新対象のユーザーを特定します。これは Braze で使用されている external_id 値と一致しなければなりません。
  • ALIAS_NAME および ALIAS_LABEL - この 2 列はユーザーエイリアスオブジェクトを作成します。alias_name は一意の識別子である必要があり、alias_label はエイリアスのタイプを指定します。ユーザーは、異なるラベルを持つ複数のエイリアスを持つことができますが、alias_label ごとに alias_name を 1 つしか持つことができません。
  • BRAZE_ID - Braze のユーザー識別子。これは Braze SDK によって生成されます。クラウドデータ取り込み経由で Braze ID を使用して新規ユーザーを作成することはできません。新規ユーザーを作成するには、外部ユーザー ID またはユーザーエイリアスを指定します。
  • EMAIL - ユーザーのメールアドレス。同じメールアドレスを持つプロファイルが複数存在する場合、最後に更新されたプロファイルが優先されて更新されます。メールと電話の両方が指定された場合は、メールをプライマリ識別子として使用します。
  • PHONE - ユーザーの電話番号。同じ電話番号を持つプロファイルが複数存在する場合、最後に更新されたプロファイルが優先されて更新されます。
• PAYLOAD - Braze 内のユーザーと同期するフィールドの JSON 文字列。

ステップ 2: ユーザーの作成と権限の付与

1
2
3
CREATE USER braze_user PASSWORD '{password}';
GRANT USAGE ON SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION to braze_user;
GRANT SELECT ON TABLE USERS_ATTRIBUTES_SYNC TO braze_user;

これらは、このユーザーに最低限必要な権限です。CDI 連携を複数作成する場合は、スキーマに権限を付与したり、グループを使用して権限を管理したりできます。

ステップ 3: Braze IP へのアクセスの許可

ファイアウォールや他のネットワークポリシーがある場合は、Redshift インスタンスに Braze ネットワークへのアクセスを許可する必要があります。RedshiftのURLエンドポイントの例は “example-cluster.ap-northeast-2.redshift.amazonaws.com”.

知っておくべき重要なことがいくつかある：

• また、Redshift のデータへのアクセスを Braze に許可するように、セキュリティグループを変更しなければならないこともあります。
• テーブル内のIPとRedshiftクラスタへのクエリに使用するポート（デフォルトは5439）のインバウンド・トラフィックを明示的に許可していることを確認する。インバウンドルールが “すべて許可 “に設定されている場合でも、このポートでのRedshiftのTCP接続を明示的に許可する必要がある。
• Braze がクラスターに接続するには、Redshift クラスターのエンドポイントがパブリックにアクセス可能でなければなりません。
  • Redshift クラスターにパブリックアクセスを許可しない場合は、ssh トンネルを使用して Redshift データにアクセスするように VPC と EC2 インスタンスを設定できます。詳細については、この AWS ナレッジセンターの投稿を参照してください。

Brazeダッシュボードの地域に対応する以下のIPからのアクセスを許可する。

[パートナー連携] > [テクノロジーパートナー] に移動します。Redshift のページを見つけて、[新しいインポート同期を作成] をクリックします。

ステップ 1: Redshift の接続情報とソーステーブルの追加

Redshift データウェアハウスとソーステーブルの情報を入力します。プライベートネットワークトンネルを使用している場合は、スライダーを切り替えてトンネル情報を入力します。その後、次のステップに進みます。

ステップ2:同期の詳細の設定

次に、同期の名前を選択し、連絡先のメールアドレスを入力します。この連絡先情報は、テーブルへのアクセスが予期せず削除されたなど、連携エラーの通知に使用されます。

連絡先のメールアドレスは、テーブルや権限の欠落など、グローバルまたは同期レベルのエラーの通知のみを受け取ります。行レベルの問題を受け取ることはありません。グローバルエラーは、同期の実行を妨げる接続の重大な問題を示します。このような問題として、次のようなものがあります。

• 接続の問題
• リソース不足
• 権限の問題
• (カタログ同期のみ) カタログ層の容量不足

データ型と同期頻度も選択します。頻度の範囲は 15 分間隔から 1 か月に 1 回までです。Braze ダッシュボードで設定したタイムゾーンを使用して、定期的な同期がスケジュールされます。サポートされているデータ型は、カスタム属性、カスタムイベント、および購入イベントです。同期のデータ型は、作成後に変更できません。

Braze ダッシュボードに戻って、[テスト接続] をクリックします。成功すると、データのプレビューが表示されます。何らかの理由で接続できない場合、問題のトラブルシューティングに役立つエラーメッセージが表示されます。

Braze との連携を複数設定することもできますが、各連携で異なるテーブルを同期するように設定する必要があります。追加の同期を作成するときに同じ Snowflake または Redshift のアカウントに接続している場合は、既存の認証情報を再利用できます。

複数の連携にわたって同じユーザーを再利用している場合、すべてのアクティブな同期から削除されるまで、Braze ダッシュボードでそのユーザーを削除することはできません。

有効にすると、セットアップ時に設定したスケジュールで同期が実行される。通常のテストスケジュール以外で同期を実行したい場合や、最新のデータを取得したい場合は、「今すぐ同期」を選択する。この実行は、定期的にスケジュールされている将来の同期には影響しません。