ユーザーを識別する

Amplitude アカデミー

Amplitudeによるユニークユーザーの追跡

Amplitudeでユニークユーザーを追跡する方法について説明します。

今すぐ始める

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オブジェクトを送信します。このオブジェクトは、イベントを送信することなくユーザープロパティを設定します。

ts
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に新しいユーザーとして表示されます。

ts
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.

このページでは