Google Integrations (GSC + GA4)

Google Integrations apporte directement Search Console (GSC) et Google Analytics 4 (GA4) dans Rankion. Vous connectez votre compte Google une fois, vous liez par projet la property correspondante et Rankion tire dans le dashboard les métriques de clic, impression, position et trafic. Vous complétez 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 d'un seul jour (clics, impressions, CTR, position) pour la property : celui d'il y a trois jours. 1 crédit par appel, même si le job échoue ensuite.
• 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

• Vous voulez marier la position SERP du Rank Tracker avec de vraies données de clic GSC.
• Vous voulez voir si les findings du Content Audit ont effectivement des effets de trafic (GA4).
• Vous voulez construire des dashboards de reporting avec données GSC, GA4 et Rankion en une seule source.
• Vous voulez 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. Cela lance le backfill gratuit : 90 jours via l'API, au choix 30, 90, 180 ou 365 jours dans l'assistant de connexion. Une seule property GSC et une seule GA4 par projet.
4. Récupérer un seul jour (optionnel) — POST /v1/google/gsc/properties/{p}/sync récupère un jour (celui d'il y a trois jours), pas un historique. 1 crédit, débité avec la réponse 202, pas de remboursement si le job échoue ensuite.
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 appel, débité avec la réponse 202, pas de remboursement si le job échoue ensuite. Le backfill à la liaison est gratuit. 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.