ユーザーを識別する
Amplitudeは3つのIDを通じてユーザーを識別します。 SDKはデバイスIDを自動的に送信します。Amplitudeは、ユーザーのデバイスを1つのプロファイルに統合するAmplitude IDを計算します。誰かがサインインしたときに、ユーザーIDを設定してください。
ユーザーIDの設定はオプションですが、Amplitudeはユーザーの使用するすべてのデバイスからのイベントを接続できるため、推奨されます。 ユーザーがアカウントを作成したり、ログインしたりした後に設定します。 Amplitudeはまた、サインイン前の匿名イベントをそのユーザーIDに添付するため、匿名ユーザーに設定する必要はありません。 プロダクトがユーザーIDを割り当てていない場合は、このページをスキップしてください。
Amplitudeがデバイスとプロファイルをどのようにマージするかについては、「Amplitudeがユニークユーザーをどのように識別するか」を参照してください。
ユーザーID設定のベストプラクティス
- **ユーザーIDが存在しない場合は、設定しないでください。**たとえば、複数のユーザーに対してユーザーIDを文字列
Noneに設定した場合、Amplitudeはそれらのユーザーを別々のユーザーとして認識しません。代わりに、Amplitudeはこれらのユーザー全員が同じユーザーであると想定し、それらのユーザーに関するすべてのイベントをそのNoneユーザーIDの下にまとめます。 ユーザーIDは後でいつでも設定できます。 - 変更される可能性があるユーザー ID は割り当てないでください。 ユーザー ID は永久に固定されます。 たとえば、メールアドレスは変更されるため、ユーザーのメールアドレスをユーザー ID として設定しないでください。
- ユーザー ID は大文字と小文字を区別します。 ユーザーIDを異なる大文字・小文字に設定した場合、Amplitudeは同じユーザーの2つの別々のプロファイルを追跡します。
- サーバ側でユーザーIDを割り当てることは難しい場合があります。 ユーザーIDの割り当てに問題が発生した場合は、Amplitude サポートまでお問い合わせください。
- **ユーザーがログアウトしたときにリセットします。**そうでない場合、同じデバイス上の次のユーザーからのイベントは前のユーザーに関連付けられます。
ユーザーIDを設定する
ユーザーがサインアップまたはログインした後に、ユーザーIDを設定します。 USER_IDを、メールアドレスではなく、独自のシステムからの安定した識別子に置き換えてください。ユーザーを記述するには、Identifyオブジェクトを送信します。このオブジェクトは、イベントを送信することなくユーザープロパティを設定します。
amplitude.setUserId("USER_ID");
const identifyEvent = new amplitude.Identify();
identifyEvent.set("location", "LA");
amplitude.identify(identifyEvent);
すべてのIdentify操作について、Browser SDKドキュメントのユーザープロパティを参照してください。
その他のプラットフォームについては、プラットフォームのSDKドキュメントのユーザーIDセクションを参照してください。
ユーザーがログアウトしたときにリセットする
クライアント側のSDKでは、ユーザーがログアウトしたときにresetを呼び出します。resetはユーザーIDを消去し、新しいデバイスIDを生成します。そのデバイス上の次のアクティビティはAmplitudeに新しいユーザーとして表示されます。
amplitude.reset();
これは役に立ちましたか?
For AI agents: a documentation index is available at /docs/llms.txt. Append .md to any page URL for markdown, or send Accept: text/markdown.