> 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/faq/others/heatmap-save-blocked.md).

# 歴史ヒートマップ・スクリーンショットの保存失敗

「歴史ヒートマップの保存」「ヒートマップのスクリーンショット」「実験のサムネイル」などの保存が失敗する、または成功したり失敗したりする場合のよくある原因——当社がバックグラウンドでページを開く際にページのセキュリティによってブロックされること——と、その対処法を説明します。

### なぜ失敗するのか

これらの機能では、当社がバックグラウンドでブラウザを使ってお客様のページを開き、スナップショット / スクリーンショットを取得します。サイトで WAF・ボット対策・アクセス頻度制限（HTTP 429）が有効になっていると、当社のアクセスがボットと見なされてブロックされ、保存に失敗することがあります。

対処法は、**その防御がお客様ご自身で設定できるものか、ご利用のプラットフォームが一括管理しているものか**によって異なります。以下の 2 つのうち、ご自身の状況に当てはまる方をご覧ください。

### 状況 1：自社サイト・自社の WAF / CDN の場合 —— 当社をホワイトリストに追加

ページが自社構築のもの、または防御がお客様ご自身の Cloudflare / 阿里云 / Akamai 等のアカウント配下にある場合、当社の固定送信元 IP をホワイトリストに追加すれば解決します。

* **IP で許可**：当社の固定送信元 IP からのアクセスを許可します。具体的な固定送信元 IP は**当社までお問い合わせください**。

主要な防御製品の設定箇所：

* **Cloudflare**：WAF → カスタムルール / IP Access Rules に「許可（Allow）」ルールを追加。
* **阿里云 WAF**：サイト防護 → ホワイトリストに許可ルールを追加。
* **Akamai**：対象の Network List / ACL に許可を追加。

### 状況 2：Shopify / BASE / STORES / 楽天 / Yahoo 等のプラットフォーム上の場合

ページが **Shopify・BASE・STORES・楽天市場・Yahoo!ショッピング** 等のプラットフォーム上で運用されている場合、**アクセス制限（429）と WAF / ボット対策はプラットフォーム側が一括管理**しており、プラットフォーム自身の CDN を経由します。お客様の管理画面から**当社のアクセスを許可することはできません**——送信元 IP の許可も、この制限 / ブロックの回避もできません。「状況 1」は当てはまらず、お客様の設定の問題でもありません。

この場合は：

* 取得 / 保存の頻度を下げる・時間帯を分散する（短時間のアクセス集中を減らす）；
* または当社までお問い合わせいただければ、当社側で**手動で保存**いたします。

プラットフォームの管理画面で**セキュリティ設定を行う必要はありません**。

### 設定後の確認方法

* 次回の定期保存が自動実行されるのを待つか、管理画面から手動で保存 / スクリーンショットを一度実行します。
* それでも失敗する場合は、ページの URL を添えてサポートまでご連絡ください。
