사이트 전체에 일본어와 브라질 포르투갈어를 31유로에 추가했어요
9월 29일, globalize.now를 일본어와 브라질 포르투갈어로 출시했어요. 모든 페이지, 모든 요금표, 블로그 글 61편 전부예요. 번역 자체는 8분이 걸렸고, 앱에서 청구된 금액은 약 31유로예요. globalize.now는 AI 기반 현지화 인프라이고, 이 글은 저희 사이트에 직접 적용한 과정을 담았어요. 모든 수치는 기억이 아니라 작업 페이지와 Git 이력에서 가져왔어요.
2017년 현지화 성장 플레이북에 든 비용 글은 저희 수치는 아직 공개하지 않는다는 말로 끝나요. 이 글이 그 첫 번째예요. 성장 수치가 아니라 비용 수치예요. 아직 /ja/를 방문해 볼 시간조차 없었으니까요.
정확히 무엇을 번역했나요?
사이트 전체를 두 번 번역했어요. 저장소에서 센 목록은 이래요.
- 인터페이스: 메시지 카탈로그 5개(핵심 사이트, 요금, 비교 페이지, 연동, 번역 예시)에 걸친 영어 문자열 1,782개, 약 21,000단어예요.
- 블로그: 글 61편, 약 110,000단어예요.
- 대상 언어: 일본어(
ja)와 브라질 포르투갈어(pt-BR)예요.
원문 약 130,000단어가 언어 2개로 번역된 셈이에요. PR은 파일 170개를 건드렸고 34,681줄을 추가했어요. 머지 후 사이트맵에는 로케일 11개에 걸쳐 URL 811개가 올라 있고, 사이트는 정적 페이지 962개를 빌드해요.
시간은 얼마나 걸렸나요?
번역에 8분, 그 뒤에 더 긴 품질 검사가 이어졌어요. CTO인 Arturs가 프로젝트에 언어 2개를 추가했고, 작업은 main UTC 08:56에 시작했어요. 작업 페이지에 단계별로 정리돼 있어요.
| 단계 | 소요 시간 |
|---|---|
| 번역(신규 문자열 11,264개, 언어당 5,632개) | 8분 1초 |
| 자동 QA 검토 | 27분 11초 |
| PR로 전달 | 5분 29초 |
두 언어가 담긴 커밋은 UTC 09:29에 올라왔어요. 작업에 포함된 나머지 문자열 45,106개는 번역 메모리에서 가져왔어요. 기존 언어 8개는 바뀐 게 없었거든요.
Arturs는 팀 채팅에서 10분 정도일 거라고 짐작했어요. 번역 시간은 맞췄고 전체 작업 시간은 낙관적이었는데, 그 차이가 QA 단계예요. QA를 건너뛰느니 기계가 27분 동안 검사하게 두는 쪽이 낫다고 봤어요.
자동 QA는 무엇을 찾아냈나요?
신규 문자열 11,264개 중 플래그는 72건이고, 모두 경미로 분류됐어요. 11,192개는 문제없이 통과했고, QA가 자동 수정을 182건 적용했어요.
확인해 본 플래그는 대부분 일본어에 대해 길이 검사가 지나치게 조심스럽게 동작한 경우였어요. “Pricing”이 두 글자인 料金으로 번역되면 길이 비율 0.29가 하한선 0.3에 살짝 못 미쳐요. 오역이 아니라, 알파벳 언어용으로 만든 휴리스틱에 올바른 번역이 걸린 거예요. 그래도 플래그는 그대로 남겨둬요. 한 번도 걸리지 않는 검사는 검사가 아니니까요.
비용은 얼마나 들었나요?
약 31유로예요. 프로젝트의 언어별 비용 보기에는 일본어 €15.72, 브라질 포르투갈어 €16.15로 나와요. 앱이 청구하는 금액이고, 같은 분량을 번역하는 고객이 보는 금액과 같아요. 내부 모델 원가도 아니고 할인도 아니에요.
번역된 약 260,000단어 기준으로 1,000단어당 약 12센트예요. 그 외에 추가 청구된 건 없어요. 언어별 요금도 사용자 수 요금도 없어서, 열두 번째 언어를 추가하는 비용도 세 번째 언어와 같아요. 현재 요금제는 요금 페이지에서 확인하세요.
엔지니어링 작업은 실제로 어땠나요?
PR 하나였고 같은 날 오후에 머지했어요. 번역 작업은 하나도 없었어요. PR을 열자 번역 작업이 다시 돌았고, 문자열 56,390개 중 56,370개를 번역 메모리에서 바로 가져와서, 이미 번역된 카탈로그가 7분 만에 새 파일에 들어왔어요. 자동화된 부분은 번역이에요. Next.js 사이트에 새 로케일을 등록하는 건 여전히 직접 짜는 코드예요. 계획하기 전에 그 ‘직접 짜는 코드’가 뭔지 알아두면 좋아요.
next-intl에 로케일을 추가하는 건 라우팅 설정에서 한 줄이면 돼요. URL을 만들거나, 로케일을 읽거나, 로케일 목록을 나열하는 모든 코드가 나머지 diff예요.
- 라우팅: 로케일 목록과,
pt-BR에 대한 URL 접두사 오버라이드예요(다음 섹션 참고). - SEO 메타데이터: hreflang 클러스터, canonical,
og:locale(ja_JP,pt_BR), 그리고 메타데이터 헬퍼가 순회하는 로케일 목록이에요. - 포맷팅: 날짜와 숫자가 올바르게 표시되도록
Intl태그ja-JP과pt-BR를 추가해요. - 언어 전환기: 크롤러가 따라갈 수 있도록 모든 로케일에 실제
<a href hreflang>로 연결돼요. - 사이트맵과 검사: 사이트맵 생성기, lastmod 검사, 내부 링크 검사, 번역 검증기 모두 새 코드 2개를 인식하도록 고쳐야 했어요.
- 카탈로그: 두 로케일용 헤더만 있는 빈
.po파일을 만들고, 같은 PR에서 번역 메모리로 채웠어요.
사이트가 저희보다 덜 커스텀되어 있다면 이 목록의 대부분은 설정으로 끝나요. 다만 어딘가에서 URL을 직접 만들고 있다면(대부분의 사이트는 어딘가에서 그래요), 링크가 잘못 나올 때마다 그 지점을 하나씩 발견하게 돼요. 설정 방법은 개발자 가이드에서, 자동화되는 부분과 그렇지 않은 부분의 경계는 AI 현지화 에이전트가 실제로 하는 일에서 다뤄요.
브라질 포르투갈어는 왜 /pt-BR/이 아니라 /pt-br/인가요?
언어 태그와 URL 세그먼트는 서로 다른 역할을 하는 별개의 것이기 때문이에요.
BCP 47에 따른 올바른 태그는 pt-BR예요. 파일 이름, <html lang>, hreflang, og:locale, Intl처럼 기계가 언어를 읽는 모든 곳에 이 태그를 써요. URL만 소문자로 바꿨어요.
// i18n/routing.ts (trimmed)
const prefixes = {
"pt-BR": "/pt-br",
} as const;
export const routing = defineRouting({
locales: ["en", "it", "de", "fr", "es", "lv", "hi", "lt", "et", "ja", "pt-BR"],
defaultLocale: "en",
localePrefix: { mode: "always", prefixes },
});
/** The URL path segment for a locale: `pt-BR` → `pt-br`, `de` → `de`. */
export function localeUrlSegment(locale: string): string {
const prefix = (prefixes as Record<string, string | undefined>)[locale];
return prefix ? prefix.slice(1) : locale;
}
대소문자가 섞인 경로는 오타가 나기 쉽고, /pt-BR/과 /pt-br/ 둘 다 응답하는 사이트는 모든 페이지의 사본이 둘씩 있어서 서로 경쟁해요. 그래서 /pt-BR/은 /pt-br/로 리디렉션하고, localeUrlSegment()는 직접 만드는 모든 URL을 접두사 맵에서 만들어요. 기준이 하나뿐이라 언어 전환기, canonical, 사이트맵이 서로 어긋나지 않아요.
왜 일본어와 브라질 포르투갈어인가요?
아직 지원하지 않던 큰 웹 언어이기 때문이에요. 출시일 기준 W3Techs 집계로 일본어는 웹사이트 4.9%의 콘텐츠 언어이고, 포르투갈어는 4.1%예요.
이걸 해야 하는 이유는 우리보다 훨씬 오래된 이야기예요. CSA Research가 2020년에 29개국 소비자 8,709명을 조사했더니 76%가 자기 언어로 정보를 제공하는 제품을 선호한다고 답했어요. 여기까지가 수요 쪽 이야기예요. 달라진 건 공급 쪽이에요. 예전에는 언어 두 개를 추가하려면 번역 업체와 계약부터 해야 했는데, 이제는 €31이면 돼요.
언어를 고르는 기준은 그로스 플레이북 글에서 소개한 방식 그대로예요. 지금 트래픽이 어디서 들어오는지 확인하고, 언어 두 개를 추가하고, 다른 건 건드리지 않은 채 한 분기 동안 측정해요. 이번에 추가한 두 언어로 바로 그렇게 해 볼 거예요.
아직 확인하지 못한 건 뭘까요?
원어민 검수예요. 일본어나 브라질 포르투갈어를 모국어로 쓰는 사람이 아직 결과물을 읽어 보지 못했어요.
지금까지 확인한 건 이래요. 모든 문자열에 자동화 QA를 돌렸고, 빌드는 prebuild 검사를 전부 통과했어요. 스테이징에서 샘플로 열어 본 페이지는 200을 반환했고, lang, canonical, hreflang도 올바르게 들어 있었으며 화면도 빠짐없이 렌더링됐어요. 빌드가 확인할 수 없는 건 문장이 사람이 쓴 것처럼 읽히는지예요. 우리 독일어·프랑스어 페이지를 직접 감사했을 때 페이지 전체에 걸쳐 말투(register)가 틀려 있는 걸 발견하고 뼈저리게 배웠어요.
그래서 검수가 다음 순서예요. 잘못된 부분까지 포함해서 검수 결과를 이 글에 추가로 업데이트할게요.
내 사이트에도 똑같이 적용할 수 있나요?
문자열이 이미 카탈로그에 있다면 가능하고, 번역은 몇 분이면 끝나요. 아직 컴포넌트에 하드코딩돼 있다면 변환이 먼저예요. 변환은 앱 안의 연결 플로우에서 한 번만 실행하고, 그 뒤에는 푸시 작업이 새 문자열을 번역해요. 하드코딩이 기본인 Lovable, Bolt, Cursor로 만든 앱은 vibe coder 가이드에서 다뤄요.
비용은 번역하는 단어 수에 따라 늘어나요. 언어 수나 팀 인원과는 상관없어요. 그래서 “언어를 추가할 가치가 있을까?”라는 질문의 답이 달라졌어요. 이제는 측정해 보는 편이 그 문제로 회의하는 것보다 싸요.
내 저장소에서 직접 해 보기
언어 두 개를 번역하는 데 8분, 비용은 약 €31이 들었어요. 저장소를 연결하고, 애널리틱스에서 이미 트래픽이 보이는 언어 두 개를 골라서 내 영수증은 어떻게 나오는지 확인해 보세요.
globalize.now는 하드코딩된 앱 문구를 번역할 수 있는 로케일 파일로 바꾸고, 배포할 때마다 최신 상태로 유지해요.
globalize.now 무료로 시작하기