CSV로 번역을 대량으로 관리하는 방법

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

번역의 CSV 내보내기

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

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

Smartling CSV 내보내기

1. 브라우저에서 다음이 포함된 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 내보내기

1. 브라우저에서 다음이 포함된 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를 업데이트하고 저장한 후:

1. 번역 편집기로 돌아가 동일한 메시지를 입력합니다.
2. CSV 가져오기를 클릭합니다.

3. 가져오기 모달에서도 마찬가지입니다:

   • 파일 선택을 클릭하고 CSV를 선택하거나
   • CSV를 업로드 영역으로 끌어다 놓습니다.

   

4. Klaviyo 는 유효성 검사 '드라이 런' 을 실행하여 보여줍니다:

   • 업데이트, 변경되지 않음 또는 무시될 행 수에 대한 요약입니다.
   • 감지된 모든 경고 또는 오류

   

5. 요약과 경고를 주의 깊게 검토하세요.
6. 모든 것이 올바르게 보이면 가져오기를 클릭하여 변경 사항을 적용합니다.

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

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

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

가져오기 결과 이해

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

요약 카운트

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

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

모범 사례

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

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

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

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

추가 자료

• 스마트 번역을 활성화하는 방법
• 스마트 번역 기능을 통해 다국어 이메일 캠페인을 만드는 방법
• 스마트 번역을 사용하여 다국어 SMS 캠페인을 만드는 방법
• 언어를 기반으로 콘텐츠를 사용자 정의하는 방법