篩選

filters 查詢字串參數會限制傳回的資料 傳回的資料。使用 filters 參數時， 請提供做為篩選依據的維度，後面接著篩選器運算式。

查詢在經過篩選後，包含在結果中的資料列會受到限制。每一列 系統會根據篩選器測試結果中的資料列：如果篩選器達成比對，就會 保留該資料列，否則就會捨棄該資料列。

• 網址編碼：用戶端程式庫會自動編碼 篩選器運算子不過，如果您直接請求通訊協定 您必須按照下表指示，對篩選器運算子進行明確編碼。
• 篩選優先順序：篩選是在所有維度「之前」進行 而是匯總維度，因此傳回的指標 相關維度的數據

篩選器語法

單一篩選器會採用以下形式：

name operator expression

在這個語法中：

• name：做為篩選依據的維度名稱。 舉例來說，AD_CLIENT_ID 會以廣告用戶端 ID 為篩選依據。
• operator — 定義要使用的篩選器比對類型。
• expression：指出包含在結果中的值。

涵蓋的所有維度 套用於報表的指標就能當做篩選器使用 但不含日期相關維度 (DATE、WEEK、 和 MONTH)。如要按日期篩選，請指定 報表的日期範圍。

篩選器運算子

篩選器運算子有兩種。運算子必須經過網址編碼，才能 加進網址查詢字串中

運算子	說明	網址編碼表單	範例
==	完全比對	%3D%3D	匯總國家/地區名稱為「Canada」的指標： filters=COUNTRY_NAME%3D%3DCanada
=@	包含子字串	%3D@	彙整國家/地區名稱包含「United」的指標 比對美國和英國，例如： filters=COUNTRY_NAME%3D@United

篩選器運算式

篩選器運算式有幾個重要規則：

• 網址保留字元 — & 必須以正常的方式進行網址編碼。用戶端程式庫 會為您處理這項工作，因此只有在符合下列條件的情況下， 才能直接呼叫通訊協定
• 保留字元 — 當逗號和反斜線出現在運算式時， 必須以反斜線逸出。
  • 反斜線 \\
  • 逗號 \,

注意： 請務必正確加上反斜線， 避免重複逸出。

合併篩選器

篩選器可用 OR 和 AND 布林 邏輯。

OR 邏輯

OR 邏輯是使用, 篩選運算式。

AND 邏輯

AND 邏輯是由提供多個篩選器參數的方式來完成。 會轉譯為在用戶端程式庫中提供篩選器陣列。

合併 AND 和 OR 邏輯

可以將 AND 和 OR 邏輯合併為單一運算式。

注意： 系統會分別評估每個篩選器 ，再將所有篩選器合併成一個 AND 邏輯運算式。

後續步驟

• 選擇合適的維度
• 執行大型報表
• 指標和維度清單