根據預設,報表會包含要求指定 reportScope 中的所有資料。如果希望報表只包含一組符合一組條件的資料,可以在報表中新增一或多個篩選器。系統只會傳回符合所有篩選條件的資料列。
舉例來說,您可以要求為特定代理商的所有關鍵字製作報表。接著,您可以指定篩選器,讓報表只顯示到達網頁網址開頭為 www.example.com 和 www.another-example.com 的關鍵字。
"filters": [ { "column" : { "columnName": "keywordLandingPage" }, "operator" : "startsWith", "values" : [ "http://www.example.com", "http://www.another-example.com" ] } ]
每個篩選器會指定要篩選的資料欄、運算子以及應位於指定資料欄的值清單:
"filters": [ { "column" : column to filter on, "operator" : operator specifying the type of filter, "values" : list of values }, { ... another filter can go here ... } ]
Filterable
。篩選器運算子
所有篩選器均須區分大小寫。也就是說,含有「www.Sprockets.com」的篩選器,不會與包含「www.sprockets.com」的資料欄進行比對。
業者 | 說明 | 支援的值數量 |
---|---|---|
equals |
資料欄必須與指定值完全相符。 | 1 |
notEquals |
資料欄不得與指定值相符。 | 1 |
in |
這一欄必須與篩選器清單中的其中一個值完全相符。
不適用於清單資料類型 (例如 |
變數 |
lessThan |
資料欄所含的值必須小於指定值。
如果您為「 不適用於清單資料類型 (例如 |
1 |
greaterThan |
資料欄所含的值必須大於篩選器清單中的其中一個值。
如果您為
不適用於清單資料類型 (例如 |
1 |
lessThanOrEqual |
資料欄所含的值必須小於或等於篩選器清單中的其中一個值。
如果您為
不適用於清單資料類型 (例如 |
1 |
greaterThanOrEqual |
資料欄所含的值必須大於或等於篩選器清單中的其中一個值。
如果您為
不適用於清單資料類型 (例如 |
1 |
isNull |
此欄必須留空。舉例來說,假設您在關鍵字報表中為 keywordMaxCpc 欄指定 isNull ,報表就只會包含未指定最高單次點擊出價的關鍵字。
|
0 |
isNotNull |
資料欄必須包含值。 | 0 |
startsWith |
資料欄的開頭必須是篩選器清單中的其中一個字串。
僅適用於 |
變數 |
containsSubstring |
這個資料欄必須包含篩選器清單中指定的完整或部分字串。
例如,含有下列值的
但不會傳回含有下列值的資料列:
僅適用於 |
變數 |
doesNotContainSubstring |
資料欄不得包含篩選器清單中的任何字串。
舉例來說,如果 但不會傳回含有下列值的資料列:
僅適用於 |
變數 |
containsElement |
資料欄必須包含篩選器清單中至少一個值。僅適用於包含清單資料類型的資料欄 (例如
舉例來說,在 |
變數 |