用途：评估某个页面的热图在说明什么，并给出具体改进建议。热图只提供几何数据（指针相对横坐标、页面纵坐标及计数），本身不知道被点的是什么，因此需要与同一 URL 的自动捕获数据交叉比对，才能把坐标转成含义。
主要能力：按信号拉取 click（关注度）、rageclick（挫败信号，最强的“坏掉或误导”提示）、scrolldepth（滚动深度，用于找首屏折线与埋在下面的 CTA）；支持 unique_visitors 聚合；点击结果按热度排序并有 limit（默认 500）与 has_more，scrolldepth 返回全部桶。点击类型还返回 fold 对象：pct_below_fold、below_fold_count/total_count、median_viewport_height，可用 viewport_width_min/max 按设备分段读取。
使用方式：先确定精确 url_exact 或 url_pattern，默认近 7 天、数据量低可放宽到 30 天（热图保留 90 天）。调用 heatmaps-list 或直接 SQL 查询 heatmaps 表；用自动捕获（如查询 $autocapture，取 $el_text 计数，必要时用 elements_chain 区分同文本元素）命名热点元素。需要给用户看时用 heatmaps-saved-create 创建保存热图（默认 screenshot），再轮询 heatmaps-saved-get 直至 status 为 completed；需要“为什么”时用 heatmaps-events 取会话并交给 replay 调查。最后按信号强度排序输出问题与有依据的建议。
适用场景：页面互动诊断、CTA 位置与首屏折线评估、非交互元素被点击的发现、暴怒点击定位。
限制与注意：热图需开启 Team.heatmaps_opt_in，无数据先检查开关与 URL；存储中坐标按 16 倍缩放，应直接用 API 返回值；评估者看不到截图，布局判断须基于捕获身份与坐标；保存热图渲染是异步的，仅 screenshot 类型出图；桌面与移动端需分开看，不要混算。