立達網路行銷 0800-250-555

Search Analytics API 補上三種篩選:品牌字、多模態與多國家裝置

立達網路行銷編輯部|行銷新知・Google官方指南|發布:2026-11-22

如果你們每週都用 API 或串接工具產出 Search Console 報表,這次的更新值得花十分鐘看。Google 在 2026 年 11 月 16 日的 Search Central 部落格宣布,Search Analytics API 補上三項原本只有控制台才有的切法:品牌字與非品牌字、網頁多模態搜尋,以及一次篩選多個國家或裝置。意思是,你自己做的報表終於可以和控制台用同一套分類。下面先講官方說了什麼,再講串接前該確認的限制,最後是台灣網站可以先動手的地方。

Search Analytics API 新增品牌字、多模態與多國家裝置篩選的示意卡片
Search Analytics API 新增品牌字、多模態與多國家裝置篩選的示意卡片

官方這次補了什麼

Search Analytics API 新增的三個篩選選項
  • brandedClassification把查詢分成品牌與非品牌,只支援 equals,值為 BRANDED 或 NON_BRANDED,且只對符合資格的資源有資料
  • type=webMultimodal查 Google Lens、Circle to Search 與上傳圖片搜尋的表現,要與一般網頁搜尋分開查
  • filterLists一次篩選多個國家或裝置,文件目前只允許 country 與 device 兩個維度
  • 併用與限制三者可以搭配,但 brandedClassification 不能和 query 篩選放在同一個請求

過去一年,Search Console 控制台的成效報告已經陸續加上品牌查詢篩選、網頁多模態搜尋報表,以及多國家與多裝置篩選。這次的變動是把這三項帶進 API,方便你自訂報表,或把它接進自動化流程。官方也說明,三個篩選可以併用,例如看特定區域的品牌字成長,或看多模態搜尋在主要市場與裝置上哪些頁面表現較好。

brandedClassification:品牌字與非品牌字

brandedClassification 讓你把表現依品牌或非品牌分組,或直接拿來當篩選條件。官方強調它和控制台一樣,只對符合資格的資源提供資料;不符合的資源,回應裡不會有任何資料列。API 文件進一步寫明:這個欄位只支援 equals 運算子,值為 BRANDED 或 NON_BRANDED,資料從 2026 年 2 月 21 日開始,而且只提供給查詢量與曝光量足夠的頂層資源。至於「足夠」是多少,我們查到的文件沒有給出數字。

type=webMultimodal:看圖搜尋的表現

type 多了 webMultimodal 這個值,涵蓋 Google Lens、Android 的 Circle to Search,以及在 Google 搜尋上傳圖片的表現。如果你的資源有啟用大量資料匯出,官方說這份資料也會進 BigQuery。要注意 type 一次只填一個值,預設是 web,所以多模態和一般網頁搜尋是兩次查詢,不會混在同一份數字裡。

filterLists:一次篩選多個國家或裝置

過去想看好幾個國家的合計,你得分別請求再自己加總。filterLists 讓你在一個請求裡列出多個值,只要資料列符合其中任何一個就會被納入。官方舉的例子是 EMEA、LATAM、DACH 這類國家組合,再搭配裝置。這只是官方的舉例,不代表台灣網站要照做。依文件,filterLists 的維度目前只能是 country 或 device;國家用三碼 ISO 代碼,裝置值是 DESKTOP、MOBILE、TABLET。

串接前要先看的限制

官方文件裡有幾條規則,不先看清楚,報表跑出來容易空白或報錯:

  • brandedClassification 不能和 query 篩選放在同一個請求裡。
  • 同一個請求中,同一個維度不能同時出現在 filters 和 filterLists。
  • dimensionFilterGroups 的 groupType 目前只支援 and,「或」還不支援。
  • 官方文件寫明,API 受內部限制,不會回傳全部資料列,而是回傳較前面的列;單次最多取 25,000 列,要用 startRow 分頁。

最後一點常被忽略:你在 API 看到的列數,不一定等於控制台完整的資料量。報表要拿來做決策,別預設兩邊逐列一致。

在台灣網站上可以怎麼做

先在控制台確認你有沒有資格

品牌字分類不是每個資源都看得到。你可以先登入 Search Console,打開成效報告,看有沒有品牌查詢的篩選選項。控制台看不到,API 多半也不會有資料,這時就不必花時間改程式。另外,文件寫的是只支援頂層資源(top-level properties),且查詢量與曝光量要足夠。若你們的資源不是頂層資源,請先在控制台確認看不看得到這個篩選。

多模態與一般網頁要分開看

很多中小企業站的圖片、商品照或菜單照,確實會被看圖搜尋帶來曝光。webMultimodal 的好處,是你終於能獨立看這塊。做法是每週多跑一次請求,type 設為 webMultimodal,維度先放 page,看哪些頁面有表現,再回頭檢查那些頁面的圖片說明、檔名與周邊文字。官方沒有說明這類搜尋的量在一般網站上通常多大,所以先觀察,不要預設它很重要。

選一份既有報表試跑

不要一次重做所有報表。選一份你們每週本來就在看的,例如「各裝置的非品牌字點擊」,改成用 API 的新選項跑一次,和控制台同期間的畫面對照。差距若在文件說的限制範圍內,就可以放進例行流程。如果報表是代理商或工具商做的,請他們確認工具是否已支援這三個選項;沒支援的話,比較穩的做法是先在控制台人工看,不要自己硬改請求。

串接前檢查清單

  1. 控制台有沒有品牌查詢篩選,資源類型是不是頂層資源。
  2. 請求裡有沒有同時用了 brandedClassification 與 query 篩選。
  3. country 用的是不是三碼代碼,device 是不是大寫的官方值。
  4. 多模態與一般網頁搜尋,是否各自一個請求。
  5. 是否需要分頁,rowLimit 與 startRow 設對了沒。
  6. 欄位與可用值,一律以官方 API 文件為準,別參考第三方文章裡的舊範例。

還沒說清楚的地方

官方沒有說品牌字的分類邏輯細節,也沒有說多模態搜尋的資料量級,更沒說這些資料會不會再擴充到更多資源。這些你都不用猜,先把報表跑起來,記下日期與觀察結果,之後官方補充再對照即可。有想把 Search Console 資料接進自動化報表的需求,可以聯絡我們的免付費電話 0800-250-555 或 LINE @szt9406q。

參考來源

發布:2026-11-22|最後更新:2026-11-22

延伸閱讀

相關服務

想把這些做法用在自己的網站?

說明你目前的網站狀況與目標,我們再一起看適合的下一步。

打電話諮詢加 LINE 詢問