# 保存页面管理

{% hint style="success" %}
**功能概述**

通过该功能，可以为页面在指定时间点创建一份完整快照并保存下来。之后即使页面经历改版或下线，仍可使用这份快照作为背景画面查看对应时段的热图。 **「定期保存」** 模式，还可按设定的频率（每周 / 每两周 / 每月）自动创建快照，无需在每次改版后手动操作。

适用于改版节奏稳定的页面 —— 例如按固定周期迭代的产品页，可开启每周定期保存让系统自动归档；大促或活动节点，则可在开始前和结束后分别手动保存版本，前后对照查看效果。
{% endhint %}

## 为什么需要保存页面

Ptengine 的热图依赖于页面本身才能呈现 —— 当页面经过改修（同一 URL 下变更为完全不同的设计）、被删除或下线后，原页面便无法再访问，对应时段的热图也就无法查看。为此，「页面保存」功能会将页面的构成文件保存到服务器，以便随时调用。这样一来，即使页面后续发生改修，仍可调用已保存的页面版本作为背景画面，叠加上该时段的访客行为数据，热图便可正常呈现。

## 如何保存页面

打开「历史热图」面板后，可根据需求从以下两种方式中选择：

* **手动保存** — 提交后即时执行一次。适用于活动开始 / 结束等明确的关键节点。
* **定期保存（新功能）** — 一次性设定保存频率，系统按周期自动执行。适用于持续运维、改版节奏稳定的页面。

两种方式可同时启用，所产生的版本将汇入同一个历史版本列表统一管理。

### 如何使用手动保存

1. **打开「历史热图」面板，切换到「手动保存」标签页**
2. **填写以下内容后点击「保存」提交**

   * 版本名称（建议使用易于识别的名称）
   * 备注（可选）
   * 应用到合参及对应的原始页面（可选）：勾选后，该历史版本将同时适用于带参数和不带参数的页面。例如 `example.com` 和 `example.com?param=test` 都可以使用该历史版本

   ![手动保存面板](/files/M7r7moVvLUTOeg49n6je)
3. **等待 1～10 分钟完成抓取**

   抓取期间无需停留于当前页面，不影响其他操作。

### 如何设定定期保存

1. **在热图报告画面打开「保存历史热图」面板**

   点击顶部页面切换下拉菜单中的「+ 保存当前页面」，或点击右侧工具栏中的「保存当前页面」图标，即可打开面板。

   ![热图报告画面中打开「保存历史热图」面板的两个入口](/files/095YrvpTlaO53KQUQURN)
2. **在「定期保存」标签页中依次完成设定，再点击「保存」提交**

   * **选择保存频率**
     * **每周** — 适合改版节奏较快的页面，需指定执行的星期
     * **每两周** — 适合迭代周期约两周一次的页面，需指定执行的星期
     * **每月** — 适合相对稳定的页面，需指定执行的日期（1～28 号）
   * **填写备注（建议填写）**：简要说明该定时任务的用途，便于后续维护时识别
   * **应用到合参及对应的原始页面**（可选）：勾选后，该任务保存的历史热图将同时适用于带参数和不带参数的页面。例如 `example.com` 和 `example.com?param=test` 都可以使用该历史版本

   ![定期保存面板](/files/oS4iSf6ToC6hhlFldFNf)

   > **提示：** 月末（29 号及之后）不支持选择，因部分月份不存在该日期。范围限定于 1～28 号，可确保每月稳定执行。
3. **保存后设定即时生效**

   系统将自下一个匹配的星期或日期凌晨 00:00 起，开始按设定的周期自动执行。

### 如何修改或停用定期保存

设定完成后可随时调整或停用，操作可在以下任一位置完成。

**方式一：在热图报告画面**

1. **再次打开「保存历史热图」面板**，「定期保存」标签页会展示当前频率与下一次预定保存日期

   ![定期保存运行中状态](/files/7MYbOEL5nJIPn7VdvXHf)
2. **点击「修改定期计划」进入编辑模式**，调整频率与备注；如需停用任务，关闭「开始定期保存」开关

   ![编辑模式 — 关闭「开始定期保存」开关并保存即可停用](/files/Qwq9xLKTscs6v5YP5oC0)
3. **点击「保存」使变更生效**

**方式二：在管理页面**

进入 **Ptengine 设置 →「热图设置」→「版本管理」**，在对应页面右上角执行调整或取消操作。

> **注意：** 停用后，已保存的历史版本将完整保留，仅终止该任务的后续自动执行。

## 如何查看已保存的内容

保存后的页面快照可在以下两个位置查看与管理。

### 在热图报告画面查看

在热图报告画面顶部，点击页面切换下拉菜单中的 **「切换历史页面版本」**，即可查看当前页面下的所有历史版本。

![热图画面调出该页面的全部历史版本](/files/NPNpuEWSmqRcsbNoFXHY)

版本名称的前缀标识其来源：

* `[定期] 历史热图 (yyyy/mm/dd)` — 由定期保存自动创建
* `[手动] 历史热图 (yyyy/mm/dd)` — 由手动保存创建
* （无前缀） — 功能升级前保存的历史版本

选中任一版本后，画面背景画面将切换为该版本的页面快照，叠加显示所选时段内的真实用户行为数据。

### 在管理页面查看与操作

通过 **右上角设置菜单 →「热图设置」** 或 **左侧导航栏 →「版本管理」** 进入。

![历史热图管理页面](/files/WDd1S06tV0RRxuhfc2n8)

在管理页面，可以完成以下操作：

![页面展开后的详细信息（含头部信息与版本列表）](/files/RGQjxziU0IHw6CsXDly6)

1. **历史热图用量**：顶部显示当前账户的用量，格式为 `历史热图的用量：1/1 URLs`
2. **使用中 / 归档**：通过两个标签页按状态分类查阅
3. **编辑定时计划**：修改或停用该页面的定期保存设置
4. **删除**：一次性清除该页面下的全部版本与定时任务
5. **版本操作**：展开页面后，可对每个历史版本执行**预览** / **重命名与改备注** / **删除**

#### 「使用中」与「归档」标签页

| 标签页     | 含义                                               | 是否计入套餐用量  |
| ------- | ------------------------------------------------ | --------- |
| **使用中** | 当前处于套餐用量内的页面 — 包括手动保存了历史版本的页面，以及已配置定期保存任务的页面     | **计入用量**  |
| **归档**  | 不再处于套餐用量内的页面 — 包括功能升级前保存的旧版本，以及套餐降级后超出用量范围被移除的页面 | **不计入用量** |

## 用量是如何计算的

历史热图的用量上限由套餐决定，**以「页面 URL + 页面类型」的组合为计量单位**。Ptengine 中的页面类型包括**原始页面**、**合参页面**和**页面组**，同一 URL 在不同页面类型下各自独立计为 1 个用量单位。同一页面（URL + 类型）下的所有历史版本合计仍计为 1 个单位，无论手动或定期保存累积了多少版本。

### 套餐降级后的用量重置机制

降级生效后，系统会重新筛选「使用中」的页面，作为有权限的页面继续占用新套餐的用量。规则如下：

* **已开启定期保存的页面优先保留**。若这部分页面数仍超出新额度，将按 **最近创建时间从新到旧** 排序，超出部分对应的定期任务自动关闭，相关页面移入「归档」。
* **其余页面**按 **最近创建时间从新到旧** 排序，依次填入剩余额度；超出部分同样移入「归档」。

被移入「归档」的页面：已保存的历史版本完整保留、可正常预览；但 **既不会继续执行定期保存，也无法再手动保存新的历史热图**。

## 其他注意事项

### 可能导致保存失败的情况

{% hint style="warning" %}

* **部分外部资源未保存**：通过相对路径或绝对路径引用的特定第三方资源可能不在保存范围内
* **网址无法访问**：域名已停用或填写错误，系统找不到目标页面
* **目标网站服务器出现故障**：服务器返回错误（如 5xx），无法完成抓取
* **被防爬虫机制拦截**：目标网站的防爬虫系统（如 Cloudflare、AWS CloudFront 等 CDN 防护）将保存服务识别为机器人并拒绝访问

上述情况仅出现于少数特殊页面，绝大多数常规站点不受影响。
{% endhint %}

### 关于需要登录或访问受限的页面

{% hint style="info" %}
定期保存的工作原理是 **由系统模拟访客访问目标页面** 并抓取内容。以下情形下，系统无法获取完整的页面内容：

* 需要登录态才能正常显示的页面（会员专属页、后台管理页等）
* 设置了 IP 白名单访问限制的页面
* 依赖特定 Cookie 才能正确渲染内容的个性化页面

**建议这类页面不要设定定期保存**。如有保存需求，请联系客服团队协助进行手动保存。
{% endhint %}

## 常见问题

**Q. 同一页面是否可同时启用定期保存与手动保存？**

可以，且推荐组合使用。所有版本将汇入同一个版本列表，通过 `[定期]` 与 `[手动]` 前缀区分来源。

**Q. 单个版本最长可保留多久？**

保留时长受套餐设定的「历史热图保存时长」（例如 12 个月）约束，超出时长的版本将由系统自动归档。

**Q. 原页面后续改版或下线是否会影响已保存的版本？**

不会影响。保存的版本是当时的完整快照（包含 HTML 与静态资源），独立存储于服务器。原页面后续无论如何变更甚至完全下线，已归档的历史版本均不受影响，可持续正常预览。

**Q. 定时任务的执行时间是什么时候？**

每次执行均在指定日期的 **凌晨 00:00** 进行，以避开用户访问高峰，最大限度降低对正常访问的影响。

**Q. 保存下来的页面可以点击、交互吗（比如展开菜单、填写表单）？**

大多数页面可以正常交互。不过，由于部分现代前端框架的运行机制与保存服务的环境存在兼容性问题，**目前**以下几类页面会自动以「静态截图」方式保存——视觉内容完整，但点击操作不会有任何响应：

* 使用某些现代前端框架搭建的网站（如 Next.js App Router、Shopify Hydrogen、Wix、Shoplazza、Bubble.io 等）：这类框架依赖客户端运行时来激活交互，而该过程在保存服务的环境下无法正常完成
* 嵌入了互动地图（Google Maps、Mapbox 等）的页面：地图图块是动态生成的，无法一次性存入快照

静态模式下，点击菜单、提交表单等所有依赖 JavaScript 的交互动作将无法响应。

页面的文字、图片、布局等视觉内容以及热图数据均不受影响，可正常查看。

## 相关页面

* [智能热图概览](/cn/insight/smart-heatmap.md)
* [比较热图](/cn/insight/smart-heatmap/comparison.md)
* [工具栏功能](/cn/insight/smart-heatmap/toolbar.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/setting/saved-pages.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.