録画のトラブルシューティング

Pro プラン

このトラブルシューティングガイドでセッションリプレイとヒートマップの一般的な問題を解決します。

録画が表示されない

録画ステータスを確認

まず、ウェブサイトで録画が有効になっているか確認してください:

1. ドメインでウェブサイトを開き、設定を開いて詳細タブに移動
2. 機能トグルでセッションリプレイがオンになっていることを確認
3. エラーの周りだけで録画したい場合は、録画モードを確認してください（「エラー時のみ」または「すべてのセッションを記録」に設定できます）

トラッキングスクリプトを確認

スクリプトがインストールされていることを確認してください:

1. ページソースを表示
2. 「zenovay」を検索
3. スクリプトがエラーなく読み込まれていることを確認

コンソールでエラーを確認

ブラウザコンソールを開きます:

1. 右クリック → 検査
2. コンソールタブに移動
3. Zenovayエラーを探す

一般的なエラー:

エラー	解決策
スクリプトが見つかりません	トラッキングコードを再インストール
CORSエラー	ドメイン設定を確認
CSPによってブロック	コンテンツセキュリティポリシーを更新
ネットワークエラー	インターネット/ファイアウォールを確認

プラン制限

プランにセッションリプレイが含まれているか（Proプラン以上）、および録画が保持期間内にあるか確認してください:

プラン	保持期間
Pro	60日
Scale	120日
Enterprise	180日

同意設定

同意を使用する場合:

• 同意が与えられていることを確認
• 同意統合を確認
• 同意が与えられた状態でテスト

録画が再生されない

読み込みの問題

再生が開始しない場合:

1. ページを更新

   • 必要に応じてキャッシュをクリア

2. インターネット接続を確認

   • 別のネットワークを試す

3. 別のブラウザを試す

   • Chromeをお勧めします

4. 拡張機能を無効化

   • 広告ブロッカーが干渉する可能性があります

再生エラー

エラーメッセージが表示される場合:

エラー	解決策
「読み込みに失敗しました」	セッションが破損している可能性があります
「セッションの有効期限が切れました」	保持期間を超えています
「アクセスが拒否されました」	権限を確認
「無効なセッション」	サポートに連絡

ブラウザ要件

ブラウザが以下をサポートしていることを確認してください:

• WebGL
• 最新のJavaScript
• 十分なメモリ

表示の不具合

コンテンツが見つかりません

要素が空白に見える場合:

原因	解決策
プライバシーマスキング	マスク設定を確認
動的コンテンツ	異なる方法で読み込まれる場合があります
サードパーティコンテンツ	クロスオリジンをキャプチャできません
遅延読み込み	読み込む前にキャプチャされない場合があります

スタイルが正しくない

スタイルが間違っている場合:

1. フォント置換

   • カスタムフォントが読み込まれない場合があります
   • フォールバックフォントが使用されます

2. CSSの違い

   • 一部の動的CSSが異なる場合があります
   • CSS-in-JSの問題を確認

3. レスポンシブの問題

   • ビューポートが異なる場合があります
   • ブレークポイントの違い

画像が見つかりません

以下の場合、画像が表示されない可能性があります:

• 別のドメインから提供される
• 認証によって保護されている
• 利用できなくなっている

レイアウトのシフト

レイアウトが一致しない場合:

• 動的コンテンツの変更
• A/Bテストバリアント
• 時間ベースのコンテンツ

ヒートマップの問題

ヒートマップが空

ヒートマップがデータを表示していない場合:

1. データボリュームを確認

   • ページがヒートマップを生成する前に、十分な最近のトラフィックが必要
   • 実際にアクセスがある時間枠内で表示

2. ページを確認

   • トラフィックを受け取った同じパスを選択
   • クエリパラメータはトラフィックを別のURLに分割できます

3. ヒートマップタイプを確認

   • ビューアはクリックとスクロールヒートマップを切り替えます
   • タイプを切り替えて、データを持つものを見ていることを確認

クリックデータが不正確

クリックが正しくない場合:

問題	原因
間違った要素へのクリック	ビューポートの違い
グループ化が不正確	レスポンシブレイアウトの変更
クリックが見つかりません	サンプリングまたは制限

スクロールデータが見つかりません

スクロールヒートマップが空の場合:

• スクロールイベントがキャプチャされているか確認
• ページの長さを確認
• JavaScriptが実行されていることを確認

パフォーマンスの問題

再生が遅い

再生がカクカクしている場合:

1. 再生速度を低下

   • 0.5倍または1倍を試す

2. 他のタブを閉じる

   • メモリを解放

3. ネットワーク速度を確認

   • バッファリングが発生する可能性があります

4. 別のブラウザを試す

   • Chromeが最速であることが多い

リソース使用率が高い

CPU/メモリの消費が多い場合:

1. 関連するセクションにスキップ

   • セッション全体を再生しないでください

2. イベントパネルを閉じる

   • レンダリングが減少

3. アニメーションを無効化

   • 利用可能な場合は設定で

サイトのパフォーマンスへの影響

録画がサイトに影響を与える場合:

1. 録画範囲を削減

   • 重いまたは機密なページを設定 → 詳細の除外ルートに追加
   • 録画モードを「エラー時のみ」に設定して、何か問題が発生した場合のみセッションをキャプチャ

2. メトリクスを監視

   • Core Web Vitalsを確認
   • 録画オフと比較

データ精度の問題

セッション数の不一致

カウントが分析と一致しない場合:

理由	説明
サンプリング	高トラフィック時はサンプリングされる可能性があります
同意	すべてのユーザーが同意していません
広告ブロッカー	録画スクリプトをブロック
ページタイプ	一部のページが除外されています

期間の違い

期間が間違っているように見える場合:

• アイドル時間がスキップされる可能性があります
• タブの切り替えは時間に影響
• バックグラウンドタブは一時停止する場合があります

クリック数の差異

クリック数が分析と異なる場合があります:

• ヒートマップはサンプリングされる可能性があります
• 異なるクリック定義
• ビューポート/要素のマッチング

設定の問題

マスキングが攻撃的すぎる

マスキングはウェブサイトの設定 → 詳細タブの2つのトグルで制御されます:

• すべての入力フィールドをマスク（デフォルトで有効）は、訪問者が入力したものをプレースホルダーに置き換えます。
• テキストコンテンツをマスクは、表示されるページテキストもマスクします。

マスクが多すぎる場合は、テキストコンテンツをマスクを無効にして、通常のページコピーがキャプチャされるようにしながら、入力値をマスクしたままにします。

マスキングが機能していない

機密データが録画に表示されている場合:

1. 設定 → 詳細でマスキングトグルが有効になっていることを確認してください。すべての入力フィールドをマスクを有効にする必要があります。
2. 保存後に再度録画してください。 マスキングは新しい録画に適用されるため、既存の録画はキャプチャ時に有効だったマスキングを保持します。
3. 機密ページをリプレイから完全に除外してください。 記録すべきでない場合は、除外ルートに追加してください（下記参照）。

除外されたページが記録される

記録したくないページは設定 → 詳細の除外ルートの下にリストされています（1行につき1パス）。除外されたページが表示される場合:

1. パスがページのURLパスと一致することを確認
2. 変更を保存したことを確認
3. 除外は新しい録画に適用され、既にキャプチャされたものには適用されません

統合の問題

同意マネージャーの競合

統合が適切に機能していない場合:

1. タイミングを確認

   • 録画前の同意

2. イベントを確認

   • 同意シグナルが発火しています

3. 手動でテスト

   • 同意を付与、録画を確認

シングルページアプリケーション

トラッキングスクリプトはSPAルート変更を自動的に処理します（History API ナビゲーションをリッスン）ため、追加の設定は必要ありません。シングルページアプリケーションが依然として不具合がある場合:

問題	確認する事項
ページ変更がキャプチャされない	スクリプトが初期レンダリング時に1回読み込まれ、ルート変更のたびに再注入されていないことを確認
重複セッション	スクリプトタグがアプリシェル内に1回だけ含まれていることを確認
ナビゲーションが見つかりません	ルーターが標準History API（pushState）を使用していることを確認して、ルート変更を検出できるようにします

サードパーティスクリプト

他のツールとの競合:

1. スクリプトの競合をチェック
2. 読み込み順序を確認
3. 独立してテスト

データ復旧

失われたセッション

残念ながら:

• 削除されたセッションは復旧できません
• 期限切れのセッションは永久に削除されます
• 保持期間終了前にエクスポート

破損したセッション

セッションが破損しているように見える場合:

• 不完全なアップロードの可能性があります
• キャプチャ中のネットワーク中断
• セッションIDでサポートに連絡

ヘルプを取得

提供する情報

サポートに連絡するとき:

1. セッションID（特定のセッションの場合）
2. 影響を受けるページURL
3. ブラウザとバージョン
4. エラーメッセージ
5. 再現の手順
6. スクリーンショット/録画

サポートチャネル

• アプリ内チャット
• [email protected]
• ヘルプセンターチケット

デバッグモード

スクリプトタグにdata-debugを追加してデバッグログを有効化します:

<script defer
  src="https://api.zenovay.com/z.js"
  data-tracking-code="YOUR_TRACKING_CODE"
  data-debug="true">
</script>

詳細なログについてはコンソールを確認してください。

予防的な措置

定期的なテスト

定期的に録画をテスト:

• サイト更新後
• トラッキング変更後
• 同意更新後

監視

アラートを設定:

• 録画数の低下
• エラー率の上昇
• パフォーマンス変化

ドキュメント

記録を保持:

• 設定変更
• 除外ルール
• 既知の問題

次のステップ

• セッションリプレイ概要
• プライバシー設定
• 一般的なトラブルシューティング