CSV로 번역을 대량으로 관리하는 방법 – Klaviyo - Help Center - KR

이 기능을 사용하려면 유료 Klaviyo 계정과 스마트 번역이 활성화되어 있어야 합니다.

Klaviyo 외부에서 번역을 관리하려면 CSV 파일을 내보내고 편집한 다음 다시 가져와서 번역을 대량으로 업데이트하거나 다른 사람들과 공동 작업할 수 있습니다.

번역의 CSV 내보내기

단일 메시지에 대한 현재 번역을 내보내려면 다음 단계를 따르세요:

업데이트하려는 메시지(캠페인 이메일, 플로우 이메일, SMS, WhatsApp 메시지 등)를 엽니다.
번역을 클릭하여 번역 편집기를 엽니다.
번역 편집기에서 작업 메뉴를 열고 CSV 내보내기를 클릭합니다.
내보내기 모달을 보면 Smartling CSV 또는 CSV 중에서 선택할 수 있는 옵션이 있습니다.

Smartling CSV 내보내기

브라우저에서 다음이 포함된 CSV 파일을 다운로드합니다:
1. 다음은 기본 Smartling 지시어입니다.
  
  # smartling.first_row_header=TRUE
  # smartling.paths=2
  # smartling.source_key_paths=1
  # smartling.translations_in_columns=TRUE
2. block_id - 이 메시지에서 번역 가능한 각 문자열의 고유 식별자입니다.
3. 소스 언어 코드 (예: en) - 해당 문자열의 원본 소스 텍스트입니다.

이 파일을 그대로 사용하여 스트링을 Smartling으로 가져올 수 있습니다. 그러면 Smartling이 CSV를 자동으로 구문 분석하고 스트링을 추출해 주므로 번역 작업을 트리거할 수 있습니다.

작업이 완료되면 CSV 결과를 다운로드하고 가져오기 버튼을 눌러 다시 가져옵니다.

간단한 CS 내보내기

브라우저에서 다음이 포함된 CSV 파일을 다운로드합니다:
1. block_id - 이 메시지에서 번역 가능한 각 문자열의 고유 식별자입니다.
2. 소스 - 해당 문자열의 원본 소스 텍스트입니다.
3. 언어 열 - 언어 코드(예: en, fr, es-MX)로 명명된 언어당 하나의 열입니다.

이제 Excel, Google 스프레드시트 또는 다른 스프레드시트 편집기에서 이 파일을 열 수 있습니다.

CSV 업데이트

CSV를 편집할 때는 언어 열에서만 작업하면 됩니다.

block_id 열의 값을 수정, 추가 또는 삭제하지 마세요. 행에 유효하지 않거나 누락된 block_id가 있는 경우 가져오기 중에 해당 행이 무시되고 번역이 업데이트되지 않습니다.

안전하게 변경할 수 있는 항목

CSV에서:

해당 언어 열을 편집하여 기존 번역을 업데이트합니다.
언어 열의 빈 셀을 채워 누락된 번역을 추가합니다.
해당 언어를 업데이트하지 않으려면 언어의 값을 변경하지 않고 그대로 둡니다.
새 언어 열을 하나 이상 추가합니다:
- 유효한 BCP-47 언어 코드(예: fr-CA, de, ca)를 사용합니다.
- 가져오기 시 이러한 언어가 지원되는 경우 이 메시지의 번역 편집기에 해당 언어가 추가됩니다.

변경하지 말아야 할 사항

다음을 피하세요:

block_id 값을 수정하거나 삭제하지 마세요.
행을 추가하지 마십시오. 각 행은 메시지의 기존 번역 가능한 문자열에 계속 매핑되어야 합니다.
CSV의 소스 값을 변경하지 마 세요:
- 소스 콘텐츠를 변경하려면 Klaviyo 편집기에서 직접 메시지를 편집한 다음 새 CSV를 내보냅니다.
필수 열 (블록 아이디, 소스, 언어 열)의 이름을 바꾸지 마 세요.
파일 형식을 변경하지 마세요:
- 파일을 .csv 파일로 보관 파일입니다.
- UTF-8 인코딩으로 저장합니다.

빈 셀 처리하기

CSV에서 번역 셀을 지우고 비워두는 경우:

가져오기는 빈 문자열을 값으로 취급합니다.
해당 셀의 기존 번역이 빈 값으로 덮어씌워집니다. 이렇게 하면 번역을 효과적으로 제거할 수 있습니다.

번역을 변경하지 않으려면 가져오기 전에 기존 값을 CSV에 그대로 두거나 해당 언어 열을 완전히 제거하세요.

편집이 끝나면 파일을 UTF-8로 인코딩된 .csv로 저장합니다.

CSV 가져오기

CSV를 업데이트하고 저장한 후:

번역 편집기로 돌아가 동일한 메시지를 입력합니다.
CSV 가져오기를 클릭합니다.
가져오기 모달에서도 마찬가지입니다:
- 파일 선택을 클릭하고 CSV를 선택하거나
- CSV를 업로드 영역으로 끌어다 놓습니다.
Klaviyo 는 유효성 검사 '드라이 런' 을 실행하여 보여줍니다:
- 업데이트, 변경되지 않음 또는 무시될 행 수에 대한 요약입니다.
- 감지된 모든 경고 또는 오류
요약과 경고를 주의 깊게 검토하세요.
모든 것이 올바르게 보이면 가져오기를 클릭하여 변경 사항을 적용합니다.

유효성 검사 중에 Klaviyo 또한 다음을 확인합니다:

파일 크기 및 행 제한(예: 10MB보다 큰 파일은 거부됨).
필수 열(예: block_id, 소스 및 하나 이상의 언어 열).
채널에서 인식되지 않거나 지원하지 않는 언어 코드입니다.
빈 번역 값 및 기타 잠재적 문제.

유효성 검사에 실패하면 오류 메시지가 표시되며 번역을 변경하지 않고 새 파일을 선택할 수 있습니다.

가져오기 결과 이해

유효성 검사 후 가져오기 요약에 계속 진행하면 어떤 일이 발생하는지 표시됩니다.

요약 카운트

요약에는 다음과 같은 카운트가 포함될 수 있습니다:

업데이트됨 - 하나 이상의 번역 값이 변경되는 행 수입니다.
변경되지 않음 - CSV에 존재하지만 모든 값이 이미 저장된 값과 일치하는 행입니다.
무시 / 건너뛰기 - 가져오지 않을 행(예: 이 메시지에 block_id가 존재하지 않거나 필수 데이터가 누락되어 있음)입니다.

개수는 언어별이 아니라 행별로 계산됩니다. 예를 들어 CSV에 두 개의 행과 두 개의 언어 열이 있는 경우입니다:

한 행이 한 언어로 업데이트되면 업데이트 횟수는 1이 됩니다.
한 행이 두 언어 모두에서 업데이트되는 경우에도 업데이트 횟수는 여전히 1입니다.
두 행이 모두 하나 또는 모든 언어로 업데이트되는 경우 업데이트 횟수는 2입니다.

모범 사례

번역 데이터를 정확하고 쉽게 관리할 수 있습니다:

최신 내보내기부터 시작하세요. 특히 메시지의 콘텐츠나 언어를 변경한 후에는 이전 CSV를 재사용하지 마세요.
각 내보내기의 백업을 보관하세요. 필요한 경우 롤백할 수 있도록 변경하기 전에 CSV의 사본을 저장하세요.
번역가와 협력하세요. 수정할 수 있는 열(언어 열만 해당)과 변경해서는 안 되는 열(블록_id, 소스)에 대해 설명합니다.
필요한 경우 소규모 배치로 작업하세요. 파일이 매우 큰 경우에는 여러 개의 메시지로 작업을 분할하거나 여러 개의 작은 가져오기를 실행하는 것이 좋습니다.
지원되는 언어 코드를 사용합니다. 새 언어 열을 추가할 때는 스마트 번역 문서에서 지원되는 BCP-47 코드를 사용하여 '처리할 수 없는' 언어를 피하세요.

유효성 검사 경고 및 가져오기 오류 해결

가져오기 유효성 검사 중에 경고나 오류가 표시되면 아래 섹션을 검토하여 그 의미와 해결 방법을 알아보세요.

"필수 열이 누락되었습니다."

의미 하나 이상의 필수 열(block_id 또는 source)이 누락되었거나 이름이 변경되었습니다.

해야 할 일 CSV에 block_id 및 source 열이 포함되어 있는지 확인합니다. 데이터를 새 시트에 복사한 경우 머리글 행이 원래 내보내기와 일치하는지 확인합니다.

"빈 번역 값이 있습니다. 빈 문자열은 값으로 처리됩니다."

의미 CSV에 빈 번역 값이 있으며 빈 문자열은 값으로 처리됩니다.

어떻게 해야 할까요? 계속 진행하면 해당 빈 셀이 해당 키 및 언어에 대한 기존 번역을 덮어씁니다. 이러한 번역을 변경하지 않으려면 이전 값을 복원하거나 해당 언어 열을 제거하고 파일을 다시 가져오세요.

"<count> 키가 프로젝트에 존재하지 않으며 가져오기에 포함되지 않습니다."

의미 CSV의 일부 block_id 값이 이 템플릿에 존재하지 않습니다(예: block_id 값이 수동으로 편집된 경우).

어떻게 해야 할까요? 해당 행은 무시되며 해당 키의 번역은 변경되지 않습니다. 이 문제를 해결하려면 CSV에서 해당 행을 제거하거나 필요한 경우 새 파일을 내보내세요.

"파일에 값이 충돌하는 중복 키가 포함되어 있습니다. 첫 번째 값이 사용됩니다."

의미 CSV에서 두 개 이상의 행이 동일한 block_id 값을 가지고 있습니다(예: 실수로 행이 중복된 경우).

수행할 작업: 첫 번째 행의 값이 사용되며 나머지 중복 행은 무시됩니다. 이 문제를 해결하려면 CSV에서 중복 행을 제거하거나 필요한 경우 새 파일을 내보내세요.

"여러 열이 동일한 언어로 해석됩니다. 마지막 열만 사용되며 다른 열은 무시됩니다."

의미 CSV의 두 개 이상의 열에 동일한 언어 코드가 있거나 동일한 언어로 해석됩니다(예: 언어 열이 실수로 중복된 경우).

수행할 작업 마지막 중복 열의 값이 사용되며 나머지 중복 열은 무시됩니다. 이 문제를 해결하려면 CSV에서 중복 열을 제거하거나 필요한 경우 새 파일을 내보내세요.

"파일에 이 채널에서 지원하지 않는 언어 코드가 포함된 열이 포함되어<invalid language code> 있습니다:. 이러한 로캘은 무시되지만 유효한 로캘은 가져옵니다."

의미 CSV의 열 머리글에 지원되지 않거나 인식되지 않는 언어 코드가 사용됩니다.

수행 방법 새 언어를 추가하려면 스마트 번역 문서에서 지원되는 BCP-47 코드 중 하나를 사용하세요. 지원되지 않는 코드가 있는 열은 무시됩니다.

"파일에 프로젝트에 없는 언어가 있습니다. 번역 편집기에 다음 언어가<language detected> 추가됩니다:."

의미 CSV에 현재 이 템플릿에 포함되지 않은 언어 열이 포함되어 있습니다.

해야 할 일

해당 언어를 추가하려면 목록을 검토하고 가져오기를 클릭하여 번역 편집기에 추가하세요.
열을 추가하지 않으려면 해당 열을 제거하고 파일을 다시 가져오세요.

"로캘 열을 찾을 수 없습니다."

의미 CSV에 block_id 및 source 열이 포함되어 있지만 다른 열 헤더가 감지되지 않았습니다.

수행할 작업 지원되는 언어 열을 하나 이상 추가하고 다시 시도하세요.

"유효한 로캘 열을 찾을 수 없습니다."

의미 CSV에 블록_id 및 소스 열은 포함되지만 유효한 언어 열은 없습니다.

수행할 작업 지원되는 언어 열을 하나 이상 추가하고 다시 시도하세요.

경고만 표시되고 그 영향을 이해했다면 가져오기를 계속 진행할 수 있습니다. 오류가 표시되면 계속하기 전에 CSV를 수정하고 다시 업로드해야 합니다. 오류가 계속 발생하면 번역 편집기에서 새 CSV를 내보내고 최소한의 변경만 한 다음 다시 가져 오기를 시도하여 문제를 격리하세요.

이러한 항목을 확인한 후에도 오류가 계속 표시되면 번역 편집기에서 새 CSV를 내보내고 최소한의 변경만 한 다음 다시 가져오기를 시도하여 어떤 변경 사항이 문제를 일으키는지 파악하세요.

추가 자료