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

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

キャンバストリガーの同期

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

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

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

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

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

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

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

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

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

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

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

考慮事項

CDI キャンバストリガーは、/canvas/trigger/send の REST API レート制限を利用します。このエンドポイントを CDI キャンバストリガーと REST API 統合で同時に使用する場合、その合計使用量がレート制限にカウントされることを想定してください。

CDI キャンバストリガーは現在早期アクセス中であるため、以下の詳細を考慮してください。

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