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.
• Reviews-Connector-Status — GET /v1/integrations/google/reviews/status zeigt, ob der Google-Reviews-Konnektor (Teil von Review Sources) aktiv ist.

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.