収集のベストプラクティス
顧客のユーザープロファイルのライフサイクルを想定する際に、既知および未知のユーザーについてユーザーデータをいつ、どのように収集すべきかを判断するのは難しい場合があります。この記事では、ユースケースを通じて、新規および既存のユーザーデータを収集するためのさまざまな方法とベストプラクティスを説明します。
以下の例はメール収集のユースケースですが、このロジックはさまざまなデータ収集シナリオに適用できます。この例では、サインアップフォームまたはユーザー情報を収集する方法がすでに連携されていることを前提としています。
ユーザーが記録するための情報を提供した後、そのデータがデータベースにすでに存在するかどうかを確認し、必要に応じてユーザーエイリアスプロファイルを作成するか、既存のユーザープロファイルを更新することをお勧めします。
未知のユーザーがサイトを閲覧し、後日アカウントを作成したり、メールサインアップで身元を明らかにした場合、プロファイルのマージは慎重に処理する必要があります。マージ方法によっては、エイリアスのみのユーザー情報や匿名データが上書きされる場合があります。
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。