> 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/faq/start-guide/heatmap-not-showing.md).

# 热图不显示

当热图不显示或显示出现问题时，可能的原因和解决方法如下。

{% hint style="info" %}
如果页面本身比较特殊（嵌了 iframe、ID 是 JS 动态生成、SPA、页面高度频繁变化），直接看 [特殊场景与故障排查](/cn/insight/smart-heatmap/special-cases.md)。
{% endhint %}

* **没有访问数据** **解决方法**：确认目标URL的数据是否已累积，检查基础代码是否正确安装。数据累积可能需要30分钟至1小时。
* **页面选择问题** **解决方法**：正确选择页面类型，并按参数检查热图。
* **页面修改导致的元素变化** **解决方法**：建议在修改前保存热图。
* **URL统一规则的影响** **解决方法**：使用符合统一规则的URL，或关闭统一规则。
* **页面重定向的影响** **解决方法**：需要禁用重定向。
* **网络环境或浏览器问题** **解决方法**：尝试切换网络环境或使用推荐浏览器。浏览器更新或临时禁用扩展功能也很有效。
* **Free计划的限制** **解决方法**：Free计划仅支持1个URL的热图，请确认设置的URL是否正确。
* **Web视图热图的检查事项**
  * **标签部署确认**：确认Ptengine 基础代码是否正常安装。
  * **Ptengine Assistant安装**：这是使用Web视图的推荐扩展功能。
  * **CSP设置**：注意内容安全策略的影响，将必要的资源添加到白名单中。
* **需要特殊处理的情况** 如果由于特殊的页面结构导致热图无法正确显示，请联系聊天支持。仅支持付费计划用户。

## 问题未解决时的咨询 <a href="#contact-support" id="contact-support"></a>

如果问题未解决，请准备好以下信息后联系聊天支持：

* 目标档案名称
* 要确认的URL
* 显示不正常的屏幕截图

通过确认上述步骤，通常可以解决热图显示问题。

***

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

* [特殊场景与故障排查](/cn/insight/smart-heatmap/special-cases.md) — iframe、动态 ID、SPA、页面改版后区块错位
* [热图的点击次数偏少](/cn/faq/data/heatmap-low-clicks.md) — 数据有但看着偏少
* [显示热图背景页面出现乱码的情况下](/cn/faq/insight-setting/heatmap-garbled.md)
* [热图的设置和管理](/cn/insight/setting/heatmap-management.md) — 确认该 URL 是否已登记