アナリティクスのデバッグ

Amplitudeのインストルメンテーションをデバッグするには、3つのツールを使用します。インジェスチョンデバッガーはリクエストとスロットリングをリアルタイムで検査し、ユーザールックアップは単一ユーザーのイベントストリーム全体を表示し、Chrome拡張機能であるインストルメンテーションエクスプローラーは、サイト内をクリックするユーザーのイベントをキャプチャします。これらのツールを使用して、イベントの到着を確認したり、そのプロパティを検証したり、特定のトリガーでインスツルメンテーションのバグを追跡したりできます。

イベントがAmplitudeに到達していないと思われる場合は、インジェスチョンデバッガーを使用してください。イベントは到着しているものの、特定のユーザーのプロパティやカウントが正しくないと思われる場合は、ユーザールックアップを使用します。イベントがクライアントを離れる前にブラウザ内でライブで検査したい場合は、インストルメンテーションエクスプローラーを使用してください。

これらのツールのいずれかがデータを表示するには、少なくとも1つの計測済みイベントが必要です。まだイベントを計測していない場合は、まずテストアプリを設定してください。

インジェストデバッガー

Amplitudeのインジェスチョンデバッガーを使用して、リクエストやイベントを確認し、カウントやスロットルされたユーザーまたはデバイスを特定します。

1. Amplitudeにログインします。
2. 上部のナビゲーションバーにあるデータをクリックし、左側のナビゲーションバーからソースを選択します。
3. インジェスチョンデバッガータブをクリックします。

インジェスチョンデバッガーには、指定したエンドポイントに対する成功した要求、イベント数とID数、エラー要求の3つのチャートが表示されます。時間枠は 1 時間または 1 週間で指定できます。

インジェスチョンデバッガーの下に、Amplitudeは過去30分間にスロットルされたユーザーとデバイスと、サイレント化されたデバイスIDを一覧表示します。

ユーザールックアップ

ステップ1：自分を見つける

イベントを計測した後、これらのイベントの一部を自分のデバイスでトリガーしてください。 次に、Amplitude Analyticsを開き、ユーザー > ユーザープロファイルに移動します。ユーザーIDまたはデバイスIDで自分自身を検索します。

ステップ2: イベントストリームの分析

ユーザープロフィール内のイベントストリームには、ユーザーのイベント履歴全体がセッションごとにグループ化されて表示されます。最新のアクティビティがリストの上部に表示され、イベントは10秒から1分以内にストリームに読み込まれます。

イベントをクリックすると、そのイベントに関する詳細情報が表示されます。これには、そのイベントが発生した時点でのユーザープロパティやイベントプロパティの値が含まれます。

イベントストリームはリアルタイムで更新できるため、このイベントストリームを使用して新しいイベントが正しくキャプチャされていることを確認したり、計装エラーをトラブルシューティングしたりデバッグしたりできます。たとえば、イベントを1回だけトリガーした場合でも、イベントストリームに常にそのイベントの2つのインスタンスが表示される場合、計装エラーが発生している可能性があります。

_未処理_をクリックすると、詳細情報とイベントの生データが表示されます。

インストルメンテーションエクスプローラー

AmplitudeインストルメンテーションエクスプローラーはGoogle Chromeウェブストアの拡張機能で、プロダクトとインタラクションすることでAmplitude Browser SDKのインストルメンテーションを検査およびデバッグするのに役立ちます。トリガーした各Amplitudeイベントをキャプチャし、そのイベントを拡張機能のポップアップに表示します。インストルメンテーションエクスプローラーをダウンロードします。

トリガーされたイベントを表示

Instrumentation エクスプローラーのイベントタブでは、ウェブサイト上でトリガーする各イベントのパラメータに関する詳細な情報を確認できます。これには、user_id、device_id、event_propertiesおよびuser_propertiesが含まれます。

セッションリプレイのデバッグパネル

セッションリプレイデバッグパネルはインストルメンテーションエクスプローラーのChrome拡張機能の一部であるため、Amplitudeアプリ内ではなく、テスト中のページ上のブラウザ内で実行されます。セッションリプレイアクティビティがあるページで、デバッグパネルをオンにしてセッションリプレイが有効になっていることを確認し、Amplitudeがどのようにページをキャプチャしているかを確認してください。パネルはページ自体の上に浮かびます。

パネルには次のような内容が表示されます。

• 現在のリプレイID。
• セッションリプレイのSDKバージョン。
• セッションリプレイプラグインのバージョン。
• サンプルレート。
• デフォルトおよび有効なマスキング設定です。

パネルはライブページ上で実行されるため、コンテキスト内でキャプチャを検証し、その後、パネルから直接Amplitudeアプリで一致するリプレイを開くことができます。