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 邏輯是使用,
篩選運算式。
範例： (每個都必須進行網址編碼)
國家/地區代碼為 (美國或英國)：
COUNTRY_CODE==US,COUNTRY_CODE==UK
AND 邏輯
AND 邏輯是由提供多個篩選器參數的方式來完成。
會轉譯為在用戶端程式庫中提供篩選器陣列。
範例：
國家/地區代碼為 US AND 產品代碼為 AFC：
filters=COUNTRY_CODE%3D%3DUS&filters=PRODUCT_CODE%3D%3DAFC
合併 AND 和 OR 邏輯
可以將 AND 和 OR 邏輯合併為單一運算式。
注意： 系統會分別評估每個篩選器 ，再將所有篩選器合併成一個 AND 邏輯運算式。
範例：
國家/地區代碼為 (US OR UK) AND 產品代碼為 AFC：
filters=COUNTRY_CODE%3D%3DUS,COUNTRY_CODE%3D%3DUK&filters=PRODUCT_CODE%3D%3DAFC