ユーザー ID の設定

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

匿名ユーザーについて

After you integrate the Braze SDK, users who launch your app for the first time will be considered “anonymous” until you call the changeUser method and assign them an external_id. Once assigned, you can’t make them anonymous again. However, if they uninstall and reinstall your app, they will become anonymous again until changeUser is called.

If a previously-identified user starts a session on a new device, all of their anonymous activity will automatically sync to their existing profile after you call changeUser on that device using their external_id. This includes any attributes, events, or history collected during the session on the new device.

ユーザーIDの設定

ユーザーIDを設定するには、ユーザーが最初にログインした後、changeUser() メソッドを呼び出す。IDは一意でなければならず、私たちの命名のベストプラクティスに従わなければならない。

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

• アンドロイド
• swift
• ウェブ
• コルドバ
• ロク
• ユニティ
• アンリアル・エンジン

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
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
UBraze->ChangeUser(TEXT("YOUR_USER_ID_STRING"));

ユーザーのエイリアス

仕組み

Although anonymous users don’t have external_ids, you can assign them a user alias instead. You should assign a user alias when you want to add other identifiers to the user but don’t know what their external_id is (for example, they aren’t logged in). With user aliases, you also can:

• Use the Braze API to log events and attributes associated with anonymous users
• Use the External User ID is blank segmentation filter to target anonymous users in your messaging

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

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

• android
• swift
• ウェブ
• rest api

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
braze.getUser().addAlias(ALIAS_NAME, ALIAS_LABEL);

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

IDネーミングのベストプラクティス

ユーザーIDはUniversally Unique Identifier（UUID）標準を使って作成することを推奨する。

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

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