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

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

***

## iframe を埋め込んでいるページ

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

**対処方法：**

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

***

### アコーディオンコンテンツが入っているページ

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

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

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

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

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

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

**対処方法：**

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

***

## ページの高さやコンテンツが変わった場合

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

**対処方法：**

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

***

## 動的 ID を使っているサイト

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

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

***

## ヒートマップが正しく取得できないその他のケース

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

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

SPA に関する設定方法は [SPA サイトにおける Ptengine 計測設定ガイド](/faq/tag-and-domain/spa-tracking.md) をご覧ください。

***

## データが反映されないとき

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

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

***

## スクリーンショットがうまく取れない

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

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

***

## 推奨ブラウザ

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

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

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

***

## 関連 FAQ

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

***

## 関連ページ

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://helps.ptengine.com/insight/smart-heatmap/special-cases.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.