> 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 的页面

页面包含 iframe（外部内容嵌入）时，点击等指标数据可能无法正确取得。

**处理方法：**

* 主要分析对象在 iframe 内时，建议直接在 iframe 源页面部署基础代码获取热力图
* iframe 之外（父页面）的内容仍可正常计测

***

## 页面高度或内容变化时

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

**处理方法：**

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

***

## 使用动态 ID 的站点

JavaScript 动态生成 ID 的站点，由于无法唯一识别元素，点击数据可能无法正确取得。

**处理方法：** 请联系客服。我们会根据站点实现提供个别对应方案。

***

## 其他可能导致热力图无法正确取得的情况

* 内容频繁更新的情况
* 没有交互的情况下动态生成元素
* 同一页面内 ID 名称重复
* SPA（单页应用）页面切换时 URL 不变化的情况

SPA 设定方法请参考 [SPA 站点的 Ptengine 计测设定指南](broken://pages/4jSvTfhsvHP1N29k8RxD)。

***

## 数据未更新

热力图数据未反映时：

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

***

## 截图无法正常获取

页面设计或规范导致截图获取失败时，请使用 [Chrome 扩展保存](https://helps.ptengine.com/cn/insight/smart-heatmap/pages/106UthNRnRi6BHfqTn4z#方法-2从-chrome-扩展保存)。

***

## 推荐浏览器

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

安装 [Ptengine 助手](/cn/start-guide/what-is-ptengine/ptengine-assistant.md) Chrome 扩展可提高兼容性。

***

## 相关 FAQ

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

***

## 相关页面

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