ユーザー識別子のカスタマイズ¶

SDK は匿名ユーザーに対して識別子を生成します。ユーザーがログインした後、setUser() を呼び出して安定したビジネスユーザー情報を書き込むことで、Session をまたいで同一ユーザーの View、Action、Resource、Error をクエリできるようになります。

少なくとも id を指定することを推奨します。頻繁に変更されるニックネームやメールアドレスを安定したユーザー ID の代わりに使用しないでください。

NPM の例¶

import { datafluxRum } from "@cloudcare/browser-rum"

datafluxRum.setUser({
  id: "user-1234",
  name: "John Doe",
  email: "john@example.com",
  membership_level: "gold"
})

CDN の例¶

window.DATAFLUX_RUM &&
  window.DATAFLUX_RUM.setUser({
    id: "user-1234",
    name: "John Doe",
    email: "john@example.com"
  })

window.DATAFLUX_RUM.onReady(function () {
  window.DATAFLUX_RUM.setUser({
    id: "user-1234",
    name: "John Doe",
    email: "john@example.com"
  })
})

ログアウトまたはユーザー切り替え¶

ログアウト時には clearUser() を呼び出し、後続のイベントが元のユーザーに関連付けられないようにします。

datafluxRum.clearUser()

SDK 3.3.6 以降では、ログイン、ログアウト、またはアカウント切り替え後に、ユーザー情報を更新してから startSession() を呼び出すことで、新しい Session 境界を即座に作成できます。

datafluxRum.setUser({ id: "user-5678" })
datafluxRum.startSession()

CDN で導入する場合は、window.DATAFLUX_RUM.clearUser() および window.DATAFLUX_RUM.startSession() を使用します。

注意事項¶

1. パスワード、アクセストークン、身分証明書番号などの機密情報は書き込まないでください。
2. ユーザー情報は、設定後に生成されるイベントにのみ影響します。既に報告済みのデータは変更されません。
3. ユーザーを切り替えた後は、ユーザー情報と Session を同期して更新し、2 つのアカウントのデータが同じ Session に混在しないようにしてください。

確認¶

ユーザーを設定した後、ページ操作を 1 回トリガーし、View または Action エクスプローラーでイベントに user.id が含まれていることを確認します。ログアウトして clearUser() を呼び出した後、新しく生成されるイベントは元のユーザーに関連付けられないことを確認してください。