Przejdź do treści

Wykrywanie anomalii SEO z Google Search Console, BigQuery i AI

Maciej Sala

Founder StriveLab

18 min czytaniaAktualizacja

Szybka odpowiedź: jak automatycznie wykrywać anomalie SEO w danych Search Console?

  • Podstawą jest Bulk Data Export z GSC do BigQuery i reguły SQL, a nie generatywne AI.
  • Najpierw sprawdź kompletność danych w ExportLog, a segmenty porównuj z medianą tego samego dnia tygodnia.
  • Detektor tworzy pełną siatkę dat i segmentów, bo brak wiersza może oznaczać zniknięcie ruchu.
  • Zapytanie uruchamiaj raz dziennie przez Scheduled Queries i zapisuj wynik do tabeli alertów.
  • AI może redagować notatkę z alertu, ale nie wymyśla przyczyny ani nie wdraża zmian bez zatwierdzenia.

Dlaczego sam raport Search Console nie wystarcza do automatycznych alertów

Search Console udostępnia widok ostatnich 24 godzin, funkcję porównywania okresów oraz raport Insights, które pomagają w ręcznej analizie, lecz nie zastępują automatycznych alertów SEO precyzyjnie dopasowanych do architektury konkretnego serwisu. Średnia dla całej domeny potrafi skutecznie ukryć poważny problem w jednej sekcji, a trzeba jeszcze pamiętać o regularnym otwieraniu raportu i ręcznym ustawianiu właściwych filtrów.

Największym zagrożeniem są spadki częściowe. Gdy strona główna trzyma się mocno, a blog rośnie, katalog /poradniki/ może tracić widoczność tuż po wdrożeniu nowego layoutu. W efekcie ogólne statystyki domeny wyglądają pozornie dobrze, choć w firmowej kasie sytuacja wygląda zupełnie inaczej. To z kolei wymusza przeniesienie wykrywania anomalii znacznie bliżej surowych danych.

Dane z Google Search Console: czego szukać w eksporcie do BigQuery

Bulk Data Export z Google Search Console zapisuje dane do BigQuery codziennie. W praktyce najczęściej pracujesz na dwóch tabelach danych i tabeli ExportLog:

  • searchdata_site_impression: dane zagregowane na poziomie właściwości, z zapytaniami, krajem, typem wyszukiwania i urządzeniem.
  • searchdata_url_impression: dane na poziomie URL, dobre do analizy katalogów, szablonów i konkretnych stron.
  • ExportLog: rejestr udanych zapisów do każdej z tabel danych.

Do pierwszej wersji systemu alertów biorę tabelę URL. Daje mniej „ładny” obraz, ale lepiej odpowiada na pytanie, które naprawdę pada w firmie: co dokładnie spadło?

Załóżmy, że tabela nazywa się:

Code
my_project.searchconsole.searchdata_url_impression

W danych masz między innymi datę, URL, kraj, urządzenie, typ wyszukiwania, kliknięcia, impresje i sumę pozycji. CTR i średnią pozycję liczysz samodzielnie, bo eksport przechowuje liczniki potrzebne do ponownej agregacji.

Warto znać kilka szczegółów, zanim zaczniesz pisać alerty:

  • data_date jest datą danych w czasie Pacific Time, więc nie próbuj dopasowywać jej co do godziny do polskiej strefy czasowej,

  • eksport jest przyrostowy i może zawierać powtarzające się klucze, dlatego prawie zawsze ponownie agregujesz metryki,

  • ExportLog zapisuje wyłącznie udane eksporty, a tabele URL i site mogą zakończyć zapis o różnych porach,

  • tekst zapytania może zostać ukryty z powodów prywatności,

  • dane URL i site mają różną semantykę agregacji, więc ich sumy i średnie pozycje nie zawsze są bezpośrednio porównywalne,

  • metryki są zwykle przypisywane do adresu kanonicznego wybranego przez Google, a nie zawsze do URL-a, na który ostatecznie trafił użytkownik.

W tabeli URL Google używa pola sum_position, a w tabeli site pola sum_top_position. W obu przypadkach pozycja jest liczona od zera. Średnią pozycję w stylu raportu GSC liczysz więc jako SUM(sum_position) / SUM(impressions) + 1 dla tabeli URL albo SUM(sum_top_position) / SUM(impressions) + 1 dla tabeli site.

Pola eksportu Search Console w BigQuery

Najważniejsze kolumny obu tabel danych, w tym te, o które najczęściej pada pytanie przy pierwszym zapytaniu:

Polesearchdata_site_impressionsearchdata_url_impressionZnaczenie
data_datetaktakdata danych w strefie czasowej Pacific Time
site_urltaktakwłaściwość w Search Console
url—takadres, któremu Google przypisał wyświetlenie, zwykle kanoniczny
querytaktakzapytanie; puste, gdy Google je zanonimizował
is_anonymized_querytaktakczy tekst zapytania ukryto ze względu na prywatność
countrytaktakkraj jako trzyliterowy kod ISO 3166-1, np. pol
search_typetaktaktyp wyszukiwania, np. WEB, IMAGE, VIDEO, NEWS, DISCOVER
devicetaktakDESKTOP, MOBILE albo TABLET
is_… (m.in. is_amp_top_stories, is_job_listing)—takflagi wyglądu wyniku w wyszukiwarce
impressionstaktakliczba wyświetleń
clickstaktakliczba kliknięć
sum_top_positiontak—suma najwyższych pozycji strony w wynikach, liczona od zera, typ INT64
sum_position—taksuma pozycji danego adresu, liczona od zera, typ INT64

Pola sum_top_position i sum_position nie są średnią pozycją. To liczniki, które sumujesz razem z impressions, a średnią wyliczasz dopiero na końcu, według wzorów z poprzedniego akapitu. Pełną listę kolumn opisuje schemat eksportu w centrum pomocy Google.

Funkcja Bulk Data Export zaczyna zbierać dane dopiero od momentu konfiguracji – nie uzupełnia automatycznie wcześniejszej historii. Zapisane w BigQuery informacje zostaną tam tak długo, dopóki ich nie usuniesz lub nie skonfigurujesz wygaśnięcia partycji. Pamiętaj więc, że jeśli Twój detektor korzysta z kilkumiesięcznej bazy odniesienia, okres przechowywania danych w bazie musi być odpowiednio dłuższy niż samo okno analizy.

Dane godzinowe z Search Analytics API a eksport do BigQuery

Bulk Data Export świetnie sprawdza się jako źródło pełnych danych dobowych, ale nie działa w czasie rzeczywistym. Z kolei Search Analytics API obsługuje wymiar godzinowy ze statusem HOURLY_ALL, który pozwala pobrać do 10 dni danych z podziałem na godziny, przy czym najnowsze wpisy pojawiają się z kilkugodzinnym opóźnieniem.

W żądaniu API ustaw dataState: "hourly_all" oraz wymiar hour. API nie gwarantuje zwrócenia wszystkich wierszy, więc nie traktuj drobnych segmentów jako kompletnego odpowiednika eksportu. Szczegóły opisuje dokumentacja Search Analytics API.

Unikaj łączenia tych danych z zamkniętymi dniami w BigQuery bez wyraźnego oznaczenia. Ostatnie godziny mają charakter wstępny i mogą ulec zmianie. Najbezpieczniejsze podejście opiera się na dwóch niezależnych alarmach:

  1. Wczesny alarm godzinowy porównuje zakończone godziny z analogicznymi godzinami z poprzednich dni.

  2. Alarm dobowy potwierdza problem dopiero po poprawnym zapisie tabeli w ExportLog.

W sytuacji, kiedy biznes nie wymaga natychmiastowej reakcji tego samego dnia, prostszym i mniej podatnym na fałszywe alarmy rozwiązaniem będzie oparcie się wyłącznie na eksporcie dobowym.

Segment URL przed alertem: jak ograniczyć fałszywe alarmy SEO

Alert obejmujący całą domenę może początkowo wydawać się dobrym pomysłem, ale w praktyce okazuje się mało użyteczny, ponieważ ogólny spadek nie wskazuje przyczyny. Gdy spadek o 42% dotyczy katalogu /blog/ na urządzeniach mobilnych w Polsce, można od razu rozpocząć analizę: sprawdzić ostatnie wdrożenia, działania robotów indeksujących, strukturę szablonu, linkowanie wewnętrzne oraz nowe błędy w kodzie HTML.

Właśnie dlatego najpierw sklasyfikuj adresy według ścieżki, zamiast analizować cały adres. Dzięki temu parametry zapytania zawierające ciąg /blog/ nie przypiszą strony do niewłaściwej grupy.

Code
CREATE OR REPLACE VIEW `my_project.seo.segment_daily` AS
WITH source AS (
  SELECT
    data_date,
    url,
    COALESCE(
      REGEXP_EXTRACT(url, r'^https?://[^/]+(/[^?#]*)'),
      '/'
    ) AS path,
    country,
    device,
    clicks,
    impressions,
    sum_position
  FROM `my_project.searchconsole.searchdata_url_impression`
  WHERE search_type = 'WEB'
    AND url IS NOT NULL
)
SELECT
  data_date AS date,
  CASE
    WHEN path = '/blog' OR STARTS_WITH(path, '/blog/') THEN 'blog'
    WHEN path = '/uslugi' OR STARTS_WITH(path, '/uslugi/') THEN 'services'
    WHEN path = '/produkty' OR STARTS_WITH(path, '/produkty/') THEN 'products'
    WHEN path = '/kategorie' OR STARTS_WITH(path, '/kategorie/') THEN 'categories'
    ELSE 'other'
  END AS page_group,
  country,
  device,
  SUM(clicks) AS clicks,
  SUM(impressions) AS impressions,
  -- przechowujemy surową sumę pozycji; średnią liczymy dopiero po finalnej agregacji
  SUM(sum_position) AS sum_position
FROM source
GROUP BY date, page_group, country, device;

Widok agreguje od razu do poziomu używanego przez detektor. Przechowywanie w nim każdego URL-a i gotowego CTR byłoby zbędne, ponieważ kolejne zapytanie ponownie grupuje dane według page_group, kraju i urządzenia. Zwróć też uwagę na pozycję: eksport z GSC nie dostarcza gotowej średniej, lecz wartość sum_position. Faktyczną średnią obliczasz dopiero podczas odczytu za pomocą wyrażenia SAFE_DIVIDE(SUM(sum_position), SUM(impressions)) + 1. Nie wolno ponownie uśredniać średnich, ponieważ dałoby to niepoprawny wynik.

Prosta detekcja anomalii SEO na kompletnych danych

Na start nie potrzebujesz uczenia maszynowego. Możesz porównać ostatni pomyślnie wyeksportowany dzień z medianą 6–8 wcześniejszych, poprawnie wyeksportowanych wystąpień tego samego dnia tygodnia z okna 70 dni. Poniedziałek porównujesz z poniedziałkami, a nie z niedzielą.

Samo CURRENT_DATE() - 3 jest kruche. Eksport może pojawić się później, a korekta starszych danych może zostać zapisana ponownie. Datę raportową wybierz z ExportLog. Następnie zbuduj pełną siatkę segmentów i poprawnych dat. Bez tego segment, który spadł do zera i nie ma żadnego wiersza w tabeli, zniknie również z wyniku alertu.

Code
DECLARE v_max_lag_days INT64 DEFAULT 4; -- Przykładowy próg operacyjny
DECLARE v_report_date DATE DEFAULT (
  SELECT MAX(data_date)
  FROM `my_project.searchconsole.ExportLog`
  WHERE namespace = 'searchdata_url_impression'
);
 
ASSERT v_report_date IS NOT NULL AS 'Brak udanego eksportu tabeli URL';
ASSERT DATE_DIFF(CURRENT_DATE('America/Los_Angeles'), v_report_date, DAY)
  BETWEEN 0 AND v_max_lag_days AS 'Eksport nie spełnia warunku świeżości';
 
CREATE TEMP TABLE detected AS
 
WITH exported_dates AS (
  SELECT data_date AS date
  FROM `my_project.searchconsole.ExportLog`
  WHERE namespace = 'searchdata_url_impression'
    AND data_date BETWEEN DATE_SUB(v_report_date, INTERVAL 70 DAY) AND v_report_date
  GROUP BY date
),
comparison_dates AS (
  SELECT date
  FROM exported_dates
  WHERE EXTRACT(DAYOFWEEK FROM date) = EXTRACT(DAYOFWEEK FROM v_report_date)
  QUALIFY ROW_NUMBER() OVER (ORDER BY date DESC) <= 9
),
daily_raw AS (
  SELECT
    date,
    page_group,
    COALESCE(country, 'UNKNOWN') AS country,
    COALESCE(device, 'UNKNOWN') AS device,
    SUM(clicks) AS clicks,
    SUM(impressions) AS impressions,
    SUM(sum_position) AS sum_position
  FROM `my_project.seo.segment_daily`
  JOIN comparison_dates USING (date)
  GROUP BY 1, 2, 3, 4
),
segments AS (
  SELECT page_group, country, device, MIN(date) AS first_observed_date
  FROM daily_raw
  GROUP BY page_group, country, device
),
daily AS (
  SELECT
    d.date,
    s.page_group,
    s.country,
    s.device,
    COALESCE(r.clicks, 0) AS clicks,
    COALESCE(r.impressions, 0) AS impressions,
    SAFE_DIVIDE(r.clicks, r.impressions) AS ctr,
    SAFE_DIVIDE(r.sum_position, r.impressions) + 1 AS avg_position
  FROM comparison_dates d
  CROSS JOIN segments s
  LEFT JOIN daily_raw r
    ON r.date = d.date
    AND r.page_group = s.page_group
    AND r.country = s.country
    AND r.device = s.device
  WHERE d.date >= s.first_observed_date
),
history AS (
  SELECT * FROM daily WHERE date < v_report_date
),
history_stats AS (
  SELECT
    page_group, country, device,
    COUNT(*) AS baseline_n,
    ARRAY_AGG(date ORDER BY date) AS baseline_dates,
    COUNTIF(impressions >= 100 AND ctr IS NOT NULL) AS ctr_n,
    COUNTIF(impressions >= 100 AND avg_position IS NOT NULL) AS position_n
  FROM history
  GROUP BY page_group, country, device
  HAVING COUNT(*) >= 6
),
baseline_medians AS (
  SELECT DISTINCT
    page_group, country, device,
    PERCENTILE_CONT(CAST(clicks AS FLOAT64), 0.5) OVER w AS median_clicks,
    PERCENTILE_CONT(CAST(impressions AS FLOAT64), 0.5) OVER w AS median_impressions,
    PERCENTILE_CONT(IF(impressions >= 100, ctr, NULL), 0.5) OVER w AS median_ctr,
    PERCENTILE_CONT(IF(impressions >= 100, avg_position, NULL), 0.5) OVER w AS median_position
  FROM history
  WINDOW w AS (PARTITION BY page_group, country, device)
),
baseline AS (
  SELECT DISTINCT
    m.*,
    PERCENTILE_CONT(ABS(d.clicks - m.median_clicks), 0.5)
      OVER (PARTITION BY page_group, country, device) AS mad_clicks
  FROM baseline_medians m
  JOIN history d USING (page_group, country, device)
),
current_day AS (
  SELECT *
  FROM daily
  WHERE date = v_report_date
),
metrics AS (
  SELECT
    v_report_date AS report_date,
    c.page_group,
    c.country,
    c.device,
    h.baseline_n,
    h.baseline_dates,
    h.ctr_n,
    h.position_n,
    c.clicks,
    b.median_clicks AS baseline_clicks,
    SAFE_DIVIDE(c.clicks - b.median_clicks, b.median_clicks) AS clicks_delta,
    SAFE_DIVIDE(
      c.clicks - b.median_clicks,
      1.4826 * NULLIF(b.mad_clicks, 0)
    ) AS clicks_robust_z,
    c.impressions,
    b.median_impressions AS baseline_impressions,
    SAFE_DIVIDE(c.impressions - b.median_impressions, b.median_impressions)
      AS impressions_delta,
    c.ctr,
    b.median_ctr AS baseline_ctr,
    c.ctr - b.median_ctr AS ctr_delta,
    c.avg_position,
    b.median_position AS baseline_position,
    c.avg_position - b.median_position AS position_delta,
    GREATEST(b.median_clicks - c.clicks, 0) AS click_gap_vs_baseline,
    GREATEST(b.median_impressions - c.impressions, 0)
      AS impression_gap_vs_baseline
  FROM current_day c
  JOIN baseline b USING (page_group, country, device)
  JOIN history_stats h USING (page_group, country, device)
),
scored AS (
  SELECT
    * EXCEPT (impression_gap_vs_baseline),
    baseline_clicks >= 20
      AND click_gap_vs_baseline >= 10
      AND (clicks_delta <= -0.30 OR clicks_robust_z <= -3)
      AS has_clicks_drop,
    baseline_impressions >= 100
      AND impression_gap_vs_baseline >= 50
      AND impressions_delta <= -0.25
      AS has_visibility_drop,
    baseline_impressions >= 100
      AND impressions >= 100
      AND ctr_n >= 6
      AND ctr_delta <= -0.02
      AND ctr < baseline_ctr * 0.75
      AS has_ctr_drop,
    baseline_impressions >= 100
      AND impressions >= 100
      AND position_n >= 6
      AND position_delta >= 2
      AS has_ranking_drop
  FROM metrics
)
SELECT
  report_date,
  page_group,
  country,
  device,
  CASE
    WHEN IF(has_clicks_drop, 1, 0)
      + IF(has_visibility_drop, 1, 0)
      + IF(has_ctr_drop, 1, 0)
      + IF(has_ranking_drop, 1, 0) >= 2 THEN 'mixed'
    WHEN has_visibility_drop THEN 'visibility_drop'
    WHEN has_ctr_drop THEN 'ctr_drop'
    WHEN has_ranking_drop THEN 'ranking_drop'
    ELSE 'clicks_drop'
  END AS anomaly_type,
  * EXCEPT (
    report_date,
    page_group,
    country,
    device,
    ctr_n,
    position_n,
    has_clicks_drop,
    has_visibility_drop,
    has_ctr_drop,
    has_ranking_drop
  ),
  CURRENT_TIMESTAMP() AS created_at
FROM scored
WHERE has_clicks_drop
  OR has_visibility_drop
  OR has_ctr_drop
  OR has_ranking_drop
ORDER BY click_gap_vs_baseline DESC, page_group, country, device;
 
SELECT * FROM detected
ORDER BY click_gap_vs_baseline DESC, page_group, country, device;

Zapytanie stosuje osobne progi dla kliknięć, wyświetleń, CTR i pozycji. Dla kliknięć wymaga sensownego poziomu bazowego, minimalnej bezwzględnej różnicy oraz spadku procentowego albo dużego odchylenia względem medianowego odchylenia bezwzględnego, czyli MAD. Współczynnik 1.4826 skaluje MAD do wartości zbliżonej do odchylenia standardowego przy rozkładzie normalnym. Nie zamienia to prostej reguły w dowód statystyczny. Ponieważ warunki łączy OR, duży spadek procentowy może uruchomić alarm także przy naturalnie dużej zmienności. Przy MAD równym zero z-score jest NULL, ale nadal działa próg procentowy. Progi 20, 10, 100, 50, 25%, 2 pp i 2 pozycje są wartościami startowymi, a nie uniwersalną definicją anomalii — trzeba je dostroić do wolumenu i wartości biznesowej segmentów.

Próg świeżości czterech dni jest przykładem do uzgodnienia z zespołem, a nie terminem gwarantowanym przez Google. Jego przekroczenie oznacza awarię danych, nie „brak anomalii”. ExportLog potwierdza udany zapis konkretnej daty; nie zastępuje kontroli aktualności. Kolumny i opóźnienia opisuje schemat eksportu GSC w centrum pomocy Google.

Kod nie uzupełnia zerami dat sprzed pierwszej obserwacji segmentu w oknie porównawczym. To ostrożne uproszczenie: w produkcji warto utrzymywać rejestr segmentów z datą rozpoczęcia monitorowania. Segmenty bez sześciu dat historii oznaczaj osobno jako „za mało danych”, zamiast raportować je jako poprawnie ocenione. baseline_n i baseline_dates pokazują faktyczny zakres porównania.

Dla tak małej próbki stosuję dokładną medianę interpolowaną PERCENTILE_CONT; wynik może być ułamkiem, dlatego pola bazowe w tabeli alertów mają typ FLOAT64. CTR i pozycja dodatkowo wymagają co najmniej 100 bieżących wyświetleń i sześciu historycznych obserwacji o takim wolumenie. Przy zaniku ruchu nadal działają alarmy kliknięć i wyświetleń. Działanie PERCENTILE_CONT opisuje dokumentacja funkcji nawigacyjnych BigQuery.

click_gap_vs_baseline jest różnicą względem poziomu bazowego, a nie wiarygodnym szacunkiem utraconego ruchu. Popyt, sezonowość, święta, kampanie marki i zmiany w wynikach wyszukiwania również wpływają na liczbę kliknięć.

Lepszy alert SEO: rozbij przyczynę na typ spadku

W powyższym zapytaniu instrukcja CASE nadaje etykietę na podstawie przekroczonych progów kliknięć, wyświetleń, CTR i średniej pozycji. Jeżeli jednocześnie wystąpią co najmniej dwa sygnały, alert otrzymuje etykietę mixed. W przeciwnym razie reguły rozróżniają spadek kliknięć, widoczności, CTR albo pogorszenie pozycji.

To nie jest diagnoza. To skrót, który mówi zespołowi, od którego obszaru zacząć. Warto też liczyć click_gap_vs_baseline, ponieważ alerty sortowane wyłącznie po procencie spadku promują małe segmenty. Różnicę względem poziomu bazowego traktuj jako miarę priorytetu, a nie dowód utracenia konkretnej liczby kliknięć przez błąd SEO.

AI w monitoringu SEO: autor notatki, nie sędzia

Wrzucenie danych do modelu z pytaniem „czy mamy problem?” nie tworzy wiarygodnego detektora. Model może dopowiedzieć wzorzec, którego nie ma w danych. Reguła SQL też może być źle zaprojektowana, ale pozostaje jawna, testowalna i audytowalna.

Lepszy układ wygląda tak:

  1. SQL wykrywa segmenty, które przekroczyły progi.
  2. Query dopisuje typ anomalii i metryki.
  3. AI dostaje tylko wyniki alertu i pisze krótką notatkę dla człowieka.

Przykładowy prompt:

Code
Napisz krótką notatkę SEO po polsku.
Nie diagnozuj ponad dane.
Użyj 4 sekcji:
- co spadło
- skala spadku
- hipotezy do sprawdzenia, wyraźnie oddzielone od obserwacji
- pierwsze 3 kroki
 
Dane:
report_date: 2026-10-14
page_group: blog
country: pol
device: MOBILE
baseline_n: 8
baseline_clicks: 1000
clicks: 590
baseline_impressions: 10000
impressions: 6200
baseline_ctr: 0.10
ctr: 0.095161
baseline_position: 3
avg_position: 3.6
clicks_delta: -0.41
impressions_delta: -0.38
ctr_delta: -0.004839
position_delta: +0.6
has_clicks_drop: true
has_visibility_drop: true
has_ctr_drop: false
has_ranking_drop: false
anomaly_type: mixed

Wartość ctr_delta w tym kontrakcie jest różnicą zapisaną jako ułamek. -0.004839 oznacza spadek o około 0,484 punktu procentowego, a nie o 0,484%. W tym ilustracyjnym przykładzie historyczne wartości są stałe, więc mediany CTR i pozycji odpowiadają podanym agregatom. Jednostki powinny być jawne zarówno w tabeli alertów, jak i w prompcie.

Przykładowa notatka do tych danych: „Blog na mobile w Polsce ma 590 kliknięć wobec bazowych 1000 (−41%) i 6200 wyświetleń wobec 10 000 (−38%). Przekroczono dwa progi wolumenowe. Sprawdź poprawność danych, listę URL-i odpowiadających za spadek i ostatnie wdrożenia. Z tych liczb nie wynika jeszcze, czy przyczyną jest indeksacja, popyt czy zmiana wyników wyszukiwania”. To ilustracja kontraktu, nie wynik pomiaru konkretnej witryny.

Wynik analizy powinien być w pełni konkretny i wyraźnie rozdzielać twardą obserwację od samej hipotezy, co oznacza, że model może na przykład wykazać spadek wyświetleń, a następnie wskazać indeksację, zmiany w szablonie czy wahania popytu jako potencjalne obszary do sprawdzenia, nie powinien jednak pochopnie stwierdzać, że odnalazł ostateczną przyczynę problemu.

Jeśli chcesz wygenerować takie notatki z poziomu BigQuery, możesz użyć AI.GENERATE_TEXT z modelem zdalnym skonfigurowanym w BigQuery ML. Funkcja nadal wysyła prompt do wskazanego modelu w Vertex AI albo obsługiwanej usłudze modelowej, więc nie oznacza to, że dane pozostają wyłącznie w silniku BigQuery. Lokalizacja datasetu, połączenia i endpointu oraz wymagania dotyczące przetwarzania danych muszą być świadomą decyzją.

Przykład używa gemini-3.5-flash-lite, wymienionego w dokumentacji modeli zdalnych BigQuery. Przed wdrożeniem sprawdź dostępność endpointu w wybranej lokalizacji oraz jego cykl życia; nazwy modeli nie są bezterminową gwarancją działania. Model zdalny można utworzyć tak:

Code
CREATE OR REPLACE MODEL `my_project.seo.gemini_flash`
REMOTE WITH CONNECTION DEFAULT
OPTIONS (ENDPOINT = 'gemini-3.5-flash-lite');

Przed uruchomieniem potrzebujesz aktywnych API, połączenia Cloud Resource oraz odpowiedniej roli dla konta usługi tego połączenia. Dataset i połączenie powinny znajdować się w zgodnej lokalizacji. Globalnego endpointu nie używaj, jeśli musisz kontrolować region przetwarzania.

Najpierw wybierz maksymalnie kilka najważniejszych alertów dla jawnie wskazanego v_report_date, zbuduj z nich prompty według powyższego kontraktu i zapisz do małej tabeli stagingowej daily_prompts. Tabela musi mieć kolumnę prompt oraz identyfikator uruchomienia. Przykład zakłada, że zawiera wyłącznie wybrane prompty tego wykonania; przy pracy równoległej użyj osobnego zbioru dla każdego uruchomienia, aby nie wymieszać dni. Przygotowanie daily_prompts jest osobnym etapem, którego pełnej implementacji tutaj nie pokazuję. Dopiero ten zbiór przekaż do modelu:

Code
SELECT result, prompt, status
FROM AI.GENERATE_TEXT(
  MODEL `my_project.seo.gemini_flash`,
  TABLE `my_project.seo_alerts.daily_prompts`,
  STRUCT(512 AS max_output_tokens, 0.2 AS temperature)
);

Jawny filtr daty podczas budowania tabeli stagingowej jest potrzebny także dlatego, że tabela alertów wymaga filtra partycji. Samo LIMIT w zapytaniu przekazanym bezpośrednio do AI.GENERATE_TEXT ogranicza liczbę wynikowych promptów, ale nie gwarantuje, że BigQuery pominie wcześniejsze przetwarzanie całego wejścia. Po wywołaniu kontroluj również status odpowiedzi modelu i obsłuż błędy limitów oraz nieudane wywołania, zamiast zakładać, że każdy wiersz otrzymał poprawny tekst.

Harmonogram wykrywania anomalii SEO: raz dziennie i do tabeli alertów

BigQuery Scheduled Queries pozwala uruchamiać zapytanie cyklicznie. Dla eksportu GSC wystarczy jedno uruchomienie dziennie. Zapytanie powinno jednak wybrać najnowszą datę potwierdzoną w ExportLog, a nie zakładać stałego opóźnienia dwóch lub trzech dni.

Wyniki zapisuję do tabeli:

Code
my_project.seo_alerts.daily_anomalies

Minimalny schemat może wyglądać tak:

Code
CREATE TABLE IF NOT EXISTS `my_project.seo_alerts.daily_anomalies` (
  report_date DATE,
  page_group STRING,
  country STRING,
  device STRING,
  anomaly_type STRING,
  baseline_n INT64,
  baseline_dates ARRAY<DATE>,
  clicks INT64,
  baseline_clicks FLOAT64,
  clicks_delta FLOAT64,
  clicks_robust_z FLOAT64,
  impressions INT64,
  baseline_impressions FLOAT64,
  impressions_delta FLOAT64,
  ctr FLOAT64,
  baseline_ctr FLOAT64,
  ctr_delta FLOAT64,
  avg_position FLOAT64,
  baseline_position FLOAT64,
  position_delta FLOAT64,
  click_gap_vs_baseline FLOAT64,
  created_at TIMESTAMP
)
PARTITION BY report_date
CLUSTER BY page_group, country, device
OPTIONS (require_partition_filter = TRUE);

Zapytanie cykliczne może zostać uruchomione ponownie po błędzie lub wykonane ręcznie. Z kolei, zwykłe polecenie WRITE_APPEND utworzy w takiej sytuacji duplikaty danych. Aby taka sytuacja nie miała miejsca, zapisuj wyniki za pomocą operacji MERGE z kluczem złożonym z daty i wymiarów albo nadpisuj wyłącznie partycję dotyczącą konkretnego dnia. Do samego uruchamiania zadań użyj dedykowanego konta usługi z minimalnymi uprawnieniami zamiast poświadczeń pojedynczego pracownika.

Najprostszy idempotentny wariant w zapytaniu skryptowym zapisuje najpierw wynik detektora do tabeli tymczasowej detected, a następnie atomowo zastępuje alerty dla przetwarzanej daty:

Code
-- Dalszy ciąg tego samego skryptu, po utworzeniu detected.
-- Tabelę docelową utwórz wcześniej, jednorazowo.
BEGIN TRANSACTION;
DELETE FROM `my_project.seo_alerts.daily_anomalies`
WHERE report_date = v_report_date;
 
INSERT INTO `my_project.seo_alerts.daily_anomalies` (
  report_date, page_group, country, device,
  anomaly_type, baseline_n, baseline_dates, clicks,
  baseline_clicks, clicks_delta, clicks_robust_z, impressions,
  baseline_impressions, impressions_delta, ctr, baseline_ctr,
  ctr_delta, avg_position, baseline_position, position_delta,
  click_gap_vs_baseline, created_at
)
SELECT
  report_date, page_group, country, device,
  anomaly_type, baseline_n, baseline_dates, clicks,
  baseline_clicks, clicks_delta, clicks_robust_z, impressions,
  baseline_impressions, impressions_delta, ctr, baseline_ctr,
  ctr_delta, avg_position, baseline_position, position_delta,
  click_gap_vs_baseline, created_at
FROM detected WHERE report_date = v_report_date;
COMMIT TRANSACTION;

Połącz deklaracje i detektor z pierwszego przykładu z powyższą transakcją w jeden skrypt. Deklaracje pozostają przed CREATE TEMP TABLE, a v_report_date jest jedną zmienną używaną w odczycie, zapisie i budowaniu promptów. Nie jest parametrem @report_date: Scheduled Queries udostępniają automatycznie @run_date i @run_time. Parametry opisuje dokumentacja harmonogramów BigQuery. Alternatywą jest MERGE; usunięcie i ponowne wstawienie jednej partycji jest jednak krótsze, a zarazem usuwa alert, który po ponownym przeliczeniu przestał spełniać warunki.

Zapisz również stan wykonania: datę danych, wersje eksportów użytych do obliczeń, wersję reguł, czas zakończenia, liczbę ocenionych i pominiętych segmentów oraz liczbę alertów. Aktualizuj go dopiero po udanym zapisie. Brak zmiany danych i reguł pozwala pominąć powtórne powiadomienie; sama liczba zero w tabeli anomalii nie jest dowodem sprawnego monitoringu.

Wartość epoch_version w tabeli ExportLog rośnie w sytuacji, gdy Google dokonuje poprawek wcześniej zapisanych danych. W sytuacji, gdy zajmujesz się materializowaniem agregatów, pamiętaj o zapamiętywaniu najwyższej przetworzonej wersji dla każdej pary namespace oraz data_date. Ewentualna zmiana tej wersji powinna automatycznie uruchomić ponowne przeliczenie odpowiedniej partycji danych oraz powiązanych alertów, których poziom bazowy korzysta z poprawionej daty.

Dopiero na tej tabeli budujesz powiadomienie do Slacka, poczty, Looker Studio albo webhooka. Powiadomienie nie powinno uruchamiać się dla każdego wiersza. Lepiej zebrać anomalie w jeden dzienny raport i posortować je po click_gap_vs_baseline, prawdopodobieństwie anomalii albo własnej wartości biznesowej.

Rozdziel zapis wyników od wysyłania powiadomień. Metrykę liczby zwróconych wierszy Scheduled Query można zastosować do osobnego zapytania SELECT, które czyta alerty dla daty potwierdzonej w stanie zakończonego wykonania. Nie zakładaj, że liczba wierszy zadania kończącego się transakcją DELETE/INSERT oznacza liczbę anomalii. Kontroluj też świeżość stanu wykonania. Metryka ostatniej liczby wierszy może utrzymywać poprzednią wartość przez 35 dni, dlatego osobno monitoruj brak udanego zakończenia zadania i jego błędy. Konfigurację opisuje dokumentacja alertów dla Scheduled Queries.

Każdy alert powinien mieć właściciela, status weryfikacji i warunek zamknięcia. Deduplikuj wysyłkę po dacie zdarzenia i segmencie; po korekcie danych aktualizuj istniejący incydent. Kolejność procesu to: eksport → kontrola danych → agregat → detektor → zapis i stan wykonania → powiadomienie → opcjonalna notatka AI. Awaria modelu redagującego notatkę nie powinna blokować liczbowego alertu.

Co sprawdzić po alercie

Alert sygnalizuje jedynie problem, a nie jego ostateczną przyczynę, dlatego po zauważeniu spadku w segmencie postępuję według następującej kolejności:

  • kompletność ExportLog i status wykonania pipeline'u,
  • oficjalną listę anomalii danych Search Console, aby wykluczyć błąd raportowania po stronie Google,

  • dane z analityki lub logów serwera, aby odróżnić problem raportowania od realnej zmiany wejść,

  • ostatnie zmiany w szablonie lub layoucie,
  • zmiany w robots.txt, sitemapie, linkach kanonicznych i meta robots,

  • raport indeksowania w GSC dla przykładowych URL-i,
  • logi crawlowania, jeśli masz Cloudflare lub serwerowe access logi,

  • zmiany title i description,
  • nowa treść konkurencji albo zmiana intencji w SERP,
  • problemy z renderowaniem, szczególnie przy React/Next.js.

Kolejność zależy od sygnału. Kiedy problem pojawił się bezpośrednio po wdrożeniu i dotyczy konkretnego szablonu, sprawdzenie kodu ma wysoki priorytet. Jeśli natomiast spadły wyświetlenia w całej branży, trzeba uwzględnić sezonowość, popyt i zmiany w wynikach wyszukiwania. Warto przechowywać obok szeregu daty wdrożeń, migracji, kampanii, świąt oraz incydentów. Korelacja czasowa co prawda nie dowodzi przyczyny, ale pomaga ustalać kolejność pracy.

Dobry alert SEO nie ma imponować. Ma skrócić drogę od spadku do pierwszej sensownej decyzji.

Kiedy dołożyć model anomalii

Zwykłe reguły SQL wystarczą na długi czas. Zaawansowany model analityczny ma uzasadnienie dopiero wtedy, gdy zarządzasz wieloma segmentami, uwzględniasz silną sezonowość, prowadzisz działania w różnych krajach lub obsługujesz zróżnicowane typy stron. Funkcja AI.DETECT_ANOMALIES korzysta z wbudowanego modelu TimesFM, który porównuje aktualne wyniki z prognozowanym przedziałem. W wyniku otrzymujesz m.in. flagę is_anomaly, granice przedziału, prawdopodobieństwo oraz status wywołania.

Zanim uruchomisz funkcję, musisz przygotować uporządkowaną, gęstą tabelę z dokładnie jednym wierszem dla każdej poprawnie wyeksportowanej daty oraz kombinacji identyfikatorów. Unikaj przekazywania surowej, nieregularnej tabeli, w której brak wpisu może oznaczać zarówno zerowy ruch, jak i zwykły błąd eksportu danych.

segment_daily_dense jest osobnym, przygotowanym wcześniej zbiorem, a nie tabelą tworzoną przez powyższy widok. Ma zawierać kolejne daty kalendarzowe i monitorowane segmenty, z zerem tylko po potwierdzonym eksporcie. Przy luce eksportu wstrzymaj ocenę dotkniętego szeregu i zgłoś brak danych. Poniższy fragment uruchom w tym samym skrypcie po kontroli v_report_date; dla osobnego zadania powtórz deklarację i kontrolę świeżości.

Code
CREATE TEMP TABLE model_results AS
SELECT *
FROM AI.DETECT_ANOMALIES(
  (
    SELECT
      date,
      page_group,
      country,
      device,
      clicks
    FROM `my_project.seo.segment_daily_dense`
    WHERE date BETWEEN DATE_SUB(v_report_date, INTERVAL 180 DAY)
      AND v_report_date
  ),
  data_col => 'clicks',
  timestamp_col => 'date',
  target_last_n_points => 7,
  id_cols => ['page_group', 'country', 'device'],
  anomaly_prob_threshold => 0.95
);
 
-- Alerty SEO:
SELECT * FROM model_results
WHERE is_anomaly AND ai_detect_anomalies_status = '';
 
-- Osobny kanał błędów technicznych; nie wolno go pomijać:
SELECT * FROM model_results
WHERE COALESCE(ai_detect_anomalies_status, 'Brak statusu') != ''
  OR is_anomaly IS NULL;

Pełny model_results zapisz w rejestrze wykonania przed filtrowaniem i osobno przekaż błędy techniczne. Porównaj liczbę oczekiwanych szeregów z poprawnie ocenionymi i odrzuconymi; pusty wynik anomalii nie oznacza, że wszystkie szeregi zostały przetworzone. target_last_n_points => 7 ponownie ocenia nakładające się dni, dlatego kolejne uruchomienie nie powinno wysyłać nowego incydentu dla tej samej daty i segmentu. Kolumny wyniku opisuje dokumentacja AI.DETECT_ANOMALIES.

BigQuery domyślnie korzysta obecnie z TimesFM 2.5 i automatycznie dobiera najmniejsze obsługiwane context_window, które mieści wejściowy szereg, dlatego w podstawowym przykładzie nie trzeba podawać tych parametrów. Wybór okna i próg detekcji nie mają jednak uniwersalnego charakteru, dlatego należy je walidować na historycznych incydentach oraz w stabilnych okresach, kiedy nic szczególnego się nie działo. Pamiętaj, że wyższy próg ogranicza liczbę anomalii, ponieważ poszerza przedział ufności. W przypadku segmentów z bardzo małym ruchem nawet poprawnie skonfigurowany i uruchomiony model może jednak nie dostarczyć użytecznego sygnału.

Dlatego traktuj model jako drugą warstwę:

  1. Warstwa pierwsza obejmuje kontrolę danych i reguły SQL. Jest szybka, przewidywalna i zrozumiała dla zespołu.
  2. Warstwa druga wykorzystuje model anomalii. Pomaga przy sezonowości i wielu szeregach czasowych.
  3. Warstwa trzecia wykorzystuje generatywne AI. Redaguje streszczenie i sugeruje pytania do sprawdzenia.

Jak sprawdzić detektor przed włączeniem powiadomień

Przeprowadź backtest dzień po dniu: dla każdej daty korzystaj wyłącznie z wcześniejszej historii. Kontrolę świeżości odnoś wtedy do symulowanej daty wykonania, nie dzisiejszej daty. Jeżeli nie masz historycznych wersji eksportu, zaznacz, że test na dzisiejszych, skorygowanych danych nie odtwarza dokładnie informacji dostępnych wtedy.

Porównaj alerty ze znanymi incydentami oraz spokojnymi okresami. Mierz liczbę fałszywych alarmów tygodniowo, odsetek wykrytych incydentów i czas wykrycia. Dostrajaj progi na jednym okresie, a oceniaj na późniejszym. Próg modelu 0,95 nie oznacza, że 95% powiadomień będzie potwierdzonymi problemami SEO; przy wielu segmentach kontroluj także łączną liczbę alarmów.

Przypadek testowyOczekiwany wynik
Aktywny segment znika w poprawnie wyeksportowanym dniuZero i możliwy alarm wolumenu.
Eksport dnia nie dotarł albo jest zbyt staryBłąd danych, nie uspokajający raport SEO.
Nowy segment nie ma sześciu dat historiiStan „za mało danych”.
Bieżący dzień ma jedno wyświetlenieBez samodzielnego alarmu CTR lub pozycji.
Historia kliknięć jest stała, MAD = 0Brak dzielenia przez zero; działa reguła procentowa.
Ponowiono zapis lub poprawiono eksportJeden aktualny stan alertu i kontrolowana aktualizacja powiadomienia.
Model zgłosił błądWidoczny problem techniczny, niezależny od anomalii SEO.

To scenariusze do wykonania na Twoich danych, nie wyniki wdrożenia produkcyjnego. Fragmenty pokazują logikę detekcji i zapisu; przygotowanie gęstej tabeli, rejestru wykonań i wysyłki pozostaje częścią integracji.

Kontrola kosztów i jakości danych

Koszt zależy od wybranego modelu rozliczeń w BigQuery, ilości faktycznie przetworzonych danych oraz liczby wywołań BigQuery ML i modeli zdalnych, przy czym w standardowym trybie rozliczeń on-demand klauzula LIMIT w żaden sposób nie zmniejsza liczby skanowanych bajtów. W praktyce:

  • filtruj bezpośrednio po partycji data_date i sprawdzaj plan zapytania,

  • zapisuj dzienne agregaty do tabeli partycjonowanej i klastrowanej zamiast za każdym razem czytać surowy eksport,

  • używaj progów wolumenu, żeby nie generować alertów i promptów dla mikrosegmentów,

  • sprawdzaj ExportLog, zanim uznasz spadek za problem SEO,

  • materializuj mały zbiór promptów przed wywołaniem modelu,

  • ogranicz max_output_tokens i liczbę segmentów wysyłanych do modelu,

  • używaj dry run oraz maximum bytes billed do kontroli zapytań,

  • ustaw retencję partycji zgodną z potrzebnym oknem historycznym i polityką danych.

Audyt techniczny i optymalizacja SEO.
Audyt techniczny SEO

Często zadawane pytania

Po co wykrywać anomalie SEO w BigQuery, skoro mam raporty w Search Console?

Search Console ma raport skuteczności, widok ostatnich 24 godzin i Insights, ale nie zastępuje własnego procesu monitoringu. BigQuery pozwala automatyzować dzienne alerty, segmentować adresy URL i łączyć wyniki z wdrożeniami lub danymi biznesowymi. Do alarmów wymagających danych godzinowych można użyć Search Analytics API, pamiętając, że najnowsze dane są wstępne.

Czy Bulk Data Export z Search Console ma limit wierszy jak interfejs GSC?

Nie działa jak zwykły eksport z interfejsu. Google opisuje Bulk Data Export jako dzienny zrzut danych do BigQuery, bez typowego limitu wierszy z UI. Nadal obowiązują ograniczenia prywatności. Tekst rzadkich zapytań może być ukryty, a w niektórych typach danych część wymiarów może być pusta. Nie należy też zakładać, że sumy po dowolnych wymiarach będą identyczne z wykresem zagregowanym na poziomie usługi.

Od ilu danych ma sens wykrywanie anomalii SEO?

Nie istnieje uniwersalny próg kliknięć. Liczy się wolumen w pojedynczym monitorowanym segmencie i liczba obserwacji historycznych. Przy małym ruchu lepiej agregować dane tygodniowo, łączyć podobne adresy URL i wymagać minimalnej bezwzględnej zmiany. Dzienny procent dla kilku kliknięć będzie generował głównie szum.

Czy AI powinno samo decydować, że mamy problem SEO?

Nie. Model może opisać anomalię i zasugerować, gdzie szukać przyczyny. Pierwsza wersja detekcji powinna opierać się na jawnych regułach statystycznych i biznesowych w SQL. Generatywne AI nie powinno samodzielnie ogłaszać przyczyny ani uruchamiać zmian na stronie.

Czy BigQuery AI.DETECT_ANOMALIES zastępuje własne reguły SQL?

Nie w pierwszej wersji systemu, ponieważ AI.DETECT_ANOMALIES może pomóc przy wielu szeregach czasowych i sezonowości, ale nadal potrzebujesz kompletnych dat, segmentów, progów wpływu, monitoringu samego eksportu i procesu weryfikacji. Funkcja wykorzystuje wbudowany model TimesFM, a jej wynik jest sygnałem statystycznym, nie diagnozą SEO.

Jak często uruchamiać alerty SEO?

Raz dziennie wystarczy w większości projektów. Dane GSC mają opóźnienie, a Bulk Data Export zapisuje dane dobowe. Jeżeli potrzebujesz szybszego sygnału, Search Analytics API udostępnia dane godzinowe z ostatnich dni. Takie dane są wstępne, dlatego alarm godzinowy powinien mieć osobne progi i zostać potwierdzony po zamknięciu dnia.

O autorze

Maciej Sala

Maciej Sala — konsultant technologiczny produktów cyfrowych i web developer z bogatym doświadczeniem w marketingu internetowym oraz SEO. Na co dzień pracuje z Reactem, Next.js i TypeScriptem, a ostatnio także z Astro i narzędziami do automatyzacji procesów AI. Sprawnie łączy perspektywę produktową z praktycznym podejściem do kodu. Przez kilka lat był związany z branżą gier wideo jako project manager i game designer. Absolwent historii na Uniwersytecie Jagiellońskim oraz studiów podyplomowych z marketingu internetowego na AGH w Krakowie. Po godzinach trenuje na siłowni, maluje figurki i rozwija własne projekty.

Pomagam przekładać takie tematy na konkretne wdrożenia w frontendzie, SEO, analityce i procesie produktowym.

Skontaktuj się ze mną
LH.pl – Hosting Mango

Biblioteka wiedzy na temat SEO

Czytaj dalej

Zobacz więcej wpisów
Data Science w SQL i wdrażanie modeli AI w BigQuery

Model działający w BigQuery potrafi skrócić drogę od tabeli do pierwszej prognozy z dni do godzin. SQL nie zwalnia jednak z walidacji, kontroli kosztów ani zabezpieczenia danych wysyłanych do zdalnego modelu. Ten przewodnik pokazuje kompletny warsztat: od przygotowania szeregu czasowego, przez poprawne wywołania TimesFM i Gemini, aż po kryteria wdrożenia na produkcję.

Maciej Sala

Maciej Sala

Founder StriveLab

AI jako wsparcie analityka w SQL i Google BigQuery

AI może skrócić drogę od pytania biznesowego do zapytania SQL , ale nie zbuduje wiarygodnej analityki na niejednoznacznych danych. Zanim analityk odda modelowi część pracy, firma potrzebuje uzgodnionych definicji metryk, opisanego schematu i kontroli nad tym, co trafia do asystenta — w zakresie objętym daną analizą.

Maciej Sala

Maciej Sala

Founder StriveLab

Czym jest Google Search Console i do czego służy

Google Search Console to podstawowe narzędzie, w którym Google pokazuje dane o obecności Twojej strony w wyszukiwarce i bardzo trudno wyobrazić sobie współczesny monitoring bez niego. Bezpłatnie pokazuje, na jakie frazy ją wyświetla, ile kliknięć zbiera, które podstrony indeksuje i jakie problemy wykrył. W artykule wyjaśnię, czym jest Search Console, jak dodać do niej stronę i które raporty czytać na początku, żeby nie utonąć w liczbach. Będzie też trochę o automatyzacji AI.

Maciej Sala

Maciej Sala

Founder StriveLab

LH.pl – Cloud Server 1C4G