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