ユーザープロファイルのライフサイクル
この記事では、Brazeのユーザープロファイルのライフサイクルと、ユーザープロファイルを識別および参照するさまざまな方法について説明します。カスタマーライフサイクルをより詳しく理解したい場合は、ユーザーライフサイクルのマッピングに関するBraze Learning コースをご覧ください。
ユーザーに関連付けられるすべての永続データは、そのユーザーのユーザープロファイルに保存されます。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を割り当てないでください。ユーザーを識別した後、匿名ユーザーに戻すことはできません。
external_idは/users/external_ids/renameエンドポイントを使用して更新できます。ただし、ユーザーのセッション中に異なるexternal_idを設定しようとすると、新しいexternal_idが関連付けられた新しいユーザープロファイルが作成されます。2つのプロファイル間でデータが引き継がれることはありません。
メールアドレスまたはハッシュ化されたメールアドレスを external ID として使用するリスク
メールアドレスやハッシュ化されたメールアドレスを Braze の external ID として使用すると、データソース全体でのID管理を簡素化できます。ただし、ユーザーのプライバシーとデータセキュリティに対する潜在的なリスクを考慮することが重要です。
- 推測可能な情報: メールアドレスは容易に推測できるため、攻撃に対して脆弱です。
- 悪用のリスク: 悪意のあるユーザーが Web ブラウザーを改変して他人のメールアドレスを自分の external ID として送信した場合、機密性の高いメッセージやアカウント情報にアクセスできてしまう可能性があります。
匿名ユーザーを識別した場合の動作
匿名ユーザーを識別すると、次の2つのシナリオのいずれかが発生します。
1) 匿名ユーザーが新しい識別済みユーザーになる: external_id がまだ Braze に存在しない場合、匿名ユーザーは新しい識別済みユーザーになり、匿名ユーザーの属性と履歴をすべてそのまま保持します。
2) 匿名ユーザーが既存のユーザーとして識別される: external_id がすでに Braze に存在する場合、このユーザーは別のデバイス（タブレットなど）やインポートされたユーザーデータなど、何らかの別の方法で、すでにシステム内のユーザーとして識別されていたことになります。
つまり、このユーザーのユーザープロファイルはすでに存在しています。この場合、Braze は次の処理を行います。
- 匿名ユーザーを孤立させます
- 識別済みユーザープロファイルにまだ存在しない特定のユーザープロファイルフィールドを、匿名プロファイルから統合します
- ユーザー数が水増しされないよう、匿名プロファイルをユーザー群から削除します
匿名ユーザーと既知のユーザーの両方に名がある場合は、既知のユーザーの名が維持されます。既知のユーザーの値が null で匿名ユーザーに値がある場合、その値がこれらの特定のユーザープロファイルフィールドに該当すれば、匿名ユーザーの値が既知のユーザーのプロファイルに統合されます。
匿名プロファイルのすべてのデータが統合されるわけではありません。プッシュトークンとメッセージエンゲージメント履歴は引き継がれます（受信したキャンペーンやセグメンテーションに使用されます）。また、匿名プロファイルのカスタム属性、カスタムイベント、購入履歴は、識別済みユーザープロファイルにそれらのフィールドがまだ存在しない場合にのみ、識別済みユーザーに統合されます。データが競合する場合は、識別済みユーザーの値が保持されます。なお、メッセージング履歴タブはデータウェアハウスを基盤としており、統合後に更新されないため、統合前のイベントはそこに表示されません。転送されるフィールドと転送されないフィールドの完全な一覧（統合が反映されない画面を含む）については、統合の動作を参照してください。
ユーザープロファイルに external_id を設定する方法については、ドキュメント（iOS、Android、Web）を参照してください。
レポートと統合されたプロファイル
送信後に匿名プロファイルと識別済みプロファイルが統合された場合、ダッシュボードのキャンペーン概要では、その送信は存続する（識別済み）プロファイルに帰属します。一方、Currents、クエリビルダー、およびメッセージング履歴タブでは、引き続き孤立したプロファイルのユーザー ID（送信時点の ID）に送信が帰属します。これは想定どおりの動作です。転送されるフィールドの完全な一覧については、統合の動作を参照してください。
Currents、クエリビルダー、またはメッセージング履歴でその送信を見つけるには、孤立したプロファイルの braze_id を検索してください。識別済みユーザーの braze_id のみを使用するクエリでは、統合前の送信は返されません。
孤立したユーザーはメッセージを受信できません。
重複ユーザーの統合
ワークスペース内で重複するユーザープロファイルを特定した場合は、REST APIを使用してそれらを統合できます。ユーザーの統合と利用可能な方法の詳細については、重複ユーザーの統合を参照してください。
ユーザーエイリアス
Brazeのexternal_id以外の識別子でユーザーを参照するには、ユーザープロファイルにユーザーエイリアスを設定します。ユーザープロファイルに設定したエイリアスは、ユーザーのbraze_idやexternal_idを置き換えるのではなく、それらに追加される形で機能します。1つのユーザープロファイルに設定できるエイリアスの数に制限はありません。
各エイリアスは、2つの部分で構成されるキーと値のペアとして機能します。エイリアスのキーを定義するalias_labelと、値を定義するalias_nameです。1つのラベルに対する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のアカウントマネージャーにお問い合わせください。詳しくは、スパムブロッキングを参照してください。