このページでは

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.

Amplitudeの使用を開始する

SDKのいずれか、またはSegment、mParticle、Tealiumなどのサードパーティ連携を使用してAmplitudeにデータを送信し、次にイベントのインストルメンテーション、ユーザープロパティの設定、グループタイプの設定を行うことで、チャートに実際のプロダクト使用状況が反映されます。計測をリリースする前に、少なくとも2つのプロジェクト（1つはステージング用、1つは本番用）を設定してください。これは、Amplitudeが過去のイベントデータを遡及的に名前を変更したり変更したりできないためです。

新しいAmplitudeプロジェクトをゼロから立ち上げる場合は、ここから始めましょう。 すでにデータを送信しており、分析用にモデル化する必要がある場合は、代わりにデータ計画プレイブックを参照してください。

インストルメンテーションにおけるベストプラクティス

Amplitudeの計測を行う際には、以下の推奨ベストプラクティスに従ってください：

  • インストルメンテーションは常にテストする：Amplitudeでは、組織内のすべての本番プロジェクトに対してテストプロジェクトを用意することを推奨します。テストプロジェクトは、本番データをAmplitudeに送信する前に、インストルメンテーションをテストするための信頼性の高い方法となります。
  • Amplitudeは過去のデータを遡って変更することはできません：インストルメンテーションが間違っていても、後で収集したデータをクリーンアップすることはできません。
  • 少なくとも2つのAmplitudeプロジェクトを設定してください。1つは開発環境またはステージング環境用で、もう1つは本番環境用です。 2つのプロジェクトでは、テストデータを本番データとは別に保管します。
  • 適切なキーを送信する：HTTP APIを使用してデータをサーバー側に送信する場合は、各イベントにsession_idとinsert_idを送信してください。

Amplitudeによるデータの受け取り方法

SDKまたはサードパーティを通じてAmplitudeにデータを送信できます：

Amplitude API

Amplitudeには、プラットフォームで使用できる多くのAPIがあります。

すべての API リファレンスを参照してください。

Amplitudeスキーマ

データ計画プレイブックでは、Amplitudeスキーマがどのように連携しているかを説明しています。 タクソノミー設計の詳細については、このドキュメントを参照してください。

イベントの命名規則

イベントを計測した後は、生データ内のそのイベントタイプの名前を変更することはできません。 たとえば、アプリのv1.0では、開発者は次のイベントタイプを実装します。

Amplitude.getInstance().logEvent('Play song');

その後、アプリのv2.0で、開発者はこのイベントタイプを実装します。

Amplitude.getInstance().logEvent('play song');

Amplitudeに渡される文字列は大文字と小文字を区別するため、Amplitudeはこれら2つのイベントタイプを別々のイベントとして解釈します。 計測中にイベント名が一貫した構文に従っていることを確認してください。

ユーザープロパティをインストルメントする

ユーザープロパティは、個々のユーザーに固有の属性です。ユーザープロパティの例としては、所在地、言語、アカウントタイプ、使用金額、プレイヤータイプなどがあります。

どのユーザープロパティを追跡すべきかについての推奨事項については、「データ計画プレイブック」を参照してください。

Amplitude SDKには、ユーザープロパティ値を更新するために使用できるいくつかのユーザープロパティ操作が含まれています。

  • set：プロパティ値を設定または上書きします。
  • setOnce：値がまだ設定されていない場合にのみ値を設定します。
  • unset：値をnullにリセットします。
  • add: 数値を指定した数だけ増やします。
  • append: 値をプロパティ配列に追加します。
  • prepend：プロパティ配列の先頭に値を追加します。

また、Identify APIを使用して、別のイベントを送信することなくユーザーのユーザープロパティの値を更新することもできます。新しい値は、ユーザーがオーガニックに送信する次のイベントに適用されます。

グループタイプのインストルメント

Amplitudeのアカウントレベルのレポート機能を使用するには、グループタイプを実装してください。アカウントレベルのレポート作成機能を使用すると、ユーザープロパティグループごとにカウントできます。これにより、個々のユーザーレベルではなくグループレベルでデータを処理できます。 Amplitudeでは最大5つのグループタイプを使用できます。サードパーティ製ツールを使用してAmplitudeを計測する場合（mParticle、Segment、Tealium）、この最大しきい値は、パートナーの制限に基づいて低くなる場合があります。

Amplitudeによるユニークユーザーとセッションの追跡方法

Amplitudeは、ユーザーID、デバイスID、Amplitude IDのシステムを通じてユニークユーザーを追跡します。 詳細については、「ユニークユーザーの追跡」を参照してください。

Amplitudeでは、セッションとはユーザーがプロダクト内でアクティブである単一の連続した期間のことです。AmplitudeはすべてのイベントにセッションIDを送信するため、セッションを追跡できます。 詳細については、「Amplitudeでのセッションのトラッキング」を参照してください。

一般的なSDK設定オプション

このセクションでは、ユーザーが一般的に変更するAmplitude SDKの設定オプションについて詳しく説明します。

  • minTimeBetweenSessions（iOS/Android）：新しいセッションを開始する前にアプリをバックグラウンドにしておく必要がある最小時間です。
  • sessionTimeout（Web）：新しいセッションが開始されるまでに経過する必要のあるイベント間の最小時間です。
  • batchEvents：モバイルSDKの場合にはデフォルトで有効になっており、Webの場合にはオプションです。
  • eventUploadPeriodMillis: batchEventsが有効な場合、このオプションはイベントバッチアップロードの間隔を設定します。
  • eventUploadThreshold: batchEventsが有効な場合、このオプションはバッチごとのイベント数の最小値を設定します。
  • optOut: 有効な場合、現在のユーザーを追跡から除外します。
  • offline: イベントの送信を禁止します。
  • saveEvents: すべての SDK でデフォルトで有効になっています。 SDK が未送信のイベントをデバイスに保存できるようにします。
  • savedMaxCount：デバイスに保存されている未送信イベントの最大数です。デフォルトは 1000 です。

データのバックフィル

以下の場合にデータのバックフィリングを検討してください：

  1. Amplitudeで履歴データを分析したい場合。 Amplitudeへのデータのバックフィルの詳細な手順については、「データバックフィルガイド」を参照してください。
  2. このプロダクトにはすでにユーザーがいます。これらのユーザーがいつAmplitudeに初めて登録されたかを正確に反映したいと考えています。

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