Technical Documentation

技術文書

Matomoに関する技術文書

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

 

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.

 

 

オンラインデモを体験

面倒なアカウント登録や
サーバーへのインストールは一切不要です。
実際の解析データを反映した管理画面で、
Matomoの快適な操作感を
今すぐ体験できます。

matomo画面
※Matomo Cloudは
Matomo開発元である
InnoCraft社が
提供するサービスです。
matomo画面

法人向け導入運用サポート

導入から運用まで 完全支援

Matomoユーザー会では、法人・団体向けにMatomoの導入から運用までの技術支援を行っています。
必要なサービスだけを組み合わせてご利用いただけます。

導入・運用支援

初期構築をお任せ

要件の整理から環境構築、導入直後の調整まで、必要な作業をまとめてお任せいただけます。

  • 要件整理・ヒアリング
  • 環境構築・インストール
  • パフォーマンス調整

matomo保守

導入後も安心の保守

操作や設定のご相談から、バージョンアップや性能改善までを継続的に支援します。

  • お問い合わせ対応
  • バージョンアップ対応
  • 性能・障害の調査対応

サーバ保守

サーバ稼働もお任せ

Matomoが動作するサーバを監視し、障害時も含めて計測を止めない状態を維持します。

  • 死活・リソース監視
  • 障害の一次・二次対応
  • 24時間365日の対応

オプション

必要な分だけ依頼

ご契約の有無にかかわらず、必要な作業だけを単発でご依頼いただけます。

  • トレーニング・設定代行
  • マニュアル・運用設計
  • データ移行
法人導入のご相談はお気軽にお問い合わせください。

要件整理・見積もり・PoC環境提供まで無償で対応いたします。