CSV로 번역을 일괄 관리하는 방법

CSV 파일을 내보내 편집한 다음 다시 가져오면 Klaviyo 외부에서 번역을 관리하면서 번역을 한 번에 업데이트하거나 다른 사람과 공동 작업할 수 있어요.

번역 CSV 내보내기

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

1. 업데이트하려는 메시지(캠페인 이메일, 플로우 이메일, SMS, WhatsApp 메시지 등)를 여세요.
2. 번역을 클릭해 번역 편집기를 여세요.
3. 번역 편집기에서 작업 메뉴를 열고 CSV 내보내기를 클릭합니다.

4. 내보내기 모달에서 Smarting CSV 또는 CSV중에서 선택할 수 있어요.
   

Smartling CSV 내보내기

1. 브라우저가 다음을 포함한 CSV 파일을 다운로드해요:

1. 다음은 기본 Smartling 지시어입니다.
2. # smartling.first_row_header=TRUE
   # smartling.paths=2
   # smartling.source_key_paths=1
   # smartling.translations_in_columns=TRUE
3. block_id – 이 메시지에서 번역 가능한 각 문자열의 고유 식별자입니다.
4. 소스 언어 코드 (예: en) – 해당 문자열의 원본 소스 텍스트입니다.

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

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

간단한 CS 내보내기

1. 브라우저가 다음을 포함한 CSV 파일을 다운로드해요:

1. block_id – 이 메시지에서 번역 가능한 각 문자열의 고유 식별자입니다.
2. source – 해당 문자열의 원본 소스 텍스트입니다.
3. 언어 열 – 언어별로 하나씩 있는 열로, 언어 코드로 이름이 지정돼요(예: en, fr, es-MX).

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

CSV 업데이트

CSV를 편집할 때는 언어 열에서만 작업하면 돼요.

block_id 열의 값은 편집, 추가 또는 삭제하지 마세요. 행에 유효하지 않거나 누락된 block_id가 있으면 가져오기 중 해당 행이 무시되며 번역이 업데이트되지 않아요.

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

CSV에서:

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

변경하지 말아야 할 사항

다음 사항은 피하세요:

• block_id 값은 편집하거나 삭제하지 마세요.
• 행을 추가하지 마세요. 각 행은 메시지에 있는 기존 번역 가능 문자열에 계속 매핑되어야 해요.
• CSV에서 소스 값을 변경하지 마세요:
  • 원본 콘텐츠를 변경하려면 Klaviyo 편집기에서 메시지를 직접 편집한 다음 새 CSV를 내보내세요.
• 필수 열 이름을 변경하지 마세요 (block_id, source, 및 언어 열).
• 파일 형식을 변경하지 마세요:
  • 파일을 .csv로 유지해 주세요 내보냅니다.
  • UTF‐8 인코딩으로 저장해 주세요.

빈 셀 처리

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

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

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

편집이 끝나면 UTF-8로 인코딩된 .csv로 파일을 저장해 주세요.

CSV 가져오기

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

1. 같은 메시지에 대한 번역 편집기로 돌아가세요.
2. CSV 가져오기를 클릭해 주세요.
3. 가져오기 모달에서 다음 중 하나를 수행해 주세요:

• 파일 선택을 클릭하고 CSV를 선택하거나
• CSV 파일을 업로드 영역으로 드래그 앤 드롭해 주세요.

5. Klaviyo가 유효성 검사 “드라이 런”을 실행하고 다음을 표시해요:

• 업데이트, 변경 없음 또는 무시될 행 수에 대한 요약
• 감지된 경고 또는 오류

7. 요약과 경고를 꼼꼼히 검토해 주세요.
8. 모두 올바르게 보이면 가져오기를 클릭하여 변경 사항을 적용해 주세요.

유효성 검사 중에 Klaviyo에서 다음 항목도 확인해요:

• 파일 크기 및 행 제한(예: 10MB보다 큰 파일은 거부됩니다).
• 필수 열(예: block_id, source, 그리고 최소 1개의 언어 열).
• 채널에서 인식하지 못하거나 지원되지 않는 언어 코드예요.
• 번역 값이 비어 있는 경우 및 기타 잠재적인 문제.

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

가져오기 결과 이해

검증 후, 가져오기 요약에 진행할 경우 어떤 일이 발생하는지 표시돼요.

요약 개수

요약에는 다음과 같은 개수가 포함될 수 있어요:

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

모범 사례

번역 데이터를 정확하고 관리하기 쉽게 유지하려면:

1. 가장 최근 내보내기부터 시작하세요. 특히 메시지의 콘텐츠나 언어를 변경한 후에는 오래된 CSV를 다시 사용하지 마세요.
2. 각 내보내기 파일의 백업을 보관해 두세요. 변경하기 전에 CSV 사본을 저장해 두면, 필요할 때 되돌릴 수 있어요.
3. 번역가와 조율해 주세요. 편집할 수 있는 열(언어 열만)과 변경하면 안 되는 열(block_id, source)을 설명해 주세요.
4. 필요하면 더 작은 단위로 나눠 작업해 주세요. 파일이 매우 큰 경우, 작업을 여러 메시지로 나누거나 더 작은 가져오기를 여러 번 실행하는 것을 고려해 보세요.
5. 지원되는 언어 코드를 사용하세요. 새 언어 열을 추가할 때는 “처리할 수 없음” 언어를 방지하기 위해 스마트 번역 문서의 지원되는 BCP-47 코드를 사용해 주세요.

유효성 검사 경고 및 가져오기 오류를 해결해 주세요.

가져오기 유효성 검사 중 경고 또는 오류가 표시되면 아래 섹션을 검토하여 의미와 해결 방법을 확인해 주세요.