ユーザー IDを設定する

Braze SDKでユーザーIDを設定する方法を学習します。これは、デバイスやプラットフォームを超えてユーザーを追跡し、ユーザーデータAPIを通じてユーザーデータをインポートし、メッセージングAPIを通じてターゲットメッセージを送信するための一意の識別子です。ユーザーに固有の ID を割り当てない場合、Braze は代わりに匿名 ID を割り当てますが、割り当てるまでこれらの機能を使用することはできません。

匿名ユーザーについて

Braze SDKを統合した後、アプリを初めて起動したユーザーは、changeUser メソッドを呼び出してexternal_id を割り当てるまで、「匿名」とみなされる。一度割り当てられると、再び匿名にすることはできない。しかし、アプリをアンインストールして再インストールすると、changeUser が呼び出されるまで、再び匿名になる。

以前に識別されたユーザーが新しいデバイスでセッションを開始した場合、そのユーザーのexternal_id を使用してそのデバイスでchangeUser を呼び出すと、すべての匿名アクティビティが自動的に既存のプロファイルに同期される。これには、新しいデバイスでのセッション中に収集された属性、イベント、または履歴が含まれる。

匿名ユーザーのトラッキングを防止する

ユーザーが識別される前にデータを収集しないユースケースの場合、ユーザーがログインして external_id が利用可能になるまで Braze SDK の初期化を遅延させることができます。コード内にフラグを設定し、ユーザーがサインインしたときに true に切り替え、そのフラグが設定されている場合にのみ SDK を初期化します。

ユーザーIDの設定

ユーザーIDを設定するには、ユーザーが最初にログインした後に changeUser() メソッドを呼び出します。ID は一意であり、命名のベストプラクティスに従っている必要があります。

代わりに一意な識別子をハッシュする場合は、ハッシュ関数の入力を正規化してください。たとえば、メールアドレスをハッシュする場合は、先頭または末尾のスペースを削除し、ローカライゼーションを考慮します。

• web
• android
• swift
• cordova
• roku
• unity
• react native

1
braze.changeUser(YOUR_USER_ID_STRING);

1
Braze.getInstance(context).changeUser(YOUR_USER_ID_STRING);

1
Braze.getInstance(context).changeUser(YOUR_USER_ID_STRING)

1
AppDelegate.braze?.changeUser(userId: "YOUR_USER_ID")

1
[AppDelegate.braze changeUser:@"YOUR_USER_ID_STRING"];

1
BrazePlugin.changeUser("YOUR_USER_ID");

1
m.Braze.setUserId(YOUR_USER_ID_STRING)

1
AppboyBinding.ChangeUser("YOUR_USER_ID_STRING");

1
Braze.changeUser("YOUR_USER_ID_STRING");

changeUser() の仕組み

changeUser() を呼び出すと、以下の動作が適用されます。

• すでに設定されている同じユーザー ID で changeUser() を呼び出しても、セッション数には影響しません。
• 異なるユーザー ID で changeUser() を呼び出すと、現在のセッションが自動的に終了し、新しいセッションが開始されます。
• 匿名ユーザーが新しいユーザー ID（Braze にまだ存在しないもの）で changeUser() を呼び出すと、匿名プロファイルのデータが新しい識別済みプロファイルにマージされます。
• 匿名ユーザーが既存のユーザー ID で changeUser() を呼び出すと、匿名プロファイルのデータは識別済みプロファイルにマージされません。

ユーザーエイリアス

仕組み

匿名ユーザーはexternal_ids 、代わりにユーザーエイリアスを割り当てることができる。ユーザーエイリアスを割り当てる必要があるのは、ユーザーに他の識別子を追加したいが、そのユーザーのexternal_id がわからない場合である（たとえば、ログインしていない）。ユーザーエイリアスを使えば、こんなこともできる：

• Braze APIを使用して、匿名ユーザーに関連するイベントと属性を記録する。
• 外部ユーザーIDが空白のセグメンテーションフィルターを使用して、匿名ユーザーをメッセージングのターゲットにする。

ユーザーエイリアスの設定

ユーザーエイリアスは、名前とラベルの 2 つの部分で構成されます。名前は識別子そのものを指し、ラベルはその識別子が属するタイプを指します。たとえば、サードパーティのカスタマーサポートプラットフォームに external ID 987654 を持つユーザーがいる場合、Braze でそのユーザーに 987654 という名前と support_id というラベルのエイリアスを割り当てることで、プラットフォーム間でそのユーザーを追跡できます。

• web
• android
• swift
• rest api
• react native

1
braze.getUser().addAlias(ALIAS_NAME, ALIAS_LABEL);

1
Braze.getInstance(context).getCurrentUser().addAlias(ALIAS_NAME, ALIAS_LABEL);

1
Braze.getInstance(context).currentUser?.addAlias(ALIAS_NAME, ALIAS_LABEL)

1
Appboy.sharedInstance()?.user.addAlias(ALIAS_NAME, ALIAS_LABEL)

1
 [[Appboy sharedInstance].user addAlias:ALIAS_NAME withLabel:ALIAS_LABEL];

1
2
3
4
{
  "alias_name" : (required, string),
  "alias_label" : (required, string)
}

1
Braze.addAlias("ALIAS_NAME", "ALIAS_LABEL");

ID 命名のベストプラクティス

ユーザー ID は、Universally Unique Identifier (UUID) 標準を使用して作成することをおすすめします。UUID は、ランダムで適切に分散された 128 ビットの文字列です。

あるいは、既存の一意識別子（名前やメールアドレスなど）をハッシュ化してユーザー ID を生成することもできます。その場合は、必ず SDK 認証を実装し、ユーザーのなりすましを防いでください。

最初からユーザー ID に正しい名前をつけることが重要ですが、将来的にはいつでも /users/external_ids/rename エンドポイントを使って変更できます。