Filters

filter 查詢字串參數會限制 AdSense Host API v4 報表中傳回的日期。使用 filter 參數時,您必須提供做為篩選依據的維度,後面則接著篩選器運算式。

查詢在經過篩選後,包含在結果中的列會變少。結果中的每一列都會根據篩選器進行測試:如果篩選器達成比對,就會保留該列,否則會捨棄該列。

  • 網址編碼:用戶端程式庫會自動替篩選器運算子進行編碼。不過,如果您直接請求通訊協定,則必須依照下表所述的方式,替篩選器運算子進行明確的編碼。
  • 篩選優先級:篩選是在所有維度彙整「之前」進行的,這樣傳回的指標就只會代表相關維度的總數。

篩選器語法

任何一個篩選器的格式都是這樣:

name operator expression

在這個語法中:

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

篩選器運算子

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

運算子 說明 網址編碼格式 範例
== 完全比對 %3D%3D 彙整國家/地區名稱為「Canada」的指標:
filter=COUNTRY_NAME%3D%3DCanada
=@ 包含子字串 %3D@ 彙整國家/地區名稱包含「United」的指標 (相符項目包括 United States 和 United Kingdom 等等):
filter=COUNTRY_NAME%3D@United

篩選器運算式

篩選器運算式有幾項重要規則:

  • 網址保留字元& 等字元必須以正常的方式進行網址編碼。用戶端程式庫會為您處理這項工作,因此如果您要直接呼叫通訊協定,就不需要進行這項編碼。
  • 保留字元 — 當逗號和反斜線出現在運算式時,必須以反斜線溢出。
    • 反斜線 \\
    • 逗號 \,

備註:請您務必確認逗號之前以反斜線溢出,避免重複溢出。

合併篩選器

篩選器可用 ORAND 布林邏輯加以合併。

OR 邏輯

OR 邏輯是使用篩選器運算式中的逗號 (,) 來定義。

範例:(每個都必須進行網址編碼)

國家/地區代碼為 (US OR UK):
COUNTRY_CODE==US,COUNTRY_CODE==UK


AND 邏輯

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

範例:

國家/地區代碼為 US AND 產品代碼為 AFC:
filter=COUNTRY_CODE%3D%3DUS&filter=PRODUCT_CODE%3D%3DAFC


合併 AND 和 OR 邏輯

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

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

範例:

國家/地區代碼為 (US OR UK) AND 產品代碼為 AFC:
filter=COUNTRY_CODE%3D%3DUS,COUNTRY_CODE%3D%3DUK&filter=PRODUCT_CODE%3D%3DAFC