収集のベストプラクティス
顧客のユーザープロファイルのライフサイクルを想定する際に、既知および未知のユーザーについてユーザーデータをいつ、どのように収集すべきかを判断するのは難しい場合があります。この記事では、ユースケースを通じて、新規および既存のユーザーデータを収集するためのさまざまな方法とベストプラクティスを説明します。
以下の例はメール収集のユースケースですが、このロジックはさまざまなデータ収集シナリオに適用できます。この例では、サインアップフォームまたはユーザー情報を収集する方法がすでに連携されていることを前提としています。
ユーザーが記録するための情報を提供した後、そのデータがデータベースにすでに存在するかどうかを確認し、必要に応じてユーザーエイリアスプロファイルを作成するか、既存のユーザープロファイルを更新することをお勧めします。
未知のユーザーがサイトを閲覧し、後日アカウントを作成したり、メールサインアップで身元を明らかにしたりした場合、プロファイルのマージは慎重に処理する必要があります。マージ方法によっては、エイリアスのみのユーザー情報や匿名データが上書きされる場合があります。
Webフォームを通じたユーザーデータの取得
ステップ1: ユーザーが存在するかどうかを確認する
ユーザーがWebフォームからコンテンツを入力したら、そのメールアドレスを持つユーザーがすでにデータベース内に存在するかどうかを確認します。確認方法は次のいずれかです。
- 内部データベースを確認する（推奨）: Brazeの外部に、提供されたユーザー情報を含む外部レコードまたはデータベースがある場合は、メール送信時またはアカウント作成時にそれを参照して、その情報がまだ取得されていないことを確認します。
/users/trackエンドポイント:emailを識別子として使用します。メールアドレスがまだ存在しない場合は、新しいユーザープロファイルが作成されます。/subscription/status/getエンドポイント: カスタムフォームでメールアドレスを収集し、REST APIを通じて購読グループのメンバーシップを設定する場合は、最初にこのエンドポイントを呼び出します。一致するプロファイルが存在しない場合は、/subscription/status/setエンドポイントでユーザーを作成または購読登録します。それ以外の場合は、重複を作成せずに既存のプロファイルを更新します。
ステップ2: ユーザーを記録または更新する
- ユーザーが存在する場合:
- 新しいプロファイルは作成しません。
- ユーザーがニュースレターの購読を通じてメールアドレスを送信したことを示すために、ユーザーのプロファイルにカスタム属性（例:
newsletter_subscribed: true）を記録します。同じメールアドレスを持つBrazeユーザープロファイルが複数存在する場合は、すべてのプロファイルがエクスポートされます。
- ユーザーが存在しない場合:
/users/trackエンドポイントを通じてエイリアスのみのプロファイルを作成します。このエンドポイントはuser_aliasオブジェクトを受け付け、update_existing_onlyがfalseに設定されている場合にエイリアスのみのプロファイルを作成します。ユーザーにはexternal_idがないため、今後そのユーザーを参照できるように、ユーザーのメールアドレスをユーザーエイリアスとして設定します。
メールキャプチャフォームでユーザーのメールアドレスを取得する
メールキャプチャフォームを使用すると、ユーザーにメールアドレスの送信を促せます。送信されたメールアドレスはユーザープロファイルに追加されます。このフォームの設定方法について詳しくは、メールキャプチャフォームを参照してください。
カスタムフォームを使用し、REST APIで購読グループのメンバーシップを設定する場合は、ユーザーを作成する前にプロファイルがすでに存在するかどうかを確認してください。ステップ1: ユーザーが存在するかどうかを確認するを参照してください。
エイリアスのみのユーザーを識別する
アカウント作成時にユーザーを識別する場合、/users/identify エンドポイントを使用して、エイリアスのみのユーザーを既知のプロファイルとマージすることで、そのユーザーを識別し、external IDを割り当てられます。
ユーザーがエイリアスのみかどうかを確認するには、データベース内でユーザーが存在するかどうかを確認します。
- 外部レコードが存在する場合は、
/users/identify/エンドポイントを呼び出せます。 /users/export/idエンドポイントがexternal_idを返した場合は、/users/identify/エンドポイントを呼び出せます。- エンドポイントが何も返さない場合は、
/users/identify/を呼び出さないでください。
エイリアスのみのユーザー情報がすでに存在する場合のユーザーデータの取得
ユーザーがアカウントを作成した場合や、メール登録によって自身を識別した場合は、プロファイルを統合できます。統合可能なフィールドの一覧については、統合時の更新動作を参照してください。
重複ユーザープロファイルの統合
ユーザーデータが増えてきたら、Brazeダッシュボードから重複したユーザープロファイルを統合できます。これらの重複プロファイルは、同じ検索クエリで見つかるものである必要があります。重複したユーザープロファイルの統合方法の詳細については、重複ユーザーの統合を参照してください。
ユーザー統合エンドポイントを使用して、あるユーザープロファイルを別のユーザープロファイルに統合することもできます。
ユーザープロファイルを統合した後は、この操作を元に戻すことはできません。