Rapports
Utilisez la vue d'ensemble de Radar et les rapports enregistrés dans Explorer pour repérer des tendances dans les événements et les réponses aux mesures, et conserver le calcul à la base d'une analyse récurrente.
Les rapports permettent de passer d'une traduction isolée à une vue des tendances. Une équipe peut ainsi repérer les langues qui représentent l'essentiel du travail enregistré, les mesures dont les réponses ont changé ou les règles qui échouent à répétition. La suite à donner dépend de ce que le rapport comptabilise : une hausse des événements, une baisse des réponses conformes et une hausse des tokens correspondent à des situations différentes.
Radar propose deux écrans de rapports. Radar → Vue d'ensemble résume le mois en cours : score moyen, mots générés, événements du jour et valeurs calculées par les mesures pour ces événements. Radar → Explorer représente sous forme de graphiques les événements et les réponses de type réussite/échec ou à score numérique, puis enregistre ces graphiques comme rapports pour l'organisation. Ouvrez une réponse individuelle dans Résultats pour examiner son texte et son explication. Les classifications des types de modifications ne figurent ni dans ces rapports ni dans les listes de résultats ; utilisez le taux et la distance de modification pour repérer les changements, puis lisez les textes comparés.
Dans la vue d'ensemble, survolez le nom d'une tuile pour savoir ce qu'elle comptabilise. Les tuiles de score, de mots, d'événements et Mesures du jour, ainsi qu'Explorer, nécessitent le droit d'accès aux rapports, disponible avec le forfait Enterprise ; sans ce droit, ces éléments indiquent que les rapports ne sont pas disponibles avec votre forfait.
Choisir un rapport selon la question posée #
| Question | Où chercher |
|---|---|
| Quel volume Lingo.dev a-t-il généré ce mois-ci ? | La tuile Mots générés de la vue d'ensemble, présentée dans Volume de traduction. |
| Quel volume d'activité chaque langue, moteur ou fournisseur a-t-il enregistré ? | Les Événements dans Explorer, présentés dans Volume de traduction. |
| Où les commits du dépôt ont-ils modifié le contenu localisé ? | Les événements GitHub dans Radar → Journaux, présentés dans Modifications du dépôt. |
| Comment les réponses aux mesures ont-elles évolué au cours du mois ? | Le panneau de score de la vue d'ensemble, présenté dans Résultats des évaluations. |
| Quelles réponses une mesure a-t-elle fournies, par langue ou par moteur ? | Un rapport Mesures dans Explorer, présenté dans Résultats des évaluations. |
| Avec quelle régularité les règles ou les termes ont-ils été respectés ? | Un rapport Score sur le respect des règles ou du glossaire, avec des explications individuelles dans Résultats ; voir Résultats des évaluations. |
Les séries de tokens et de coûts des modèles pour la période du compte se trouvent dans Paramètres → Utilisation, et non dans Radar ; elles sont expliquées dans Utilisation.
Créer un rapport dans Explorer #
- Ouvrez Radar → Explorer. Sélectionnez Nouveau rapport, ou ouvrez Exemples et choisissez un rapport issu de vos données pour l'adapter.
- Pour suivre une mesure numérique ou de type réussite/échec, sélectionnez-la sous Préréglage. Le rapport affiche alors les réponses à cette mesure par semaine sur les 90 derniers jours : Score avec Moyenne pour une mesure de 0 à 100, ou Valeur booléenne avec Moyenne pour une mesure de type réussite/échec. Un préréglage remplace l'ensemble du rapport, et le sélecteur n'affiche son nom que tant que le rapport lui correspond.
- Sous Données, sélectionnez Ajouter des données, choisissez ce que vous souhaitez compter ou calculer, puis la méthode : Nombre ou Valeurs uniques pour un champ, Somme ou Moyenne pour Score, et Moyenne pour Valeur booléenne. Chaque série lit les événements ou les réponses aux mesures selon les données choisies.
- Sous Filtres, sélectionnez Ajouter un filtre, choisissez un champ et utilisez est l'une des valeurs, n'est aucune des valeurs ou est vide. La liste des valeurs d'un filtre propose les valeurs les plus courantes sur l'ensemble de l'historique enregistré, et pas uniquement sur la plage sélectionnée.
- Sous Regrouper par, choisissez une Ventilation facultative, puis Puis par pour en ajouter une seconde. La ventilation ne propose que les champs présents dans toutes les séries du rapport.
- Au-dessus du graphique, choisissez une Plage de dates et la granularité sous Temps — Jour, Semaine, Mois, Année ou Total — puis, sous Graphique, choisissez le mode de représentation. Sélectionnez ensuite Enregistrer le rapport.
Chaque option de Données, Filtres et Ventilation précise sous son nom ce qu'elle contient, et chaque type d'événement proposé comme valeur de filtre en indique la signification. Le nom suggéré d'un rapport reflète ce qu'il affiche et commence par la mesure qu'il suit, par exemple MQM · Score per week. Le titre d'un graphique reprend les noms du sélecteur Données.
Choisissez parmi Graphique en courbes, Graphique en barres, Nombre, Barres horizontales, Graphique en secteurs, Carte thermique, Nuage de points et Diagramme à points selon les données et le regroupement sélectionnés. Sur un graphique temporel, Faire glisser pour zoomer réduit la plage à des périodes entières ; Réinitialiser le zoom rétablit la plage enregistrée.
Les plages de dates proposées sont 7 derniers jours, 30 derniers jours, 90 derniers jours, 12 derniers mois, soit 365 jours, et Depuis le début, à partir du premier jour contenant des données. Chaque plage se termine à la fin de la journée en cours : aujourd'hui est donc inclus même si la journée n'est pas terminée. Les jours, semaines et mois sont délimités selon le fuseau horaire de l'organisation, défini dans Paramètres → Général ; les semaines commencent le lundi. Les événements et les réponses sont positionnés selon l'heure de l'événement, et non celle du calcul de la réponse.
Une ventilation limite le nombre de groupes affichés simultanément. Les graphiques temporels conservent les 5 premiers, plus Autres. Une ventilation unique sans dimension temporelle conserve les 10 premiers, plus Autres, ou affiche d'abord 50 groupes pour Barres horizontales, Carte thermique, Diagramme à points et Nuage de points ; Afficher plus en ajoute 50. Une seconde ventilation conserve les 100 premières combinaisons. Les enregistrements dépourvus du champ apparaissent sous Non défini. Trier propose Valeurs les plus élevées d'abord et Valeurs les plus faibles d'abord pour une ventilation unique sans dimension temporelle.
Pour les séries d'événements, Filtres et Ventilation proposent Type d'événement, Langue cible, Langue source, Moteur et Fournisseur. Les séries de mesures proposent également Mesure, Type de valeur, Non applicable, Décidé par et Modèle évaluateur. Un rapport contenant à la fois des séries d'événements et de mesures peut regrouper les données selon leurs champs communs.
Conserver et partager les rapports #
Un rapport enregistré conserve son nom et sa définition : séries, filtres, regroupement, graphique et plage de dates. Il ne conserve pas les données. Son ouverture relance la requête ; un même rapport peut donc afficher des valeurs différentes par la suite. Tous les membres de l'organisation voient ses rapports et peuvent renommer, remplacer ou supprimer n'importe lequel. Un rapport supprimé ne peut pas être restauré.
Après avoir modifié un rapport enregistré, sélectionnez Enregistrer pour le remplacer, Enregistrer comme nouveau rapport pour conserver l'original, ou Abandonner. Télécharger le CSV exporte le tableau sous le graphique exactement tel qu'il s'affiche, y compris les pourcentages mis en forme, — pour les valeurs manquantes et le groupe Autres. Les groupes masqués par la limite de ventilation ne figurent pas dans le fichier.
Expliquer le calcul de la valeur principale #
Calculer la moyenne des pourcentages et regrouper les observations peut donner des résultats différents. Prenons un exemple : un jour compte 1 réussite sur 1 réponse, et un autre 0 réussite sur 9 réponses. La moyenne de leurs pourcentages quotidiens est de 50 %, mais la population combinée compte 1 réussite sur 10 réponses, soit 10 %.
Radar utilise ces deux calculs à différents endroits :
| Affichage | Calcul |
|---|---|
| Panneau de score de la vue d'ensemble | Le calcul quotidien regroupe les réponses de la journée. La valeur principale du mois correspond à la moyenne des jours ayant un score, sans pondération par le nombre de réponses. |
| Variation du score de la vue d'ensemble | La moyenne des scores quotidiens du mois jusqu'à aujourd'hui, moins celle des mêmes jours du mois précédent, en points. |
| Mots générés | La somme des mots sur le mois, comparée aux mêmes dates du mois précédent, indiquées sur la tuile, par exemple vs Oct 1 – 2. |
| Graphique Nombre d'Explorer | Une valeur calculée sur l'ensemble de la population de la plage. Sa variation est calculée par rapport à la période de même durée qui la précède immédiatement : en points pour les pourcentages, en variation relative pour les décomptes, et — lorsque la valeur précédente est absente ou égale à zéro. |
| Score → Moyenne dans Explorer | La moyenne des réponses numériques de 0 à 100 qui ne sont pas N/A. |
| Valeur booléenne → Moyenne dans Explorer | Le nombre de réponses conformes divisé par le nombre de réponses de type réussite/échec qui ne sont pas N/A. Les réponses sur une échelle de 0 à 100 sont exclues du dénominateur. |
Pour obtenir un ratio sur la population combinée, lisez une valeur calculée sur l'ensemble de la population — un graphique Nombre d'Explorer ou le totals de la réponse à la requête ci-dessous — plutôt que de faire la moyenne des points du graphique. Les jours sans valeur sont exclus de la moyenne de la vue d'ensemble, et un mois sans réponse notée affiche — plutôt que zéro.
Les populations vides demandent la même vigilance. Une valeur null, un zéro affiché et l'absence de lignes observées peuvent représenter des états différents. Les totaux de réponses ne permettent pas d'identifier les traductions éligibles qui n'ont jamais été sélectionnées ou achevées. Utilisez Résultats pour présenter le taux d'achèvement et la couverture des réponses déterminées en complément des taux de réussite.
Examiner la tendance derrière le chiffre #
Pour comprendre une variation de score, examinez des exemples pour une même mesure, puis comparez la répartition des contenus, les langues, l'échantillonnage et les consignes. Une moyenne globale peut évoluer parce qu'une langue difficile a représenté davantage de travail, ou parce qu'une autre mesure a commencé à fournir des réponses. Un classement fondé sur des observations peut suggérer une comparaison contrôlée de modèles ; il ne démontre pas que le modèle est à l'origine de la différence.
Pour analyser les modifications, examinez conjointement le taux et la distance de modification, et vérifiez l'appariement entre le brouillon et la cible. Un nombre réduit de modifications peut refléter de meilleurs brouillons, moins de relecture ou une politique d'acceptation différente. Les réponses sur les types de modifications sont structurées et ne sont pas incluses dans les mesures de score ou de taux de réussite. Le temps gagné doit être étayé séparément.
Pour les problèmes opérationnels, consultez Exécutions et Requêtes. Distinguez les étapes absentes, ignorées, en échec et achevées. L'achèvement de la traduction, l'écriture vers la destination et la publication du résultat sont des jalons distincts. Les enregistrements individuels facilitent l'analyse, mais ne fournissent pas un historique agrégé complet des transitions d'état.
Les constats d'intégrité structurelle demandent eux aussi une interprétation spécifique. Comparez les clés manquantes, les clés supplémentaires, les espaces réservés et les résultats réparés au contrat attendu. L'absence de champs d'intégrité ne prouve pas qu'une vérification a réussi, et un échec structurel ne se confond pas avec une modification d'affirmation.
Interprétez les horodatages des événements et de l'ingestion selon la signification réelle des dates dans la source. Les approbations Crowdin conservent l'heure de création de la suggestion ; l'écart peut donc inclure du temps écoulé avant l'approbation, et pas uniquement le délai de collecte. Événements explique la conséquence sur le filtre de dates. La durée de l'évaluateur correspond à un autre intervalle. Distinguez les événements associés aux chaînes du fournisseur de ceux associés aux requêtes ou aux couples tâche-langue lorsque vous calculez des décomptes ou des synthèses de délais.
Comparer les dépenses et le temps pour un même travail #
Précisez toujours l'unité de comptabilisation : requête, étape, réponse à une mesure ou période du compte. Plusieurs réponses aux mesures peuvent se rapporter à une seule requête de génération ; attribuer son coût total à chaque réponse comptabilise donc plusieurs fois la même dépense. Les totaux de tokens représentent un volume de travail, et non un montant, et les champs d'événement définis à zéro par défaut ne prouvent pas que le coût de génération est nul.
La durée d'une requête couvre un intervalle plus restreint que le temps total d'une tâche avec ses attentes en file ou en relecture. Le coût enregistré par réponse déterminée peut décrire le rendement d'une mesure, mais ne permet pas d'établir l'effort humain économisé. Coûts précise les périmètres de comptabilisation à respecter.
Conserver une analyse récurrente #
Un rapport Explorer enregistré conserve la définition de la question, mais ni le raisonnement associé ni les valeurs qu'il affichait. Conservez ces éléments avec l'analyse de l'équipe : la décision qu'elle éclaire, la population source, l'unité, les mesures, les ventilations, les filtres, l'intervalle, le fuseau horaire, la granularité temporelle, l'ordre et le traitement des groupes exclus de l'affichage des N premiers. Conservez les identifiants des mesures ainsi que leurs noms, car ces derniers peuvent changer.
Pour chaque ratio, nommez le numérateur et le dénominateur. La part d'une langue se calcule sur tous les groupes restants après filtrage, avant de masquer les plus petits. Un taux de réussite en matière de qualité utilise les réponses déterminées selon un seul critère et présente la couverture séparément. La croissance entre périodes correspond à la différence divisée par la valeur de la période précédente ; elle n'est pas définie lorsque cette valeur est égale à zéro.
Conservez le résultat observé ou la date de récupération avec la spécification. Un rapport enregistré ou une requête en direct peut renvoyer des données différentes par la suite, par exemple après qu'une évaluation historique a remplacé les réponses sur son intervalle. Un CSV téléchargé consigne ce que le rapport affichait à cet instant.
Enfin, testez la mesure à la base du rapport. Valider les constats de qualité examine si les signalements sont justifiés ; la conception des mesures examine les fausses alertes, les erreurs non détectées et la couverture. Le seul accord entre deux modèles évaluateurs ne suffit pas à établir l'exactitude.
Interroger les valeurs des rapports calculées sur l'ensemble de la population #
Envoyez du JSON avec Content-Type: application/json à https://api.lingo.dev, en vous authentifiant avec un X-API-Key côté serveur pour l'organisation visée ou un justificatif d'authentification de type Bearer accepté. Ces opérations nécessitent d'être membre de l'organisation et de disposer du droit d'accès aux rapports ; le rôle Propriétaire n'est pas requis pour la seule lecture des données analytiques. Remplacez :orgId par l'identifiant de l'organisation et ne placez pas les informations d'authentification dans le code client ni dans les spécifications des rapports enregistrés.
| Chemin POST | Mesures à demander et à lire dans totals |
|---|---|
/v2/organizations/:orgId/analytics/measurement-scores | averageScore, reviews, scored |
Pour obtenir un score sur l'ensemble de la période, utilisez ce corps avec l'opération measurement-scores, en remplaçant l'intervalle donné à titre d'exemple :
{
"measures": ["averageScore", "reviews", "scored"],
"time": {
"axis": "createdAt",
"from": "2026-10-01T00:00:00.000Z",
"to": "2026-11-01T00:00:00.000Z"
}
}Lisez totals.averageScore avec totals.reviews et totals.scored. averageScore utilise une échelle de 0 à 1 ; reviews compte toutes les réponses, y compris N/A, et scored compte celles dont la réponse est déterminée. L'omission des dimensions demande la population combinée ; les réponses regroupées calculent également les totaux sur l'ensemble de la population, indépendamment de leurs lignes. L'axe createdAt correspond à l'heure de l'événement.
Les filtres pris en charge restreignent la population : par exemple, filters: {"reviewerId":"…"} sélectionne une mesure par son identifiant, et engineId, sourceLocale et targetLocale sélectionnent les moteurs et les langues. Utilisez des identifiants réels issus des opérations de lecture des mesures. Ces opérations reposent sur des requêtes déclarées, et non sur du SQL arbitraire. Le serveur fournit le fuseau horaire de l'organisation et rejette tout timezone fourni par l'appelant ; conservez ce fuseau horaire avec les bornes explicites de l'intervalle. Une requête exécutée plus tard peut renvoyer des données différentes ; enregistrez donc les totaux observés et la date de récupération avec le calcul.
Les séries propres à Explorer utilisent /analytics/events et /analytics/measurement-answers avec la même structure de requête sur un axe eventAt ; elles renvoient des lignes sans totals. Les rapports enregistrés sont disponibles sur GET et POST /v2/organizations/:orgId/reports ainsi que GET, PATCH et DELETE /v2/reports/:id.