収集のベストプラクティス
顧客のユーザープロファイルのライフサイクルを想定する際に、既知および未知のユーザーについてユーザーデータをいつ、どのように収集すべきかを判断するのは難しい場合があります。この記事では、ユースケースを通じて、新規および既存のユーザーデータを収集するためのさまざまな方法とベストプラクティスを説明します。
以下の例はメール収集のユースケースですが、このロジックはさまざまなデータ収集シナリオに適用できます。この例では、サインアップフォームまたはユーザー情報を収集する方法がすでに連携されていることを前提としています。
ユーザーが記録するための情報を提供した後、そのデータがデータベースにすでに存在するかどうかを確認し、必要に応じてユーザーエイリアスプロファイルを作成するか、既存のユーザープロファイルを更新することをお勧めします。
未知のユーザーがサイトを閲覧し、後日アカウントを作成したり、メールサインアップで身元を明らかにした場合、プロファイルのマージは慎重に処理する必要があります。マージ方法によっては、エイリアスのみのユーザー情報や匿名データが上書きされる場合があります。
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ダッシュボードから重複するユーザープロファイルをマージできます。これらの重複プロファイルは、同じ検索クエリを使用して見つける必要があります。ユーザープロファイルの重複に関する詳細については、重複ユーザーのマージを確認してください。
また、ユーザーマージエンドポイントを使用して、あるユーザープロファイルを別のプロファイルにマージすることもできます。
ユーザープロファイルがマージされた後は、このアクションを元に戻すことはできません。
その他のリソース
- Brazeのユーザープロファイルのライフサイクルに関する記事で、追加のコンテキストを確認できます。
- ユーザーIDの設定と
changeUser()メソッドの呼び出しに関するドキュメントを、Android、iOS、Webでご覧いただけます。