Search Console API でブランド検索を分けて集計できるように|3つの新機能と注意点

  • URLをコピーしました!

Search Console の API(Search Analytics API)に、3つの機能が加わりました。

11月16日付けの Google 検索セントラル ブログで発表されています。

どれも Search Console の画面にある「検索パフォーマンス」のレポートで、すでに使える機能です。

それが API でも使えるようになった、という話です。

この記事では3つの中身をかみ砕いて紹介し、制作者が気を付けたい点を整理します。


目次

ひとことで

Search Analytics API で、次の3つができるようになりました。

  • ブランド名を含む検索(指名検索)と、それ以外の検索を分けて集計する
  • Google レンズなど、画像を使った検索からの成果を取り出す
  • 複数の国や複数のデバイスに、1回のリクエストで絞り込む

ただし、ブランド検索の分類はどのサイトでも使えるわけではありません。

小さなサイトでは結果が1行も返ってこないことがあります。

前提: Search Analytics API とは

Search Console の検索パフォーマンスのデータ(クリック数、表示回数、CTR、掲載順位)を、プログラムから取り出す仕組みです。

画面からエクスポートするのと違い、毎月の集計を自動にしたり、ダッシュボードに数字を流し込んだりするのに使われます。

クライアント向けの月次レポートを自動で作っている制作会社なら、裏側でこの API を使っていることが多いと思います。

追加された3つの機能

1. ブランドクエリ(brandedClassification)

検索語を「ブランド名を含む検索」と「含まない検索」に分けて、絞り込んだり分類したりできます。

値は BRANDED(ブランド名を含む)と NON_BRANDED(含まない)の2つです。

分類は正規表現でキーワードを指定する方式ではありません。

Google の AI を使った仕組みで判定していて、次のような検索もブランド検索に含まれるそうです。

  • 各国の言葉で書いたブランド名
  • 表記ゆれや誤字
  • ブランド名を含まなくても、そのサイトに固有の商品やサービスを指す検索(google.com にとっての「Gmail」のようなもの)

Google 自身もときどき誤って分類されることがある、と書いています。

また、この分類は順位には一切影響しないそうです。

使える条件には制約があります。

  • ドメイン全体のプロパティだけが対象です。https://example.com/path のようなパスのプロパティや、サブドメインのプロパティでは使えません
  • 検索数と表示回数が十分にあるサイトだけが対象です
  • データは2026年2月21日以降の分です

条件に当てはまらないプロパティではエラーではなく、結果が1行も返ってこない形になります。

もう1つ、API ならではの制約があります。

同じリクエストの中で、ブランドクエリと「検索キーワード」の絞り込みは組み合わせられません。

2. ウェブのマルチモーダル検索(webMultimodal)

検索の種類(type)に webMultimodal を指定すると、画像を使った検索からの成果を取り出せます。

対象は次の3つです。

  • Google レンズ
  • Android の「かこって検索」
  • Google 検索への画像のアップロード

画面のレポートには2026年9月にこの種類が加わっていました。

BigQuery への一括データエクスポートを使っている場合はそちらにもこのデータが入ります。

3. 複数の国・デバイスの絞り込み(filterLists)

新しい項目 filterLists を使うと、1回のリクエストで複数の国や複数のデバイスに絞り込めます。

これまでは国ごとにリクエストを分けて、あとで足し合わせる必要がありました。

国は3文字のコード(ISO 3166-1 alpha-3)で指定します。

日本なら JPN、アメリカなら USA です。

デバイスは DESKTOP・MOBILE・TABLET の3つです。

リファレンスの項目名をもとに、リクエストの例を書いてみました。

「日本とアメリカの、スマホとタブレットからの、ブランド名を含まない検索」を、ページごとに集計する例です。

{
  "startDate": "2026-10-01",
  "endDate": "2026-10-31",
  "dimensions": ["page"],
  "type": "web",
  "dimensionFilterGroups": [
    {
      "filters": [
        {
          "dimension": "brandedClassification",
          "operator": "equals",
          "expression": "NON_BRANDED"
        }
      ],
      "filterLists": [
        { "dimension": "country", "expressions": ["JPN", "USA"] },
        { "dimension": "device", "expressions": ["MOBILE", "TABLET"] }
      ]
    }
  ]
}

私はまだこのリクエストを実際に送って試していません。

項目の組み合わせはリファレンスで確かめましたが、使うときは一度、小さな期間で試してください。

なお、同じ項目(たとえば国)を、これまでの filters と新しい filterLists の両方で同時には絞り込めません。

制作の現場で: 気を付けたいこと

ここからは試していないので「こうすればよさそう」という程度の話です。

小さなサイトでは、結果が空になることがある

いちばん気を付けたいのはブランドクエリの「検索数と表示回数が十分にあるサイトだけ」という条件です。

地域の店舗や小さな事務所のサイトはこの条件に届かないかもしれません。

API でレポートの仕組みを作り込んだあとに「数字が出ない」と気づくと、手戻りになります。

先に Search Console の画面で、検索パフォーマンスのレポートにブランドクエリの絞り込みが出るかを確かめておくのがよさそうです。

画面に出なければ、API でも取れないはずです。

プロパティの種類を確かめる

Search Console のプロパティにはドメイン全体を登録するものと、URL のパスやサブドメインを登録するものがあります。

ブランドクエリが使えるのはドメイン全体を登録したプロパティだけです。

クライアントのサイトを https://example.com/blog/ のようなパスで登録している場合は対象外になります。

レポートを作る前に、どの形で登録しているかを確かめておくと安心です。

指名検索を除く集計を、正規表現から切り替えるとき

これまで「指名検索を除いた集計」はブランド名や表記ゆれを正規表現で並べて除外する方法が一般的でした。

新しい分類を使えば、そのリストを手で直す手間が減ります。

ただ、Google の分類は AI による判定です。

自分で作った正規表現とは数字がずれることがあります。

クライアントへの報告で切り替えるなら、しばらくは両方の数字を並べて見て、差が大きくないかを確かめてからのほうがよさそうです。

数字の定義が途中で変わったことも報告書に一言書いておくと誤解を防げます。

ふだん使うツールで選べるかは別の話

API に機能が入ったことと、Looker Studio などのツールでその項目を選べるようになることは別の話です。

ツールが対応するまでには時間がかかることがあります。

ここは私のほうでまだ確かめていません。

ふだん使っているツールで選べるかはそれぞれ確認してください。

判断基準のまとめ

  • ブランド検索の分類を試す価値があるのはドメイン全体でプロパティを登録していて、検索からの流入がある程度あるサイト
  • API で仕組みを作る前に、画面の検索パフォーマンスのレポートで絞り込みが出るかを確かめる
  • 正規表現で作っていた指名検索の集計から切り替えるときはしばらく並べて差を見る
  • 画像検索から人が来そうなサイト(商品・料理・観光など)はマルチモーダル検索の数字を見てみる
  • 海外向けのサイトで国ごとにリクエストを分けていたなら、filterLists でまとめられる

Google 検索からの流入を、アクセス解析やサーバーのログで見分ける方法はこちらで紹介しています。

出典

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

この記事を書いた人

Web制作会社にてフロントエンド業務に携わる一方、個人でブログを書いたりサイト制作やシステム構築にいそしむ。元家具職人。
https://rcwas.com/

目次