CDIを用いたゼロコピーパーソナライゼーション

CDIを使ってキャンバストリガーを同期する方法を学び、ゼロコピーパーソナライゼーションを実現する。この機能は、データストレージソリューションからユーザー固有の情報にアクセスし、それを送信先のキャンバスに渡す。Canvasステップには、Brazeユーザープロファイルに永続化されないパーソナライゼーションフィールドを任意で含めることができる。

キャンバスの同期がトリガーされる

クイックスタートのステップ

Braze CDIに既に慣れている場合、キャンバストリガーの同期設定はユーザーデータCDI統合のプロセスとほぼ同様だが、以下の注意点がある：

• 外部IDまたはユーザーエイリアス識別子のみがサポートされている。メールと電話番号はサポートされていない識別子だ。
• 既存のBrazeユーザーのみ同期できる。新規ユーザーは作成できない。
• properties 列payloadを置き換える。これは、パーソナライゼーション用のキャンバスエントリプロパティとして使用したいフィールドのJSON文字列だ。

始めるには、新しい同期を作成する際に「Canvas Triggers」データタイプを選択する。

キャンバスのトリガーを使用する

ステップ 1: Canvasトリガー用のデータソースを設定する

• snowflake
• redshift
• bigquery
• databricks
• fabric
• file storage

1
2
3
4
5
6
7
8
9
10
11
CREATE DATABASE BRAZE_CLOUD_PRODUCTION;
CREATE SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION;
CREATE OR REPLACE TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.CANVAS_TRIGGERS_SYNC (
     UPDATED_AT TIMESTAMP_NTZ(9) NOT NULL DEFAULT SYSDATE(),
     --at least one of external_id or alias_name and alias_label is required  
     EXTERNAL_ID VARCHAR(16777216),
     --if using user alias, both alias_name and alias_label are required
     ALIAS_LABEL VARCHAR(16777216),
     ALIAS_NAME VARCHAR(16777216),
     PROPERTIES VARCHAR(16777216)
);

1
2
3
4
5
6
7
8
9
10
11
12
13
CREATE ROLE BRAZE_INGESTION_ROLE;

GRANT USAGE ON DATABASE BRAZE_CLOUD_PRODUCTION TO ROLE BRAZE_INGESTION_ROLE;
GRANT USAGE ON SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION TO ROLE BRAZE_INGESTION_ROLE;
GRANT SELECT ON TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.CANVAS_TRIGGERS_SYNC TO ROLE BRAZE_INGESTION_ROLE;

CREATE WAREHOUSE BRAZE_INGESTION_WAREHOUSE;
GRANT USAGE ON WAREHOUSE BRAZE_INGESTION_WAREHOUSE TO ROLE BRAZE_INGESTION_ROLE;

CREATE USER BRAZE_INGESTION_USER;
GRANT ROLE BRAZE_INGESTION_ROLE TO USER BRAZE_INGESTION_USER;

1
2
3
4
5
6
7
8
9
10
11
CREATE DATABASE BRAZE_CLOUD_PRODUCTION;
CREATE SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION;
CREATE TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.CANVAS_TRIGGERS_SYNC (
    updated_at timestamptz default sysdate not null,
    --at least one of external_id or alias_name and alias_label is required
    external_id varchar not null,.
    --if using user alias, both alias_name and alias_label are required
    alias_label varchar,
    alias_name varchar,
    properties varchar(max)
 );

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

1
CREATE SCHEMA BRAZE-CLOUD-PRODUCTION.INGESTION;

1
2
3
4
5
6
7
8
9
10
CREATE TABLE `BRAZE-CLOUD-PRODUCTION.INGESTION.CANVAS_TRIGGERS_SYNC`
(
  updated_at TIMESTAMP DEFAULT current_timestamp,
  --At least one of external_id or alias_name and alias_label is required  
  external_id STRING,
  --If using user alias, both alias_name and alias_label are required
  alias_name STRING,
  alias_label STRING,
  properties JSON
);

1
CREATE SCHEMA BRAZE-CLOUD-PRODUCTION.INGESTION;

1
2
3
4
5
6
7
8
9
10
CREATE TABLE `BRAZE-CLOUD-PRODUCTION.INGESTION.USERS_ATTRIBUTES_SYNC`
(
  updated_at TIMESTAMP DEFAULT current_timestamp(),
  --At least one of external_id or alias_name and alias_label is required  
  external_id STRING,
  --If using user alias, both alias_name and alias_label are required
  alias_name STRING,
  alias_label STRING,
  properties STRING, STRUCT, or MAP
);

1
2
3
4
5
6
7
8
9
10
11
CREATE OR ALTER TABLE [warehouse].[schema].[CDI_table_name] 
(
  UPDATED_AT DATETIME2(6) NOT NULL,
  PROPERTIES VARCHAR NOT NULL,
  --at least one of external_id or alias_name and alias_label is required  
  EXTERNAL_ID VARCHAR,
  --if using user alias, both alias_name and alias_label are required
  ALIAS_NAME VARCHAR,
  ALIAS_LABEL VARCHAR
)
GO

ステップ 2:送信先のキャンバスを設定する

1. Canvasトリガー用の送信先のキャンバスを設定する。新しいAPIトリガー付きキャンバスを作成するか、既存のものを選択する。APIトリガーによる配信スケジュールタイプでキャンバスを作成する方法については、エントリスケジュールタイプを参照せよ。
2. APIトリガーによる配信スケジュールタイプを選択した後、Canvasの設定を続けてCanvasを構築する。キャンバスは、単純な単一メッセージ送信から、複数のステップを含む複雑な顧客ワークフローまで様々だ。
3. キャンバスステップ内で、ソーステーブルから同期する予定の属性フィールドを用いて、キャンバスエントリプロパティでメッセージをパーソナライズする。
   • 例えば、ステップ1でプロパティフィールドを計測した場合account_balance、メッセージをパーソナライズするには以下のLiquidテンプレートを使用する：\{\{canvas_entry_properties.\$\{account_balance\}\}\}
4. キャンバスを作成したら、それを起動してステップ3に進め。

ステップ 3:ゼロコピー同期を作成する

ソースの設定が完了し、送信先のキャンバスが起動したら、新しいデータ同期を作成する：

1. Brazeで、データ設定＞クラウドデータ取り込みに移動する。
2. 接続の詳細を入力して接続を設定する（または既存の認証情報を再利用する）。そしてステップ1で指定したソーステーブルを指定する。
3. 統合に名前を付ける。
4. キャンバストリガーのデータ型を選択する。
5. ステップ2から送信先のキャンバスを選ぶ。
6. 同期頻度を選べ。
7. 通知設定を有効にする。
8. 接続テストを選択して、すべてが期待通りに動作することを確認する。Snowflakeに接続する場合、まずダッシュボードに表示されている公開キーを、BrazeがSnowflakeに接続するために作成したユーザーに追加する。このステップを完了するには、SnowflakeでSECURITYADMIN以上のアクセス権限が必要だ。
9. 同期を保存して、キャンバストリガーの同期を開始する。

同期が実行されると、ソーステーブルのユーザーがキャンバスに入力し始める。Canvasの分析機能とクラウドデータ取り込みの同期ログページを使って、パフォーマンスを監視する。

考慮事項

CDI Canvasのトリガーは、REST APIのレート制限を利用する/canvas/trigger/send。このエンドポイントをCDI CanvasトリガーとREST API統合と同時に使用する場合、その合計使用量がレート制限にカウントされることを想定せよ。

CDIキャンバスにおけるトリガーは現在早期アクセス中であるため、以下の詳細を考慮すること。

• ワークスペースごとに最大5つのアクティブなキャンバストリガー同期
• 各同期実行では、最大で1時間あたり約375万人のユーザーを、それぞれの送信先に追加する。
  • 以下の場合には、ソースからキャンバスへのエントリ時間が長くなることを覚悟しておけ：
    • 1回の同期実行で375万人以上のユーザーを同期する。
    • REST APIのレート制限が既に飽和状態にある場合、CDI /canvas/trigger/sendキャンバストリガーを使用する。