追跡計画を作成する

追跡計画は、収集するすべてのイベントとプロパティ、それらを収集する理由、およびそれらを送信するソースを定義します。 コードを実装する前に1つ構築することで、アナリスト、PM、エンジニアは、データが格納された後にフィールド名について議論することなく、1つのスキーマに基づいて作業できます。Amplitudeデータでは、計画はイベントやプロパティの隣に存在するため、編集内容は計装、ガバナンス、Ampliコードジェネレーターに直接流れます。

チームがイベントやプロパティを一緒に設計するためのレビュー可能な共有ワークスペースを必要としている場合は、Amplitude DataのUIで直接計画を作成または更新できます。 AIコーディングクライアントにコードから直接同じトラッキングプランを作成または編集してもらいたい場合は、代わりにAmplitude MCPサーバーを使用してください。 計画を構築する前に計画を設計する際の戦略については、データ計画のプレイブックを参照してください。

トラッキングプランを見つける

Amplitudeの各プロジェクトには独自のトラッキング計画があります。ご利用のプランを見つけるには、上部ナビゲーションにある「データ」タブを選択してください。 次に、左側のナビゲーション画面で、上部のドロップダウンからプロジェクトを選択します。

プランのイベントとプロパティは左側に表示されます。

トラッキングプランを更新してください

プランを更新するには、次の2つの方法があります。

• 実装前に新しいイベントやプロパティを積極的に計画し、Amplitude データを使用して詳細を定義し、チームメンバーと協力して、追跡したいものについて合意します。（推奨）
• Amplitudeが初めてデータを取り込んだ後、事後的にイベントやプロパティを計画します。デフォルトでは、これらのイベントとプロパティはプランに「予期しない」として表示されます。 これらのデータをプランに追加することも、データを削除してデータ収集を停止し、データカタログから削除することもできます。

また、AI コーディングクライアントから Amplitude MCP サーバーを通じてイベント、プロパティ、ブランチを作成および更新することもできます。 manage_amp_eventsやcreate_propertiesのようなMCPツールは、Amplitudeデータで管理しているトラッキングプランと同じものを修正します。

ソースを作成する

ソースは、Amplitudeに送信されたデータの送信元を表します（iOS、Android、Web、バックエンドなど）。Ampli Developer エクスペリエンスを使用する場合は、正しいトラッキングライブラリを生成するためのソースを作成する必要があります。

ソースを作成するには、次の手順に従ってください。

1. データ > ソースに移動し、ソースを追加を選択します。
2. 追加したいSDKソースを選択します。
3. 新しいソースに名前を付け、「作成」を選択します。

イベントを作成する

イベントとは、ユーザーがプロダクト内で実行できる個別のアクションです。イベントを作成するときに、イベントに関するメタデータを指定できます。これは、実装後のアナリティクスでの実装と検出の両方に役立ちます。

イベントを作成するには、次の手順に従ってください。

1. データ > イベント に移動し、Create event を選択します。

2. イベントに名前を付けます。 Amplitudeは、お客様の命名規則に合致するように変更を提案します。

3. ソースを追加して、このイベントをどこで計測するかを指定してください。

4. 次のような関連メタデータをすべて追加してください：

   • イベントを送信するタイミングやイベントに関する重要な詳細を定義するのに役立つ説明です。
   • より多くのコンテキストを提供し、類似したイベントをグループ化するためのカテゴリ。
   • イベントのアクティブまたは非アクティブのステータス。 アクティブなイベントとは、ユーザーがトリガーするイベントです。 非アクティブなイベントはユーザーに関連していますが、ユーザーによる直接のアクション（プッシュ通知の受信など）によって開始されることはありません。

5. 関連するイベントプロパティをイベントに追加します。

イベントプロパティを作成する

イベントプロパティは、イベントとユーザーがイベントをトリガーしたコンテキストを記述します。たとえば、Song PlayedイベントにはSong Titleプロパティが含まれている場合があります。名前、説明、例、および規則によって各プロパティが定義されます。 ルールは各データタイプに固有です。 たとえば、Song Title という型のプロパティ String には、最小長、最大長、および Regex というルールを設定できます。

新しいイベントプロパティを作成するには、次の手順に従います。

1. Amplitudeデータで、データ > プロパティに移動し、イベントプロパティタブを選択します。

2. ［イベントプロパティを作成］を選択します。

3. イベントプロパティに名前を付け、次のような関連メタデータをプロパティに追加します。

   • 説明。値の例を含めると役に立つ場合があります。
   • このプロパティがこのイベントで必要かどうか。 この情報が存在する場合、Amplitudeがその情報を含まないイベントを受信した場合、Amplitudeデータは警告を生成します。
   • データ型（文字列や数値など）とその他のルール。

これで、このプロパティをイベントに追加できるようになりました。

既存のプロパティを追加したり、イベント内に新しいプロパティを作成したりするには、次の手順に従ってください。

1. Amplitude Dataで、「*データ」>「イベント」*に移動し、プロパティを追加したいイベントを選択します。
2. イベント詳細ペインで、［プロパティを追加］を選択します。
3. 新しいプロパティに名前を付けるか、既存のプロパティを選択してイベントに追加してください。

ユーザープロパティを作成する

ユーザープロパティは、ユーザーに関する特性を取得します。 ユーザープロパティを設定すると、その値が更新されるまで、ユーザーがその後トリガーするすべてのイベントに自動的に適用されます。

新しいユーザー プロパティを作成するには、次の手順に従います。

1. Amplitude Dataで、「*データ」>「プロパティ」*に移動し、「ユーザープロパティ」タブを選択します。

2. [ユーザープロパティを作成] を選択します。 新しいユーザープロパティに名前を付けます。

3. 次のような関連メタデータをプロパティに追加します。

   • 説明。値の例を含めると役に立つ場合があります。
   • データ型（文字列や数値など）とその他のルール。

グループプロパティを使用してグループを作成する

グループ プロパティを使用すると、group()通話が実行されるたびにユーザを特定のアカウント（名前、業界、従業員など）に関連付けることが容易になります。 グループプロパティは、ユーザーのグループを追跡したい場合に役立ちます（たとえば、会社内の特定のユーザーではなく、会社全体でのイベントを追跡する場合など）。

グループを作成するには、次の手順に従ってください。

1. Amplitude Dataで、「データ」>「グループ」に移動し、「グループを作成」を選択します。

2. グループに名前を付け、次のような関連メタデータを追加してください。

   • 説明。値の例を含めると役に立つ場合があります。
   • データ型（文字列や数値など）とその他のルール。

3. このグループタイプに適用されるグループプロパティをすべて追加します。

グループプロパティを作成するには、次の手順に従います。

1. Amplitudeデータで、「*データ」>「プロパティ」*に移動し、「グループプロパティ」タブを選択します。

2. ［グループプロパティを作成］を選択します。

3. グループに名前を付け、次のような関連メタデータを追加してください。

   • 説明。値の例を含めると役に立つ場合があります。
   • データ型（文字列や数値など）とその他のルール。

計画についてコラボレーションする

自分が行った変更についてフィードバックが必要な場合は、イベントやプロパティのリッチテキストエディタで同僚を@メンションすることで、メール通知やSlackメッセージを送信できます。このアプローチは、ブランチで作業をしていて、使用を計画しているイベント名とプロパティ名を確定しているときに役立ちます。

開発者に計画を送信する

最後に、この計画を開発者に送信してください。

Ampli開発者ツールを使用している場合、Ampli開発者ツールはお客様のトラッキングプランを消費し、それをタイプセーフな自動生成コードとして開発者に提示します。Amplitude データは、すべての一般的なプラットフォームとプログラミング言語に対応したトラッキングライブラリを生成できます。 自動生成されたライブラリは、アナリティクスプロバイダーの SDK に対する軽量なラッパーであり、タイプセーフティを提供し、リンティングをサポートし、入力検証などの追加機能を有効にします。 このコードは、追跡計画の仕様を正確に複製し、そのすべての規則と要件を適用します。

また、ブランチへのリンクを送信するか、Amplitude Dataに直接送信することもできます。そこで、お客様が指定した詳細を確認できます。