Crowdin como fonte de medição
Colete atividades de tradução do Crowdin no Radar e use medições definidas para analisar o texto e o processo de edição.
Continue produzindo e revisando traduções no Crowdin enquanto usa o Lingo.dev para analisar a qualidade delas. A conexão com o Crowdin recebe eventos compatíveis no nível de string e disponibiliza os textos desses eventos como evidências para medições no Radar. Suas traduções e seu workflow de publicação continuam no Crowdin.
No menu do Studio 2.5, acesse Studio 2.5 → Integrações em vez de Configurações → Integrações. Os links de conexão e configuração existentes continuam funcionando.
Uma alteração no texto de origem, uma nova sugestão, uma aprovação e uma atualização do texto de destino exportado representam etapas diferentes do trabalho. A conexão preserva essas diferenças para que cada medição possa analisar exatamente o texto ou a alteração de que precisa. Ela não gera traduções nem envia textos corrigidos de volta ao Crowdin.
Conecte a fonte #
- Na organização desejada do Lingo.dev, abra Configurações → Integrações e selecione Conectar para o Crowdin. Se a opção não estiver disponível, verifique se a organização tem acesso ao recurso.
- Insira um Nome para a conexão. Para crowdin.com, deixe Domínio Enterprise em branco. Para o Crowdin Enterprise, insira a parte que vem antes de
.crowdin.com, comoacme, e selecione Conectar. - Copie a URL do webhook fornecida. Em cada projeto do Crowdin que você deseja medir, abra Ferramentas → Webhooks e adicione um webhook com essa URL, o método POST e dados no formato JSON. Selecione os eventos de string compatíveis listados abaixo.
Trate a URL do webhook como uma credencial: o receptor usa o segredo contido nela para autorizar os eventos recebidos. Não a inclua em chamados nem em arquivos do repositório. Uma única conexão da organização pode receber eventos de vários projetos; cada evento traz a identificação do projeto de origem. Registre quais projetos você configurou para saber o que os relatórios futuros abrangem.
Selecione os eventos de string necessários #
No Crowdin, configure o recebimento dos eventos compatíveis no nível de string:
| Eventos do Crowdin | Evidências fornecidas |
|---|---|
string.added, string.updated, string.deleted | Atividade na string de origem. |
suggestion.added, suggestion.updated, suggestion.deleted | Atividade nas traduções candidatas. |
suggestion.approved, suggestion.disapproved | Ações de revisão em uma sugestão. |
translation.updated | A alteração entre a versão anterior e a nova do texto de destino exportado. |
Em uma tradução exportada, um valor anterior vazio e um novo valor preenchido indicam criação. Dois valores preenchidos indicam atualização; um valor anterior preenchido e um novo valor vazio indicam exclusão. A aprovação de uma sugestão é um evento distinto de uma alteração no texto de destino exportado.
Eventos no nível de arquivo, como file.approved e file.translated, não geram evidências de string por meio deste adaptador. Tipos de evento não compatíveis e eventos sem identificação do projeto ou da string podem ser ignorados. Na primeira verificação, use um evento de string compatível, em vez de considerar qualquer entrega bem-sucedida de webhook como prova de que há evidências utilizáveis.
Acompanhe uma alteração de tradução até uma medição #
Neste primeiro teste, use a medição integrada de distância de edição. Ela é executada quando um texto de destino é criado ou atualizado e compara o novo texto com a tradução anterior da string. Ative a medição no Radar antes de gerar a atividade de teste.
- Escolha um projeto, uma string e um idioma de destino que você conheça e para os quais já exista uma tradução. Registre essa tradução e o texto que você vai aprovar.
- Aprove uma sugestão editada pelo workflow habitual de revisão do Crowdin e verifique a entrega de
translation.updatedao webhook configurado. - Localize o evento de destino correspondente no Lingo.dev. Compare o projeto, a chave legível, o idioma e o texto de destino do evento com o par registrado. Se a tradução anterior usada pela medição não for a que você pretendia comparar, verifique os eventos anteriores da string antes de interpretar a distância.
- Abra o resultado da distância de edição. Confira a definição, os textos comparados e a resposta numérica da medição concluída. A referência de medições integradas explica o denominador e as limitações relacionadas às unidades de caracteres.
Este teste liga uma ação no provedor à resposta que você vai interpretar depois. A primeira tradução de uma string não tem versão anterior, por isso a distância de edição retorna 0 nesse caso. A aprovação em si é registrada como suggestion.approved e não aciona nenhuma das medições de edição. As verificações integradas de glossário e regras processam eventos de localização concluída, não edições ou aprovações do Crowdin. Para medir outro tipo de evento, configure uma medição personalizada para esse evento específico e as evidências disponíveis nele; os gatilhos integrados não podem ser reatribuídos.
Os registros de data e hora e as identidades dos eventos ajudam a associar cada registro à sua origem, mas seu significado depende da atividade. Eventos de tradução e sugestão, incluindo aprovações, usam o createdAt da tradução; uma aprovação recebida hoje pode aparecer sob uma data de criação anterior. O horário de recebimento diferencia rejeições repetidas de uma mesma sugestão e substitui registros de data e hora ausentes ou inválidos; uma aprovação é registrada apenas uma vez por sugestão. Confira o eventAt registrado ao filtrar Eventos ou selecionar um período histórico de medição. Uma extração posterior de texto não permite reassociar com segurança todos os eventos sem um registro de data e hora. A ausência de autoria também não justifica atribuir um evento a uma pessoa ou a um modelo sem evidências.
Leia os resultados considerando sua cobertura #
Os webhooks coletam as atividades configuradas à medida que elas são entregues. Eles não reconstituem todas as traduções anteriores, as revisões do texto de origem ou o histórico do projeto. A ausência de texto nos dados enviados, os eventos não compatíveis e os projetos não configurados podem reduzir o conteúdo disponível para medição. Entregas repetidas de ações de revisão podem gerar registros de evidência separados, portanto a contagem de eventos não corresponde necessariamente ao número de traduções distintas revisadas.
Separe os registros aos quais um critério não se aplica dos registros aplicáveis que não contêm o texto necessário. Nas avaliações, diferencie as respostas concluídas, as respostas concluídas com resultado indeterminado e os trabalhos sem resposta concluída. Uma resposta indeterminada registra um trabalho de avaliação concluído, mas não permite concluir nem pela aprovação nem pela reprovação.
Ao apresentar uma taxa de aprovação, use como denominador as respostas com resultado determinado e informe quanto do conteúdo elegível recebeu esse tipo de resposta. A ausência de avaliação não comprova baixa qualidade da tradução, e uma aprovação no Crowdin reflete o processo de revisão daquele projeto, sem comprovar de forma independente a correção semântica. O guia Crie uma medição de qualidade de tradução detalha o cálculo e a interpretação.
Corrija a entrega ou desative a fonte #
Se as evidências pararem de aparecer, verifique as inscrições de eventos nos webhooks do projeto, o tipo de evento, os erros de entrega e a URL de destino. Confirme que o webhook envia solicitações POST com dados em JSON para a URL atual do webhook da conexão. A conexão não recupera automaticamente os eventos perdidos. Para avaliar eventos já coletados no Lingo.dev, use o workflow de medição histórica.
Se a URL do webhook for exposta ou precisar ser substituída, abra a conexão em Configurações → Integrações, escolha Rotacionar e confirme com Rotacionar URL. A URL antiga deixa de funcionar imediatamente. Copie a nova URL para todos os projetos do Crowdin configurados e, em seguida, verifique a entrega de um evento compatível e suas evidências no Radar.
Desconectar interrompe o recebimento de novas evidências dessa conexão; as medições registradas permanecem. Remova os webhooks dos projetos do Crowdin separadamente. As traduções e as ações de revisão no Crowdin não são alteradas. Em relatórios que abrangem uma desconexão, leve em conta o período sem coleta, em vez de interpretá-lo como um período sem trabalho de tradução.