ヒートマップのトラブルシューティング

このページを使用して、ヒートマップに関する最も一般的な問題を解決できます。 開始する前に、インストルメンテーションが前提条件を満たしていることを確認してください。

「お客様の組織ではヒートマップは使用できません」

このメッセージは、現在のパッケージング以前にAmplitudeが作成したレガシー組織に対して表示されます。 従来型の組織では手動での有効化が必要で、いくつかの考慮事項があります。

• ヒートマップはヒートマップイベントをプロジェクトに直接送信するため、イベントはイベントタクソノミーに表示されます。ヒートマップのイベントタイプまたはプロパティをブロックすると、ヒートマップが機能しなくなる可能性があります。また、これらのイベントは「任意イベント」クエリに表示されることがあります。特にグループ化基準の場合です。
• お客様の組織がCDP統合を使用している場合、Amplitudeはヒートマップイベントをお客様のデータウェアハウスに転送できます。
• ヒートマップは新しいイベントプロパティを送信します。 組織がプロパティ上限に達している場合は、ヒートマップを機能させるために制限値を上げてください。

従来の組織に対してヒートマップを有効にするには、Amplitude サポートまでお問い合わせください。

ヒートマップが空白であるか、「使用可能なヒートマップはありません」と表示されます

ヒートマップが空白の場合、通常はデータが新しいか、URLフィルタが一致しないか、またはインストルメンテーションが要件を満たしていないことを意味します。次のチェックを完了してください。

• 処理を待機します。 セッションリプレイをインストールまたは有効にした直後、Amplitudeがリプレイデータとクリックデータを処理するまで、URLリストとオーバーレイは空白のままになることがあります。この処理には数分かかる場合があります。
• URLフィルタを確認してください。URL 一致オプションがAmplitudeイベント内のURLと一致することを確認してください。 パターンが狭すぎると、データは返されません。
• **SDKのバージョンを確認します。**ヒートマップを使用するには、セッションリプレイBrowser SDKプラグイン1.7.0以降、またはセッションリプレイStandalone SDK1.14.0以降が必要です。単にコード内のバージョンが変更されただけでなく、ライブデプロイ済みのサイトが更新された SDK を提供していることを確認してください。
• データのしきい値を確認します。 ヒートマップは、Amplitudeが十分なデータ（少なくとも10ページ以上、かつ各ページで約500回のリプレイクリックが記録されていること）を収集した後に表示されます。
• ページの URL プロパティを復元します。 この[Amplitude] Page URLプロパティが指定されていない場合、ヒートマップは URL と一致できません。 _データ > プロパティ_で復元します: [Amplitude] Page URLを検索して 復元 をクリックします。

これらのチェックの後もヒートマップにデータが表示されない場合は、Amplitudeサポートまでお問い合わせください。

背景に正しいページ状態が表示されない

ヒートマップの背景はセッションリプレイのスナップショットであるため、デフォルトのスナップショットは、コンテンツを覆うモーダルが開いているページなど、望ましくない状態をキャプチャする可能性があります。**「背景を選択」**オプションを使用して、使用可能なスナップショットを移動し、分析したいページと一致する状態を選択します。 各ヒートマップは、最も多くのアクションが発生した状態から8つの背景を取得します。

背景は、ライブページのピクセルパーフェクトなコピーではありません。外部リソースをブロックするコンテンツセキュリティポリシー (CSP) に依存しているページや、Shadow DOM スタイルを使用しているページは、バックグラウンドで異なるようにレンダリングされる場合があります。

モバイルのヒートマップにデータが表示されない

ヒートマップはウェブベースのセッション再生のみをサポートしており、モバイルアプリや SDK はサポートしていません。 モバイルリプレイが存在するにもかかわらずモバイル Web ヒートマップにデータが表示されない場合は、ヒートマップ用に選択したデバイスタイプが、キャプチャしたビューポートと一致していることを確認してください。 選択したデバイスタイプとキャプチャされたスクリーンショットが一致しない場合、警告が発生したり、レンダリングが不適切になったり、使用可能な背景がなくなったりすることがあります。

スクリーンショットにはヒートマップデータがないことが示されています

ヒートマップは、クリックデータを 4 つの画面幅バケット（1440px 超、900～1440px、500～899px、500px 未満）にグループ化します。マップをレンダリングするには、スクリーンショットの背景とヒートマップデータが同じバケットに含まれている必要があります。 一致するクリックデータがないビューポート幅でスクリーンショットをキャプチャした場合（たとえば、すべてのセッションが 900–1440 ピクセルの範囲でキャプチャされた場合、1920 ピクセルのデスクトップスクリーンショットなど）、データが存在していてもヒートマップは空白のように見えます。

この問題を解決するには、スクリーンショットの変更 > リプレイから を使用し、データが存在するバケット内のビューポート幅で撮影されたスクリーンショットを選択します。特定のリプレイをコミットする必要はありません。適切な幅の範囲から任意のスクリーンショットを選択すれば、背景とデータが一致します。

シングルページのアプリでのクリック数マージ

ヒートマップはビューごとではなく、URL文字列ごとにデータを計算します。多くの状態が1つのURLを共有している単一ページアプリ (SPA) では、ヒートマップはこれらの状態すべてからのクリックを1つのオーバーレイにマージします。状態を分離するには、各状態をターゲットとする狭いURLフィルターを使用して個々のヒートマップを作成するか、各ビューに異なるURLが設定されるようにURL構造を調整します。

サンプリングを使用するとヒートマップは不完全に見えます

セッションリプレイのサンプルレートを適用した場合も、ヒートマップは引き続き生成されますが、各ヒートマップにはキャプチャしたセッションのみが反映されます。 たとえば、サンプルレートが1%の場合、1%のセッションからヒートマップが作成されます。そのため、全体的なビューが得られず、精度が低下する可能性があります。サンプルレートを上げて、より多くのインタラクションを取得してください。

作成していないヒートマップが表示される

Amplitudeは、データがしきい値を満たした後、トラフィックの多いページ用の少数のヒートマップを自動的に作成します。 この自動作成は1回実行され、最も多くのクリック数が記録されているページを選択します。これらのヒートマップは安全に削除できます。Amplitudeはそれらを再作成しません。

SDKの更新を促すバナーが表示されます

ヒートマップのメリットをフルに活用するためにSDKを更新するよう促すバナーが表示されている場合、古いバージョンのセッションリプレイSDKを実行していることを意味します。最新バージョンの セッションリプレイ Browser SDK プラグインまたは セッションリプレイ Standalone SDK にアップグレードして、最新のキャプチャとレンダリングの改善点を入手してください。