技術情報

ページオーバーレイの問題のトラブルシューティング

2025年01月21日 トラブルシューティング ページオーバーレイ レポート

 

1.まったく機能しない

  • ページオーバーレイで表示したいページにMatomo（Piwik）のトラッカーコードがあることを確認してください。
  • Adblock plusやGhosteryなどのスクリプトをブロックするブラウザ拡張機能を使用している場合は、オーバーレイ機能を使用する際にそれらを無効にしてください。同様に、ブラウザがReferrerフィールドを通過することを確認してください（拡張機能やブラウザの設定によっては、これを無効にすることができます）。
  • Webサイト内の他のJavaScriptコードにエラーが含まれている場合、ページオーバーレイJavaスクリプトが動作しないことがあります。
  • もしかすると、あなたのウェブサイトはjqueryを非常に古いバージョンやハックされたバージョンで使用しているかもしれません。Page Overlayはjqueryを使用し、あなたのウェブサイトがすでにjqueryを使用していることを検出すると、あなたの実装を使用しようとします。
  • もし、「Refused to display ‘https://example.com/’ in a frame because it set ‘X-Frame-Options’ to ‘deny’.」 というエラーが表示された場合、あなたのウェブサイトは、HTTPヘッダ X-FRAME-OPTIONS を SAMEORIGIN (または DENY) に送信しているため、Matomo はあなたのウェブサイトをオーバーレイレポート用に iframing することができません。この問題を解決するには、X-FRAME-OPTIONSヘッダを送信しないようにしてください。
  • サイドバーを表示するには、ページをフレームで開く必要があります。あなたのウェブサイトにフレームバスターがある場合、ページオーバーレイは壊れてしまいます。しかし、設定オプションoverlay_disable_framed_modeを使用することで、サイドバーなしで使用することができます。
  • ページオーバーレイはTransitionsプラグインに依存します。つまり、OverlayはTransitionsも有効になっている場合にのみ機能します。(もちろん、Overlayプラグインも有効にする必要があります）。
  • Page Overlay は、Matomo トラッカーに渡した URL からスクリプトとデータを読み込もうとします。mod_proxyを制限的に設定している場合、またはこれが動作しない他の理由がある場合は、MatomoトラッカーのsetAPIUrl(apiUrl)メソッドを使用して、どのURLからスクリプトとデータを読み込むべきかを知らせてください。パラメータapiUrlはpiwikのルートディレクトリ、例えばhttp://piwik.example.org/ やhttps://example.org/piwik/ を指す必要があります。setAPIUrlの呼び出しは、trackPageViewを呼び出す前に行う必要があります。

Matomo ではリダイレクトは追跡されないため、異なる URL にリダイレクトされる URL を指すリンクは、ページオーバーレイではアノテーションできません。これが発生する最も一般的なケースは、クリックするとサブメニューが表示され、最初のサブカテゴリにリダイレクトされるカテゴリがナビゲーションに含まれている場合です。

3.ページ・オーバーレイ・セッションはまだ開始できません。

通常、ウェブサイトはサイドバーの位置を通知する。このエラーは、通知が送信されていないことを意味します。
考えられる原因は以下の通りである：

  • Matomo が現在 SSL で読み込まれている場合、Page Overlay はウェブサイトも SLL で読み込もうとします。ウェブサイトがhttpsをサポートしていない場合は、それが問題です。Matomoをhttpで使用すれば、ウェブサイトもhttpで読み込まれます。
  • ページオーバーレイで開くページにはMatomoトラッカーが必要です。
  • ページオーバーレイで表示したいページにリダイレクトが含まれていると、セッションを開始できません。

4.複数のドメインを持っていますが、すべてのデータが表示されません。

Matomo Page Overlay は、http または https、www の有無にかかわらず URL を扱うことができます。異なるドメインがある場合、ページを異なるアクションとして記録し、Page Overlay は 1 つのドメインの次のページのみを表示します。これを避けるには、Java ScriptのトラッカーメソッドsetCustomUrl()を使用して、エイリアスドメインをJava Scriptのメインドメインに置き換えることで、1つのドメインのページビューのみを追跡することができます。

5.トラフィックの多いウェブサイトを持っているのですが、泡が出るまで時間がかかります。

右下に “loading following pages… “と長時間表示される場合は、Matomoサーバーが次のページを素早く見つけられないことを意味します。これらのページを見つけるために、Overlay はバックグラウンドで Transitions を使用します。したがって、Transitionsを高速化することは、Page Overlayを高速化することと同じです。

あなたの問題を解決するために、以下をご覧ください。トランジションの高速化に関するFAQ.