> 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/cn/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="#when-page-height-or-content-changes" id="when-page-height-or-content-changes"></a>

页面整体高度或内容发生变更时，已设定的区块位置可能错位，数据无法正确显示。

**处理方法：**

1. 在区块设置界面执行“**重新扫描区块**”
2. 扫描请等待页面**完全加载完毕**后再进行（中途扫描可能导致区块高度错位）
3. 大幅改版时，建议先用 [页面保存](https://helps.ptengine.com/cn/insight/smart-heatmap/toolbar.md) 保存改版前页面，再与改版后比较

***

## 使用动态 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（单页应用）页面切换时 URL 不变化的情况

SPA 站点的设置方法请参考 [标签设置常见问题](https://helps.ptengine.com/cn/faq/tracking-code/tag-setting-faq.md)。

***

## 数据未更新 <a href="#data-not-refreshing" id="data-not-refreshing"></a>

热图数据未反映时：

1. 点击工具栏“**热图更新**”按钮加载最新数据
2. 数据汇总可能有几十分钟到几小时的延迟
3. 仍未反映请参考 [热图无法显示](https://helps.ptengine.com/cn/faq/start-guide/heatmap-not-showing.md)

***

## 截图无法正常获取 <a href="#screenshot-capture-failing" id="screenshot-capture-failing"></a>

页面设计或规范导致截图获取失败时，请使用 [Chrome 扩展保存](https://helps.ptengine.com/cn/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/cn/start-guide/what-is-ptengine/ptengine-assistant.md) Chrome 扩展可提高兼容性。

***

## 相关 FAQ <a href="#related-faq" id="related-faq"></a>

* [如何确认基础代码是否正常触发](https://helps.ptengine.com/cn/faq/start-guide/check-tag-firing.md)
* [部署了基础代码但监测不正确的情况](https://helps.ptengine.com/cn/faq/start-guide/incorrect-tracking.md)
* [热图无法显示](https://helps.ptengine.com/cn/faq/start-guide/heatmap-not-showing.md)
* [显示热图时背景页面乱码](https://helps.ptengine.com/cn/faq/insight-setting/heatmap-garbled.md)
* [热图的点击次数偏少](https://helps.ptengine.com/cn/faq/data/heatmap-low-clicks.md)
* [点击数与转化数差异较大时的处理](https://helps.ptengine.com/cn/faq/data/click-cv-mismatch.md)

***

## 相关页面 <a href="#related-pages" id="related-pages"></a>

* [智能热图概览](https://helps.ptengine.com/cn/insight/smart-heatmap.md)
* [区块·元素设定方法](https://helps.ptengine.com/cn/insight/smart-heatmap/block-element-settings.md)
* [截图功能](https://helps.ptengine.com/cn/insight/smart-heatmap/screenshot.md)
