Google Integrations (GSC + GA4)

Google Integrations apporte directement Search Console (GSC) et Google Analytics 4 (GA4) dans Rankion. Tu connectes ton compte Google une fois, tu lies par projet la property correspondante et Rankion tire dans le dashboard les métriques de clic, impression, position et trafic. Tu complètes ainsi la vue SERP du Rank Tracker avec de vraies données de clic, et la vue contenu du Content Audit avec de vrais signaux utilisateur de GA4.

Ce qu'il peut faire

• Gestion des connexions — GET /v1/google/connections liste tous les comptes Google connectés à l'équipe. DELETE /v1/google/connections/{id} coupe une connexion proprement, y compris token revoke.
• Discovery de properties GSC — GET /v1/google/gsc/properties liste toutes les GSC properties auxquelles le compte connecté a accès (sitemap, domain ou URL prefix properties).
• Linking GSC par projet — POST /v1/google/gsc/properties/{p}/link et DELETE .../link lient / délient une property avec un projet Rankion.
• Sync GSC — POST /v1/google/gsc/properties/{p}/sync tire les données actuelles (clics, impressions, CTR, position) pour la property liée. 1 crédit par sync.
• Lecture métriques GSC — GET /v1/google/gsc/properties/{p}/metrics livre les valeurs récemment synchronisées pour reporting & UI.
• Discovery & linking properties GA4 — analogue : GET /v1/google/ga4/properties, POST/DELETE /v1/google/ga4/properties/{p}/link.
• Métriques GA4 — GET /v1/google/ga4/properties/{p}/metrics livre métriques de trafic, engagement et conversion.
• Statut connecteur reviews — GET /v1/integrations/google/reviews/status montre si le connecteur Google Reviews (partie de Review Sources) est actif.

Quand l'utiliser

• Tu veux marier la position SERP du Rank Tracker avec de vraies données de clic GSC.
• Tu veux voir si les findings du Content Audit ont effectivement des effets de trafic (GA4).
• Tu veux construire des dashboards de reporting avec données GSC, GA4 et Rankion en une seule source.
• Tu veux nourrir l'Agentic Chat avec de vraies données de performance.

Workflow

1. Connecter Google — le flow OAuth démarre dans l'UI, après succès le compte apparaît dans GET /v1/google/connections.
2. Lister les properties — GET /v1/google/gsc/properties et GET /v1/google/ga4/properties montrent les properties disponibles.
3. Lier property → projet — POST /v1/google/gsc/properties/{p}/link avec project_id, idem pour GA4. Une seule property GSC et une seule GA4 par projet.
4. Lancer le sync — POST /v1/google/gsc/properties/{p}/sync tire les 16 derniers mois de données clic/impression/position. 1 crédit.
5. Lire les métriques — GET /v1/google/gsc/properties/{p}/metrics et .../ga4/.../metrics pour rapports, dashboards, agent tools.
6. Déconnecter — DELETE /v1/google/connections/{id} revoke le token OAuth ; les liens de property sont marqués « connection lost » dans l'UI.

API

Crédits et limites

• Sync GSC : 1 crédit par run. Les endpoints de lecture sont gratuits.
• Sync GA4 : inclus dans les endpoints de lecture, pas de crédit supplémentaire.
• Tokens OAuth : le refresh tourne automatiquement ; les connexions expirées doivent être réautorisées via le flow OAuth.
• Cap de property : au maximum une property GSC et une GA4 par projet.
• Team-scoped : les connexions appartiennent à l'équipe actuelle ; cross-team → 404.

Modules associés

• Rank Tracker — combine la position SERP avec les clics et impressions GSC.
• Content Audit — évalue les contenus à l'aide de vrais signaux de trafic GA4.
• Review Sources — le connecteur Google Reviews tourne via le même flow OAuth.
• Agentic Chat — l'agent peut intégrer les métriques GSC et GA4 dans ses analyses.
• Reports — les rapports combinés GSC+GA4+Rankion utilisent les données synchronisées ici.