Google Integrations (GSC + GA4)

Google Integrations trae Search Console (GSC) y Google Analytics 4 (GA4) directamente a Rankion. Conectas tu cuenta Google una vez, vinculas la property apropiada por proyecto y Rankion trae métricas de clicks, impresiones, posición y tráfico al dashboard. Así complementas la vista SERP del Rank Tracker con datos reales de clicks, y la vista de contenido del Content Audit con señales reales de usuario desde GA4.

Qué puede hacer

• Gestión de connections — GET /v1/google/connections lista todas las cuentas Google vinculadas con el team. DELETE /v1/google/connections/{id} desconecta una conexión limpiamente, incluido revoke del token.
• GSC-Property-Discovery — GET /v1/google/gsc/properties lista todas las GSC-properties a las que la cuenta vinculada tiene acceso (sitemap, dominio o URL-prefix-property).
• GSC-Linking por proyecto — POST /v1/google/gsc/properties/{p}/link y DELETE .../link vinculan/desvinculan una property con un proyecto Rankion.
• GSC-Sync — POST /v1/google/gsc/properties/{p}/sync trae los datos actuales (clicks, impresiones, CTR, posición) para la property vinculada. 1 crédito por sync.
• GSC-Metrics-Read — GET /v1/google/gsc/properties/{p}/metrics entrega los valores recién sincronizados para reporting y UI.
• GA4-Property-Discovery & Linking — análogo: GET /v1/google/ga4/properties, POST/DELETE /v1/google/ga4/properties/{p}/link.
• GA4-Metrics — GET /v1/google/ga4/properties/{p}/metrics entrega métricas de tráfico, engagement y conversion.
• Estado del connector de reviews — GET /v1/integrations/google/reviews/status muestra si el connector Google-Reviews (parte de Review Sources) está activo.

Cuándo usarlo

• Quieres casar la posición SERP del Rank Tracker con datos reales de clicks de GSC.
• Quieres ver si los findings del Content Audit tienen efectos reales sobre el tráfico (GA4).
• Quieres construir dashboards de reporting que tengan datos GSC, GA4 y Rankion en una misma fuente.
• Quieres alimentar el Agentic Chat con datos reales de performance.

Workflow

1. Conecta Google — el flujo OAuth arranca en la UI; tras éxito la cuenta aparece en GET /v1/google/connections.
2. Lista properties — GET /v1/google/gsc/properties y GET /v1/google/ga4/properties muestran las disponibles.
3. Property → proyecto link — POST /v1/google/gsc/properties/{p}/link con project_id, análogo para GA4. Por proyecto solo una GSC y una GA4 property.
4. Inicia el sync — POST /v1/google/gsc/properties/{p}/sync trae los últimos 16 meses de clicks/impresiones/posición. 1 crédito.
5. Lee las métricas — GET /v1/google/gsc/properties/{p}/metrics y .../ga4/.../metrics para reports, dashboards, agent-tools.
6. Disconnect — DELETE /v1/google/connections/{id} revoca el token OAuth; los property-links se marcan en la UI como «connection lost».

API

Créditos y límites

• GSC-Sync: 1 crédito por run. Los endpoints de lectura son sin coste.
• GA4-Sync: incluido en los endpoints de lectura, sin crédito extra.
• Tokens OAuth: el refresh corre automáticamente; las connections expiradas requieren re-autorización vía OAuth.
• Property-Cap: por proyecto, máximo una GSC y una GA4 property.
• Team-scoped: las connections pertenecen al team actual; cross-team → 404.

Módulos relacionados

• Rank Tracker — combina posición SERP con clicks e impresiones de GSC.
• Content Audit — evalúa contenidos con ayuda de señales reales de tráfico desde GA4.
• Review Sources — el connector Google-Reviews corre por el mismo flujo OAuth.
• Agentic Chat — el agent puede integrar métricas GSC y GA4 en sus análisis.
• Reports — los reports combinados GSC+GA4+Rankion utilizan los datos sincronizados aquí.