CDIによるゼロコピーパーソナライゼーション

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

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

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

Braze CDI にすでに精通している場合は、キャンバストリガーシンクの設定がユーザー-data CDI 統合 の処理に厳密に従うことに注意してください。

• 外部ID またはユーザー別名識別子のみがサポートされます。メールおよび電話番号は、サポートされていない識別子sです。
• 同期できるのは、すでに存在するBraze ユーザーs のみです。新しいユーザーsは作成できません。
• 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. キャンバスステップs 内で、Canvas エントリプロパティー を使用して、ソーステーブルから同期する予定のプロパティーフィールドs を使用してメッセージをカスタマイズします。
   • たとえば、ステップ1 でaccount_balance のプロパティーフィールドをインストゥルメントした場合、次のリキッドテンプレートを使用してメッセージをパーソナライズします: \{\{canvas_entry_properties.\$\{account_balance\}\}\}。
4. キャンバスを構築したら、それを起動し、ステップ3に進みます。

ステップ 3: ゼロコピー同期の作成

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

1. Brazeで、データ設定> クラウドデータ取り込みに移動します。
2. 接続の詳細(または既存の認証情報s を再利用)を入力し、ソーステーブルをステップ1 から設定します。
3. 統合の名前を指定します。
4. キャンバストリガーsデータタイプを選択します。
5. 送信先のキャンバスを選択します(ステップ2)。
6. 同期周波数を選択します。
7. 通知環境設定を設定します。
8. Test Connectionを選択して、すべてが期待どおりに動作することを確認します。Snowflakeに接続する場合は、最初にダッシュボードに表示される公開キーを、Snowflakeに接続するためにBraze用に作成されたユーザーに追加します。このステップを完了するには、SnowflakeでSECURITYADMINアクセス以上が必要です。
9. 同期を保存して、キャンバストリガーの同期を開始します。

同期が実行されると、ソーステーブルのユーザーがキャンバスに入ります。キャンバス分析とクラウドデータインジェションの同期ログページを使用して、パフォーマンスを監視します。

考慮事項

CDI Canvas トリガー は、/canvas/trigger/send のREST API レート制限を使用します。このエンドポイントをCDI Canvas トリガー s およびREST API インテグレーションと同時に使用している場合は、組み合わせ使用量がレート制限にカウントされることを想定してください。

CDI Canvas トリガーは初期アクセスですが、次の点を考慮してください。

• ワークスペースごとに最大5 つの有効なキャンバストリガーシンク
• 1 回の同期実行で、1 時間あたり最大375万 ユーザー 秒のアプリ速度で、それぞれの送信先 キャンバスにユーザーs が入力されます。
  • 以下の場合、ソースからキャンバスへのエントリ時間が長くなるように準備してください。
    • 同期実行ごとに3.75M 以上のユーザーを同期する。
    • REST API の レート制限が/canvas/trigger/send ですでに飽和しているときにCDI Canvas トリガーを使用する。