まず、Matomo (Piwik) UIでヒートマップまたはセッション記録の設定を開き、正しいターゲットページまたはエントリーページが設定されていることを確認することをお勧めします。ページ設定の隣にURLバリデーターがあり、特定のページURLでヒートマップやセッションが記録されるかどうかを確認できます。このようにして、タイプミスやその他の設定の問題を見つけることができます。

Matomoクラウドビジネスプランを使用している場合は、以下のトラブルシューティングの手順を実行する必要はありません。ヒートマップとセッション録画プラグインは設定済みで、すぐに使用できます。空白のヒートマップやセッション録画の問題に直面している場合は、こちらのガイドをご覧ください：Matomoのブランク・ヒートマップ

設定が正しい場合、ウェブサーバー設定の制限により、$yourPiwikDomain/plugins/HeatmapSessionRecording/config.phpへのリクエストが失敗している可能性があります。

Matomoにログインしてください。スーパーユーザーをクリックし、管理 => 診断 => システムチェックに進みます。ヒートマップ＆セッション録画のシステムチェックでは、ファイルがインターネット／イントラネットからアクセス可能かどうかをチェックします。アクセスできない場合は、問題を説明するエラーメッセージが表示されます。

システムチェックで問題ないと言われても、まだ動かない場合は、「configs.php」ファイルにアクセスできるかどうかを手動でチェックすることもできます。ウェブサイトを開き、右クリックして「検査」を選択します。ネットワークタブに移動し、ウェブサイトをリロードします。configs.php” のステータスが “200 OK” であることが確認できるはずです。403 “のようなステータスがある場合は、このファイルへのアクセスを許可するようにウェブサーバーを変更する必要があります。

注意：ブラウザからconfigs.phpが利用可能かどうかを手動で確認する場合、「400 Bad Request」レスポンスが表示されることがあります。これは、パラメータが送信されていない場合に期待されるレスポンスであり、configs.phpファイルへのアクセスがブロックされていないことを示します。

また、”matomo.js” ファイルが書き込み可能かどうかを確認し、ヒートマップトラッカーのコードを Matomo JavaScript トラッキングファイルに自動的に挿入できるようにしてください。

Cloudflareなどを使用している場合、Heatmapトラッキングコードを “piwik.js “トラッキングファイルに表示するために、キャッシュを無効にする必要があるかもしれません。また、”config/config.ini.php “ファイルを編集し、以下の2行を追加または修正してください：

[HeatmapSessionRecording]
add_tracking_code_only_when_needed = 0

まだうまくいきませんか？お気軽にお問い合わせください。