Search Console: klastry zapytań i widoczność AI

Klastry zapytań grupują wyszukiwane hasła według tematów, na przykład cen lub integracji. Filtry regex rozpoznają pasujące hasła za pomocą wzorców tekstowych; Search Console obsługuje już takie grupy. Dashboard dodaje wielokrotnie używane kategorie i kilka trendów w jednym widoku. Ten przewodnik łączy klastry zapytań z Search Analytics API lub natywnego konektora z osobnym widokiem wyświetleń w generatywnej AI Google.

Te dane odpowiadają na różne pytania: klastry zapytań opisują raportowany popyt w wyszukiwarce, a raport skuteczności generatywnej AI pokazuje wyświetlenia w AI Overviews i AI Mode. Sam spadek kliknięć nie mierzy widoczności AI.

1. Wybór źródła danych i agregacji

Interfejs eksportuje najwyżej 1000 wierszy tabeli. API zwraca do 25 000 wierszy na żądanie i udostępnia najwyżej 50 000 dziennie dla danego typu wyszukiwania, według liczby kliknięć. Paginacja nie odzyskuje każdego rzadkiego zapytania. Przy cyklicznym eksporcie pobieranie pojedynczych zakończonych dni ułatwia kontrolę dziennego limitu.

Poniższe żądanie pokazuje przykładową treść dla jednego dnia, a nie kompletny program eksportu. Wymagany jest token OAuth z dostępem do usługi; wystarcza zakres tylko do odczytu. Identyfikator musi odpowiadać usłudze Search Console, na przykład prefiksowi URL lub sc-domain:example.com. Daty API obowiązują w strefie Pacific Time. Zadanie produkcyjne wymaga paginacji, ponawiania żądań, jednoznacznego klucza usługa/data/typ wyszukiwania i zastępowania wcześniej zaimportowanych dni bez duplikatów.

POST https://www.googleapis.com/webmasters/v3/sites/https%3A%2F%2Fexample.com%2F/searchAnalytics/query
Authorization: Bearer ACCESS_TOKEN
Content-Type: application/json

{
  "startDate": "2026-07-01",
  "endDate": "2026-07-01",
  "dimensions": [
    "query"
  ],
  "type": "web",
  "dataState": "final",
  "rowLimit": 25000,
  "startRow": 0
}

Następna strona zachowuje datę i filtry, a startRow rośnie o 25 000. Mniej niż 25 000 zwróconych wierszy kończy pobieranie danego dnia. Po pełnej ostatniej stronie potrzebne jest jeszcze jedno żądanie, które może zwrócić pusty wynik. Kompletność dotyczy tylko wierszy udostępnionych przez API, nie ukrytej lub ograniczonej historii.

Natywny konektor Search Console jest alternatywą dla zadania API. Site Impression agreguje dane na poziomie usługi; URL Impression pozwala analizować strony, w tym zapytania i strony docelowe. Te poziomy agregacji mogą dawać różne sumy. Porównanie wymaga osobnych źródeł z jednakowymi datami, typami wyszukiwania i filtrami.

2. Definiowanie i testowanie regexów

Search Console i Looker Studio używają składni RE2. Lookahead i lookbehind nie są obsługiwane. W API filtr excludingRegex wyklucza wzorzec, a includingRegex uwzględnia dopasowane wartości. Dwa filtry w jednej grupie and łączą uwzględnienie i wykluczenie.

REGEXP_MATCH sprawdza całą wartość pola. Dopasowanie fragmentu wymaga symboli wieloznacznych. Przykład celowo używa granic liter: samo api pasowałoby także do słowa kapitał. Granice odpowiadają przykładowemu słownictwu i wymagają testów dla danego języka.

CASE
  WHEN REGEXP_MATCH(Query, '(?i).*(^|[^a-ząćęłńóśźżäöüß])(acme|acmecorp|acme corp|acme app)([^a-ząćęłńóśźżäöüß]|$).*') THEN 'Marka'
  ELSE 'Niemarkowe'
END

(?i) jawnie wyłącza rozróżnianie wielkości liter. Warianty marki i nazwy produktów wymagają utrzymywanej listy; zbyt szerokie pojęcia mogą przypisać obce zapytania do marki. Klasyfikacja opisuje słowa zapytania, a nie dowodzi pozyskania wizyty treścią lub reklamą.

3. Grupowanie zapytań w klastry

Wygrywa pierwsza pasująca gałąź CASE. Przykład nadaje marce pierwszeństwo przed tematami, a cenom przed integracjami i porównaniami. Możliwa jest inna reguła, lecz priorytet wymaga dokumentacji oraz testów zapytań pasujących do kilku kategorii.

CASE
  WHEN REGEXP_MATCH(Query, '(?i).*(^|[^a-ząćęłńóśźżäöüß])(acme|acmecorp|acme corp|acme app)([^a-ząćęłńóśźżäöüß]|$).*') THEN 'Marka'
  WHEN REGEXP_MATCH(Query, '(?i).*(^|[^a-ząćęłńóśźżäöüß])(cena|ceny|koszt[a-z]*|ile kosztuje)([^a-ząćęłńóśźżäöüß]|$).*') THEN 'Cennik'
  WHEN REGEXP_MATCH(Query, '(?i).*(^|[^a-ząćęłńóśźżäöüß])(integrac[a-z]*|api|webhooks?|sync)([^a-ząćęłńóśźżäöüß]|$).*') THEN 'Integracje'
  WHEN REGEXP_MATCH(Query, '(?i).*(^|[^a-ząćęłńóśźżäöüß])(vs|alternatyw[a-z]*|por[oó]wn[a-z]*)([^a-ząćęłńóśźżäöüß]|$).*') THEN 'Porównania'
  ELSE 'Bez dopasowania'
END

Bez dopasowania oznacza brak zgodności ze skonfigurowanymi wzorcami. Wiersze uporządkowane według wyświetleń pomagają znaleźć brakujące terminy i niepożądane trafienia. Kategorie są konwencją raportowania, a nie pełnym opisem intencji wyszukiwania.

4. Obliczanie porównywalnych metryk

Przydatne widoki obejmują trendy wyświetleń i kliknięć według klastra, tabelę klastrów oraz zapytania bez dopasowania. CTR klastra to SUM(Clicks) / SUM(Impressions); przy zerowej liczbie wyświetleń wynik pozostaje pusty. CTR oznacza odsetek wyświetleń prowadzących do kliknięcia. Średnia z CTR wierszy nadaje wierszowi z 10 wyświetleniami tę samą wagę co wierszowi z 10 000 wyświetleń, co może zniekształcać wynik. Wersjonowanie reguł pozwala odróżnić zmianę klasyfikacji od zmiany historycznego trendu.

Osobne trendy marki i zapytań niemarkowych mogą ujawnić zmiany ukryte w sumie. Ruch markowy może zależeć od kampanii, sezonu i rozpoznawalności, ale wyższa konwersja nie jest gwarantowana. Kliknięcia Search Console nie są tym samym co sesje analityczne lub zakończone zakupy.

5. Osobny raport generatywnej AI

Od 31 sierpnia 2026 Google dokumentuje globalną dostępność raportu skuteczności generatywnej AI w wyszukiwarce. Raport obejmuje wyświetlenia w AI Overviews i AI Mode. Udokumentowane podziały dotyczą stron, krajów, dat i urządzeń, a nie klastrów zapytań. Eksport raportu może zasilać osobno oznaczoną tabelę dashboardu. Dokumentacja Search Analytics API i natywnego konektora nie potwierdza równoważnego wymiaru generatywnej AI; przykładowe żądanie w artykule nie pobiera tego raportu.

Raport generatywny pokrywa się częściowo z danymi skuteczności Web. Dodanie jego wyświetleń do sum Web podwójnie liczy wspólne obserwacje. Spadek CTR klastra pozostaje wskazówką diagnostyczną, a nie dowodem zastąpienia kliknięć przez AI. Zmienione snippety, urządzenia i skład zapytań również mogą wyjaśniać trend. Bez wymiaru zapytania tabela wyświetleń AI nie daje podstaw do wiarygodnego połączenia z klastrami zapytań.

6. Dokumentowanie ograniczeń danych

Filtry prywatności ukrywają część tekstów zapytań, a limity wierszy pomijają dodatkowe dane. Sumy filtrowane po zapytaniu mogą więc być mniejsze od sum bez tego filtra. Udziały klastrów dotyczą pobranych wierszy przy wybranych filtrach. Brakującej części nie można przypisać do tematu. Różnica nie zawsze wynika wyłącznie z anonimizacji.

Standardowa historia skuteczności obejmuje 16 miesięcy. Dłuższe porównania wymagają danych zapisanych przed ich wygaśnięciem; uruchomienie eksportu teraz nie odzyskuje wygasłej historii. Średnie pozycje można łączyć wagami wyświetleń tylko dla zgodnych, niepokrywających się wierszy: SUM(Position * Impressions) / SUM(Impressions). Zwykła średnia pozycji wierszy jest niewłaściwa.