このページでは

Amplitudeクイックスタート

Amplitudeには3つのインストール方法があります。1つ目はフレームワークを検出してSDK連携を記述するCLIウィザード、2つ目はCursorまたはClaude Code内で使用できるコピー&ペースト用のAIプロンプト、3つ目は<head>サイトに追加できるブラウザスニペットです。これら3つの機能はすべて同じAmplitudeプロジェクトにデータを送信するため、最速のオプションから開始してから後で切り替えることができます。

お客様に最適なパスを選択してください


ウィザード CLI

開発者向けの完全なSDKセットアップ。 ウィザードは、Amplitudeでの認証を行い、使用しているフレームワークを検出し、カスタムイベントを提案し、データがプロジェクトに正常に送信されていることを確認してから終了します。

得られるもの

Node.js 20 が必要です。

  1. 実行

    セットアップウィザードを実行してください。ターミナル

    でコマンドを実行するか、ターミナル内の Claude Code から実行してください。

    bash
    npx @amplitude/wizard
    
  2. 追加

    API キーを追加 ウィザードの指示

    が表示されたら、トラッキングするプロジェクトの API キーを貼り付けてください。

    API キーの入手場所

    設定 > プロジェクト に移動し、追跡したいプロジェクトの API キーをコピーします。 APIキーが必要ですか?無料のAmplitudeアカウントを作成してください。

  3. 検証

    データが流れていることを検証します

    Amplitude Debuggerを開き、ウィザードのテストイベントがリアルタイムで到着することを確認します。

ヒント

  • 自動検出に頼るのではなく、--menuを使用してフレームワークを選択します。
  • ウィザードの実行中にtabを押すと、質問やフィードバックを送信できます。

AIプロンプト

AIアシスタントを使用したローコード設定。このプロンプトをAIコーディングツールにコピーすると、ウィザードフロー全体を実行することなく、JavaScriptウェブアプリ用にAmplitude Browser SDKを設定できます。

AI プロンプトを使用して設定する

AI ツールにコードを変更してもらいたい場合にこのオプションを使用します。 Amplitudeにフレームワークを検出して自動的にイベントを提案してもらいたい場合は、代わりにWizard CLIを使用してください。

何が得られるか JavaScript Web アプリ用の

  1. コピ

    ープロンプトを AI ツ

    ールにコピーします。それを Cursor、Claude Code、Copilot など、プロジェクトを編集できる別のコーディング アシスタントに貼り付けます。

    text
    Install and configure Amplitude for this JavaScript web application.
    Use API key: AMPLITUDE_API_KEY
    Requirements:
    - Run the implementation only on the client.
    - Initialize Amplitude once during app load.
    - Install the correct browser package for this project.
    - Enable fetchRemoteConfig: true.
    - Enable autocapture for attribution, page views, sessions, element interactions, form interactions, and file downloads.
    - Enable Session Replay with sampleRate: 1.
    - Preserve the project's existing TypeScript and framework patterns.
    
  2. レビュー

    生成された変更を確認します。

    アシスタントが SDK をインストールし、正しいクライアントエントリポイントで初期化し、コードをクライアント側に保存したことを確認します。

  3. 検証

    イベントが到着したことを確認します

    変更が反映されたら、Amplitude Debuggerを開き、ページビューとセッションデータがプロジェクトに到達していることを確認してください。

ヒント

  • コードブロック内のAPIキーボタンをクリックしてキーを挿入してから、プロンプトをコピーしてください。
  • まだプロジェクトとAPIキーが必要な場合は、無料のAmplitudeアカウントを作成してください。

ブラウザのスニペット

Webサイト向けに貼り付けと実行でインストールできます。 ビルド手順やnpmパッケージを使用せず、可能な限り迅速にブラウザへのインストールを行いたい場合は、このスクリプトをサイトの<head>に貼り付けてください。。

ブラウザ スニペットを使用して設定

静的サイト、CMS 駆動型サイト、または SDK のインストールよりもスクリプト タグの方が簡単なプロジェクトでは、このオプションを使用してください。フレームワーク対応のセットアップが必要な場合は、代わりにWizard CLIを使用してください。

得られるもの

  1. 貼り付け

    に追加してください。

    html
    <script src="https://cdn.amplitude.com/script/AMPLITUDE_API_KEY.js"></script>
    <script>
      window.amplitude.add(window.sessionReplay.plugin({ sampleRate: 1 }));
      window.amplitude.init("AMPLITUDE_API_KEY", {
        fetchRemoteConfig: true,
        autocapture: {
          attribution: true,
          fileDownloads: true,
          formInteractions: true,
          pageViews: true,
          sessions: true,
          elementInteractions: true,
          networkTracking: true,
          webVitals: true,
          frustrationInteractions: true,
        },
      });
    </script>
    
  2. 設定

    APIキーを設定してページを読み込む

    プレースホルダをプロジェクトのAPIキーに置き換えてから、ブラウザで追跡対象のページを読み込みます。

  3. 確認

    Amplitudeのデータを確認

    Amplitudeデバッガーを開き、ページビュー、セッション、インタラクションイベントを確認します。

ヒント

  • コードブロック内のAPIキーボタンをクリックしてキーを挿入してから、スニペットをコピーしてください。
  • プロジェクトでEUデータレジデンシーを使用している場合は、EUのCDNホストを使用してください。
  • プロジェクトとAPIキーが必要な場合は、無料のAmplitudeアカウントを作成してください。

次のステップへ進む

データの流れが始まったら、これらのガイドを使用して実装を拡張してください。

このセクションの詳細

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