Anomaly check
anomaly_checkAnomalie-Check der letzten N Tage über alle verbundenen Quellen des Workspace: Google Ads, GA4, Search Console und (nur mit include_clarity=True) Clarity — läuft auch ohne Google-Ads-Konto. Rückgabe: findings[{severity critical|warn|info, check, source google_ads|ga4|search_console|clarity, message}], ok, daily (Google-Ads- Tagesreihe [{date, cost_eur, clicks, conversions}]; [] ohne Google Ads), sources{: {status checked|not_connected|not_permitted|skipped|error, days_with_data, last_data_date, daily, note, …}}. ok = kein warn-/critical-Finding UND mindestens eine Quelle checked (info-Findings lassen ok unberührt). Keine Quelle verbunden → {error: no_sources, hint}. Zugänge mit eingeschränkten Datenquellen bekommen nur freigeschaltete Quellen ausgewertet (übrige: not_permitted). Fällt eine Quelle aus (API-Fehler, Verbindung abgelaufen, unerwarteter Fehler), laufen die anderen weiter: sources..status=error mit Fehler-Dict der Quelle plus Finding sources_unavailable (warn) — nie ein Fehler-Dict fürs ganze Tool, solange eine Quelle verbunden ist. Google Ads (Fenster bis gestern, heute nicht enthalten): conversions_zero (≥3 Tage mit Kosten seit der letzten Conversion; Tage ohne Kosten unterbrechen die Serie nicht, critical), cost_spike (gestern >2,5× Ø der Vortage), cost_drop_to_zero (gestern 0 trotz sonst täglicher Ausgaben), clicks_no_conversions (≥50 Klicks, 0 Conversions), ctr_drop (CTR letzte 3 Tage <50 % der Vorperiode), ads_no_data (info: keine Tageszeile). Conversions = primäre Aktionen — Konten mit nur sekundären Aktionen lösen conversions_zero aus (ads_conversion_performance). GA4 (sessions + keyEvents je Tag, Fenster bis gestern; GA4 liefert keine Zeilen für Tage ohne Sitzungen): sessions_drop_to_zero (Kalender-Gestern ohne Sitzungen, obwohl an mehr als der Hälfte der Tage davor Sitzungen liefen — warn, wenn nur gestern fehlt: GA4 verarbeitet bis zu 24–48 h nach, morgen erneut prüfen; critical ab 2 Tagen Lücke oder bei ausdrücklich 0 Sitzungen), sessions_drop (Ø letzte 3 Datentage <50 % der Datentage davor, erst ab Ø 5 Sitzungen/Tag; entfällt neben sessions_drop_to_zero), key_events_zero (≥3 Datentage in Folge Sitzungen ohne Key Event, davor gab es welche), key_events_none (info: im ganzen Fenster keine Key Events), sessions_spike (info: letzter Datentag >2,5× Ø), ga4_no_data (keine Sitzungen im Fenster). Findings nennen das Datum bzw. den letzten Datentag. Search Console (clicks + impressions je Datentag; Daten kommen 2–3 Tage verzögert, Fenster days+3; fehlende letzte Tage sind NICHT 0 und werden nicht bewertet, nur vorhandene Datentage): sc_clicks_drop / sc_impressions_drop (Ø letzte 3 Datentage <50 % der Vorperiode; Impressionen = Indexierungs-/Sichtbarkeitsproblem), sc_no_recent_data (letzter Datentag >5 Tage her oder keine Daten). „Gestern" ist bei Google Ads und GA4-sessions_drop_to_zero das Kalender-Gestern (fehlende Tage = 0 — morgens kann das der noch unverarbeitete Vortag sein); alle übrigen GA4- und Search-Console-Checks rechnen mit Datentagen, der letzte Datentag steht im Finding. Clarity (nur include_clarity=True, weil Clarity 10 Aufrufe je Projekt und Tag erlaubt; letzte 72 h, unabhängig von days): info-Findings js_errors_high (>5 % der Sitzungen mit JavaScript-Fehler), dead_clicks_high (>20 %), rage_clicks_high (>5 %) — Heuristik-Schwellen; warn-Findings clarity_no_data (keine einzige Sitzung in 72 h: Snippet prüfen) und clarity_metrics_unreadable (Kennzahl ohne lesbaren Anteil, steht in unreadable_metrics — nichts gilt still als 0). sources.clarity.metrics zeigt je Kennzahl Anteil (_pct), betroffene Sitzungen (_sessions) und Vorkommen (_count). Dieses Tool bewertet nur; Gesamtzahlen liefern ads_campaign_performance, ga4_report und sc_performance(dimensions=[]). days: Fensterlänge in Tagen (Default 14; Mindestlänge für 3-Tage-Vergleiche: 6). include_clarity: Clarity-Abfrage einschließen (verbraucht 1 der 10 Tagesaufrufe). workspace: Slug des Kunden-Workspace (optional bei nur einem Workspace).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| days | No | ||
| workspace | No | ||
| include_clarity | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||