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

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

概要

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

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

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

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

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

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

• 内部データベースのチェック (推奨)
  提供されたユーザー情報を含む外部レコードまたはデータベースが Braze の外部にある場合は、メール送信時またはアカウント作成時に参照して、そのユーザーの情報がまだ取得されていないことを確認します。
  
  
• /users/export/idエンドポイント
  次の呼び出しを実行して、返されたユーザー配列が空か、値を含んでいるかを確認します。

  1
  2
  3
  4
  --data-raw '{
    "email_address": "[email protected]",
    "fields_to_export": ["external_id", "user_aliases"]
  }'
  

ステップ 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() メソッドの呼び出しに関するドキュメント。