Universal アナリティクス Core Reporting API フィルタ演算子、フィルタ式

フィルタ演算子
フィルタ式

フィルタ演算子

Core Reporting API - リファレンスガイド | Analytics Core Reporting API | Google for Developers

ディメンション用と指標用にそれぞれ 6 つのフィルタ演算子があります。演算子を URL クエリ文字列に含めるには URL エンコードする必要があります。

ヒント: URL エンコードが必要なフィルタを設計するには、Data Feed Query Explorer を使用します。Query Explorer は、文字列と空白を含む URL を自動的にエンコードします。

演算子	説明	URL エンコード形式	例
`==`	次と等しい	`%3D%3D`	ページ閲覧時間がちょうど 10 秒である結果を返します。 `filters=ga:timeOnPage%3D%3D10`
`!=`	等しくない	`!%3D`	ページ閲覧時間が 10 秒以外である結果を返します。 `filters=ga:timeOnPage!%3D10`
`>`	上回る	`%3E`	ページ閲覧時間が 10 秒を超える結果を返します。 `filters=ga:timeOnPage%3E10`
`<`	下回る	`%3C`	ページ閲覧時間が 10 秒未満である結果を返します。 `filters=ga:timeOnPage%3C10`
`>=`	以上	`%3E%3D`	ページ閲覧時間が 10 秒以上である結果を返します。 `filters=ga:timeOnPage%3E%3D10`
`<=`	以下	`%3C%3D`	ページ閲覧時間が 10 秒以下である結果を返します。 `filters=ga:timeOnPage%3C%3D10`

演算子	説明	URL エンコード形式	例
`==`	完全一致	`%3D%3D`	都市が Irvine である指標を集計します。 `filters=ga:city%3D%3DIrvine`
`!=`	一致しない	`!%3D`	都市が Irvine 以外である指標を集計します。 `filters=ga:city!%3DIrvine`
`=@`	文字列の一部に一致	`%3D@`	都市に York が含まれる指標を集計します。 `filters=ga:city%3D@York`
`!@`	文字列の一部に一致しない	`!@`	都市に York が含まれない指標を集計します。 `filters=ga:city!@York`
`=~`	正規表現の一致を含む	`%3D~`	都市が New から始まる指標を集計します。 `filters=ga:city%3D~%5ENew.*` （%5E は、パターンを文字列の先頭に固定する ^ 文字を URL エンコードした形式です。）
`!~`	次の正規表現に一致する場合を除く	`!~`	都市が New から始まらない指標を集計します。 `filters=ga:city!~%5ENew.*`

フィルタ式

Core Reporting API - リファレンスガイド | Analytics Core Reporting API | Google for Developers

フィルタ式にはいくつか重要な規則があります。

URL 予約文字 – & などの文字には、一般的な方法で URL エンコードを使用する必要があります。
予約文字 – セミコロンとカンマを式に含める場合は、すべてバックスラッシュでエスケープ処理する必要があります。
- セミコロン \;
- カンマ \,
正規表現 – フィルタ式では =~ や !~ 演算子を使用して正規表現も使用できます。正規表現の構文は Perl 正規表現と似ていますが、次の規則が追加で適用されます。
- 最長 128 文字 – 正規表現の長さが 128 文字を超えると、400 Bad Request ステータスコードがサーバーから返されます。
- 大文字と小文字の区別 – 正規表現一致では大文字と小文字は区別されません。

フィルタの組み合わせ

フィルタはブール論理演算の OR と AND を使用して組み合わせることができます。これにより、フィルタ式の 128 文字の制限を事実上拡張できます。

OR

OR 演算子は、カンマ（,）を使用して定義します。この演算子は AND 演算子よりも優先されます。この演算子を同じ式内でディメンションと指標を組み合わせるために使用することはできません。

例: （URL エンコードする必要があります）

国が米国または（OR）カナダのいずれか:
ga:country==United%20States,ga:country==Canada

Windows または（OR）Macintosh オペレーティングシステムの Firefox ユーザー:
ga:browser==Firefox;ga:operatingSystem==Windows,ga:operatingSystem==Macintosh

AND

AND 演算子は、セミコロン（;）を使用して定義します。この演算子より OR 演算子の方が優先されます。この演算子は、同じ式内でディメンションと指標を組み合わせるために使用することができます。

例: （URL エンコードする必要があります）

国が米国で、かつ（AND）ブラウザが Firefox:
ga:country==United%20States;ga:browser==Firefox

国が米国で、かつ（AND）言語コードの先頭が「en」以外:
ga:country==United%20States;ga:language!~^en.*

オペレーティングシステムが Windows または（OR）Macintosh で、かつ（AND）ブラウザが Firefox または（OR）Chrome:
ga:operatingSystem==Windows,ga:operatingSystem==Macintosh;ga:browser==Firefox,ga:browser==Chrome

国が米国で、かつ（AND）セッション数が 5 を超える:
ga:country==United%20States;ga:sessions>5