> For the complete documentation index, see [llms.txt](https://helps.ptengine.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://helps.ptengine.com/insight/smart-heatmap/special-cases.md).

# 特殊ケース・トラブルシュート

スマートヒートマップが思うように動かないときや、特殊なページ構造での注意点と対処方法をまとめています。

***

## iframe を埋め込んでいるページ <a href="#pages-with-iframe-embeds" id="pages-with-iframe-embeds"></a>

ページに iframe（外部コンテンツの埋め込み）が含まれていると、クリックなどの指標データが正しく取得できないことがあります。

**対処方法：**

* 主な分析対象が iframe 内のコンテンツである場合は、iframe 元のページに直接タグを設置してヒートマップを取得するのがおすすめです
* iframe の外（親ページ）のコンテンツであれば、通常どおり計測されます

***

### アコーディオンコンテンツが入っているページ <a href="#pages-with-accordion-content" id="pages-with-accordion-content"></a>

FAQ ページや商品詳細ページなど、アコーディオンコンテンツを多く含むページでは、 ユーザー操作によってページ全体の高さが動的に変化します。 このため、同じスクロール位置で離脱したユーザーでも、実際に見ていたコンテンツが ユーザーごとに異なる可能性があり、ユーザーの関心度を示す指標が正しく解釈できなくなります。

**影響を受ける原因：**

同じ高さで離脱していても、ユーザー A は本文を読み終えて離脱、ユーザー B はアコーディオンが展開された結果その位置に到達して離脱、というケースが混在します

**影響を受ける指標：**

* **スクロール到達率**： アコーディオン展開によりページ全高が伸びるため、同じ実コンテンツを見たユーザーでも分母（ページ全体の高さ）が変動し、**到達率は実態より低く算出される傾向**があります。逆に未展開のまま閲覧したユーザーは分母が小さく、**到達率が過大に算出される**ため、ユーザー間の比較が困難になります。
* **アテンションヒートマップ**： 同じスクロール位置に異なるコンテンツが表示されるため滞在時間が分散し、**特定領域の色が実態より薄く表示される**傾向があります。また、展開状態によっては本来注目されていない領域に滞在が集計され、**誤って高アテンションと判定される**箇所が発生する可能性もあります。
* **ブロック滞在時間**： アコーディオン展開によりブロックの表示位置がページ内で変動するため、同一ブロックでもユーザーごとに計測条件が異なります。展開操作中に該当ブロックが画面内に留まり続けるケースでは**滞在時間が実際の閲読時間より長く計測される**一方、ページ高変動でブロックが画面外に押し出された場合は**短く計測される**など、値のばらつきが大きくなります。
* **離脱ヒートマップ**： 離脱位置がページ高さに依存するため、アコーディオン展開後に離脱したユーザーは**ページ下部寄りに分布**し、未展開で離脱したユーザーは**上部寄りに分布**します。結果として離脱ポイントが分散し、**特定位置への離脱集中が見えにくくなる（ピークが弱まる）**&#x50BE;向があります。

いずれも「スクロール位置 × 滞在時間」を基準に算出しているため、 ページ高さが変動するページでは、ユーザーの関心に関する厳密な判断が難しくなることがございます。

**対処方法：**

* 上記の指標を用いた**ユーザー関心度分析では、現時点で上記機能・指標の利用は推奨しません**
* ただし、**クリックヒートマップは引き続き有効**です。ボタンのクリック状況を見ることで、 どの内容にユーザーの関心が集まっているかを評価できます

***

## ページの高さやコンテンツが変わった場合 <a href="#when-page-height-or-content-changes" id="when-page-height-or-content-changes"></a>

ページ全体の高さやコンテンツが変わると、設定済みのブロック位置がずれて、データが正しく表示されなくなることがあります。

**対処方法：**

1. ブロック設定画面で「**ブロックの再スキャン**」を実行する
2. スキャンは、ページが**完全に読み込まれてから**行うのがおすすめです（途中だとブロックの高さがずれる場合があります）
3. 大きく構造を変える前後では、[ページ保存](https://helps.ptengine.com/insight/smart-heatmap/toolbar.md#id-18-page-save) で旧バージョンを残してから、改修後と並べて比較すると違いがつかみやすくなります

***

## 動的 ID を使っているサイト <a href="#sites-with-dynamic-ids" id="sites-with-dynamic-ids"></a>

JavaScript で動的に ID が生成されるサイトでは、要素を一意に特定できず、クリックデータが正しく取得できない場合があります。

**対処方法：** サポートにお問い合わせください。サイトの実装に合わせて、個別に対応方法をご案内します。

***

## ヒートマップが正しく取得できないその他のケース <a href="#other-cases-where-heatmaps-may-not-capture-correctly" id="other-cases-where-heatmaps-may-not-capture-correctly"></a>

以下のような場合は、ヒートマップの計測が不安定になることがあります。

* コンテンツが頻繁に更新される場合
* インタラクションなしで動的に要素が生成される場合
* 同一ページ内で ID 名が重複している場合
* SPA（Single Page Application）で、URL がページ遷移時に変わらない場合

SPA に関する設定方法は [SPA サイトにおける Ptengine 計測設定ガイド](broken://pages/lsXW3UllgfX3muTVfOzm) をご覧ください。

***

## データが反映されないとき <a href="#data-not-refreshing" id="data-not-refreshing"></a>

ヒートマップにデータが反映されていないと感じたときは、次の順番で確認してみてください：

1. ツールバーの「**ヒートマップの更新**」ボタンで最新データに更新する
2. データの集計は数十分〜数時間程度の遅延が出ることがあります
3. それでも反映されない場合は [ヒートマップが表示されない](https://helps.ptengine.com/faq/start-guide/heatmap-not-showing.md) をご覧ください

***

## スクリーンショットがうまく取れない <a href="#screenshot-capture-failing" id="screenshot-capture-failing"></a>

ページのデザインや仕様によって、標準のスクリーンショットがうまく動作しない場合があります。

**対処方法：** [Chrome 拡張機能から保存](https://helps.ptengine.com/insight/smart-heatmap/screenshot.md#method-2-save-via-chrome-extension) をご利用ください。

***

## 推奨ブラウザ <a href="#recommended-browsers" id="recommended-browsers"></a>

スマートヒートマップは、以下のブラウザで動作確認しています。

* Google Chrome（推奨）
* Microsoft Edge
* Mozilla Firefox

[Ptengine アシスタント](https://helps.ptengine.com/start-guide/what-is-ptengine/ptengine-assistant.md)（Chrome 拡張機能）を入れておくと、互換性が高まります。

***

## 関連 FAQ <a href="#related-faq" id="related-faq"></a>

* [タグが正常に発火しているか確認する方法](https://helps.ptengine.com/faq/start-guide/check-tag-firing.md)
* [タグを設置したのに正しく計測されない場合](https://helps.ptengine.com/faq/start-guide/incorrect-tracking.md)
* [ヒートマップが表示されない](https://helps.ptengine.com/faq/start-guide/heatmap-not-showing.md)
* [ヒートマップを表示した背景のページが文字化けしてしまった場合](https://helps.ptengine.com/faq/insight-setting/heatmap-garbled.md)
* [ページ分析ヒートマップのクリック数が少ない](https://helps.ptengine.com/faq/data/heatmap-low-clicks.md)
* [クリック数とコンバージョン数に大きなズレがある場合の対処法](https://helps.ptengine.com/faq/data/click-cv-mismatch.md)

***

## 関連ページ <a href="#related-pages" id="related-pages"></a>

* [スマートヒートマップ概要](https://helps.ptengine.com/insight/smart-heatmap.md)
* [ブロック・要素の設定方法](https://helps.ptengine.com/insight/smart-heatmap/block-element-settings.md)
* [スクリーンショット](https://helps.ptengine.com/insight/smart-heatmap/screenshot.md)
