Matomoで特定のトラッキングリクエストを除外するには？

2025年01月21日追跡データ除外する除外設定

この FAQ では、送信されたトラッキング API パラメータに応じて、特定のトラッキングリクエストを全サイトの記録から除外する方法について説明します。この機能は、例えば以下のような場合に便利です：

パフォーマンスの問題を一時的に解決するために、特定のリクエストのトラッキングを緊急に停止する必要がある場合。例えば、ウェブサイトやアプリケーションで新しいイベントのトラッキングを開始したところ、トラッキングコードの実装にバグがあり、突然大量のトラッキングリクエストが送られてきたとします。この機能を使えば、新しく追加されたイベントの特定のトラッキングリクエストは除外し、その他の通常のトラッキングリクエストはすべてトラッキングし続けることができます。
プライバシーやセキュリティ上の理由から、特定のリクエストが記録されないようにしたいです。

必要条件

この機能を使用するには、Matomo On-Premise 4.0以降が必要で、$matomoRoot/config/config.ini.phpにあるMatomo設定ファイルを変更できる必要があります。

この設定はサイトごとに設定することもできます。

構成

この機能を設定するには、設定ファイルに以下の行を追加します：

[Tracker] # only add this line if it doesn't exist yet
exclude_requests = ""

このコンフィギュレーションの構造は次のとおりです：{トラッキングパラメータ名}{オペランド}{マッチする値}。
以下のオペランドがサポートされています：
- イコールである：==
- 対等ではない：!=
- を含む：=@
- 含まれていない：!@
- で始まる：=^
- で終わる：=$
右側のマッチする値はURLエンコードされていなければなりません。例えば"action_name==foo%2Cbar"は、”foo,bar “という名前のページタイトルを除外します。
すべての比較は大文字と小文字を区別せずに行われます。

例えば"e_c==Media"は、イベントカテゴリがMediaの場合、すべてのトラッキングリクエストが除外されることを意味します。

複数の除外をコンマで区切って設定することができます。リクエストが除外されるのは、どれかの表現がマッチした場合です (全てではありません)。例えば"e_c==Media,action_name=@privacy".これはさらに、ページタイトルにプライバシーが含まれているリクエストを追跡対象から除外します。

左側で使用できるトラッキングパラメータのリストについては、Tracking API Referenceをご覧ください。

他の例：

ID 1 の特定のサイトに対するすべてのトラッキング要求を除外します："idsite==1"
イベント名が “file “であるものを除外します："e_n==file"
ページのURLに “restricted “が含まれている場合は除外します："url=@restricted"
クッキーが使用された場合を除外します（例えば、プライバシー遵守のためにクッキーが使用されたリクエストを追跡しないようにしたい場合など）："_id!="
ログインユーザーを除外します："uid!="
ログインしていないユーザーを除外します："uid=="
ダウンロードしたファイルのURLに “token “が含まれている場合は除外します："download=@token"

技術情報