Source de mesure Crowdin

Collectez l’activité de traduction de Crowdin dans Radar et utilisez des mesures définies pour analyser le texte et le processus de modification.

Continuez à produire et à relire vos traductions dans Crowdin, tout en analysant leur qualité avec Lingo.dev. La connexion Crowdin reçoit les événements pris en charge au niveau des chaînes et met leur texte à disposition dans Radar comme éléments d’analyse pour les mesures. Vos traductions et votre workflow de publication restent dans Crowdin.

Dans le menu de navigation de Studio 2.5, ouvrez Studio 2.5 → Intégrations plutôt que Paramètres → Intégrations. Les liens de connexion et de configuration existants restent valides.

Une modification de la source, une nouvelle suggestion, une approbation et une mise à jour du texte cible exporté correspondent à différentes étapes du travail. La connexion préserve ces distinctions pour que chaque mesure puisse examiner le texte ou la modification dont elle a réellement besoin. Elle ne génère pas de traductions et ne renvoie pas de formulations corrigées à Crowdin.

Connecter la source #

  1. Dans l’organisation Lingo.dev concernée, ouvrez Paramètres → Intégrations et sélectionnez Connecter pour Crowdin. Si cette option n’est pas disponible, vérifiez que l’organisation a accès à cette fonctionnalité.
  2. Saisissez un Nom pour la connexion. Laissez le champ Domaine Enterprise vide pour crowdin.com. Pour Crowdin Enterprise, saisissez la partie qui précède .crowdin.com, par exemple acme, puis sélectionnez Connecter.
  3. Copiez l’URL du webhook fournie. Dans chaque projet Crowdin que vous souhaitez mesurer, ouvrez Outils → Webhooks et ajoutez un webhook avec cette URL, la méthode POST et des données au format JSON. Sélectionnez les événements de chaîne pris en charge indiqués ci-dessous.

Traitez l’URL du webhook comme un identifiant d’accès : le récepteur utilise le secret qu’elle contient pour autoriser les événements entrants. Ne la faites pas figurer dans des tickets ni dans les fichiers du dépôt. Une connexion d’organisation peut recevoir des événements de plusieurs projets ; chaque événement contient l’identité de son projet. Notez les projets configurés pour savoir ce que couvrira un rapport ultérieur.

Sélectionner les événements de chaîne nécessaires #

Abonnez-vous aux événements pris en charge au niveau des chaînes dans Crowdin :

Événements CrowdinÉléments d’analyse fournis
string.added, string.updated, string.deletedActivité sur les chaînes sources.
suggestion.added, suggestion.updated, suggestion.deletedActivité sur les traductions proposées.
suggestion.approved, suggestion.disapprovedActions de relecture sur une suggestion.
translation.updatedLa différence entre l’ancien et le nouveau texte cible exporté.

Pour une traduction exportée, une ancienne valeur vide et une nouvelle valeur présente indiquent une création. Deux valeurs présentes indiquent une mise à jour ; une ancienne valeur présente et une nouvelle valeur vide indiquent une suppression. L’approbation d’une suggestion est un événement distinct d’une modification du texte cible exporté.

Cet adaptateur ne transforme pas les événements au niveau des fichiers, tels que file.approved et file.translated, en éléments d’analyse au niveau des chaînes. Les types d’événements non pris en charge et les événements sans identité de projet ou de chaîne peuvent être ignorés. Pour la première vérification, utilisez un événement de chaîne pris en charge : la livraison réussie d’un webhook ne suffit pas à prouver que des éléments d’analyse exploitables sont disponibles.

Suivre une modification de traduction jusqu’à une mesure #

Pour ce premier test, utilisez la mesure intégrée distance d’édition. Elle s’exécute lors de la création ou de la mise à jour d’un texte cible et compare le nouveau texte à la traduction précédente de la chaîne. Activez la mesure dans Radar avant de créer l’activité de test.

  1. Choisissez un projet, une chaîne et une langue cible que vous connaissez, avec une traduction déjà existante. Notez cette traduction et le texte que vous allez approuver.
  2. Approuvez une suggestion modifiée via le workflow de relecture habituel de Crowdin, puis vérifiez la livraison de translation.updated au webhook configuré.
  3. Retrouvez l’événement cible correspondant dans Lingo.dev. Comparez son projet, sa clé lisible, sa langue et son texte cible à la paire de textes notée. Si la traduction précédente utilisée par la mesure n’est pas celle que vous souhaitiez comparer, vérifiez les événements antérieurs de la chaîne avant d’interpréter la distance.
  4. Ouvrez le résultat de la distance d’édition. Vérifiez la définition, les textes comparés et la réponse numérique finale. La référence des mesures intégrées explique le dénominateur utilisé et les limites liées aux unités de caractères.

Ce test relie une action du fournisseur à la réponse que vous interpréterez ensuite. La première traduction d’une chaîne n’a pas de version antérieure : la distance d’édition renvoie donc 0. L’approbation elle-même est enregistrée en tant que suggestion.approved et ne déclenche aucune mesure de modification. Les vérifications intégrées du glossaire et des règles utilisent les événements de localisation terminée, et non les modifications ou les approbations de Crowdin. Pour mesurer un autre type d’événement, configurez une mesure personnalisée pour cet événement précis et les éléments d’analyse disponibles ; les déclencheurs intégrés ne peuvent pas être réaffectés.

Les horodatages et les identités associés aux événements permettent de relier un enregistrement à sa source, mais leur signification dépend de l’activité. Les événements de traduction et de suggestion, y compris les approbations, utilisent le createdAt de la traduction ; une approbation reçue aujourd’hui peut donc apparaître à une date de création antérieure. L’heure de réception permet de distinguer les refus répétés d’une même suggestion et remplace les horodatages manquants ou invalides ; une approbation n’est enregistrée qu’une fois par suggestion. Vérifiez le eventAt enregistré lorsque vous filtrez les Événements ou sélectionnez une période de mesure passée. Une extraction ultérieure du texte ne permet pas de réassocier de façon fiable tous les événements dépourvus d’horodatage. L’absence d’information sur l’auteur ne justifie pas non plus d’attribuer un événement à une personne ou à un modèle sans preuve.

Lire les résultats en tenant compte de leur couverture #

Les webhooks collectent l’activité configurée à partir du moment où elle est livrée. Ils ne permettent pas de reconstituer toutes les traductions antérieures, les révisions de la source ou l’historique du projet. L’absence de texte dans les données reçues, les événements non pris en charge et les projets non configurés peuvent tous limiter les éléments disponibles pour les mesures. Les livraisons répétées d’actions de relecture peuvent produire des enregistrements d’analyse distincts ; le nombre d’événements ne correspond donc pas nécessairement au nombre de traductions uniques relues.

Distinguez les enregistrements qui ne correspondent pas à un critère de ceux auxquels il s’applique, mais pour lesquels le texte requis manque. Parmi les évaluations, distinguez les réponses finalisées, les réponses indéterminées finalisées et les travaux sans réponse finalisée. Une réponse indéterminée atteste que l’évaluation est terminée, mais ne permet de conclure ni à une réussite ni à un échec.

Lorsque vous présentez un taux de réussite, utilisez les réponses déterminées comme dénominateur et précisez quelle quantité de contenu admissible a reçu une réponse déterminée. L’absence d’évaluation ne prouve pas que la traduction est de mauvaise qualité. De même, une approbation Crowdin reflète le processus de relecture du projet, mais ne constitue pas une preuve indépendante d’exactitude sémantique. Concevoir une mesure de la qualité des traductions détaille le calcul et son interprétation.

Rétablir la livraison ou retirer la source #

Si les éléments d’analyse cessent d’apparaître, vérifiez les abonnements aux webhooks du projet, le type d’événement, les erreurs de livraison et l’URL de destination. Assurez-vous que le webhook envoie des requêtes POST avec des données JSON à l’URL actuelle du webhook de la connexion. La connexion ne récupère pas automatiquement les événements manqués. Pour évaluer les événements déjà collectés dans Lingo.dev, utilisez le workflow de mesure historique.

Si l’URL du webhook a été divulguée ou doit être remplacée, ouvrez la connexion dans Paramètres → Intégrations, choisissez Renouveler, puis confirmez avec Renouveler l’URL. L’ancienne URL cesse immédiatement de fonctionner. Copiez la nouvelle URL dans chaque projet Crowdin configuré, puis vérifiez la livraison d’un événement pris en charge et la présence de ses éléments d’analyse dans Radar.

La déconnexion interrompt l’arrivée de nouveaux éléments d’analyse depuis la connexion ; les mesures enregistrées restent disponibles. Supprimez séparément les webhooks des projets Crowdin. Les traductions et les actions de relecture dans Crowdin restent inchangées. Pour les rapports couvrant une déconnexion, tenez compte de la période sans collecte plutôt que de l’interpréter comme une période sans travail de traduction.