ユーザープロファイルのライフサイクル

この記事では、Brazeユーザープロファイルのライフサイクルと、ユーザープロファイルを識別および参照するさまざまな方法について説明します。カスタマーライフサイクルをより詳しく理解したい場合は、ユーザーライフサイクルのマッピングに関するBrazeラーニングコースをご覧ください。

ユーザーに関連付けられるすべての永続データは、そのユーザープロファイルに保存されます。APIを使用してユーザープロファイルが作成された後、またはSDKによりユーザーが認識された後に、そのユーザーを識別および参照するために、そのプロファイルに多数のパラメーターを割り当てることができます。

これらのパラメーターには以下のものが含まれます。

• braze_id（Brazeにより割り当て）
• external_id
• email
• phone
• 設定した任意の数のカスタムユーザーエイリアス

匿名ユーザープロファイル

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として使用するリスク

メールアドレスまたはハッシュ化されたメールアドレスをBrazeのexternal IDとして使用すると、データソース間のID管理を簡素化できますが、ユーザーのプライバシーとデータセキュリティに対する潜在的なリスクを考慮することが重要です。

• 推測可能な情報：メールアドレスは容易に推測できるため、攻撃に対して脆弱です。
• 悪用のリスク：悪意のあるユーザーがWebブラウザーを改変して他人のメールアドレスをexternal IDとして送信した場合、機密性の高いメッセージやアカウント情報にアクセスされる可能性があります。

匿名ユーザーを識別した場合の動作

匿名ユーザーを識別する際には、2つのシナリオのいずれかが発生する可能性があります。

1) 匿名ユーザーが新しい識別済みユーザーになる場合：
そのexternal_idがまだBrazeに存在しない場合、匿名ユーザーは新しい識別済みユーザーとなり、匿名ユーザーのすべての属性と履歴が保持されます。

2) 匿名ユーザーが既存のユーザーとして識別される場合：
そのexternal_idがすでにBrazeに存在する場合、そのユーザーは別のデバイス（タブレットなど）やインポートされたユーザーデータなど、何らかの別の方法でシステム内のユーザーとしてすでに識別されています。

つまり、そのユーザーのプロファイルがすでに存在しています。この場合、Brazeは以下の処理を行います。

1. 匿名ユーザーを孤立化する
2. 匿名プロファイルから、識別済みユーザープロファイルにまだ存在しない特定のユーザープロファイルフィールドを統合する
3. ユーザー数が膨らまないように、ユーザー群から匿名プロファイルを削除する

匿名ユーザーと既知のユーザーの両方が名を持っている場合、既知のユーザーの名が維持されます。既知のユーザーの値がnullで匿名ユーザーに値がある場合、その値がこれらの特定のユーザープロファイルフィールドに該当するときは、匿名ユーザーの値が既知のユーザーのプロファイルに統合されます。

ユーザープロファイルにexternal_idを設定する方法については、ドキュメント（iOS、Android、Web）を参照してください。

レポートと統合されたプロファイル

送信後に匿名プロファイルと識別済みプロファイルが統合された場合、ダッシュボードのキャンペーンサマリーではその送信を残存する（識別済み）プロファイルに帰属させます。Currents、クエリビルダー、およびメッセージング履歴タブでは、引き続きその送信を孤立化されたプロファイルのユーザーID（送信時のID）に帰属させます。これは想定通りの動作です。転送されるフィールドの完全なリストについては、統合の動作を参照してください。

Currents、クエリビルダー、またはメッセージング履歴でその送信を見つけるには、孤立化されたプロファイルのbraze_idで検索してください。識別済みユーザーのbraze_idのみを使用するクエリでは、統合前の送信は返されません。

重複ユーザーの統合

ワークスペース内で重複するユーザープロファイルを特定した場合、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と入力することでこのユーザーを見つけることができます。

この情報がわからない場合は、識別子によるユーザープロファイルのエクスポートエンドポイントを呼び出し、APIレスポンスでユーザーエイリアスを見つけることができます。

既知のユーザープロファイルへのエイリアスの設定

ユーザーエイリアスは、既知のユーザープロファイルにも設定でき、別の外部で知られているIDで既知のユーザーを参照できます。たとえば、ユーザーがBraze内で参照したいビジネスインテリジェンスツールのID（Amplitude IDなど）を持っている場合があります。

ユーザーエイリアスの設定方法については、各プラットフォームのドキュメントを参照してください（iOS、Android、Web）。

高度なユースケース

SDKおよびAPIのユーザーデータエンドポイントを使用して、既存の識別済みユーザープロファイルに新しいユーザーエイリアスを設定できます。ただし、既存の不明なユーザープロファイルに対してAPIでユーザーエイリアスを設定することはできません。

ユーザーエイリアスも統合プロセスで統合されます。ただし、孤立させるユーザーとターゲットユーザーの両方が同じラベルのエイリアスを持っている場合、ターゲットユーザーのエイリアスのみが維持されます。

アプリをアンインストールして再インストールすると、そのユーザーに対して新しい匿名のbraze_idが生成されます。

ユーザーIDによるトラブルシューティング

すべてのユーザーIDを使用して、テスト用にダッシュボード内でユーザーを検索および特定できます。Brazeダッシュボードでユーザーを検索するには、テストユーザーの追加を参照してください。