収集のベストプラクティス

顧客のユーザープロファイルのライフサイクルを想定する際に、既知および未知のユーザーについてユーザーデータをいつ、どのように収集すべきかを判断するのは難しい場合があります。この記事では、ユースケースを通じて、新規および既存のユーザーデータを収集するためのさまざまな方法とベストプラクティスを説明します。

以下の例はメール収集のユースケースですが、このロジックはさまざまなデータ収集シナリオに適用できます。この例では、サインアップフォームまたはユーザー情報を収集する方法がすでに連携されていることを前提としています。

ユーザーが記録するための情報を提供した後、そのデータがデータベースにすでに存在するかどうかを確認し、必要に応じてユーザーエイリアスプロファイルを作成するか、既存のユーザープロファイルを更新することをお勧めします。

未知のユーザーがサイトを閲覧し、後日アカウントを作成したり、メールサインアップで身元を明らかにした場合、プロファイルのマージは慎重に処理する必要があります。マージ方法によっては、エイリアスのみのユーザー情報や匿名データが上書きされる場合があります。

Webフォームを使用したユーザーデータのキャプチャ

ステップ1: ユーザーが存在するかどうかの確認

ユーザーがWebフォームからコンテンツを入力したら、そのメールアドレスを持つユーザーがデータベース内にすでに存在するかどうかを確認します。これは、次の2つの方法のいずれかで実行できます。

• 内部データベースのチェック（推奨）： 提供されたユーザー情報を含む外部レコードまたはデータベースがBrazeの外部に存在する場合は、メール送信時またはアカウント作成時にそれを参照して、情報がまだキャプチャされていないことを確認してください。
• /users/trackエンドポイント： 識別子としてemailを使用します。メールアドレスがまだ存在しない場合は、新しいユーザープロファイルが作成されます。

ステップ2: ユーザーの記録または更新

• ユーザーが存在する場合：
  • 新しいプロファイルを作成しないでください。
  • ユーザーのプロファイルにカスタム属性（例：newsletter_subscribed: true）を記録して、ユーザーがニュースレターのサブスクリプションを通じてメールを送信したことを示します。同じメールアドレスを持つ複数のBrazeユーザープロファイルが存在する場合、すべてのプロファイルがエクスポートされます。
    
    
• ユーザーが存在しない場合：
  • /users/trackエンドポイントを使用してエイリアスのみのプロファイルを作成します。このエンドポイントはuser_aliasオブジェクトを受け入れ、update_existing_onlyがfalseに設定されている場合にエイリアスのみのプロファイルを作成します。ユーザーのメールアドレスをユーザーエイリアスとして設定し、今後そのユーザーを参照できるようにします（ユーザーにはexternal_idがないため）。

メールキャプチャフォームを使用したユーザーメールアドレスのキャプチャ

メールキャプチャフォームを使用して、ユーザーにメールアドレスの送信を促し、ユーザープロファイルに追加します。このフォームの設定方法の詳細については、メールキャプチャフォームを参照してください。

エイリアスのみのユーザーの識別

アカウント作成時にユーザーを識別する場合、/users/identifyエンドポイントを使用して、エイリアスのみのユーザーを既知のプロファイルとマージすることにより、エイリアスのみのユーザーを識別してexternal IDを割り当てることができます。

ユーザーがエイリアスのみかどうかを確認するには、データベース内にユーザーが存在するかどうかを確認します。

• 外部レコードが存在する場合は、/users/identify/エンドポイントを呼び出すことができます。
• /users/export/idエンドポイントがexternal_idを返す場合、/users/identify/エンドポイントを呼び出すことができます。
• エンドポイントが何も返さない場合、/users/identify/呼び出しを行うべきではありません。

エイリアスのみのユーザー情報がすでに存在する場合のユーザーデータのキャプチャ

ユーザーがアカウントを作成したり、メールサインアップで身元を明らかにしたりした場合、プロファイルをマージできます。マージできるフィールドのリストについては、マージ更新の動作を参照してください。

重複するユーザープロファイルのマージ

ユーザーデータが増加するにつれて、Brazeダッシュボードから重複するユーザープロファイルをマージできます。これらの重複するプロファイルは、同じ検索クエリを使用して検出する必要があります。ユーザープロファイルの重複をマージする方法の詳細については、プロファイルのマージを参照してください。

また、ユーザーマージエンドポイントを使用して、あるユーザープロファイルを別のユーザープロファイルにマージすることもできます。

注

ユーザープロファイルがマージされた後、この操作を元に戻すことはできません。

その他のリソース

• 追加のコンテキストについては、Brazeのユーザープロファイルのライフサイクルに関する記事を参照してください。
  
• Android、iOS、およびWebでのユーザーIDの設定とchangeUser()メソッドの呼び出しに関するドキュメントを参照してください。