ユーザー IDを設定する

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

匿名ユーザーについて

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

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

ユーザー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");

ユーザーのエイリアス

仕組み

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

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

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

ユーザーエイリアスは、名前とラベルの 2 つの部分で構成されます。名前は識別子そのものを指し、ラベルはその識別子が属するタイプを指す。例えば、サードパーティのカスタマーサポートプラットフォームに外部ID987654 を持つユーザーがいる場合、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 は、汎用一意識別子 (UUID) 標準を使用して作成することをおすすめします。UUID は、ランダムで適切に分散された 128 ビットの文字列です。

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

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