Crowdin 측정 소스

레이더에서 Crowdin 번역 활동을 수집하고, 정의된 측정을 활용해 텍스트와 편집 과정을 살펴보세요.

Crowdin에서 번역과 검토를 계속하면서 Lingo.dev로 품질을 살펴보세요. Crowdin 연결은 지원되는 문자열 단위 이벤트를 수신하고, 해당 텍스트를 레이더에서 측정 근거로 활용할 수 있게 합니다. 번역과 게시 워크플로는 그대로 Crowdin에서 진행됩니다.

Studio 2.5 탐색 메뉴에서 설정 → 연동 대신 Studio 2.5 → 연동을 여세요. 기존 연결 및 설정 링크는 그대로 사용할 수 있습니다.

원문 변경, 새 제안, 승인, 내보낸 대상 텍스트의 업데이트는 작업의 서로 다른 부분을 나타냅니다. 연결은 이 차이를 그대로 유지하므로 각 측정에 실제로 필요한 텍스트나 변경 사항을 살펴볼 수 있습니다. 번역을 생성하거나 수정된 문구를 Crowdin으로 다시 보내지는 않습니다.

소스 연결 #

  1. 연결하려는 Lingo.dev 조직에서 설정 → 연동을 열고 Crowdin의 연결을 선택하세요. 사용할 수 없다면 조직의 해당 기능 이용 권한을 확인하세요.
  2. 연결의 이름을 입력하세요. crowdin.com을 사용한다면 Enterprise 도메인은 비워 두세요. Crowdin Enterprise를 사용한다면 .crowdin.com 앞부분을 acme와 같이 입력한 다음 연결을 선택하세요.
  3. 제공된 웹훅 주소를 복사하세요. 측정하려는 각 Crowdin 프로젝트에서 도구 → 웹훅을 열고, 해당 주소와 POST 메서드, JSON 페이로드를 사용하는 웹훅을 추가하세요. 아래에 나열된 지원 문자열 이벤트를 선택하세요.

웹훅 주소는 자격 증명처럼 안전하게 관리하세요. 수신기는 주소에 포함된 비밀값으로 수신 이벤트를 인증합니다. 티켓이나 저장소 파일에 주소를 포함하지 마세요. 하나의 조직 연결로 여러 프로젝트의 이벤트를 수신할 수 있으며, 각 이벤트에는 프로젝트 식별 정보가 포함됩니다. 나중에 보고서의 범위를 파악할 수 있도록 설정한 프로젝트를 기록해 두세요.

필요한 문자열 이벤트 선택 #

Crowdin에서 지원되는 문자열 단위 이벤트를 구독하세요.

Crowdin 이벤트제공되는 근거
string.added, string.updated, string.deleted원문 문자열 관련 활동.
suggestion.added, suggestion.updated, suggestion.deleted번역 후보 관련 활동.
suggestion.approved, suggestion.disapproved제안에 대한 검토 작업.
translation.updated내보낸 대상 텍스트의 이전 값과 새 값 간 변경 사항.

내보낸 번역에서 이전 값이 비어 있고 새 값이 있으면 생성을 뜻합니다. 두 값이 모두 있으면 업데이트를, 이전 값이 있고 새 값이 비어 있으면 삭제를 뜻합니다. 제안 승인은 내보낸 대상 텍스트의 변경과는 별개의 이벤트입니다.

file.approved 및 file.translated 같은 파일 단위 이벤트는 이 어댑터를 통해 문자열 근거로 변환되지 않습니다. 지원되지 않는 이벤트 유형이나 프로젝트 또는 문자열 식별 정보가 없는 이벤트는 건너뛸 수 있습니다. 웹훅 전송에 성공했다는 사실만으로 활용 가능한 근거가 확보되었다고 판단하지 마세요. 첫 검증에는 지원되는 문자열 이벤트를 사용하세요.

번역 변경 하나가 측정으로 이어지는 과정 확인 #

첫 테스트에는 기본 제공 편집 거리 측정을 사용하세요. 이 측정은 대상 텍스트가 생성되거나 업데이트될 때 실행되며, 새 대상 텍스트를 해당 문자열의 이전 번역과 비교합니다. 테스트 활동을 만들기 전에 레이더에서 측정을 활성화하세요.

  1. 이미 번역이 있는 프로젝트, 문자열, 대상 언어 중 확인하기 쉬운 조합을 선택하세요. 기존 번역과 승인할 텍스트를 기록해 두세요.
  2. Crowdin의 일반적인 검토 워크플로에 따라 수정된 제안을 승인하고, 설정한 웹훅으로 translation.updated이 전송되는지 확인하세요.
  3. Lingo.dev에서 해당 대상 이벤트를 찾으세요. 이벤트의 프로젝트, 사람이 읽을 수 있는 키, 로캘, 대상 텍스트가 기록해 둔 두 텍스트의 정보와 일치하는지 확인하세요. 측정에 사용된 이전 번역이 의도한 비교 대상이 아니라면, 편집 거리를 해석하기 전에 해당 문자열의 이전 이벤트를 확인하세요.
  4. 편집 거리 결과를 여세요. 측정 정의와 비교한 텍스트, 계산이 완료된 수치 결과를 확인하세요. 분모와 문자 단위의 제약은 기본 제공 측정 레퍼런스에서 설명합니다.

이 테스트를 통해 제공업체에서 수행한 작업 하나가 나중에 해석할 결과로 어떻게 이어지는지 확인할 수 있습니다. 문자열의 첫 번역에는 이전 버전이 없으므로 편집 거리 결과는 0입니다. 승인 자체는 suggestion.approved으로 기록되며 어떤 편집 측정도 실행하지 않습니다. 기본 제공 용어집 및 규칙 검사는 Crowdin의 편집이나 승인 이벤트가 아니라 로컬라이제이션 완료 이벤트를 사용합니다. 다른 이벤트 유형을 측정하려면 해당 이벤트와 사용 가능한 근거에 맞춰 사용자 지정 측정을 설정하세요. 기본 제공 트리거는 다른 이벤트에 재지정할 수 없습니다.

이벤트의 타임스탬프와 식별 정보는 기록을 출처와 연결하는 데 도움이 되지만, 그 의미는 활동에 따라 달라집니다. 승인을 포함한 번역 및 제안 이벤트는 해당 번역의 createdAt 값을 사용하므로, 오늘 접수된 승인도 과거의 생성 날짜에 표시될 수 있습니다. 수신 시각은 동일한 제안에 대한 반복적인 승인 거부를 구분하고, 타임스탬프가 없거나 유효하지 않을 때 이를 대신합니다. 승인은 제안당 한 번만 기록됩니다. 이벤트를 필터링하거나 과거 측정 기간을 선택할 때는 기록된 eventAt 값을 확인하세요. 나중에 텍스트를 추출하더라도 타임스탬프가 없으면 모든 이벤트를 정확하게 다시 연결하기는 어렵습니다. 작성자 정보가 없다는 이유만으로 근거 없이 이벤트를 사람이나 모델의 활동으로 판단해서도 안 됩니다.

측정 범위를 고려해 결과 읽기 #

웹훅은 수집 대상으로 설정된 활동이 전송되는 시점부터 이를 수집합니다. 그 이전의 모든 번역, 원문 수정, 프로젝트 이력을 확보해 주지는 않습니다. 페이로드의 텍스트 누락, 지원되지 않는 이벤트, 설정되지 않은 프로젝트는 모두 측정 가능한 범위를 줄일 수 있습니다. 검토 이벤트가 반복 전송되면 별도의 근거 기록이 생성될 수 있으므로, 이벤트 수가 반드시 중복을 제외한 검토된 번역 수와 같지는 않습니다.

기준에 해당하지 않는 기록과, 기준에 해당하지만 필수 텍스트가 누락된 기록을 구분하세요. 평가에서는 결과가 나온 경우, 평가를 완료했지만 판정 불가로 나온 경우, 아직 결과가 나오지 않은 경우를 구분하세요. 판정 불가 결과는 평가 작업이 완료되었음을 나타내지만, 통과와 실패 어느 쪽의 근거도 되지 않습니다.

통과율을 보고할 때는 판정이 가능한 결과 수를 분모로 사용하고, 평가 대상 콘텐츠 중 판정 가능한 결과를 얻은 비중도 함께 보고하세요. 평가가 없다고 해서 번역 품질이 낮다는 뜻은 아닙니다. 또한 Crowdin의 승인은 해당 프로젝트의 검토 과정을 나타낼 뿐, 의미적 정확성을 독립적으로 입증하지는 않습니다. 계산과 해석에 관한 자세한 내용은 번역 품질 측정 설계에서 확인하세요.

전송 문제 해결 또는 소스 사용 종료 #

근거가 더 이상 표시되지 않으면 프로젝트의 웹훅 구독, 이벤트 유형, 전송 오류, 대상 주소를 확인하세요. 연결의 현재 웹훅 주소로 JSON을 담은 POST 요청을 보내는지 확인하세요. 연결은 누락된 이벤트를 자동으로 소급 수집하지 않습니다. Lingo.dev에 이미 수집된 이벤트를 평가하려면 과거 데이터 측정 워크플로를 사용하세요.

웹훅 주소가 노출되었거나 교체가 필요하다면 설정 → 연동에서 연결을 열고 교체를 선택한 다음 주소 교체로 확정하세요. 이전 주소는 즉시 작동을 멈춥니다. 설정된 모든 Crowdin 프로젝트에 새 주소를 복사해 넣은 다음, 지원되는 이벤트가 전송되고 해당 근거가 레이더에 표시되는지 확인하세요.

연결을 해제하면 해당 연결을 통한 새 근거 수집은 중단되지만, 기록된 측정 결과는 유지됩니다. Crowdin 프로젝트의 웹훅은 별도로 제거하세요. Crowdin의 번역과 검토 작업에는 변화가 없습니다. 연결 해제 전후에 걸친 보고서를 작성할 때는 수집 공백을 고려하세요. 수집이 중단된 기간을 번역 작업이 없었던 기간으로 해석해서는 안 됩니다.