# 特殊场景与故障排查

智能热力图无法正常工作时，或针对特殊页面结构的注意事项与处理方法。

***

## 嵌入了 iframe 的页面

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

**处理方法：**

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

***

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

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

**处理方法：**

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

***

## 使用动态 ID 的站点

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

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

***

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

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

SPA 设定方法请参考 [SPA 站点的 Ptengine 计测设定指南](/cn/faq/tag-and-domain/spa-tracking.md)。

***

## 数据未更新

热力图数据未反映时：

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)


---

# 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/cn/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.