Google Integrations (GSC + GA4)

Google Integrations bringt Search Console (GSC) und Google Analytics 4 (GA4) direkt in Rankion. Du verbindest dein Google-Konto einmal, linkst pro Projekt die passende Property und Rankion zieht Klick-, Impression-, Position- und Traffic-Metriken ins Dashboard. Damit ergänzt du die SERP-Sicht des Rank Trackers um echte Klick-Daten, und die Inhalts-Sicht des Content Audits um echte User-Signale aus GA4.

Was es kann

• Connection-Verwaltung — GET /v1/google/connections listet alle Google-Konten, die mit dem Team verbunden sind. DELETE /v1/google/connections/{id} trennt eine Verbindung sauber inklusive Token-Revoke.
• GSC-Property-Discovery — GET /v1/google/gsc/properties listet alle GSC-Properties, auf die das verbundene Konto Zugriff hat (sitemap-, domain- oder URL-Prefix-Properties).
• GSC-Linking pro Projekt — POST /v1/google/gsc/properties/{p}/link und DELETE .../link verknüpfen / entkoppeln eine Property mit einem Rankion-Projekt.
• GSC-Sync — POST /v1/google/gsc/properties/{p}/sync zieht aktuelle Daten (Klicks, Impressionen, CTR, Position) für die verlinkte Property. 1 Credit pro Sync.
• GSC-Metrics-Read — GET /v1/google/gsc/properties/{p}/metrics liefert die zuletzt gesyncten Werte für Reporting & UI.
• GA4-Property-Discovery & Linking — analog: GET /v1/google/ga4/properties, POST/DELETE /v1/google/ga4/properties/{p}/link.
• GA4-Metrics — GET /v1/google/ga4/properties/{p}/metrics liefert Traffic-, Engagement- und Conversion-Metriken.
• Besucher aus KI-Suchen — dieselbe Route mit dimension=ai_source zeigt, wie viele Sitzungen über ChatGPT, Perplexity, Gemini, Copilot, Claude oder Grok auf deine Seite kamen. Im Performance-Tab des Projekts steht das als eigene Karte (siehe unten).
• Reviews-Connector-Status — GET /v1/integrations/google/reviews/status zeigt, ob der Google-Reviews-Konnektor (Teil von Review Sources) aktiv ist.

Besucher aus KI-Suchen

Der Performance-Tab eines Projekts (Projekte → Projekt → Performance) zeigt unter den Kennzahlen die Karte »Besucher aus KI-Suchen«: die Zahl der Sitzungen, deren Herkunft in GA4 ein KI-Assistent ist, ihren Anteil an allen Sitzungen des Zeitraums und je Assistent die Sitzungen mit Anteil. Erkannt werden ChatGPT, Perplexity, Gemini, Copilot, Claude und Grok über ihre Referrer-Domains; Assistenten, die Google selbst als ai-assistant kennzeichnet, aber noch keine bekannte Domain haben, laufen als »Weitere KI-Assistenten«.

Drei Dinge, die man wissen sollte:

• Google AI Overviews und der AI Mode fehlen. Sie kommen in GA4 als normale Google-Suche an und lassen sich nicht abtrennen. Die Karte zeigt also die Untergrenze des KI-Traffics, nicht die Obergrenze.
• Daten gibt es ab dem Tag, an dem Rankion den Herkunftsbericht abruft. Bei einer frisch verknüpften Property füllt der Backfill die gewählten 30 bis 365 Tage. Fehlen für einen Zeitraum noch Daten, sagt die Karte das statt »0 %«; reichen sie kürzer als der Zeitraum, steht »erfasst seit« dabei.
• Der Anteil bezieht sich auf alle Sitzungen des Zeitraums, so wie GA4 sie im selben Bericht liefert. Das Verhältnis ist deshalb in sich stimmig, auch wenn die Kennzahl-Karte darüber aus einem anderen Bericht stammt und um wenige Sitzungen abweichen kann.

Wann nutzen

• Du willst SERP-Position aus Rank Tracker mit echten Klick-Daten aus GSC verheiraten.
• Du willst sehen, ob Content-Audit-Findings tatsächlich Traffic-Effekte haben (GA4).
• Du willst Reporting-Dashboards bauen, die GSC-, GA4- und Rankion-Daten in einer Quelle haben.
• Du willst die Agentic Chat mit echten Performance-Daten füttern.

Workflow

1. Google verbinden — OAuth-Flow im UI startet, nach Erfolg taucht das Konto in GET /v1/google/connections auf.
2. Properties listen — GET /v1/google/gsc/properties und GET /v1/google/ga4/properties zeigen verfügbare Properties.
3. Property → Projekt linken — POST /v1/google/gsc/properties/{p}/link mit project_id, analog für GA4. Pro Projekt nur eine GSC- und eine GA4-Property.
4. Sync starten — POST /v1/google/gsc/properties/{p}/sync zieht die letzten 16 Monate Klick-/Impression-/Position-Daten. 1 Credit.
5. Metriken lesen — GET /v1/google/gsc/properties/{p}/metrics und .../ga4/.../metrics für Reports, Dashboards, Agent-Tools.
6. Disconnecten — DELETE /v1/google/connections/{id} revoked das OAuth-Token; Property-Links werden in der UI als „Connection lost" markiert.

API

Credits & Limits

• GSC-Sync: 1 Credit pro Lauf. Lese-Endpoints sind credit-frei.
• GA4-Sync: in den Read-Endpoints inkludiert, kein Extra-Credit.
• OAuth-Tokens: Refresh läuft automatisch; expired Connections müssen über den OAuth-Flow neu autorisiert werden.
• Property-Cap: pro Projekt maximal eine GSC- und eine GA4-Property.
• Team-scoped: Connections gehören zum aktuellen Team; Cross-Team → 404.

Verwandte Module

• Rank Tracker — kombiniert SERP-Position mit GSC-Klicks und -Impressionen.
• Content Audit — bewertet Inhalte mit Hilfe von echten Traffic-Signalen aus GA4.
• Review Sources — der Google-Reviews-Konnektor läuft über denselben OAuth-Flow.
• Agentic Chat — der Agent kann GSC- und GA4-Metriken in seine Analysen einbeziehen.
• Reports — kombinierte GSC+GA4+Rankion-Reports nutzen die hier synchronisierten Daten.