エンジニア向けのクイックスタート

For engineers implementing Amplitude15分Intermediate

このクイックスタートは、Amplitudeを初めて実装するエンジニア向けです。 以下の手順に従って、Browser SDKをインストールし、イベントがプロジェクトに流れることを確認し、ユーザーを識別します。

You'll set up

Before you start

  • AmplitudeアカウントとプロジェクトAPIキー。プロジェクトがない場合は、「プロジェクトを作成」に移動してください。

  • 製品のコードベース(スタックに応じてフロントエンドまたはバックエンド)へのアクセスが必要です。

  • Amplitude組織内のメンバー、開発者、または管理者の役割。

チームが何を追跡すべきかをまだ決めていない場合は、コードを書く前に、まず計装の事前作業に移動して追跡計画に沿って調整してください。

  1. ブラウザSDKをインストールする

    ブラウザSDKを追加する

    ブラウザSDKは、データをAmplitudeに最も早く取り込むための手段です。いずれかのインストール方法を選択し、そのページに従います。このページでは、イベントが到着したことを確認します。

    Amplitudeはまた、アカウントを最初に作成するときに、プロジェクト設定で事前設定されたスニペットとAIプロンプトも提供します。

    初期化後、最初のカスタムイベントを送信するためにamplitude.track('Event Name', { property: 'value' })呼び出します。

  2. キャプチャ

    自動キャプチャを有効にする

    自動キャプチャは、クリック数、ページビュー数、セッション数、フォームのやり取り数、ファイルのダウンロード数、マーケティングアトリビューションを追跡します。イベントを手動で呼び出す必要はありません。スクリプトスニペットとAIプロンプトのインストール方法により、これが有効になります。自分で設定するには、初期化期間中に以下のautocaptureオプションを渡します。

    js
    amplitude.init("AMPLITUDE_API_KEY", {
      autocapture: {
        attribution: true,
        fileDownloads: true,
        formInteractions: true,
        pageViews: true,
        sessions: true,
        elementInteractions: true,
        networkTracking: true,
        webVitals: true,
        frustrationInteractions: true,
      },
    });
    

    Amplitudeデバッガーを開き、ページビュー、セッション、インタラクションイベントが到着することを確認します。自動キャプチャが処理する動作に対して追跡コードを追加する必要はありません。

    自動キャプチャは、幅広い行動データをキャプチャするのに最適です。 購入、アップグレード、主要機能の使用など、ビジネスにとって重要なアクションの場合、これらのイベントが適切なプロパティを持つように明示的なamplitude.track()呼び出しを追加してください。

  3. 識別

    ユーザーを識別

    Autocaptureは、ユーザーが何をしているかを記録しますが、ユーザーが誰であるかは記録しません。ユーザーのサインアップ時またはログイン時にユーザーIDを設定してください。これにより、Amplitudeはセッションやデバイス間でそのユーザーのアクティビティを関連付けます。ログアウト時にreset()を呼び出し、そのデバイスの次のユーザーがIDを継承しないようにします。

    js
    // On sign-up or login
    amplitude.setUserId("USER_ID");
    // On logout
    amplitude.reset();
    

    USER_IDを、メールアドレスではなく、独自のシステムからの安定した識別子に置き換えてください。そのユーザーに属するイベントを送信する前に、ユーザーIDを設定します。 ユーザーIDを選択する際のベストプラクティスについては、「Identify users」を参照してください。

次のステップ

これは役に立ちましたか?

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.

このページでは