Reports & Cross-Module Correlation

Reports & Cross-Module Correlation ist Rankions Konsolidierungs-Layer. Statt drei Tabs offen zu halten und zwischen AVI-Tracking, Site-Audit und Backlinks-Analyse hin- und herzuspringen, dispatched dieses Modul einen Job, der einen narrativen Markdown-Report über alle relevanten Module eines Tracking-Projects erzeugt — Executive Summary, KPI-Highlights, Wins, Risks. Plus: ein synchroner Korrelations-Endpoint, der Site-Audit × Rank-Tracker × Backlinks × AVI in einem Roundtrip zu Risk-Map, Backlink-AVI-Korrelation und Smart-Todos verknüpft.

Was es kann

• Auto-Generated Reports — GenerateTrackingProjectReportJob bündelt alle Project-Daten zu einem Markdown-Dokument inklusive summary_json mit Headline-KPIs, Wins, Risks.
• Markdown-Export — der markdown_content ist direkt verwendbar in Notion, GitHub, E-Mail oder als Vorstufe für PDF.
• Report-History — pro Project bis zu 50 letzte Reports, sortiert nach created_at.
• Cross-Module-Korrelation — Risk-Map (welche Top-10-Keywords haben kritische Site-Audit-Issues?), Backlink-Velocity × AVI-Trend (Pearson-Korrelation, 30-Tage-Fenster), Smart-Todos mit priority_score.
• Smart-Todos — priorisierte Action-Items mit Begründung, Reference-IDs und Impact-Schätzung — direkt umsetzbar.

Wann nutzen

• Wöchentliches/monatliches Stakeholder-Update — der Report ist als Standalone-Dokument lesbar.
• Du willst wissen welche deiner rankenden URLs Site-Audit-Issues haben (Risk-Map).
• Du willst statistisch belegen ob deine Backlink-Aktivität tatsächlich AVI bewegt — die Pearson-Korrelation gibt dir den Koeffizienten plus Beobachtung.
• Du brauchst eine priorisierte Todo-Liste die Cross-Module argumentiert ist, statt 4 Modul-Tabs einzeln zu sichten.

Analysebericht als PDF auf Knopfdruck

Auf der Projektseite eines KI-Sichtbarkeitsprojekts steht die Karte Analysebericht als PDF. Sie fasst alle gemessenen Module des Projekts in einem Dokument zusammen, mit priorisierten Maßnahmen. Module ohne Messung stehen im Bericht als solche da, nicht als Nullen.

1. Zeitraum wählen — Letzte 30 Tage, Letzte 90 Tage oder Letzte 180 Tage.
2. Bericht erstellen (10 Credits) klicken. Der Bericht entsteht im Hintergrund; du kannst die Seite verlassen.
3. PDF herunterladen — die Karte listet die letzten fünf Berichte des Projekts mit ihrem Zeitraum. Solange einer entsteht, steht dort Wird erstellt ….

• Kosten: 10 Credits je Bericht. Abgebucht wird erst, wenn Bericht und PDF fertig sind. Schlägt der Lauf fehl oder reicht das Guthaben am Ende nicht, steht in der Liste »Es wurde nichts abgebucht.«
• Ein Bericht je Projekt alle 30 Minuten. Ein früherer Klick wird mit einem Hinweis abgewiesen.
• Wer ihn erstellen darf: wer im Team KI-Sichtbarkeit anlegen darf. Wer das Projekt nur sehen darf, sieht die Liste, aber keinen Knopf.
• Sprache: der Bericht erscheint in der Sprache deines Kontos.
• Logo und Farbe: in Tarifen mit White-Label trägt das PDF Logo und Farbe des verknüpften Content-Projekts, sonst das Rankion-Design.

Was im Bericht steht

Der Bericht beginnt mit dem Projektsteckbrief, danach folgen Executive Summary, Priorisierte Maßnahmen, die KI-Sichtbarkeit und die thematischen Abschnitte, dann Rank-Tracker, Site-Audit, Gap-Analyse, Backlinks, Content-Audit, Zitierfähigkeit und der Vergleich mit dem Vorbericht. Alle Zahlen stammen aus gespeicherten Messungen; die thematischen Abschnitte kosten nichts extra.

Projektsteckbrief

Der erste Abschnitt sagt, worum es bei dem Projekt geht: Marke, Domain, aktive Wettbewerber, vergebene Themen, Zahl der aktiven und der im Zeitraum gemessenen Fragen, die abgefragten Systeme mit ihrem Modell, Antworten und Messtage sowie der Suchmodus (mit oder ohne Websuche). Dazu steht der Stand der Themenzuordnung, damit klar ist, welche Zuordnung der Bericht beschreibt.

Sichtbarkeit je Themencluster

Je Thema: Fragen, Antworten, Nennungen, Sichtbarkeit und Zitierungsrate, darunter die Zeile Gesamt (jede Antwort einmal).

• Themen, die dein Projekt nicht hat, fehlen. Ein Thema ohne Antwort im Zeitraum bekommt keine Zeile, keine Null und kein »nicht gemessen«.
• Ein Thema mit Antworten, aber 0 Nennungen bleibt sichtbar, als 0,0 %. Genau dort fehlt deine Marke, und dort setzt eine Maßnahme an.
• Die Zeile Ohne Thema steht nur, wenn es Antworten zu Fragen ohne Thema gibt. Hat noch keine Frage ein Thema, steht alles unter Ohne Thema, mit einem erklärenden Satz.
• Steckt eine Frage in zwei Themen, zählt sie in beiden. Die Summe der Themen ist dann größer als die Zeile Gesamt; der Bericht sagt das und nennt die Zahl dieser Fragen.

Fragen im Detail

• Fragen mit den meisten eigenen Nennungen — die zehn Fragen, in deren Antworten deine Marke am häufigsten vorkommt, mit Treffern, Antworten und den Systemen, die dich nennen.
• Fragen mit Rückstand, nach Priorität — Antworten, in denen andere Marken genannt werden, deine aber nicht. Mit Themen: je Thema die drei mit der höchsten Priorität, höchstens zehn Themen. Ohne Themen: die zehn wichtigsten insgesamt. Die Spalte Genannt statt dir zeigt, wer an deiner Stelle steht.

Wettbewerbsvergleich

Zwei Zählweisen stehen bewusst nebeneinander, jede mit ihrem Namen:

Die beiden Quoten können voneinander abweichen. Den Vergleich mit Wettbewerbern erlaubt nur die Markenliste; darunter stehen deine gepflegten Wettbewerber oder, ohne gepflegte Wettbewerber, die häufig genannten Marken.

Quellen nach Art

Welche Quellen die KI zitiert, eingeordnet nach Seitentyp (etwa Artikel, Vergleich, FAQ, Produkt-Seite) und nach Domain-Art (etwa Blog / Magazin, Forum / Community, E-Commerce / Shop, Vergleichsportal). Was noch nicht eingeordnet ist, steht als eigene Zeile da. Dazu das Formatprofil der Wettbewerber — welche Seiten zitiert werden, wenn ein gepflegter Wettbewerber genannt wird — und die eigenen zitierten Seiten.

Keyword-Bündel

Im Rank-Tracker stehen die Keywords als Keywords nach Gruppe, je Gruppe mit bis zu drei Beispielen. Die Gap-Analyse wird nur dann nach Gruppen gebündelt, wenn sich jede Keyword-Chance einer Gruppe zuordnen lässt; sonst bleibt die einfache Liste, damit keine Chance unbemerkt herausfällt.

Jede Tabelle nennt ihre Grundgesamtheit

Unter jeder Tabelle steht in einer Fußnote, worauf sich die Zahlen beziehen, etwa »Grundgesamtheit: 412 Antworten« — dazu Zeitraum, Systeme und Suchmodus. Summenzeilen werden vor dem Erstellen gegen diese Grundgesamtheit geprüft. Passt eine nicht, entsteht kein PDF und es wird nichts abgebucht.

Workflow

Reports sind asynchron — Pattern wie alle Long-Running-Jobs in Rankion: Dispatch, Pollen, Konsumieren.

1. Report dispatchen — POST /tracking-projects/{id}/generate-report. Antwort: 202 mit report_id und status: "pending". Rate-Limit: 1 Request / 30 Min / Project.
2. Pollen bis completed — GET /reports/{id} alle 5 Sekunden, bis status von pending → generating → completed (oder failed).
3. Markdown extrahieren — markdown_content aus dem Detail-Response. Direkt in Notion paste-bar oder per pandoc zu PDF.

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

Cross-Module-Korrelation läuft synchron — kein Polling.

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

API

Response — GET /reports/{id} (gekürzt).

{
  "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"
}

Korrelations-Response liefert drei Blöcke: site_audit_ranking_risks[] (Top-Ranking-URLs mit Site-Audit-Issues, sortiert nach risk_score), backlinks_av_correlation (Pearson-Koeffizient mit observation-Text), smart_todos[] (priorisierte Action-Items mit priority_score, Reference-IDs).

Credits & Limits

• Report-Generierung: 10 Credits pro Run (POST /tracking-projects/{id}/generate-report).
• Abbuchung nur bei Erfolg: die 10 Credits werden erst gebucht, wenn Bericht und PDF fertig sind; ein fehlgeschlagener Bericht kostet nichts.
• Rate-Limit: 1 Report / 30 Minuten pro Project. 429 mit {error: "rate_limited"} bei Verstoß.
• Korrelation: kostenfrei, synchron, keine Limits außer Standard-Auth-Throttle.
• Status-Codes: 202 (Dispatch), 200 (List/Detail/Correlation), 403 (Cross-Team / Cross-Project), 404 (Report/Project nicht gefunden), 429 (Rate-Limit).
• Datenquellen: Report aggregiert über alle aktiven Module des Projects — Werte sind so aktuell wie der letzte Tracking-Run / Audit / Backlink-Pull.

Verwandte Module

• AI-Visibility Tracking — liefert AVI-Score und Delta-30d für die Headline-KPIs.
• Content Audit — liefert Site-Audit-Issues für die Risk-Map.
• Competitor & Backlinks Analyse — liefert Backlink-Velocity für die Korrelations-Berechnung.
• Agentic Chat — kann Reports per Frage dispatchen und Smart-Todos in Action-Items umwandeln.