❓ 管理者のよくある質問 (FAQ)

本ドキュメントは、管理画面の管理時に発生する可能性のあるバックアップ復元、外部画像ストレージの連携、ダッシュボード統計に関するよくある質問の原因と確認事項を紹介します。

---

🗄️ Q1. バックアップデータの復元（Restore）時にエラーが発生します。

バックアップファイルを選択して復元を実行した際にエラーが発生する場合の確認事項です。

💡 主な確認事項

1. ファイルの破損:
   • ダウンロード時にテキストが正常に保存されなかった場合、復元に失敗することがあります。.json ファイルをメモ帳等で開き、正常なデータ形式であるか確認してください。
2. メニューの不一致:
   • データの種類に応じた復元メニューを使用する必要があります。記事データは コンテンツバックアップ メニューの データバックアップ＆復元 セクション、画像等のメディアファイルは コンテンツバックアップ メニューの メディアバックアップ＆復元 セクション、システム全体データは サイト設定 メニューの システム全体バックアップ＆復元 セクションで復元を実行する必要があります。
3. データベース (D1) のバインディング:
   • Cloudflareのデータベース（D1）接続情報が正常に連携されているか、管理者コンソールで確認してください。

---

📂 Q2. 画像ストレージ変更後にアップロードまたは表示のエラーが発生します。

標準のストレージ（KV）からR2、Supabase、ImageKitなどに変更した後、アップロードエラーが発生したり画像が表示されなくなったりする場合の原因分析です。

💡 主な確認事項

1. Cloudflare R2:
   • プロジェクト設定で IMAGES R2バケットバインディングが接続されているか確認します (wrangler.json)。
2. Supabase Storage:
   • 入力したAPIエンドポイント (supabase_storage_url)、サービスロールキー (supabase_storage_key)、バケット名 (supabase_storage_bucket) の正確性を確認します。特にバケットのアクセス権限が Public (公開) に設定されている必要があります。
3. ImageKit.io:
   • エンドポイントURL (imagekit_url_endpoint) の形式を確認し、クロスオリジンリソース共有 (CORS) 設定をチェックします。
4. アップロード容量制限:
   • エッジサーバー環境の1回あたりの転送容量制限により、大容量の画像はアップロードに失敗することがあります。あらかじめ画像の解像度やサイズを調整してアップロードしてください。

---

📊 Q3. ダッシュボードの統計グラフがデモデータのみで表示されます。

メインダッシュボードに実際のトラフィック統計ではなく、デモ用データが表示される場合の確認事項です。

💡 主な確認事項

• 原因: Google Analytics 4 (GA4) APIの環境変数が入力されていない、または正しくない場合、ダッシュボードのクラッシュを防ぐためにダミー用のデモデータが代替表示されます。
• 設定手順: Cloudflare Pagesの設定に以下の環境変数を入力し、再度デプロイを行ってください。
  • GA4_PROPERTY_ID: Google Analytics プロパティ ID
  • GA4_CLIENT_EMAIL: Google Cloud サービスアカウントメールアドレス
  • GA4_PRIVATE_KEY: Google サービスアカウント秘密鍵
• Google AdSense: 収益ダッシュボードの連携を行いたい場合、ADSENSE_ACCOUNT_ID 環境変数が正しく入力されているか確認してください。