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

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

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

クイックスタートの手順

Braze CDIに慣れている場合、キャンバストリガー同期の設定は、同じソースでのユーザーデータ同期のプロセスとほぼ同じです。ただし、次の点に注意してください。

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

開始するには、新しい同期を作成する際にキャンバストリガーデータタイプを選択します。

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

ソースのソーステーブルまたはファイル形式については、ソースのページを開いてキャンバストリガータブを選択します。そのページで認証情報とネットワークの設定も完了してください。

既存の同期の認証情報がある場合は再利用できますが、キャンバストリガーのソーステーブルへのアクセス権を必ず付与してください。

ステップ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. キャンバストリガーデータタイプを選択します。
5. 送信先キャンバス(ステップ2で設定したもの)を選択します。
6. 同期頻度を選択します。
7. 通知設定を行います。
8. テスト接続を選択して、すべてが想定どおりに動作することを確認します。Snowflakeに接続する場合は、まずダッシュボードに表示される公開キーを、BrazeがSnowflakeに接続するために作成したユーザーに追加します。このステップを完了するには、SnowflakeでSECURITYADMIN以上のアクセス権が必要です。
9. 同期を保存して、キャンバストリガーの同期を開始します。

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

ヒント

予期しない送信を避けるため、設定全体(同期の動作からキャンバスの設定まで)を確認してください。レート制限、フリークエンシーキャップ、セグメンテーションフィルターなどのキャンバス設定を使用すると、メッセージ配信をさらに絞り込むことができます。

本番のユースケースを実装する前に、少人数またはテスト用のオーディエンスで試験運用を行うことをお勧めします。

考慮事項

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

各同期の実行では、それぞれの宛先キャンバスに最大で 1 時間あたり約 375 万ユーザーの割合でユーザーがエントリーします。次の場合は、ソースからキャンバスへのエントリーに時間がかかることを想定してください。

• 1 回の同期の実行で 375 万を超えるユーザーを同期する場合。
• REST APIの /canvas/trigger/send のレート制限にすでに達している状態で CDI キャンバストリガーを使用する場合。

メッセージアーカイブが有効になっている場合は、ゼロコピー CDI について次の点を考慮してください。

• テーブルの結果は、処理中に一時的に Braze に保存されます。また、同期された内容を正確に確認できるように、30 日間 Snowflake にエクスポートされます。
• アーカイブされたメッセージは Braze 内のどこにも保存されません。コピーは、設定したストレージにのみ保存されるように送信されます。
• キャンバストリガーでゼロコピー CDI を使用する場合、Braze はデータウェアハウスからのクエリ結果のバックアップを保存せず、データがユーザープロファイルにコピーされることもありません。
• キャンバスコンテキストのプロパティは、最大 30 日間内部システムにログとして記録される場合があります。