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

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

번역 CSV 내보내기

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

1. 업데이트하려는 메시지(캠페인 이메일, 플로우 이메일, SMS, WhatsApp 메시지 등)를 여세요.
2. 메시지의 번역 아이콘 또는 버튼, 또는 번역 수가 표시된 버튼을 클릭해 번역 편집기를 여세요. 메시지가 아직 번역되지 않았다면 먼저 언어 설정을 완료해 주세요.
3. 번역 편집기에서 점 3개 작업 메뉴를 열고 내보내기를 클릭해 주세요.

4. 내보내기 형식 선택에서 CSV를 선택하세요. 파일을 Smartling으로 보낼 예정이라면 Smartling compatible을 선택된 상태로 유지하고, 스프레드시트에서 표준 CSV를 편집하려면 선택을 해제하세요.

5. 내보낼 언어에서 모든 기존 번역 언어를 포함하려면 모두 선택을 선택하고, 특정 언어를 선택하려면 사용자 지정 선택을 선택하세요. 번역가에게 소스 텍스트만 내보내려면 소스 언어만 옵션을 선택하세요. 소스 언어는 모든 내보내기에 포함됩니다.
6. 내보내기를 클릭하여 CSV를 다운로드하세요.

Smartling CSV

Smartling 호환 CSV에는 다음이 포함돼요:

파일 상단에 있는 Smartling 지침에는 다음이 포함돼요:

# smartling.first_row_header=TRUE
# smartling.paths=2
# smartling.source_key_paths=1
# smartling.translations_in_columns=TRUE

• block_id – 이 메시지에서 번역 가능한 각 문자열의 고유 식별자입니다.
• 소스 언어 코드 (예: en) – 해당 문자열의 원본 소스 텍스트입니다.
• 선택한 번역 언어가 있는 경우 해당 번역 언어의 언어 열입니다.

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

작업이 완료되면 번역된 CSV를 다운로드하세요. Klaviyo로 가져오기 전에 첫 번째 행에 열 헤더가 오도록 앞부분의 # smartling. 지시문 행을 모두 삭제하세요. block_id 열, 원본 언어 열, 그리고 지원되는 번역 언어 열을 최소 1개 이상 유지하세요. 그런 다음 아래의 CSV 가져오기를 따르세요.

Standard CSV

표준 CSV에는 다음이 포함돼요:

• block_id – 이 메시지에서 번역 가능한 각 문자열의 고유 식별자입니다.
• source – 해당 문자열의 원본 소스 텍스트입니다.
• 언어 열: 선택한 번역 언어마다 1개 열이 있으며, 언어 코드(예: 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 열 헤더는 변경하지 마세요. Smartling CSV에서는 source 대신 소스 언어 열 헤더를 유지하세요. 각 번역 언어 열에는 지원되는 언어 코드가 표시되도록 레이블을 유지하세요.
• 파일 형식을 변경하지 마세요:
  • 파일을 .csv로 유지해 주세요 내보냅니다.
  • UTF‐8 인코딩으로 저장해 주세요.

각 번역에서 {{ first_name }} 및 {% if ... %} 같은 템플릿 태그와 템플릿 태그를 변경하지 않고 그대로 유지해 주세요. 이러한 플레이스홀더가 원본 메시지와 다르면 유효성 검사가 가져오기를 차단해요.

빈 셀 처리

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

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

셀을 비우는 과정에서 소스에 있는 플레이스홀더까지 함께 제거되면, 유효성 검사로 인해 가져오기가 차단돼요. 가져오기 전에 플레이스홀더를 복원하거나 해당 언어 열을 삭제해 주세요.

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

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

CSV 가져오기

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

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

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

4. 파일을 검증하고 변경 사항을 미리 보려면 다음을 클릭해 주세요.

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

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

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

가져오기에 성공하면 모달이 닫히고 번역 편집기에서 번역이 업데이트됩니다. 가져온 번역을 검토하세요.

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

• 파일 유형 및 인코딩: UTF-8로 인코딩된 CSV를 사용하세요.
• CSV 열: block_id(소스 열 또는 Smartling의 경우 소스 언어 열)을 유지하고, 지원되는 번역 언어 열을 최소 1개 포함해 주세요.
• 채널에서 인식하지 못하거나 지원되지 않는 언어 코드예요.
• 번역 값이 비어 있는 경우 및 기타 잠재적인 문제.
• 소스 메시지와 다른 템플릿 태그 및 템플릿 태그.

유효성 검증에 실패하면 오류 메시지가 표시됩니다. CSV를 수정한 후 새 파일 선택을 클릭해 다시 시도하세요, 유효성 검증은 번역을 변경하지 않습니다.

가져오기 결과 이해

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

요약 개수

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

• 업데이트됨: 최소 1개의 번역 값이 변경되는 행의 수입니다.
• 건너뜀(변경 없음): 포함된 모든 번역 값이 이미 저장된 값과 일치하는 CSV의 행.
• 무시됨: 첫 번째 항목 이후의 중복 행 또는 이 메시지에 block_id이(가) 존재하지 않는 행 등, 가져오지 않을 행입니다.

모범 사례

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

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

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

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

추가 자료