Reports & Cross-Module Correlation

Reports & Cross-Module Correlation est la couche de consolidation de Rankion. Au lieu de garder trois onglets ouverts et de basculer entre AVI Tracking, Site Audit et analyse de backlinks, ce module dispatch un job qui génère un document Markdown narratif sur tous les modules pertinents d'un tracking project — executive summary, KPI highlights, wins, risks. Plus : un endpoint de corrélation synchrone qui lie Site Audit × Rank Tracker × Backlinks × AVI en un round-trip vers risk map, corrélation backlink-AVI et smart todos.

Ce qu'il peut faire

• Documents auto-générés — GenerateTrackingProjectReportJob regroupe toutes les données du projet dans un document Markdown incluant summary_json avec headline KPIs, wins, risks.
• Export Markdown — le markdown_content est directement utilisable dans Notion, GitHub, e-mail ou comme étape préalable au PDF.
• Historique — par projet jusqu'aux 50 derniers documents, triés par created_at.
• Corrélation cross-module — risk map (quels top-10 mots-clés ont des issues critiques de Site Audit ?), Backlink Velocity × tendance AVI (corrélation Pearson, fenêtre 30 jours), smart todos avec priority_score.
• Smart todos — action items priorisés avec justification, reference IDs et estimation d'impact — directement actionnables.

Quand l'utiliser

• Update stakeholder hebdomadaire/mensuel — le document est lisible comme standalone.
• Vous voulez savoir lesquelles de vos URLs en ranking ont des issues de Site Audit (risk map).
• Vous voulez prouver statistiquement si votre activité de backlink bouge effectivement l'AVI — la corrélation Pearson vous donne le coefficient plus une observation.
• Vous avez besoin d'une todo list priorisée argumentée cross-module, plutôt que d'examiner 4 onglets de modules individuellement.

Rapport d’analyse en PDF en un clic

Sur la page d’un projet de visibilité IA, vous trouvez la carte Rapport d’analyse en PDF. Elle réunit dans un seul document tous les modules mesurés du projet, avec des actions prioritaires. Les modules sans mesure y figurent comme tels, et non comme des zéros.

1. Choisissez la période — 30 derniers jours, 90 derniers jours ou 180 derniers jours.
2. Cliquez sur Créer le rapport (10 crédits). Le rapport est créé en arrière-plan ; vous pouvez quitter la page.
3. Télécharger le PDF — la carte liste les cinq derniers rapports du projet avec leur période. Tant qu’un rapport est en préparation, elle affiche En cours de création ….

• Coût : 10 crédits par rapport. Le débit n’a lieu qu’une fois le rapport et le PDF terminés. Si la création échoue ou si le solde ne suffit plus à la fin, la liste indique « Rien n’a été débité. »
• Un rapport par projet toutes les 30 minutes. Un clic plus tôt est refusé avec un message.
• Qui peut le créer : les membres de l’équipe autorisés à créer dans la visibilité IA. Si vous pouvez seulement consulter le projet, vous voyez la liste, mais pas le bouton.
• Langue : le rapport est rédigé dans la langue de votre compte.
• Logo et couleur : avec les offres en marque blanche, le PDF porte le logo et la couleur du projet de contenu associé ; sinon le design Rankion.

Ce que contient le rapport

Le rapport commence par la Fiche du projet, puis viennent l’Executive Summary, les Actions prioritaires, la Visibilité IA et les sections thématiques, ensuite Rank Tracker, Site Audit, Analyse des écarts, Backlinks, Content Audit, Citabilité et la comparaison avec le rapport précédent. Tous les chiffres proviennent de mesures enregistrées ; les sections thématiques ne coûtent rien de plus.

Fiche du projet

La première section dit de quoi parle le projet : marque, domaine, concurrents actifs, thèmes attribués, nombre de questions actives et de questions mesurées sur la période, systèmes interrogés avec leur modèle, réponses et jours de mesure, ainsi que le mode de recherche (avec ou sans recherche web). Elle indique aussi quel état de l’attribution des thèmes le rapport décrit.

Visibilité par cluster thématique

Par thème : questions, réponses, mentions, visibilité et taux de citation, puis la ligne Total (chaque réponse une fois).

• Les thèmes que votre projet n’a pas sont omis. Un thème sans aucune réponse sur la période n’a ni ligne, ni zéro, ni « non mesuré ».
• Un thème avec des réponses mais 0 mention reste visible, à 0,0 %. C’est précisément là que votre marque manque, et là qu’une action commence.
• La ligne Sans thème n’apparaît que s’il existe des réponses à des questions sans thème. Si aucune question n’a encore de thème, tout figure sous Sans thème, avec une phrase d’explication.
• Une question rattachée à deux thèmes compte dans les deux. La somme des thèmes dépasse alors la ligne Total ; le rapport le signale et donne le nombre de ces questions.

Questions en détail

• Questions avec le plus de mentions propres — les dix questions dont les réponses citent le plus souvent votre marque, avec les hits, les réponses et les systèmes qui vous mentionnent.
• Questions en retard, par priorité — les réponses qui citent d’autres marques mais pas la vôtre. Avec des thèmes : les trois plus prioritaires par thème, pour dix thèmes au plus. Sans thèmes : les dix plus importantes au total. La colonne Citées à votre place montre qui prend votre place.

Comparaison concurrentielle

Deux méthodes de comptage figurent volontairement côte à côte, chacune avec son nom :

Les deux taux peuvent différer. Seule la liste de marques permet la comparaison avec les concurrents ; en dessous figurent vos concurrents enregistrés ou, à défaut, les marques souvent citées.

Sources par type

Quelles sources l’IA cite, classées par Type de page (par exemple Articles, FAQ) et par Type de domaine (par exemple Blog / magazine, Forum / communauté, E-commerce / boutique). Ce qui n’est pas encore classé a sa propre ligne. S’y ajoutent le Profil de formats des concurrents — quelles pages sont citées lorsqu’un concurrent enregistré est nommé — et Vos pages citées.

Regroupements de mots-clés

Dans la section Rank Tracker, les mots-clés apparaissent en Mots-clés par groupe, avec jusqu’à trois exemples par groupe. L’Analyse des écarts n’est regroupée que si chaque opportunité de mot-clé peut être rattachée à un groupe ; sinon la liste simple reste, pour qu’aucune opportunité ne disparaisse sans qu’on le remarque.

Chaque tableau indique sa population

Sous chaque tableau, une note de bas de page précise à quoi se rapportent les chiffres, par exemple « Population : 412 réponses », avec la période, les systèmes et le mode de recherche. Les lignes de somme sont vérifiées par rapport à cette population avant la création du rapport. Si l’une ne correspond pas, aucun PDF n’est produit et rien n’est débité.

Workflow

Les documents sont asynchrones — pattern comme tous les long-running jobs dans Rankion : dispatch, poller, consommer.

1. Dispatcher le document — POST /tracking-projects/{id}/generate-report. Réponse : 202 avec report_id et status: "pending". Rate-limit : 1 requête / 30 min / projet.
2. Poller jusqu'à completed — GET /reports/{id} toutes les 5 secondes, jusqu'à ce que status passe de pending → generating → completed (ou failed).
3. Extraire le Markdown — markdown_content depuis la réponse de détail. Directement collable dans Notion ou via pandoc vers 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

La corrélation cross-module tourne synchrone — pas de polling.

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

API

Réponse — GET /reports/{id} (raccourci).

{
  "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 réponse de corrélation livre trois blocs : site_audit_ranking_risks[] (top URLs en ranking avec issues Site Audit, triés par risk_score), backlinks_av_correlation (coefficient Pearson avec texte d'observation), smart_todos[] (action items priorisés avec priority_score, reference IDs).

Crédits et limites

• Génération : 10 crédits par run (POST /tracking-projects/{id}/generate-report).
• Débit uniquement en cas de succès : les 10 crédits ne sont débités qu’une fois le rapport et le PDF terminés ; un rapport en échec ne coûte rien.
• Rate-limit : 1 / 30 minutes par projet. 429 avec {error: "rate_limited"} en cas de violation.
• Corrélation : gratuite, synchrone, pas de limites au-delà du throttle d'auth standard.
• Status codes : 202 (dispatch), 200 (list/detail/correlation), 403 (cross-team / cross-project), 404 (non trouvé), 429 (rate-limit).
• Sources de données : agrégation sur tous les modules actifs du projet — les valeurs sont aussi à jour que le dernier tracking-run / audit / backlink pull.

Modules associés

• AI-Visibility Tracking — livre score AVI et delta-30d pour les headline KPIs.
• Content Audit — livre les issues Site Audit pour la risk map.
• Competitor & Backlinks Analyse — livre la velocity backlink pour le calcul de corrélation.
• Agentic Chat — peut dispatcher des documents par question et transformer les smart todos en action items.