Fuente de medición de Crowdin

Recopila la actividad de traducción de Crowdin en Radar y usa mediciones definidas para analizar el texto y el proceso de edición.

Sigue creando y revisando traducciones en Crowdin mientras usas Lingo.dev para analizar su calidad. La conexión con Crowdin recibe eventos compatibles a nivel de cadena y permite usar su texto como evidencia para las mediciones en Radar. Tus traducciones y tu flujo 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 tienes 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 conserva esas diferencias para que cada medición pueda analizar el texto o el cambio que necesita. No genera traducciones ni envía texto corregido a Crowdin.

Conecta la fuente #

  1. En la organización de Lingo.dev que quieras usar, abre Configuración → Integraciones y selecciona Conectar para Crowdin. Si la opción no está disponible, verifica el acceso de la organización a la función.
  2. Ingresa un Nombre para la conexión. Deja Dominio de Enterprise vacío para crowdin.com. Para Crowdin Enterprise, ingresa la parte que aparece antes de .crowdin.com, como acme, y luego selecciona Conectar.
  3. Copia la URL del webhook proporcionada. En cada proyecto de Crowdin que quieras medir, abre Herramientas → Webhooks y agrega 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 usa su secreto para autorizar los eventos entrantes. No la incluyas en tickets ni en archivos del repositorio. Una conexión de la organización puede recibir eventos de varios proyectos; cada evento incluye la identidad de su proyecto. Registra qué proyectos configuraste para saber qué abarcarán los informes posteriores.

Selecciona los eventos de cadena que necesitas #

Suscríbete a los eventos compatibles a nivel de cadena en Crowdin:

Eventos de CrowdinEvidencia proporcionada
string.added, string.updated, string.deletedActividad de las cadenas de origen.
suggestion.added, suggestion.updated, suggestion.deletedActividad de las traducciones propuestas.
suggestion.approved, suggestion.disapprovedAcciones de revisión sobre una sugerencia.
translation.updatedEl 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 presente indican una creación. Si ambos valores están presentes, indican una actualización; si el valor anterior está presente 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.

Los eventos a nivel de archivo, como file.approved y file.translated, no se convierten en evidencia de cadenas mediante este adaptador. Los tipos de eventos no compatibles y los eventos sin identidad de proyecto o de cadena pueden omitirse. Para la primera verificación, usa un evento de cadena compatible: una entrega exitosa del webhook, por sí sola, no demuestra que haya evidencia utilizable.

Sigue un cambio de traducción hasta una medición #

Usa la medición integrada de distancia de edición para esta primera prueba. Se ejecuta cuando se crea o actualiza un texto de destino y compara el nuevo texto con la traducción anterior de la cadena. Habilita la medición en Radar antes de generar la actividad de prueba.

  1. Selecciona un proyecto, una cadena y un idioma de destino conocidos para los que ya exista una traducción. Registra esa traducción y el texto que aprobarás.
  2. Aprueba una sugerencia editada mediante el flujo de revisión habitual de Crowdin y revisa la entrega de translation.updated al webhook configurado.
  3. Busca el evento de destino correspondiente en Lingo.dev. Compara su proyecto, clave legible, idioma y texto de destino con el par de textos registrado. Si la traducción anterior que usa la medición no es la que querías comparar, revisa los eventos anteriores de la cadena antes de interpretar la distancia.
  4. Abre el resultado de distancia de edición. Confirma la definición, los textos comparados y la respuesta numérica final. La Referencia de mediciones integradas explica su denominador y los límites de las unidades de caracteres que utiliza.

Esta prueba vincula una acción del proveedor con la respuesta que interpretarás después. 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 de las mediciones de edición. Las comprobaciones integradas de glosario y reglas usan 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 específico y la evidencia disponible; los activadores integrados no se pueden reasignar.

Las marcas de tiempo y las identidades de los eventos ayudan a vincular un registro con su origen, pero su significado depende de la actividad. Los eventos de traducción y de sugerencias, incluidas las aprobaciones, usan el createdAt de la traducción; una aprobación recibida hoy puede aparecer con una fecha de creación anterior. La hora de recepción permite distinguir los rechazos repetidos de una misma sugerencia y reemplaza las marcas de tiempo faltantes o no válidas; la aprobación se registra una sola vez por sugerencia. Revisa el eventAt registrado al filtrar Eventos o seleccionar un período histórico de medición. Una extracción de texto posterior no permite volver a vincular de forma confiable todos los eventos que carecen de 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 evidencia.

Interpreta los resultados según su cobertura #

Los webhooks recopilan la actividad configurada a partir del momento en que se entrega. No permiten reconstruir todas las traducciones anteriores, las revisiones del texto de origen ni el historial del proyecto. La ausencia 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 separados, por lo que el número de eventos no necesariamente equivale al número de traducciones únicas revisadas.

Separa los registros a los que no aplica un criterio de aquellos a los que sí aplica, pero les falta el texto requerido. Entre las evaluaciones, distingue las respuestas completadas, las respuestas indeterminadas completadas y el trabajo que aún no tiene una respuesta completada. Una respuesta indeterminada indica que la evaluación se completó, pero no permite concluir que el criterio se cumple o se incumple.

Al informar una tasa de cumplimiento, usa las respuestas concluyentes como denominador e indica qué proporción del contenido elegible recibió una respuesta concluyente. La ausencia de una evaluación no demuestra una mala calidad de traducción, y una aprobación de Crowdin refleja el proceso de revisión de ese proyecto, sin probar por sí sola la corrección semántica. Diseña una medición de calidad de traducción explica en detalle el cálculo y la interpretación.

Soluciona problemas de entrega o retira la fuente #

Si deja de aparecer evidencia, revisa las suscripciones del webhook del proyecto, el tipo de evento, los errores de entrega y la URL de destino. Confirma que envíe 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, usa el flujo de trabajo de medición histórica.

Si la URL del webhook queda expuesta o necesitas reemplazarla, abre la conexión en Configuración → Integraciones, elige Rotar y confirma con Rotar URL. La URL anterior deja de funcionar de inmediato. Copia la nueva URL en cada proyecto de Crowdin configurado y luego verifica la entrega de un evento compatible y su evidencia en Radar.

Al desconectar la fuente, se detiene la recepción de nueva evidencia desde esa conexión; las mediciones registradas se conservan. Elimina los webhooks de los proyectos de Crowdin por separado. Las traducciones y las acciones de revisión de Crowdin no cambian. En los informes que abarquen una desconexión, ten en cuenta el período sin recopilación de datos en lugar de interpretarlo como un período sin trabajo de traducción.