Reports & Cross-Module Correlation

Reports & Cross-Module Correlation es la capa de consolidación de Rankion. En lugar de tener tres pestañas abiertas y saltar entre AVI-Tracking, Site-Audit y análisis de Backlinks, este módulo dispatchea un job que genera un documento Markdown narrativo sobre todos los módulos relevantes de un Tracking-Project — Executive Summary, KPI highlights, wins, risks. Plus: un endpoint síncrono de correlación que conecta Site-Audit × Rank-Tracker × Backlinks × AVI en un solo roundtrip generando Risk-Map, correlación Backlink-AVI y Smart-Todos.

Qué puede hacer

• Documentos auto-generados — GenerateTrackingProjectReportJob agrupa todos los datos del proyecto en un documento Markdown con summary_json con headline-KPIs, wins y risks.
• Exportación Markdown — el markdown_content se usa directamente en Notion, GitHub, email o como paso previo a PDF.
• Histórico — por proyecto hasta los 50 últimos documentos, ordenados por created_at.
• Correlación cross-módulo — Risk-Map (¿qué top-10 keywords tienen issues críticos del Site-Audit?), Backlink-Velocity × AVI-Trend (correlación de Pearson, ventana de 30 días), Smart-Todos con priority_score.
• Smart-Todos — action-items priorizados con justificación, reference-IDs y estimación de impacto — directamente accionables.

Cuándo usarlo

• Update semanal/mensual a stakeholders — el documento se lee como contenido standalone.
• Quieres saber qué URLs en posicionamiento tienen issues del Site-Audit (Risk-Map).
• Quieres demostrar estadísticamente si tu actividad de backlinks mueve realmente el AVI — la correlación de Pearson te da el coeficiente más una observación.
• Necesitas una lista priorizada de todos argumentada cross-module, en lugar de revisar 4 pestañas de módulo individuales.

Informe de análisis en PDF con un clic

En la página de un proyecto de visibilidad en IA encontrarás la tarjeta Informe de análisis en PDF. Reúne en un solo documento todos los módulos medidos del proyecto, con medidas priorizadas. Los módulos sin medición aparecen como tales en el informe, no como ceros.

1. Elige el periodo — Últimos 30 días, Últimos 90 días o Últimos 180 días.
2. Haz clic en Crear informe (10 créditos). El informe se genera en segundo plano; puedes salir de la página.
3. Descargar PDF — la tarjeta muestra los cinco últimos informes del proyecto con su periodo. Mientras uno se está generando, aparece Creándose ….

• Coste: 10 créditos por informe. Solo se cobra cuando el informe y el PDF están terminados. Si la generación falla o al final no hay saldo suficiente, la lista indica »No se ha cobrado nada.«
• Un informe por proyecto cada 30 minutos. Un clic anterior se rechaza con un aviso.
• Quién puede crearlo: quien en el equipo tenga permiso para crear en visibilidad en IA. Quien solo puede ver el proyecto ve la lista, pero no el botón.
• Idioma: el informe se redacta en el idioma de tu cuenta.
• Logo y color: en los planes con marca blanca, el PDF lleva el logo y el color del proyecto de contenido vinculado; si no, el diseño de Rankion.

Qué contiene el informe

El informe empieza con la Ficha del proyecto; le siguen el Executive Summary, las Medidas priorizadas, la Visibilidad en IA y las secciones temáticas, después Rank Tracker, Site Audit, Análisis de brechas, Backlinks, Content Audit, Citabilidad y la comparación con el informe anterior. Todas las cifras proceden de mediciones guardadas; las secciones temáticas no cuestan nada extra.

Ficha del proyecto

La primera sección explica de qué trata el proyecto: marca, dominio, competidores activos, temas asignados, número de preguntas activas y de preguntas medidas en el periodo, los sistemas consultados con su modelo, respuestas y días de medición, y el modo de búsqueda (con o sin búsqueda web). Además indica qué estado de la asignación de temas describe el informe.

Visibilidad por clúster temático

Por tema: preguntas, respuestas, menciones, visibilidad y tasa de citas, y debajo la fila Total (cada respuesta una vez).

• Los temas que tu proyecto no tiene se omiten. Un tema sin ninguna respuesta en el periodo no recibe fila, ni cero, ni »no medido«.
• Un tema con respuestas pero 0 menciones sigue visible, como 0,0 %. Justo ahí falta tu marca, y ahí empieza una medida.
• La fila Sin tema solo aparece si hay respuestas a preguntas sin tema. Si ninguna pregunta tiene tema todavía, todo figura en Sin tema, con una frase que lo explica.
• Una pregunta en dos temas cuenta en ambos. La suma de los temas es entonces mayor que la fila Total; el informe lo indica y da el número de esas preguntas.

Preguntas en detalle

• Preguntas con más menciones propias — las diez preguntas en cuyas respuestas tu marca aparece con más frecuencia, con aciertos, respuestas y los sistemas que te mencionan.
• Preguntas con desventaja, por prioridad — respuestas que nombran otras marcas pero no la tuya. Con temas: las tres de mayor prioridad por tema, como máximo diez temas. Sin temas: las diez más importantes en total. La columna Nombradas en tu lugar muestra quién ocupa tu sitio.

Comparación con la competencia

Dos formas de contar aparecen a propósito una junto a otra, cada una con su nombre:

Las dos tasas pueden diferir. Solo la lista de marcas permite comparar con la competencia; debajo aparecen tus competidores registrados o, si no hay ninguno, las marcas mencionadas con frecuencia.

Fuentes por tipo

Qué fuentes cita la IA, ordenadas por Tipo de página (por ejemplo Artículos, FAQ) y por Tipo de dominio (por ejemplo Blog / revista, Foro / comunidad, Comercio electrónico / tienda, Portal comparador). Lo que aún no está clasificado tiene su propia fila. Además, el Perfil de formatos de la competencia — qué páginas se citan cuando se nombra a un competidor registrado — y las Páginas propias citadas.

Grupos de palabras clave

En la sección Rank Tracker las palabras clave aparecen como Palabras clave por grupo, con hasta tres ejemplos por grupo. El Análisis de brechas solo se agrupa si cada oportunidad de palabra clave puede asignarse a un grupo; si no, se mantiene la lista simple, para que ninguna oportunidad desaparezca sin que se note.

Cada tabla indica su población

Debajo de cada tabla, una nota al pie dice a qué se refieren las cifras, por ejemplo »Población: 412 respuestas«, junto con el periodo, los sistemas y el modo de búsqueda. Las filas de suma se comprueban contra esa población antes de crear el informe. Si una no cuadra, no se genera ningún PDF y no se cobra nada.

Workflow

El flujo es asíncrono — patrón como todos los long-running jobs en Rankion: dispatch, polling, consumir.

1. Dispatchea — POST /tracking-projects/{id}/generate-report. Respuesta: 202 con report_id y status: "pending". Rate-limit: 1 request / 30 min / proyecto.
2. Polling hasta completed — GET /reports/{id} cada 5 segundos hasta que status pase de pending → generating → completed (o failed).
3. Extrae el markdown — markdown_content del detail-response. Pegable directamente en Notion o convertible a PDF con pandoc.

RID=$(curl -s -X POST $BASE/tracking-projects/$PID/generate-report \
  -H "Authorization: Bearer $TOKEN" | jq -r '.report_id')

while true; do
  S=$(curl -s -H "Authorization: Bearer $TOKEN" $BASE/reports/$RID | jq -r '.status')
  [ "$S" = completed ] && break
  [ "$S" = failed ] && exit 1
  sleep 5
done

curl -s -H "Authorization: Bearer $TOKEN" $BASE/reports/$RID \
  | jq -r '.markdown_content' > report.md

La correlación cross-módulo corre síncrona — sin polling.

curl "$BASE/tracking-projects/$PID/correlation" \
  -H "Authorization: Bearer $TOKEN"

API

Response — GET /reports/{id} (recortado).

{
  "id": 42,
  "tracking_project_id": 7,
  "status": "completed",
  "markdown_content": "# Tracking-Report Project XY\n\n## Executive Summary\n…",
  "summary_json": {
    "headline_kpis": { "avi_score": 64, "delta_30d": "+8", "top10_keywords": 14 },
    "wins": ["…"],
    "risks": ["…"]
  },
  "credits_used": 10,
  "generated_at": "2026-04-27T18:14:22+00:00"
}

La response de correlación entrega tres bloques: site_audit_ranking_risks[] (top-ranking-URLs con issues del Site-Audit, ordenadas por risk_score), backlinks_av_correlation (coeficiente Pearson con texto de observation), smart_todos[] (action-items priorizados con priority_score, reference-IDs).

Créditos y límites

• Generación: 10 créditos por run (POST /tracking-projects/{id}/generate-report).
• Cobro solo si sale bien: los 10 créditos se cobran cuando el informe y el PDF están terminados; un informe fallido no cuesta nada.
• Rate-limit: 1 ejecución / 30 minutos por proyecto. 429 con {error: "rate_limited"} ante violación.
• Correlación: sin coste, síncrona, sin límites más allá del throttle estándar de auth.
• Status codes: 202 (dispatch), 200 (list/detail/correlation), 403 (cross-team / cross-project), 404 (no encontrado), 429 (rate-limit).
• Fuentes de datos: la salida agrega sobre todos los módulos activos del proyecto — los valores son tan recientes como el último tracking-run / audit / backlink-pull.

Módulos relacionados

• AI-Visibility Tracking — entrega el AVI-Score y delta-30d para las headline-KPIs.
• Content Audit — entrega los issues del Site-Audit para la Risk-Map.
• Competitor & Backlinks Analysis — entrega la backlink-velocity para el cálculo de correlación.
• Agentic Chat — puede dispatchear este flujo por pregunta y convertir Smart-Todos en action-items.