ユーザープロファイルのライフサイクル
この記事では、Brazeユーザープロファイルのライフサイクルと、ユーザープロファイルを識別および参照するさまざまな方法について説明します。カスタマーライフサイクルをより詳しく理解したい場合は、ユーザーライフサイクルのマッピングに関するBrazeラーニングコースをご覧ください。
ユーザーに関連付けられるすべての永続データは、そのユーザープロファイルに保存されます。APIを使用してユーザープロファイルが作成された後、またはSDKによりユーザーが認識された後に、そのユーザーを識別および参照するために、そのプロファイルに多数のパラメーターを割り当てることができます。
これらのパラメーターには以下のものが含まれます。
braze_id(Brazeにより割り当て)external_idemailphone- 設定した任意の数のカスタムユーザーエイリアス
匿名ユーザープロファイル
external_idが指定されていないユーザーは、匿名ユーザーと呼ばれます。例えば、Webサイトを訪問したがサインアップしなかったユーザーや、モバイルアプリをダウンロードしたがプロファイルを作成しなかったユーザーが該当します。
最初にSDKがユーザーを認識すると、関連するbraze_idを持つ匿名ユーザープロファイルが作成されます。braze_idはBrazeによって自動的に割り当てられる一意の識別子で、編集できず、デバイス固有のものです。この識別子は、APIを通じてユーザープロファイルを更新するために使用できます。
識別済みユーザープロファイル
アプリ内でユーザーが認識可能になった後(ユーザーIDやメールアドレスなどの形式を提供することで)、changeUserメソッド(Web、iOS、Android)を使用して、そのユーザーのプロファイルにexternal_idを割り当てることをお勧めします。external_idを使用すると、複数のデバイスにわたって同じユーザープロファイルを識別できます。
external_idを使用する追加のメリットには、以下が含まれます。
- 複数のデバイスやプラットフォームにわたって一貫したユーザー体験を提供します(例えば、iPhoneアプリのロイヤルユーザーに対して、Androidタブレットに離脱ユーザー向け通知を送信しないなど)。
- ユーザーがアプリをアンインストールして再インストールしたり、別のデバイスにインストールしたりするたびに新しいユーザープロファイルを作成していないことを確認し、分析の精度を向上させます。
- ユーザーデータエンドポイントを使用してアプリ外のソースからユーザーデータをインポートしたり、メッセージングエンドポイントを使用してトランザクションメッセージでユーザーをターゲットにしたりできます。
- セグメンターの「テスト」フィルターや、ユーザー検索ページで個々のユーザーを検索できます。
external IDに関する考慮事項

ユーザープロファイルを一意に識別する前に、external_id を割り当てないこと。ユーザーを識別した後、匿名ユーザーに戻すことはできません。
An は、エンド/users/external_ids/renameポイントexternal_idを使って更新できる。ただし、ユーザーのセッション中にexternal_id異なる設定を試みると、新しい設定external_idが関連付けられた新しいユーザープロファイルが作成される。2 つのプロファイル間でデータは渡されません。
メールアドレスまたはハッシュ化されたメールアドレスをexternal IDとして使用するリスク
メールアドレスまたはハッシュ化されたメールアドレスをBrazeのexternal IDとして使用すると、データソース間のID管理を簡素化できます。ただし、ユーザーのプライバシーとデータセキュリティに対する潜在的なリスクを考慮することが重要です。
- 推測可能な情報:メールアドレスは容易に推測できるため、攻撃に対して脆弱です。
- 悪用のリスク:悪意のあるユーザーがWebブラウザを改変して他人のメールアドレスを自分のexternal IDとして送信した場合、機密性の高いメッセージやアカウント情報にアクセスされる可能性があります。
匿名ユーザーを識別した場合の動作
匿名ユーザーを識別する際には、2つのシナリオのいずれかが発生する可能性があります。
1) 匿名ユーザーが新しい識別済みユーザーになる場合:
Brazeにexternal_idがまだ存在しない場合、匿名ユーザーは新しい識別済みユーザーになり、匿名ユーザーのすべての属性と履歴がそのまま保持されます。
2) 匿名ユーザーが既存のユーザーとして識別される場合:
Brazeにexternal_idがすでに存在する場合、そのユーザーは別のデバイス(タブレットなど)やインポートされたユーザーデータなど、他の方法でシステム内のユーザーとして以前に識別されています。
つまり、このユーザーのユーザープロファイルはすでに存在しています。この場合、Brazeは以下の処理を行います。
- 匿名ユーザーを孤立させる
- 匿名プロファイルから、識別済みユーザープロファイルにまだ存在しない特定のユーザープロファイルフィールドをマージする
- ユーザー数が水増しされないように、匿名プロファイルをユーザー群から削除する
匿名ユーザーと既知のユーザーの両方に名がある場合、既知のユーザーの名が維持されます。既知のユーザーの値がnullで匿名ユーザーに値がある場合、その値がこれらの特定のユーザープロファイルフィールドに該当する場合は、匿名ユーザーの値が既知のユーザーのプロファイルにマージされます。

匿名プロファイルからすべてのデータがマージされるわけではありません。プッシュトークンとメッセージング履歴は引き継がれ、匿名プロファイルのカスタム属性、カスタムイベント、購入履歴は、識別済みユーザープロファイルにそれらのフィールドがまだ存在しない場合にのみマージされます。データが競合する場合は、識別済みユーザーの値が保持されます。転送されるフィールドと転送されないフィールドの完全なリストについては、マージの動作を参照してください。
ユーザープロファイルにexternal_idを設定する方法については、ドキュメント(iOS、Android、Web)を参照してください。

孤立したユーザーはメッセージを受信する資格がありません。
重複ユーザーのマージ
ワークスペース内で重複するユーザープロファイルを特定した場合、REST APIを使用してマージできます。ユーザーのマージと利用可能な方法の詳細については、重複ユーザーのマージを参照してください。
ユーザーエイリアス
Brazeのexternal_id以外の識別子でユーザーを参照するには、ユーザープロファイルに対してユーザーエイリアスを設定します。ユーザープロファイルに設定されたエイリアスは、ユーザーのbraze_idやexternal_idを置き換えるのではなく、それらに加えて機能します。ユーザープロファイルに設定できるエイリアスの数に制限はありません。
各エイリアスはキーと値のペアとして機能し、2つの部分で構成されます。エイリアスのキーを定義するalias_labelと、値を定義するalias_nameです。任意の単一ラベルに対するalias_nameは、ユーザー群全体で一意でなければなりません(external_idと同様です)。既存のラベルと名前の組み合わせで2番目のユーザープロファイルを更新しようとしても、そのユーザープロファイルは更新されません。
ユーザーエイリアスの更新
エイリアスは、設定後にユーザーデータエンドポイントを使用するか、SDKを通じて新しい名前を渡すことで、指定されたラベルに対して新しい名前に更新できます。更新されたユーザーエイリアスは、そのユーザーのデータをエクスポートする際に表示されます。

匿名ユーザーへのタグ付け
ユーザーエイリアスを使用すると、匿名ユーザーに識別子をタグ付けすることもできます。たとえば、ユーザーがeコマースサイトにメールアドレスを提供したがまだサインアップしていない場合、そのメールアドレスをその匿名ユーザーのエイリアスとして使用できます。これらのユーザーは、エイリアスを使用してエクスポートしたり、APIで参照したりできます。
匿名ユーザープロファイルでのエイリアスの動作
エイリアスを持つ匿名ユーザープロファイルが後でexternal_idで識別された場合、通常の識別済みユーザープロファイルとして扱われますが、既存のエイリアスは保持され、引き続きそのエイリアスで参照できます。
ユーザーエイリアスの検索
ユーザーのエイリアス名とラベルがわかっている場合、ユーザー検索でalias_label:alias_nameの形式を使用してユーザーを見つけることができます。たとえば、名前がalias_name: bobby_aliasでラベルがalias_label: m4pzOndtA-CnO0uのエイリアスのみのプロファイルがある場合、m4pzOndtA-CnO0u:bobby_aliasと入力してこのユーザーを見つけることができます。
この情報がわからない場合は、Export user profile by identifierエンドポイントを呼び出し、APIレスポンスでユーザーエイリアスを確認できます。
既知のユーザープロファイルへのエイリアスの設定
ユーザーエイリアスは、既知のユーザープロファイルにも設定でき、既知のユーザーを別の外部既知IDで参照できます。たとえば、ユーザーがBraze内で参照したいビジネスインテリジェンスツールID(Amplitude IDなど)を持っている場合があります。
ユーザーエイリアスの設定方法については、各プラットフォームのドキュメントを参照してください(iOS、Android、Web)。


高度なユースケース
SDKおよびAPIのユーザーデータエンドポイントを使用して、既存の識別済みユーザープロファイルに新しいユーザーエイリアスを設定できます。ただし、既存の不明なユーザープロファイルに対しては、APIを通じてユーザーエイリアスを設定することはできません。
ユーザーエイリアスもマージプロセスで統合されます。ただし、孤立させるユーザーとターゲットユーザーの両方が同じラベルのエイリアスを持っている場合、ターゲットユーザーのエイリアスのみが維持されます。
アプリをアンインストールして再インストールすると、そのユーザーに対して新しい匿名のbraze_idが生成されます。
ユーザーIDによるトラブルシューティング
すべてのユーザーIDを使用して、テスト目的でダッシュボード内のユーザーを検索および識別できます。Brazeダッシュボードでユーザーを検索するには、テストユーザーの追加を参照してください。

Brazeは、異常に大きくなったユーザープロファイル(「ダミーユーザー」)をブロックします。これらのプロファイルは通常、統合の誤りが原因です。プロファイルは、以下のいずれかのしきい値を超えるとブロックされます。
- セッション数が5,000,000を超える
- 個別のカスタムイベント名が20,000を超える
- 購入における個別の商品名が20,000を超える
プロファイルがブロックされると、BrazeはSDKおよびREST APIの両方からそのプロファイルへのすべての受信データの取り込みを停止します。正当なユーザーにこの問題が発生した場合は、Brazeアカウントマネージャーにお問い合わせください。詳細については、スパムブロックを参照してください。