CSV로 용어집 용어를 일괄 가져오는 방법
이 기능을 사용하려면 유료 Klaviyo 계정이 있어야 하고 스마트 번역이 활성화되어 있어야 해요.
기존 용어집 가져오기
Klaviyo의 스마트 번역 기능은 용어집 을 사용해 특정 용어가 번역되는 방식을 제어해요. 즉, 모든 캠페인에서 일관된 번역이 필요한 브랜드명, 제품명, 슬로건 또는 기술 용어를 관리할 수 있어요.
이미 다른 번역 시스템(DeepL, Lokalise, Phrase, 내부 스프레드시트)에서 용어집을 관리하고 있다면, 각 항목을 직접 다시 만들지 않고 CSV로 Klaviyo에 바로 가져올 수 있어요.
CSV 가져오기를 사용해야 하는 경우
CSV 가져오기는 다음과 같은 경우에 유용해요:
- DeepL, Lokalise, Phrase, memoQ 같은 TMS(번역 관리 시스템)에서 기존 용어집을 Klaviyo로 가져오세요.
- UI에서 각 용어를 하나씩 입력하는 대신, 한 번에 많은 용어(수십 개 또는 수백 개)를 추가할 수 있어요.
- 공유 스프레드시트에서 관리하던 용어집을 Klaviyo의 단일 진실 공급원(SSoT)으로 마이그레이션하세요.
몇 가지 용어만 추가하는 경우에는 보통 용어집 패널에서 하나씩 수동으로 추가하는 것이 더 빨라요.
가져오기는 단방향이에요. 용어를 Klaviyo에 업로드할 수 있지만, 현재는 CSV로 내보내기는 지원하지 않아요. 백업이 필요하면 원본 파일의 사본을 보관해 주세요.
CSV 파일을 준비해 주세요
파일 형식
- 인코딩: UTF-8
- 파일 유형: .csv
- 구분 기호: 쉼표(,)
- 헤더 행: 필수(아래 참조)
샘플 파일
시작 언어 용어 | 도착 언어 용어 | 소스 로캘 | 대상 로케일 |
|---|---|---|---|
hello | bonjour | ko | FR |
hello | hallo | ko | de |
tschüß | 안녕히 가세요 | de | ko |
필수 열
각 행에는 4개의 열이 포함되어야 해요:
source term― 원본 언어의 용어target term— 용어를 어떻게 번역해야 하는지source locale— 소스 언어의 BCP-47 로케일 태그target locale— 대상 언어의 BCP-47 로캘 태그
파일의 첫 번째 행에 네 개의 헤더가 모두 있어야 합니다. 열 순서는 상관없습니다.
로캘 코드(BCP-47)
로캘 코드는 BCP-47 표준을 따릅니다. 가장 일반적인 형태는 2글자 언어 코드이며, 선택적으로 지역이 뒤에 올 수 있습니다:
en— 영어en-US― 영어(미국)en-GB― 영어(영국)fr— 프랑스어fr-CA― 프랑스어(캐나다)de― 독일어ja― 일본어pt-BR― 포르투갈어(브라질)
Klaviyo에서 구성한 로케일과 일치하는 가장 구체적인 태그를 사용하세요.
하나의 파일에 여러 언어 쌍
하나의 CSV에 여러 언어 쌍의 항목을 포함할 수 있어요. 각 행은 독립적으로 처리되므로 언어 쌍을 자유롭게 섞어 사용할 수 있어요:
시작 언어 용어 | 도착 언어 용어 | 소스 로캘 | 대상 로케일 |
|---|---|---|---|
hello | bonjour | ko | FR |
hello | 안녕하세요 | ko | es |
hello | hallo | ko | de |
bonjour | 부에노스 디아스 | FR | es |
여러 로케일에서 번역을 지원하는 하나의 마스터 용어집을 유지 관리하는 경우에 유용해요.
용어집 용어는 대칭적입니다.
각 용어집 항목은 용어 간의 양방향 동등성을 정의해요. 가져오는 경우:
시작 언어 용어 | 도착 언어 용어 | 소스 로캘 | 대상 로케일 |
|---|---|---|---|
hello | bonjour | ko | FR |
Klaviyo는 다음을 수행해요:
- 영어 → 프랑스어를 번역할 때
hello을(를)bonjour(으)로 번역하세요. - 프랑스어 → 영어를 번역할 때
bonjour을(를)hello(으)로 번역하세요.
즉, 다음과 같은 비대칭 매핑은 정의할 수 없습니다:
시작 언어 용어 | 도착 언어 용어 | 소스 로캘 | 대상 로케일 |
|---|---|---|---|
hello | bonjour | ko | FR |
bonjour | 안녕하세요 | FR | ko |
두 행 모두 bonjour 을(를) 서로 다른 영어 용어에 매핑하고 있어 충돌이 발생해요. 로케일 쌍-용어 조합당 하나의 매핑만 허용돼요. 가져오기 도구가 충돌하는 행을 건너뛰고 오류를 보고해요(가져오기 오류 문제 해결 참고).
컨텍스트에 따라 bonjour 에 대해 서로 다른 영어 번역이 필요하다면, 용어집 용어는 적합한 도구가 아니에요. 용어집은 매번 동일하게 번역되는 용어를 위한 것이에요.
가져오기 모드
가져오기 시 두 가지 모드 중 하나를 선택해 주세요:
- 추가 ― 기존 용어집 항목은 그대로 유지돼요. CSV의 새 항목이 추가돼요. 기존 항목과 충돌하는 행은 건너뛰어요.
- 모두 바꾸기 ― 현재 용어집 전체가 삭제되고 CSV의 내용으로 대체돼요.
모두 바꾸기 를 클릭하면 현재 용어집 전체가 삭제돼요.
CSV가 새로운 단일 기준 데이터(소스 오브 트루스)라고 확신할 때만 모두 바꾸기 를 사용해 주세요. 되돌릴 수 없어요.
파일을 가져오세요
1. 계정 → 설정 → 번역 → 용어집(으)로 이동하세요.
2. CSV 가져오기를 클릭해 주세요.
3. 대화 상자에서 추가 또는 모두 바꾸기를 선택하세요.
4. 파일 영역을 클릭하고 .csv 파일을 선택해 주세요(또는 파일을 해당 영역으로 드래그하세요).
5. 다음을 클릭해 주세요. Klaviyo에서 파일을 검증하지만 아직은 아무것도 저장하지 않아요. 미리보기 화면이 표시돼요.
6. 미리보기를 검토하세요:
- 총 행 수 ― 파일에 있던 행 수예요.
- 유효한 항목 ― 가져올 항목 수예요.
- 건너뛴 행 — 유효성 검사 문제로 인해 제외된 행 수예요.
7. 경고가 표시되더라도 계속 진행할 수 있으며, 또는 돌아가서 먼저 파일을 수정할 수 있어요.
8. 가져오기 를 클릭하여 변경 사항을 저장해요.
파일에 문제가 있으면 미리보기 대신 가져오기 실패 화면이 표시돼요.
가져오기 오류 문제 해결
가져오기에 실패하면 Klaviyo에서 문제가 무엇인지 설명하는 하나 이상의 오류 메시지가 표시돼요. 일부 오류는 파일 전체에 적용되고, 다른 오류는 특정 행을 가리켜요.
파일 수준 오류
이러한 항목은 가져오기를 완전히 중지합니다. 수정하고 다시 시도해 주세요.
"업로드한 파일이 비어 있습니다."
의미: 파일에 콘텐츠가 없습니다.
해야 할 일: 파일이 0바이트가 아니고, 헤더를 포함해 최소 1개 행이 있는지 확인해 주세요.
"누락된 필수 헤더입니다."
의미: 헤더 행에 필요한 4개의 필수 열이 모두 포함되어 있지 않아요.
수행할 작업: 첫 번째 행에 source term, target term, source locale, target locale이(가) 포함되어 있는지 확인해 주세요. 헤더 순서는 중요하지 않지만, 철자는 중요해요.
"유효한 용어집 항목이 없습니다."
의미: 검증 후 가져올 수 있는 행이 없었어요.
수행할 작업: 파일을 열고 데이터 행이 예상 형식과 일치하는지 확인해 주세요.
"인코딩 오류."
의미: 파일이 UTF-8로 인코딩되지 않았어요.
수행할 작업: 스프레드시트 도구에서 UTF-8 인코딩으로 파일을 다시 저장해 주세요. Excel에서는 다른 이름으로 저장 → CSV UTF-8을 사용하세요.
"용어가 최대 길이를 초과했습니다."
의미: 하나 이상의 용어가 너무 길어요.
해야 할 일: 용어집 용어는 짧은 구여야 해요. 매우 긴 항목은 줄이거나 분할해 주세요.
행 수준 오류
이 항목은 특정 행을 표시해요. 파일의 나머지 부분은 계속 가져올 수 있어요. 문제가 있는 행은 건너뛰어요.
"N행: 예기치 않은 열 수입니다"
의미: 행에 쉼표로 구분된 값이 너무 적거나 너무 많아요.
해야 할 일: CSV의 해당 행을 확인해 주세요. 용어 안에 있는 추가 쉼표는 따옴표("hello, world")로 감싸야 해요.
"행 N: 빈 용어 값입니다"
의미: 소스 또는 타겟 용어 셀이 비어 있어요.
해야 할 일: 누락된 용어를 입력하거나 해당 행을 삭제해 주세요.
"행 N: 빈 로케일 코드"
의미: 소스 또는 타겟 로케일 셀이 비어 있습니다.
수행할 작업: 누락된 로케일을 입력하세요(예: en, fr-CA).
"행 N: 인식할 수 없는 로케일 코드"
의미: 로캘 문자열이 유효한 BCP-47 태그가 아니에요.
해야 할 일: en, fr, de, pt-BR 같은 표준 로캘 코드를 사용해 주세요. 로캘 코드를 참고하세요.
"N행: 중복 로케일 열이 감지되었습니다"
의미: 단일 항목 컨텍스트에서 동일한 로캘이 두 번 이상 표시됩니다.
해야 할 일: 각 행에는 서로 다른 소스 로케일과 타겟 로케일이 필요해요. en → en은(는) 번역할 수 없어요.
"행 N: 동일한 용어 및 로케일에 대한 번역이 충돌합니다"
의미: 이 행은 파일의 다른 행과 달리 동일한 소스 용어를 다른 대상으로 매핑하려고 해요.
What to do: 어떤 번역이 맞는지 결정한 다음, 중복된 항목을 삭제해 주세요.
"행 N: 용어가 기존 항목과 충돌합니다"
의미: 이 행은 이미 용어집에 있는 용어와 모순되는 번역을 정의하려고 합니다(추가 모드에서만).
수행할 작업: UI에서 기존 항목을 업데이트하거나 새 파일이 올바르다면 모두 바꾸기 모드를 사용해 주세요.
"행 N: 안전을 위해 선행 수식 문자가 제거되었습니다."
의미: 용어가 =, +, - 또는 @(으)로 시작했으며, 스프레드시트 앱에서 이를 수식으로 해석할 수 있어요.
수행할 작업: 이건 실패가 아니라 경고예요. 앞의 문자가 제거된 상태로 용어가 가져와져요. 해당 문자가 필요하면 용어를 따옴표로 감싸 주세요.
일반 유효성 검사 오류
“유효성 검사 오류가 발생했습니다. 파일을 확인한 후 다시 시도하세요.”가 표시되면 가져오기가 분류할 수 없는 문제를 만난 거예요. 파일이 예상 형식과 일치하는지 다시 확인하고 오류가 계속되면 지원 팀에 문의하세요.