ALL(...)
函式會檢查某個項目是否只含有與篩選器相符的項目。檢查時,您可以為要匹配的內含項目指定類型,以及指定內含項目必須符合的子項篩選器。
ALL 是一種便利函式 (convenience function),撰寫上更為簡單,可檢查所有內含項目。ALL(types, filter)
等同於 COUNT(types, NOT(filter)) = 0
。也就是說,ALL 可以幫您找出沒有任何內含項目與子項篩選器不相符的容器。
語法
ALL(types, [filter])
types
-- 要檢查的內含項目類型。filter
-- 內含項目必須符合這項篩選條件。
示例
ALL(keywords, labels = ("abc", "xyz") )
檢查廣告活動或廣告群組中的關鍵字是否全部都有「abc」或「xyz」標籤。在本例中,「keywords」是要檢查的項目類型,而「labels = ("abc", "xyz")」則是這些項目必須完全符合的子項篩選器。
ALL(callextensions; sitelinks, approvalstatus = approved)
檢查與廣告活動或廣告群組建立關聯的所有網站連結和電話素材資源是否已獲核准。
附註
- 如果子項篩選器中設有多個條件,則這些條件都必須與內含項目相符;您可以納入 OR 函式來檢查符合「任何一個」條件的內含項目。舉例來說,
ALL(ads, OR(status = paused approvalstatus = disapproved))
會檢查所有廣告處於已暫停且/或已拒登狀態。 - 篩選器可以納入只套用到部分類型的條件,而系統檢查其他不適用的類型時會忽略這些條件。舉例來說,
ALL(keywords; sitelinks, keywordwordcount = 2 linktext : "local")
會檢查所有關鍵字是否恰好含有 2 個字詞,且所有相關網站連結的連結文字是否含有「local」一詞。 - 如果缺少指定類型的內含項目,ALL 檢查就會成功。舉例來說,
ALL(keyword, status = enabled)
會顯示完全不含任何關鍵字的廣告活動或廣告群組。這是因為範例只是COUNT(keywords, NOT(status = enabled)) = 0
的便利函式,且未在廣告活動或廣告群組中啟用的關鍵字數量剛好為 0。如果希望結果只顯示至少一個子項目與篩選器相符的父項目,您可以新增類型與子項篩選器件相同的 EXIST 函式做為 ALL。在本例中,您可以使用這個篩選器:EXIST(keywords, status = enabled) ALL(keywords, status = enabled)
。也就是說,這個篩選器會在所有關鍵字皆已啟用的情況下,找出至少存在其中一個已啟用關鍵字的廣告活動。
針對廣告活動和廣告群組使用 ALL 函式
對於只能包含在廣告群組內的項目,ALL 函式在廣告活動層級時,會檢查所有廣告群組中的全部項目是否符合子項篩選器。舉例來說,廣告活動層級的 ALL(keyword, status = enabled)
會顯示廣告活動中所有廣告群組的所有關鍵字是否都已啟用。
對於可以包含在廣告群組或廣告活動內的項目,如果是在廣告活動層級檢查,就只會檢查該廣告活動內的項目。舉例來說,廣告活動層級的 ALL(audiences, status = enabled)
會顯示已啟用所有廣告活動層級目標對象的廣告活動,即使廣告活動有部分廣告群組層級目標對象未啟用也一樣。素材資源的情況也是如此:廣告活動層級的 ALL(sitelinks, status = enabled)
只會檢查廣告活動層級網站連結,不會檢查廣告活動內的廣告群組層級網站連結。