Emailify에서 Locize API 사용하기
Locize를 사용한다면 Emailify로 이메일 디자인의 원문 카피를 Locize 네임스페이스에 업로드하고, 번역된 변형을 Figma로 다시 가져올 수 있어요.
시작하기 전에
다음이 필요해요.
- 기준 언어와 대상 언어가 하나 이상 있는 Locize 프로젝트
- 이메일 번역용으로 이미 만들어 둔 버전과 네임스페이스
- 프로젝트 범위의 Locize API 키
1단계: Locize 프로젝트 연결
- Emailify에서 Localize 버튼을 클릭하세요.
- 현지화 옵션에서 Locize API를 선택하세요.
- Project ID와 API Key를 입력하세요.
- 사용할 Locize Version(예:
latest또는production)을 입력하세요. - 이메일 번역이 담긴 Namespace(예:
emails)를 입력하세요. - Locize 프로젝트에 맞는 Standard CDN 또는 Pro CDN 옵션을 고르세요.
- String Key Source에서 Emailify가 Locize 문자열 키를 만드는 방식을 고르세요.
Emailify가 연결되면 Locize 프로젝트에 설정된 기준 언어와 대상 언어가 표시돼요.
CDN 유형이 Locize 프로젝트와 일치하는지 확인하세요. Standard CDN은 공개되어 있고 1시간 고정 캐시를 사용하지만, Pro CDN은 비공개 게시와 캐시 설정 변경을 지원해요. 자세한 내용은 Locize의 CDN 비교를 참고하세요.
Locize 문자열 키 생성 방식 선택
Figma Node ID (Default) 옵션은 기존 Emailify 동작을 그대로 유지하며, 생성된 Figma 노드 ID를 Locize 키로 사용해요. 이 옵션을 바꾸지 않는 한 기존 Locize 워크플로는 계속 이 방식을 사용해요.
Figma 텍스트 레이어 이름이 Locize 네임스페이스의 문자열 키와 이미 일치한다면 Figma Text Layer Name을 선택하세요. Emailify는 점을 포함한 레이어 이름 전체를 그대로 유지하므로, templates.assistant_invited.h01이라는 레이어는 정확히 그 Locize 키를 사용해요.
포함된 모든 텍스트 레이어 이름은 비어 있지 않아야 하며, 선택한 이메일 전체에서 고유해야 해요. 중복 키가 있으면 Emailify는 원문 문자열을 Locize로 보내기 전에 업로드나 가져오기를 중단하고 중복 키를 알려 줘요. 링크와 이미지 대체 텍스트 키에는 텍스트 또는 이미지 레이어 이름 뒤에 Emailify의 _LINK 또는 _ALT_TEXT 접미사가 붙어요. 제목과 프리헤더 행은 Figma 텍스트 레이어가 아니라 이메일 메타데이터이므로 계속 Emailify가 생성한 키를 사용해요.
2단계: 이메일과 대상 로캘 선택
현지화할 Emailify 프레임을 고른 다음, 나중에 가져올 Locize 대상 언어를 선택하세요.
번역을 주고받는 동안 이메일 카피의 굵게, 기울임꼴, 링크 텍스트, 줄바꿈을 유지하려면 Import Markdown Formatting을 켜 두세요.
3단계: 기준 카피를 Locize에 업로드
Upload를 클릭하면 선택한 Emailify 텍스트가 Locize에 설정된 기준 언어로 네임스페이스에 전송돼요. 나중에 Figma에서 원문 카피를 수정했다면 다시 업로드해 해당 Locize 키를 업데이트하세요.
4단계: Locize에서 번역
Locize 프로젝트를 열고 대상 언어별로 업로드된 키를 번역하거나 검토하세요.
5단계: 번역된 이메일을 Figma로 가져오기
Emailify로 돌아와 원하는 대상 로캘을 선택하고 Import Translations를 클릭하세요. Emailify가 번역된 Locize 키를 선택한 원문 이메일에 맞춰 연결하고, 가져온 로캘마다 이메일 프레임 복제본을 만들어요.
Emailify는 Locize API 키를 공유 Figma 파일에 저장하지 않고, 현재 사용자의 Figma 로컬 클라이언트 저장소에 저장해요. 범위가 넓은 개인 액세스 토큰 대신 프로젝트 범위의 API 키를 사용하세요.