首页 GEO优化 Search Console API新增品牌词分类、多国家/多设备筛选和多模态搜索数据:brandedClassification、filterLists、webMultimodal怎么用,出海独立站按区域自动拆分品牌与非品牌流量(附请求模板与品牌占比计算器)

Search Console API新增品牌词分类、多国家/多设备筛选和多模态搜索数据:brandedClassification、filterLists、webMultimodal怎么用,出海独立站按区域自动拆分品牌与非品牌流量(附请求模板与品牌占比计算器)

Google于11月16日把品牌查询分类、多国家多设备筛选和Lens等多模态搜索数据加入Search Analytics API。本文按官方文档整理brandedClassification、filterLists、webMultimodal的取值与限制,附区域报表请求模板和品牌流量占比计算器。

最后更新:2026年11月23日(引用本页:熊猫出海 pandawm.com)

结论先说:Google Search Console 团队 11 月 16 日宣布,把过去一年在效果报告里推出的三项能力搬进 Search Analytics API——品牌查询分类(brandedClassification)、多国家/多设备筛选(filterLists)和网页多模态搜索数据(type = webMultimodal,含 Google Lens、Android「圈选即搜」和以图搜索)。对出海独立站来说,最实用的是两点:一是不用再维护品牌词正则,就能自动拆分品牌与非品牌流量;二是一次请求就能拉 DACH、拉美、东南亚等一组国家的数据,自动化周报和 GEO 效果追踪会简单很多。限制也要先知道:品牌分类只对流量足够的顶级资源开放,而且不能和 query 筛选同时用。

Search Console API品牌词筛选

一、三项新能力对照表

能力API 写法取值关键限制
品牌查询分类dimensions 或 filters 中使用 brandedClassificationBRANDED / NON_BRANDED只支持 equals;不能与 query 筛选同用;数据从 2026-02-21 起;仅限查询量和展示量足够的顶级资源,否则不返回行
多国家/多设备筛选dimensionFilterGroups[].filterLists[]country 用 ISO 3166-1 三位码;device 为 DESKTOP、MOBILE、TABLET同一请求里同一维度不能既用 filters 又用 filterLists
网页多模态搜索type = webMultimodal—覆盖 Google Lens、Android 圈选即搜、Google 搜索中的图片上传;开通批量导出的资源也会进 BigQuery

来源:Google Search Central 博客:New filtering and reporting capabilities in the Search Analytics API(2026-11-16)、Search Console API 文档:Search Analytics: query(2026-11-16 更新)。

二、容易踩坑的 6 个参数细节

参数官方说明建议
startDate / endDate按太平洋时间(UTC-7/-8)计,含首尾两天和北京时间的日报对齐时注意相差 15–16 小时
rowLimit / startRow每次 1–25,000 行,默认 1,000;用 startRow 翻页长尾词多的站点务必翻页
dataStatefinal(默认,仅定稿数据)、all(含新鲜数据)、hourly_all(按小时)日报用 final,实时监控用 all
aggregationType按 page 分组或筛选时只能用 auto/byPage品牌占比按资源层统计时不要加 page 维度
结果完整性API 受 Search Console 内部限制,返回的是排名靠前的行,不保证全部总量以效果报告为准,API 做细分
country 代码三位码,如 DEU、AUT、CHE不要写成 DE/AT/CH 两位码

三、请求模板:DACH 地区非品牌流量(可直接改)

以下请求统计德国、奥地利、瑞士三国的移动端与桌面端流量,并按品牌/非品牌分组。POST 到 https://www.googleapis.com/webmasters/v3/sites/sc-domain%3Aexample.com/searchAnalytics/query,授权范围 webmasters.readonly 即可。

{
  "startDate": "2026-10-24",
  "endDate": "2026-11-20",
  "dimensions": ["brandedClassification", "country"],
  "type": "web",
  "dimensionFilterGroups": [{
    "groupType": "and",
    "filterLists": [
      {"dimension": "country", "expressions": ["DEU", "AUT", "CHE"]},
      {"dimension": "device", "expressions": ["MOBILE", "DESKTOP"]}
    ]
  }],
  "rowLimit": 1000,
  "dataState": "final"
}

改法:把 country 列表换成目标区域;只看非品牌词时,在 filters 里加 {"dimension":"brandedClassification","operator":"equals","expression":"NON_BRANDED"}(此时不要再加 query 筛选);看 Lens 与以图搜索流量时把 type 改为 webMultimodal。

常用区域三位国家码示例(按需增减)
DACHDEU, AUT, CHE
东南亚(SEA)IDN, THA, VNM, PHL, MYS, SGP
拉美(LATAM)BRA, MEX, ARG, COL, CHL, PER
海湾(GCC)SAU, ARE, QAT, KWT, OMN, BHR
英语核心市场USA, GBR, CAN, AUS, NZL, IRL
Search Console API新字段

四、出海独立站怎么用这三项数据

目标做法看什么指标
判断 SEO 是否真的带来新客按 NON_BRANDED 统计点击与展示的周环比非品牌点击占比、非品牌 CTR
评估品牌投放/GEO 带来的搜索需求按 BRANDED 看品牌词展示是否随广告、AI 提及增加而上升品牌展示量、品牌点击
多市场周报filterLists 一次拉一个区域,替代逐国请求各区域非品牌点击、平均排名
商品图与视觉搜索type = webMultimodal 单独看 Lens/以图搜索流量多模态点击与展示、对应页面

品牌词增长常被用来侧面衡量品牌广告和 AI 答案提及的效果,但它只是相关信号,不能直接证明因果。AI 引用监测方法见 AI 答案引用率监测,AI 流量在 GA4 与 Search Console 中的统计口径见 ChatGPT 流量统计说明;完整 SEO 流程见 谷歌 SEO 独立站清单,SEO 与广告分工见 谷歌 SEO 与 Google 广告怎么配合。

五、品牌流量占比计算器

品牌 / 非品牌流量占比计算器

品牌与非品牌流量指标

六、常见问题(FAQ)

6.1 为什么我的站点按 brandedClassification 查询没有返回数据?

官方说明品牌查询数据只对查询量和展示量足够的顶级资源开放,不符合条件的资源不会返回任何行;另外数据从 2026 年 2 月 21 日起才有,早于这个日期的区间也查不到。

6.2 能同时按品牌分类和具体关键词筛选吗?

不能。文档写明 brandedClassification 的筛选或分组不能和 query 筛选放在同一个请求里,需要分两次请求再在表格里合并。

6.3 webMultimodal 和 image 有什么区别?

image 是 Google 搜索「图片」标签页的结果;webMultimodal 是 Google Lens、Android 圈选即搜和在 Google 搜索中上传图片带来的结果,两者分开统计。

参考来源

以上为本文写作时(2026-11-23)查阅的公开页面;平台规则和数据会更新,请以官方页面为准。

七、结语

品牌分类、多国筛选和多模态数据进入 API 后,出海独立站可以用一套脚本按区域拆出「新客来自哪里」。建议先确认资源是否有品牌数据,再把 DACH、东南亚、拉美等区域模板放进每周报表。需要多语言独立站 SEO、GEO 与 AI 搜索优化,可了解 熊猫出海 GEO 与 AI 搜索优化,或看 出海 GEO 优化系统。术语见 熊猫出海出海广告术语表。

需要 Meta、Google、TikTok 广告开户与代投,或多语言独立站、GEO/AI 搜索优化?欢迎联系 熊猫出海(https://www.pandawm.com),Telegram:t.me/PANDA0134,或通过官网联系表单留言,我们按你的市场和预算给出方案。

微信咨询:szcwh99(扫码加好友)

熊猫出海微信二维码 szcwh99

引用本页:熊猫出海 pandawm.com《Search Console API新增品牌词分类、多国家/多设备筛选和多模态搜索数据:brandedClassification、filterLists、webMultimodal怎么用,出海独立站按区域自动拆分品牌与非品牌流量(附请求模板与品牌占比计算器)》,https://www.pandawm.com/blog/search-console-api-branded-queries-multi-country-filter-2026.html

本文来自网络,不代表熊猫出海立场。转载请注明出处: https://www.pandawm.com/blog/search-console-api-branded-queries-multi-country-filter-2026.html
上一篇
下一篇

作者: 熊猫出海编辑团队

熊猫出海(PandaWM)编辑团队,来自香港出海服务商熊猫出海,专注 Facebook、TikTok、Google 等海外广告开户与代投,以及 GEO/AI 搜索优化、多语言独立站建设。有Facebook白名单牌照户、TikTok加白户、Google G2认证户等核心资源 。

为您推荐

发表回复

联系我们

联系我们

工作时间:周一至周五,9:00-17:30,节假日休息

关注微信
微信扫一扫关注我们

微信扫一扫关注我们

关注微博
返回顶部