Crowdin como fuente de medición
Recopila la actividad de traducción de Crowdin en Radar y utiliza mediciones definidas para analizar el texto y el proceso de edición.
Sigue creando y revisando traducciones en Crowdin y utiliza Lingo.dev para analizar su calidad. La conexión con Crowdin recibe los eventos de cadena compatibles y pone su texto a disposición de las mediciones como evidencia en Radar. Tus traducciones y tu flujo de trabajo de publicación siguen en Crowdin.
En el menú de navegación de Studio 2.5, abre Studio 2.5 → Integraciones en lugar de Configuración → Integraciones. Los enlaces de conexión y configuración que ya tenías siguen funcionando.
Un cambio en el texto de origen, una nueva sugerencia, una aprobación y una actualización del texto de destino exportado reflejan distintas partes del trabajo. La conexión mantiene esas diferencias para que cada medición pueda analizar el texto o el cambio que necesita. No genera traducciones ni devuelve textos corregidos a Crowdin.
Conecta la fuente #
- En la organización de Lingo.dev que corresponda, abre Ajustes → Integraciones y selecciona Conectar para Crowdin. Si la opción no está disponible, comprueba a qué funciones tiene acceso la organización.
- Introduce un Nombre para la conexión. Si utilizas crowdin.com, deja Dominio de Enterprise vacío. Para Crowdin Enterprise, introduce la parte anterior a
.crowdin.com, por ejemplo,acme, y selecciona Conectar. - Copia la URL del webhook proporcionada. En cada proyecto de Crowdin que quieras medir, abre Herramientas → Webhooks y añade un webhook con esa URL, el método POST y datos en formato JSON. Selecciona los eventos de cadena compatibles que se indican a continuación.
Trata la URL del webhook como una credencial: el receptor utiliza el secreto de la URL para autorizar los eventos entrantes. No la incluyas en incidencias ni en archivos del repositorio. Una misma conexión de organización puede recibir eventos de varios proyectos; cada evento identifica el proyecto al que pertenece. Anota qué proyectos has configurado para saber qué abarcan los informes posteriores.
Selecciona los eventos de cadena que necesitas #
Suscríbete a los eventos de cadena compatibles en Crowdin:
| Eventos de Crowdin | Evidencia proporcionada |
|---|---|
string.added, string.updated, string.deleted | Actividad de las cadenas de origen. |
suggestion.added, suggestion.updated, suggestion.deleted | Actividad de las traducciones propuestas. |
suggestion.approved, suggestion.disapproved | Acciones de revisión de una sugerencia. |
translation.updated | Cambio entre el texto de destino exportado anterior y el nuevo. |
En una traducción exportada, un valor anterior vacío y un valor nuevo con contenido indican una creación. Si ambos valores tienen contenido, indican una actualización; si el valor anterior tiene contenido y el nuevo está vacío, indican una eliminación. La aprobación de una sugerencia es un evento distinto del cambio en el texto de destino exportado.
Este adaptador no convierte los eventos de archivo, como file.approved y file.translated, en evidencia de cadenas. Los tipos de evento no compatibles y los eventos que no identifican el proyecto o la cadena pueden omitirse. Utiliza un evento de cadena compatible para la primera comprobación: una entrega correcta del webhook no demuestra, por sí sola, que haya evidencia utilizable.
Sigue un cambio de traducción hasta una medición #
Utiliza la medición integrada de distancia de edición para esta primera prueba. Se ejecuta cuando se crean o actualizan traducciones de destino y compara la nueva traducción con la anterior de la misma cadena. Activa la medición en Radar antes de generar la actividad de prueba.
- Elige un proyecto, una cadena y un idioma de destino conocidos para los que ya exista una traducción. Anota esa traducción y el texto que vas a aprobar.
- Aprueba una sugerencia editada mediante el flujo de trabajo habitual de revisión de Crowdin y comprueba la entrega de
translation.updatedal webhook configurado. - Busca el evento de destino correspondiente en Lingo.dev. Compara su proyecto, clave legible, idioma y texto de destino con el par de textos que has anotado. Si la traducción anterior que utiliza la medición no es la que querías comparar, comprueba los eventos anteriores de la cadena antes de interpretar la distancia.
- Abre el resultado de la distancia de edición. Comprueba la definición, los textos comparados y la respuesta numérica final. La Referencia de mediciones integradas explica su denominador y las limitaciones de las unidades de caracteres que utiliza.
Esta prueba vincula una acción del proveedor con la respuesta que interpretarás más adelante. La primera traducción de una cadena no tiene una versión anterior, por lo que la distancia de edición devuelve 0. La aprobación en sí se registra como suggestion.approved y no activa ninguna medición de edición. Las comprobaciones integradas de glosario y reglas utilizan eventos de localización completada, no ediciones ni aprobaciones de Crowdin. Para medir otro tipo de evento, configura una medición personalizada para ese evento concreto y la evidencia disponible; los activadores integrados no se pueden reasignar.
Las marcas de tiempo y las identidades de los eventos ayudan a vincular cada registro con su origen, pero su significado depende de la actividad. Los eventos de traducción y de sugerencia, incluidas las aprobaciones, utilizan el createdAt de la traducción; una aprobación recibida hoy puede figurar con una fecha de creación anterior. La hora de recepción permite distinguir los rechazos reiterados de una misma sugerencia y sustituye las marcas de tiempo ausentes o no válidas; cada aprobación se registra una sola vez por sugerencia. Comprueba el eventAt registrado al filtrar Eventos o seleccionar un periodo de medición histórico. Una extracción posterior del texto no permite volver a vincular de forma fiable todos los eventos sin una marca de tiempo. La falta de información sobre la autoría tampoco justifica atribuir un evento a una persona o a un modelo sin pruebas.
Interpreta los resultados teniendo en cuenta su cobertura #
Los webhooks recopilan la actividad configurada a partir del momento en que se entrega. No permiten conocer todas las traducciones anteriores, las revisiones del texto de origen ni el historial del proyecto. La falta de texto en los datos enviados, los eventos no compatibles y los proyectos no configurados pueden reducir la información disponible para medir. Las entregas repetidas de acciones de revisión pueden generar registros de evidencia independientes, por lo que el número de eventos no equivale necesariamente al de traducciones únicas revisadas.
Separa los registros a los que no se aplica un criterio de aquellos a los que sí se aplica, pero que carecen del texto necesario. En las evaluaciones, distingue entre respuestas completadas, respuestas indeterminadas completadas y trabajo sin una respuesta completada. Una respuesta indeterminada deja constancia de que la evaluación se ha completado, pero no permite concluir si se cumple o se incumple el criterio.
Al informar de una tasa de cumplimiento, utiliza las respuestas determinadas como denominador e indica qué proporción del contenido elegible recibió una respuesta determinada. La ausencia de una evaluación no demuestra que la traducción sea de mala calidad. Del mismo modo, una aprobación de Crowdin refleja el proceso de revisión de ese proyecto, pero no demuestra por sí sola la corrección semántica. Diseña una medición de la calidad de traducción explica el cálculo y su interpretación.
Soluciona los problemas de entrega o retira la fuente #
Si deja de aparecer evidencia, comprueba las suscripciones del webhook del proyecto, el tipo de evento, los errores de entrega y la URL de destino. Confirma que envía solicitudes POST con JSON a la URL actual del webhook de la conexión. La conexión no recupera automáticamente los eventos que no se recibieron. Para evaluar eventos ya recopilados en Lingo.dev, utiliza el flujo de trabajo de medición histórica.
Si la URL del webhook queda expuesta o necesitas sustituirla, abre la conexión en Ajustes → Integraciones, elige Renovar y confirma con Renovar URL. La URL anterior deja de funcionar de inmediato. Copia la nueva URL en todos los proyectos de Crowdin configurados y comprueba después la entrega de un evento compatible y su evidencia en Radar.
Al desconectar, se deja de recibir nueva evidencia de esa conexión; las mediciones registradas se conservan. Elimina por separado los webhooks de los proyectos de Crowdin. Las traducciones y las acciones de revisión de Crowdin no cambian. En los informes que abarquen una desconexión, ten en cuenta el periodo sin recopilación: no lo interpretes como un periodo sin trabajo de traducción.