技術情報

Matomoは私のウェブサイトのダウンロードやアウトリンクのクリックを追跡しません。

Matomo(Piwik)は、ダウンロードファイル(jpg、png、exe、zipなどの既知の拡張子を持つ)のクリックと、Javascriptクリックハンドラを使用したアウトリンク(他のウェブサイトへのリンク)のクリックを自動的に追跡する必要があります。これが失敗する理由はいくつかあります:

  • 競合するJavascriptコード
    まれに、Matomo でダウンロードとアウトリンクのトラッキングが機能しない場合がありますが、これはページがクリックハンドラを設定する別の Javascript スクリプトやライブラリを使用しているためです。サードパーティのクリックハンドラが値を返す場合、ブラウザが他の登録済みクリックハンドラをキャンセルする原因となります。その代わりにfalseを返すべきです。ほとんどのスクリプトやライブラリは正しく動作していますが、onclickイベントでfalseを返すようにJavascriptコードを手動で編集する必要があるかもしれません。
  • Matomoは十分に速く反応せず、ユーザーはクリックターゲットにリダイレクトされる
    Matomo クリックハンドラは、リクエストが Matomo サーバに送信される間に小さな遅延を追加することで動作します。この遅延時間内にリクエストがサーバに到達しなかった場合、リクエストは追跡されず、ユーザはクリックしたダウンロードファイルまたは外部ウェブサイトにリダイレクトされます。Javascriptコードのpiwik.getTracker(…)行の後に以下を追加することで、この遅延をデフォルトの500ms(0.5秒)から増やすことができます:

    _paq.push([‘setLinkTrackingTimer’, 750]); // 750ミリ秒に増やす

  • ブラウザのバージョンが古い
    例えば、WebKitのバグでトラッキングリクエストが中断されることが知られています。回避策として、アンカー要素に target=「_blank」 属性を追加する方法があります。
  • Matomoがまだ知らない拡張子を追跡する場合は、開発者ガイドを参照してください。 ダウンロードされたファイルの種類を追跡するようにカスタマイズします。
  • 自動ダウンロードトラッキングが何らかの理由で機能しない場合、手動でクリックをダウンロードとして記録することができます。
  • MatomoのJavaScriptトラッカーでSend Beaconを有効にする Matomo 4ではデフォルトでSend Beaconが有効になっていますが、必要に応じて手動で有効にすることもできます。

それでも解決しない場合は、こちらのFAQをご覧ください: Matomoが自分のウェブサイトへのアウトリンクのクリックを追跡しません。