Branchez vos tableaux de bord sur l'API JSON heatmap par article
API JSON heatmap par article une fonctionnalité du module Analytics, heatmap & tableau de bord de Clustraly. L'API JSON heatmap par article renvoie, sur une adresse admin protégée, les statistiques de lecture agrégées et l'attention moyenne par zone H2 d'un article.
Une adresse admin protégée renvoie, en JSON, les statistiques de lecture agrégées et l'attention par zone H2 d'un article. Prête à brancher sur vos widgets, tableaux de bord et intégrations.
Un article, une adresse, tout son comportement de lecture
Appelez GET /admin/api/analytics/heatmap/{articleId} et récupérez en JSON tout ce qui décrit la lecture d'un article : ses statistiques agrégées et son attention par section. Pas d'écran à parcourir, une seule requête.
La réponse est structurée pour être consommée directement par vos widgets, vos tableaux de bord ou vos intégrations.
- Une seule requête par article
- Réponse JSON prête à consommer
- Accès réservé à la permission analytics.view
Mesurez l'engagement réel, pas les suppositions
L'endpoint renvoie les indicateurs agrégés de l'article : nombre de sessions, profondeur de scroll moyenne, temps de lecture moyen, lectures complètes et taux de complétion.
Une lecture est comptée complète dès que le scroll atteint 90 %. Vous obtenez un taux de complétion fiable et comparable d'un article à l'autre.
- Sessions, scroll moyen, temps de lecture
- Taux de complétion comparable entre articles
- Lecture complète comptée dès 90 % de scroll
Voyez quelles sections retiennent vos lecteurs
Au-delà des moyennes, l'API expose l'attention moyenne par zone H2 : le temps passé, en secondes, sur chaque section titrée de l'article.
Vous repérez d'un coup d'œil les passages qui captent et ceux que l'on survole, section par section.
- Attention moyenne par titre H2
- Exprimée en secondes, par zone
- Repère les sections survolées
Un contrat JSON qui ne casse jamais votre client
Un articleId invalide (≤ 0) reçoit une réponse 400 nette. Et si la source de données heatmap est indisponible, l'API renvoie un JSON d'erreur 500 explicite (« Heatmap data unavailable ») plutôt qu'une page HTML.
Votre intégration reçoit donc toujours du JSON, jamais une page d'erreur inattendue. L'incident est journalisé côté serveur pour votre diagnostic.
- Réponse 400 sur identifiant invalide
- Erreur renvoyée en JSON, pas en HTML
- Incidents journalisés côté serveur
- Contrat JSON préservé pour le client
Branchez vos outils sur la lecture de vos contenus
Alimentez un widget maison, un tableau de bord externe ou une automatisation éditoriale avec des données par article, à la demande.
Les données remontées proviennent d'un suivi sans cookie et soumis au consentement : vous décidez des arbitrages éditoriaux sur une base saine.
- Widgets et tableaux de bord sur mesure
- Intégrations et automatisations éditoriales
- Données issues d'un suivi consenti, sans cookie
Le contrat JSON, préservé même en cas de panne
Table heatmap absente en production ? L'API répond par un JSON d'erreur 500 clair au lieu d'un HTML 500, et journalise l'incident. Vos clients continuent de parler le même langage, quoi qu'il arrive.
Questions fréquentes
Quelle adresse appeler pour obtenir la heatmap d'un article ?
Que renvoie exactement l'API JSON heatmap par article ?
Que se passe-t-il si l'identifiant est invalide ou la donnée indisponible ?
D'où viennent les données de la heatmap ?
Exploitez la lecture de vos articles, à votre façon
L'API JSON heatmap par article met les statistiques de lecture agrégées et l'attention par section à portée de requête. Intégrez-les où vous voulez : le contrat JSON reste stable, les accès restent protégés, et vous gardez la main sur vos décisions éditoriales.