# 保存ページの管理

{% hint style="success" %}
**機能概要**

本記事では、Ptengine ヒートマップ機能の「歴史ヒートマップ保存」についてご紹介します。

この機能では、指定のタイミングでページの完全なスナップショットを作成し、長期保存できます。ページ改修や非公開化された後でも、保存したスナップショットを背景画像として、当時のヒートマップを確認できます。今回のアップデートで新たに **「定期保存」** モードが追加され、設定した頻度（毎週／隔週／毎月）でシステムが自動的にスナップショットを作成します。改修のたびに手動で操作する必要はありません。

改修サイクルが安定したページに特に適しています —— 例えば一定の周期で改修される製品ページは、毎週の定期保存をオンにすればシステムが自動的にアーカイブしてくれます。キャンペーンやイベントの節目では、開始前と終了後にそれぞれ手動で保存し、前後を比較して効果を確認できます。
{% endhint %}

## なぜページ保存が必要か

Ptengine のヒートマップは、ページ自体があってはじめて表示できる仕組みになっています。ページが改修（同一 URL で全く異なるデザインに変更）、削除、または非公開になった場合、もとのページにアクセスできず、その期間のヒートマップも見られなくなります。そのため、「ページ保存」機能では、ページの構成ファイルをサーバーに保存し、いつでも呼び出せるようにしています。これにより、ページが変更されても、保存済みのページバージョンを背景画像として呼び出し、該当期間の訪問者データを重ね合わせることで、ヒートマップを正常に表示できるという仕様になっています。

## ページの保存方法

「歴史ヒートマップ」パネルを開いた後、用途に応じて以下のいずれかの方法を選びます。

* **手動保存** — 送信後にその場で 1 回だけ実行します。キャンペーン開始／終了など、明確なタイミングがある節目向けです。
* **定期保存（新機能）** — 一度頻度を設定すれば、システムが周期的に自動実行します。運用が継続的で改修周期が安定しているページ向けです。

両方の方法は同時に利用でき、作成されたバージョンは同一の履歴バージョン一覧でまとめて管理されます。

### 手動保存の使い方

1. **「歴史ヒートマップ」パネルを開き、「手動保存」タブに切り替えます**
2. **以下を入力し、「保存」をクリックして送信します**

   * バージョン名（識別しやすい名前を推奨）
   * メモ（任意）
   * 合参ページおよび対応する元のページに適用（任意）：チェックすると、この履歴バージョンはパラメーターあり・なし両方のページに適用されます。例えば `example.com` と `example.com?param=test` の両方でこのバージョンを使用できます

   ![手動保存パネル](/files/fh8NPg9YrMhxpXANJbCJ)
3. **1 〜 10 分でスナップショットの取得が完了します**

   取得中は当該ページにとどまる必要はなく、他の操作にも影響しません。

### 定期保存の設定方法

1. **ヒートマップレポート画面で「歴史ヒートマップの保存」パネルを開く**

   ページ切り替えプルダウンの「+ 現在のページを保存」、または右側ツールバーの「現在のページを保存」アイコンをクリックすると、パネルが開きます。

   ![ヒートマップレポート画面で「歴史ヒートマップの保存」パネルを開く 2 つの入口](/files/auaGoi9ngN0XeWi19Tyd)
2. **「定期保存」タブで順に設定を行い、「保存」をクリックして送信します**

   * **保存頻度を選択**
     * **毎週** — 改修サイクルが早いページ向け。実行する曜日を指定
     * **隔週** — 約 2 週間サイクルで更新するページ向け。実行する曜日を指定
     * **毎月** — 比較的安定したページ向け。実行する日付を指定（1 〜 28 日）
   * **メモを記入（推奨）**：この定期タスクの用途を簡潔に記載しておくと、後日確認する際に識別しやすくなります
   * **合参ページおよび対応する元のページに適用**（任意）：チェックすると、このタスクで保存した履歴ヒートマップはパラメーターあり・なし両方のページに適用されます。例えば `example.com` と `example.com?param=test` の両方でこの履歴バージョンを使用できます

   ![定期保存パネル](/files/AQJfDtnIgn5O5pcFxNov)

   > **ヒント：** 月末（29 日以降）は選択できません。月によってはその日付が存在しないためで、1 〜 28 日に制限することで毎月安定して実行できるようにしています。
3. **保存後、設定は即時反映されます**

   システムは次に該当する曜日または日付の **00:00（日本時間）** から、設定された周期で自動的に実行を開始します。

### 定期保存の変更・停止方法

設定後はいつでも調整・停止できます。以下のいずれかの方法で操作します。

**方法 1：ヒートマップレポート画面で操作**

1. **再度「歴史ヒートマップの保存」パネルを開きます**。「定期保存」タブには現在の頻度と次回保存予定日が表示されます

   ![定期保存が稼働中の状態](/files/CtE750XoMqIJQ9GSGegc)
2. **「定期設定を編集」をクリックして編集モードに入ります**。頻度・メモを調整できます。停止する場合は「定期保存を有効にする」スイッチをオフにします

   ![編集モード — 「定期保存を有効にする」スイッチをオフにして保存することで停止できます](/files/08MdtAT7PUEfpUkNppk2)
3. **「保存」をクリックして変更を反映します**

**方法 2：管理画面で操作**

**Ptengine 設定 →「ヒートマップ設定」→「保存ページの管理」** に入り、対象ページの右上から調整または取消を行います。

> **注意：** 停止しても、保存済みの履歴バージョンはそのまま保持されます。停止後は当該タスクの後続自動実行のみが終了します。

## 保存内容の確認方法

保存後のページスナップショットは、以下 2 か所で確認・管理できます。

### ヒートマップレポート画面で確認

ヒートマップレポート画面の上部、ページ切り替えプルダウンから **「保存ページを呼び出す」** をクリックすると、現在のページに紐づく全履歴バージョンが表示されます。

![ヒートマップ画面で当該ページの全履歴バージョンを呼び出す](/files/QXq4G9bylrRDwQfkGLOU)

バージョン名の接頭辞は作成元を示しています。

* `[定期] 歴史ヒートマップ (yyyy/mm/dd)` — 定期保存で自動作成
* `[手動] 歴史ヒートマップ (yyyy/mm/dd)` — 手動保存で作成
* （接頭辞なし） — 機能アップデート前に保存された履歴バージョン

任意のバージョンを選択すると、画面の背景画像が当該バージョンのスナップショットに切り替わり、選択した期間内の実際の訪問者行動データが重ねて表示されます。

### 管理画面で確認・操作

**右上の設定メニュー →「ヒートマップ設定」** または **左側のナビゲーション →「保存ページの管理」** から入ります。

![歴史ヒートマップ管理画面](/files/8Wub2GDZGBAFoyOZCZAd)

管理画面では以下の操作が可能です。

![ページを展開した詳細（ヘッダー情報とバージョン一覧）](/files/7qj2wEvROzasYtQ6LLyx)

1. **歴史ヒートマップ用量**：上部に `歴史ヒートマップの用量：1/1 URLs` の形式で用量が表示されます
2. **使用中 / アーカイブ**：2 つのタブで状態別に切り替えて閲覧できます
3. **定期保存を編集**：対象ページの定期保存を変更・停止します
4. **削除**：当該ページの全バージョンと定期タスクを一括で削除します
5. **バージョン操作**：ページを展開し、各バージョンに対して**プレビュー** / **名前・メモの編集** / **削除** を実行します

#### 「使用中」と「アーカイブ」タブ

| タブ        | 内容                                                                     | プラン用量に計上されるか |
| --------- | ---------------------------------------------------------------------- | ------------ |
| **使用中**   | 現在プラン用量内のページ — 手動保存した履歴バージョンを持つページ、または定期保存タスクが設定されているページ               | **計上される**    |
| **アーカイブ** | プラン用量内ではなくなったページ — 機能アップデート前に保存された旧バージョン、およびプランダウングレードで用量範囲外となり外されたページ | **計上されない**   |

## 用量の計算方法

歴史ヒートマップの用量上限はご契約プランで決まり、**「ページ URL + ページタイプ」の組み合わせを計量単位** として計算されます。Ptengine のページタイプには**元のページ**・**パラメーター除去後**・**ページグループ**の 3 種類があり、同一 URL でもタイプが異なる場合はそれぞれ独立して 1 単位として計上されます。同一ページ（URL + タイプ）配下の全バージョンは合わせて 1 単位として計上され、手動・定期で何バージョン蓄積しても変わりません。

### プランダウングレード後の用量再判定の仕組み

ダウングレード後、システムは「使用中」のページを再判定し、新プランの用量を占有する有効なページとして扱います。ルールは以下のとおりです。

* **定期保存が有効になっているページが優先的に保持されます**。これらのページ数も新上限を超える場合、**作成日時の新しい順** にソートし、超過分の定期タスクを自動的に停止して、該当ページを「アーカイブ」に移します。
* **その他のページ** は **作成日時の新しい順** にソートされ、残りの上限枠に順次組み入れられます。超過分は同様に「アーカイブ」に移されます。

「アーカイブ」に移されたページ：保存済みの履歴バージョンは完全に保持され、いつでもプレビュー可能ですが、**定期保存は継続されず、新しい歴史ヒートマップの手動保存もできません**。

## その他注意事項

### 保存が失敗する可能性のあるケース

{% hint style="warning" %}

* **一部の外部リソースが保存されない**：相対パスや絶対パスで参照される特定のサードパーティリソースは保存対象に含まれない場合があります
* **URL が無効またはオフライン**：ドメインが解決できないか、すでに存在しないため、システムが対象ページにアクセスできません
* **サーバーエラー**：対象サイトがサーバーエラー（5xx）を返し、取得を完了できません
* **アンチボット / WAF によるブロック**：対象サイトのボット対策システム（Cloudflare、AWS CloudFront など）が取得サービスをボットと判定してアクセスを拒否しました

上記は一部の特殊なページにのみ発生する問題で、大多数の一般的なサイトでは影響を受けません。
{% endhint %}

### ログイン・アクセス制限のあるページについて

{% hint style="info" %}
定期保存は **システムが訪問者として対象ページにアクセスして内容を取得する** 仕組みです。以下の場合、システムはページの完全な内容を取得できません。

* ログイン状態が必須で表示が変わるページ（会員限定ページ、管理画面など）
* IP ホワイトリストによるアクセス制限のあるページ
* 特定の Cookie に依存して正しく表示されるパーソナライズページ

**これらのページでは定期保存の設定はお勧めしません**。保存が必要な場合は、カスタマーサポートまでご連絡ください。手動保存の対応をサポートいたします。
{% endhint %}

## よくあるご質問

**Q. 同じページで定期保存と手動保存を併用できますか？**

可能です。両方を組み合わせることをお勧めします。すべてのバージョンは同一の一覧に取り込まれ、`[定期]` と `[手動]` の接頭辞で由来を区別できます。

**Q. 1 つのバージョンは最長どのくらい保持されますか？**

保持期間はご契約プランの「歴史ヒートマップ保存期間」（例えば 12 か月）に従います。期間を超えたバージョンはシステムにより自動的にアーカイブされます。

**Q. 元のページが改修や非公開になった場合、保存済みバージョンに影響しますか？**

影響しません。保存されるのはその時点でのページの完全なスナップショット（HTML と静的リソースを含む）で、サーバーに独立して保存されます。元のページがどのように変更されても、または完全に非公開になっても、保存済みの履歴バージョンには影響せず、いつでも正常にプレビューできます。

**Q. 定期タスクの実行時刻はいつですか？**

毎回、指定日の **00:00（日本時間）** に実行されます。ユーザーのアクセスピークを避け、通常のアクセスへの影響を最小限にとどめるためです。

**Q. 保存したページはクリックや操作ができますか（メニューを開く、フォームを送信するなど）？**

ほとんどのページは通常通り操作できます。ただし、一部のモダンフレームワークと取得環境との互換性の制約により、**現時点では**以下のようなページは「静的スナップショット」として保存されます。見た目は完全ですが、クリックしても反応しません：

* 特定のモダンフレームワークで構築されたサイト（Next.js App Router、Shopify Hydrogen、Wix、Shoplazza、Bubble.io など）：これらのフレームワークはインタラクションを有効にするためにクライアントサイドのランタイムに依存していますが、そのプロセスが取得環境では正常に完了しません
* インタラクティブな地図（Google Maps、Mapbox など）が埋め込まれたページ：地図のタイルは動的に生成されるため、スナップショットに含めることができません

静的モードでは、メニューを開く・フォームを送信するなど、JavaScript に依存するすべての操作が反応しません。

文字・画像・レイアウトなどの見た目とヒートマップデータは正常に表示されます。

## 関連ページ

* [スマートヒートマップ概要](/insight/smart-heatmap.md)
* [比較ヒートマップ](/insight/smart-heatmap/comparison.md)
* [ツールバー機能](/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/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.