Amplitude Chrome拡張機能を使用したデバッグ

Amplitude Event Explorer Chrome拡張機能は、ブラウザのJS SDKが発行するすべてのAmplitudeイベントをキャプチャし、プロダクトとのやり取り時に各イベントのペイロードをポップアップに表示します。また、ガイドとサーベイのトリガー状態とウェブ実験の露出状況も表示されるため、ガイド、サーベイ、または実験が期待どおりに動作しない理由をデバッグできます。 Chromeウェブストアからインストールしてください。

この拡張機能は、イベントがブラウザで発生した瞬間にその生のイベントとユーザープロパティを調べる必要がある場合に使用します。 イベントがAmplitudeに到着した後にレビューしたり、ユーザーとセッションを横断して検索したりするには、代わりにユーザー検索を使用してください。

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

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

イベントを受信するさまざまなAmplitudeプロジェクトを切り替えるには、プロジェクトドロップダウンからプロジェクトを選択します。 短縮されたAPIキーは、各Amplitudeプロジェクトを区別します。

ポップアップからすべてのイベントをクリアするには、イベントをクリア を選択します。

特定のイベントタイプを非表示にするには、**［非表示］**アイコンを選択します。

イベントのイベントパラメータとユーザープロパティパラメータをコピーするには、コピーアイコンを選択します。

構成オプションの表示

各プロジェクトのSDKに設定した構成オプションを表示するには、APIオプションタブを選択します。

隠しイベントを表示

隠しイベントの一覧を表示したり、イベントがトリガーされたときにウェブページ上にイベントを表示したりするには、設定 タブを選択します。

ガイドとサーベイ

この拡張機能には、ガイドとサーベイのデバッグに役立つツールが含まれています。これらの機能を使用して、SDK の設定を確認したり、ガイドやサーベイが表示されない原因をトラブルシューティングしたり、イベントベースのトリガーをテストしたりできます。

SDKのセットアップ

特定のガイドやサーベイのトラブルシューティングを行う前に、ガイドとサーベイSDKがページ上で正しく動作することを確認してください。

SDKの設定セクションには、次の 4 つのステップのステータスが表示されます。

• インストール済み: このページに SDK がインストールされています。
• 初期化済み: 設定を使用して SDK を初期化しました。
• アナリティクス接続: SDK は少なくとも 1 つのアナリティクス SDK に接続されています。
• 起動済み: SDKはユーザー情報を受信し、トリガーに基づいてガイドとサーベイを表示する準備が整いました。

すべてのチェックに合格してもガイドやサーベイが機能しない場合は、以下の設定を確認してください。

• 設定: 「設定を表示」を使用して、API キーがガイドやアンケートを公開したプロジェクトと一致することを確認します。
• ユーザーの識別： ［Show user info］ を使用して、user_id が想定されたユーザーと一致することを確認します。
• SDK のインストール: ガイドとサーベイ SDK をインストールしているページもありますが、インストールしていないページもあります。ガイドやアンケートを設定する予定のすべてのページにインストールされていることを確認してください。
• 起動ステップ: 起動ステップは、特定の環境やユーザータイプによって条件付きになる場合があります。 環境やユーザータイプに関係なく、コードが常にそれを呼び出すようにしてください。

トラブルシューティングガイドとサーベイ

トラブルシューティングセクションには、関連プロジェクトのAPIキーに関するすべての公開済みガイドとサーベイが表示されます。各ガイドまたはサーベイには、トリガー条件と、その条件が満たされているかどうかが表示されます。

ガイドやアンケートのプレビューを開いて、プレビューツールバーを表示したり、個々のステップをデバッグしたりできます。 プレビューを使用すると、ガイドの動作をテストしたり、特定のステップに関する問題を特定したりできます。

この展開されたセクションでは、プレビューを開かなくてもガイドやサーベイが表示されない理由も確認できます。トリガー条件をチェックして、どの要件が満たされていないかを確認してください。

• トリガー時の表示: すべてのトリガー条件が満たされた場合にガイドが表示されるかどうか。
• トリガー条件: ビルトインスロットル、カスタムスロットル、制限値、ページターゲティング、スヌーズ設定、ユーザーターゲティング。

転送されたイベント

ガイドとサーベイSDKがクライアント側で認識するすべてのイベントを表示します。SDK はクライアント側のイベントのみを認識し、サーバー側のイベントにアクセスすることはできません。

［転送イベント］セクションは、次の目的で使用できます。

• SDKが受信したイベントを表示します。
• テストイベントをシミュレートして、特定のイベントに依存するガイドをトリガーします。

イベントベースのトリガーをテストするには、入力フィールドにイベント名を入力し、［テストイベント］を選択します。イベントは、そのタイムスタンプと完全なイベント ペイロードとともにログ イベント リストに表示されます。

ウェブ実験

この拡張機能は、アクティブなウェブ実験に関する詳細なターゲティング情報を表示するため、実験が実行されていない理由を診断できます。 ページ上で実験が実行されると、この拡張機能はデバッグ詳細パネルを表示し、対象または対象外を一目で確認できる全体的なエクスポージャーバッジを表示します。

ターゲティング対象ユーザー

オーディエンスターゲティングセクションには、どのセグメントが一致し、どのバリアントが実験で現在のユーザーに割り当てられているかが示されます。この情報を使用して、ユーザーが期待するセグメントに属していることを確認できます。

ページターゲティング

ページターゲティングセクションには、設定済みのページビュールール、現在の URL がそのルールと一致しているかどうか、およびトリガーステータスが表示されます。実験が開始されない場合は、まずこのセクションを確認してください。ほとんどの問題は、URL の不一致やトリガー設定ミスが原因です。

バリアントをプレビューする

実験設定を変更せずに特定のバリアントをQAするには、バリアントのプレビューを使用して、実験が現在のユーザーに割り当てたバリアントを上書きします。 このオーバーライドは自分のセッションにのみ適用されるため、他のユーザーやライブ実験に影響を与えることはありません。