篩選過的報表

新版 Search Ads 360 Reporting API 現已上線。新版 API 提供 更有彈性，可用來建立自訂報表，以及將資料整合至報表應用程式 和處理程序進一步瞭解如何遷移至及使用新版 Search Ads 360 報表 API。

根據預設，報表會包含 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

這一欄必須與篩選器清單中的其中一個值完全相符。

不適用於清單資料類型 (例如 String list)。

機動
lessThan

資料欄必須包含的值必須小於指定值。

如果您為「Boolean」欄指定這個篩選器，Search Ads 360 API 會轉換 false 設為 0，true 到 1 的數值。如果 您為 String 資料欄指定這個篩選器後，API 會比較 字母順序。

不適用於清單資料類型 (例如 String list)。

 1
greaterThan

此欄包含的值必須大於其中一個 篩選器清單中

如果為 Boolean 欄指定這個篩選器，API 會轉換 false 設為 0，true 到 1 的數值。如果 您為 String 資料欄指定這個篩選器後，API 會比較 字母順序。

不適用於清單資料類型 (例如 String list)。

1
lessThanOrEqual

此欄包含的值必須小於或等於下列其中一個值 篩選器清單中的值。

如果為 Boolean 欄指定這個篩選器，API 會轉換 false 設為 0，true 到 1 的數值。如果 您為 String 資料欄指定這個篩選器後，API 會比較 字母順序。

不適用於清單資料類型 (例如 String list)。

1
greaterThanOrEqual

此欄包含的值必須大於或等於下列其中一個值： 篩選器清單中的值。

如果為 Boolean 欄指定這個篩選器，API 會轉換 false 設為 0，true 到 1 的數值。如果 您為 String 資料欄指定這個篩選器後，API 會比較 字母順序。

不適用於清單資料類型 (例如 String list)。

1
isNull 資料欄必須留空。舉例來說，如果您指定 isNull (適用於關鍵字報表的「keywordMaxCpc」欄) 只會包含未指定最高單次點擊出價的關鍵字。 0
isNotNull 資料欄必須包含值。 0
startsWith

這一欄的開頭必須是篩選器清單中的任一字串。

僅適用於 String 欄。

機動
containsSubstring

此欄必須包含 篩選器清單中

例如，具有以下值的 containsSubstring 篩選器：
["ham", "cheese"]
會傳回包含以下值的資料列：
hamburger
cheeseburger

但不會傳回包含下列值的資料列：
lobster roll
lettuce
high amplitude (high amplitude 包含 子字串「h am」，但所有字元 (包括空格) 都會經過篩選器評估)

僅適用於 String 欄。

機動
doesNotContainSubstring

這一欄不得包含篩選器清單中的任何字串。

例如，具有以下值的 doesNotContainSubstring 篩選器：
["ham", "cheese"]
會傳回包含以下值的資料列：
lobster roll
lettuce

但不會傳回包含下列值的資料列：
漢堡
起司漢堡

僅適用於 String 欄。

機動
containsElement

篩選器清單中必須至少含有一個值。 僅適用於含有清單資料類型的資料欄 (例如 String list)。

以 campaign 報表為例 包含以下值的 containsElement 篩選器：

["foo", "bar"] 篩選「effectiveLabels」欄 只會傳回標籤為 foo 和/或 bar 的廣告活動。

機動