빌드된 국가에서는 완벽하게 작동하는 사이트가 다른 열두 개 나라에서는 조용히 망가져 있을 수 있다. 이탈리아에서 번역되지 않은 결제 버튼, 독일 방문자에게 달러로 표시되는 가격, 프랑스에서 페이지 전체를 덮는 동의 배너, 검색 엔진이 hreflang이 잘못된 URL을 가리켜서 찾지 못하는 언어 버전. 팀이 사무실에서 테스트할 때는 이런 것들이 드러나지 않는다.
이유는 단순하다. 시장 간에 달라지는 대부분의 것들은 방문자가 어디에 있는지에 따라 결정된다. 현지 고객이 보는 것을 보려면 해당 시장에서 테스트해야 한다. 이 가이드는 여러 시장에 걸친 로컬라이제이션 QA를 규모 있게 수행하는 방법을 다룬다. 무엇을 확인해야 하는지, 각 시장을 현지 방문자처럼 보는 방법, 그리고 가장 흔한 버그를 자동으로 잡아내는 작은 검사기를 소개한다.
로컬라이제이션 버그가 숨는 이유
로컬라이즈된 사이트는 언어별로 하나의 고정된 페이지를 제공하는 경우가 드물다. 방문자가 보내는 신호에 따라 요청 시점에 무엇을 보여줄지 결정한다.
- 위치, IP 주소로부터 결정: 통화, 가격, 배송 옵션, 법적 배너, 제품 가용성, 때로는 언어 자체까지.
- 언어 설정, 브라우저로부터 결정: 어떤 번역을 보여줄지, 날짜와 숫자 형식을 어떻게 할지.
- URL, 예를 들어
/de/또는de.example.com: 사이트에 요청된 버전으로, 앞의 두 가지와 일치할 수도 있고 그렇지 않을 수도 있다.
본사에서 하는 테스트는 보통 한 가지 조합만 다룬다. 본사가 있는 국가, 영어 브라우저, 기본 URL. 번역 검토는 단어는 확인하지만 실제로 서비스되는 페이지는 확인하지 않는다. 버그는 아무도 시도하지 않은 조합 속에 숨어 있다.
한 시장에서만 발생하는 문제들
| 버그 | 예시 | 보통 발생하는 원인 |
|---|---|---|
| 번역되지 않은 문자열 | 이탈리아 사이트의 “Add to cart” | 새 기능이 번역 워크플로우에 도달하지 못한 영어 문자열 그대로 출시됨 |
| 잘못된 통화 또는 가격 형식 | 독일 방문자에게 표시되는 $49.99, 또는 49,99 € 대신 49.99 € | 한 곳에서는 URL로, 다른 곳에서는 IP로 통화를 선택함 |
| 깨진 hreflang | 언어 버전이 404 또는 다른 언어를 가리킴 | 출시 후 URL이 변경되었으나 대체 링크가 업데이트되지 않음 |
누락되거나 잘못된 lang 속성 | 독일어 페이지에 lang="en" | 하드코딩된 속성이 있는 공유 템플릿 |
| 리디렉션 루프 또는 강제 리디렉션 | 오스트리아 방문자가 독일 쇼핑몰로 보내져 돌아올 수 없음 | 명시적 선택을 무시하는 지역 리디렉션 |
| 법적 및 동의 레이어 | 특정 EU 국가에서 콘텐츠를 가리는 배너 | 국가별 동의 설정 |
| 레이아웃 오버플로우 | 독일어 라벨이 버튼을 깨뜨림, 우에서 좌로 읽는 텍스트가 그리드를 깨뜨림 | 짧은 영어 문자열로만 테스트된 디자인 |
이 중 몇 가지는 검색에 직접 영향을 준다. lang 속성이 잘못되거나 대체 링크가 깨진 페이지는 잘못된 언어로 색인되거나, 아예 색인되지 않을 수 있다. hreflang을 사용해 페이지의 모든 언어 버전을 찾는 방법 가이드는 사이트의 대체 링크를 매핑하고 아무 곳도 가리키지 않는 링크를 찾아내는 방법을 보여준다.
1단계: 각 시장을 현지 방문자처럼 보기
핵심 요구사항은 각 페이지를 해당 시장 내부에서, 현지 방문자처럼 설정된 브라우저로 요청하는 것이다. 실제로는 다음 세 가지가 서로 일치해야 한다.
- 해당 시장의 IP 주소. 국가 또는 도시 타겟팅이 가능한 레지덴셜 프록시는 사이트의 지역 로직이 기대하는 현지 소비자 연결의 주소를 제공한다. 당사의 레지덴셜 프록시는 195개 이상의 국가를 지원하며, 필요한 경우 도시 타겟팅도 가능하다.
- 해당 시장의 언어와 로케일. 브라우저의 언어 헤더와 로케일을 일치시킨다.
- 해당 시장의 시간대, 실제 브라우저로 테스트하는 경우. 일부 사이트는 이를 또 다른 위치 신호로 사용한다.
이 세 가지가 일치하지 않으면 실제 고객에게는 존재하지 않는 조합을 테스트하게 되고, 존재하지 않는 버그를 쫓게 될 수 있다. 프록시 지역, 시간대, 로케일 일치시키기 가이드는 하나의 설정에서 세 가지 모두를 도출하는 방법을 다룬다.
또한 각 시장마다 새로운 세션으로 테스트해야 한다. 이전 방문의 쿠키는 사이트를 마지막으로 테스트한 국가에 고정시킬 수 있어 지역 로직 버그를 숨길 수 있다.
2단계: 모든 시장을 동일한 방식으로 확인하기
수십 개 시장과 수천 개 페이지에 시각적 검토를 적용하기는 어렵지만, 대부분의 로컬라이제이션 버그는 HTML에서 감지할 수 있다. 아래 함수는 로컬라이즈된 페이지 하나에서 가장 흔한 네 가지 문제를 확인한다: lang 속성, 남아 있는 영어 문자열, 잘못된 통화의 가격, 해당 시장에 대한 hreflang 항목 누락.
import re
from lxml import html as lxml_html
def market_problems(page_html, market):
"""Things that only break in one market, checked on one localized page.
market: {"lang": "de", "currency": "€", "leftovers": ["Add to cart", "Free shipping"]}
"""
doc = lxml_html.fromstring(page_html)
problems = []
lang = (doc.get("lang") or "").lower()
if not lang.startswith(market["lang"]):
problems.append(f"html lang is {lang or 'missing'}, expected {market['lang']}")
text = " ".join(" ".join(doc.itertext()).split())
for phrase in market["leftovers"]:
if phrase.lower() in text.lower():
problems.append(f"untranslated text: {phrase!r}")
prices = re.findall(r"[$€£¥₩R]\$?\s?\d[\d.,]*|\d[\d.,]*\s?[$€£¥₩]", text)
wrong = [p for p in prices if market["currency"] not in p]
if wrong:
problems.append(f"{len(wrong)} of {len(prices)} prices not in {market['currency']}, e.g. {wrong[0]!r}")
if not doc.xpath(f"//link[@rel='alternate'][starts-with(@hreflang, '{market['lang']}')]"):
problems.append(f"no hreflang entry for {market['lang']}")
return problems두 페이지에서 실행한 결과 (예시용 HTML, 실제 사이트 아님):
from locqa import market_problems
markets = {
"de": {"lang": "de", "currency": "€", "leftovers": ["Add to cart", "Free shipping"]},
"fr": {"lang": "fr", "currency": "€", "leftovers": ["Add to cart", "Free shipping"]},
}
pages = { # in practice: the same product page, fetched from inside each market
"de": '<html lang="de"><head><link rel="alternate" hreflang="de" href="/de/p/1"></head>'
'<body><h1>Wasserkocher</h1><p>49,99 €</p><p>Free shipping</p></body></html>',
"fr": '<html lang="fr"><head><link rel="alternate" hreflang="fr" href="/fr/p/1"></head>'
'<body><h1>Bouilloire</h1><p>$49.99</p><p>Ajouter au panier</p></body></html>',
}
for code, page in pages.items():
print(code, market_problems(page, markets[code]) or "ok")de ["untranslated text: 'Free shipping'"]
fr ["1 of 1 prices not in €, e.g. '$49.99'"]독일어 페이지에는 남아 있는 영어 문구가 있고, 프랑스어 페이지에는 달러 가격이 표시된다. 번역된 문자열 자체는 문제가 없기 때문에 둘 다 번역 검토는 통과했을 것이다.
남아 있는 문구 목록은 자신의 인터페이스에서 구축한다. 버튼 라벨, 배송 및 결제 메시지, 오류 메시지. 이런 것들이 나중에 추가되는 경우가 가장 많은 문자열이다. 가격 형식은 통화 기호보다 더 신경 써야 하는데, 같은 기호도 여러 방식으로 표기될 수 있기 때문이다. 로케일 간 가격, 숫자, 날짜 정규화하기 가이드는 이를 안정적으로 파싱하는 방법을 다룬다.
3단계: 일정에 따라 실행하기
로컬라이제이션은 출시 시점뿐 아니라 그 이후에도 깨진다. 새 기능, 템플릿 변경, 가격 업데이트가 다른 시장은 멀쩡해 보이는데 한 시장만 망가뜨릴 수 있다. 실용적인 리듬은 다음과 같다.
- 모든 릴리스마다: 모든 시장에서 핵심 페이지 소수 (홈, 카테고리, 제품, 장바구니, 결제).
- 매주: 시장당 더 넓은 범위의 페이지 샘플, 최근 변경된 페이지 포함.
- 지역 로직, 가격 또는 동의 설정이 변경될 때마다: 전체 점검.
결과는 시장별, 검사 항목별로 보고하여 각 팀이 자신의 문제를 볼 수 있도록 한다. 실패가 가장 많은 시장은 대개 현지 테스트가 가장 적은 시장이다.
자동화가 잡아내지 못하는 것들
일부 문제는 여전히 해당 시장을 아는 사람이 필요하다. 문법적으로는 맞지만 어색하게 들리는 번역, 현지에서 좋지 않은 의미를 가진 이미지나 색상, 템플릿이 다루지 못하는 법적 요건. 자동화된 검사는 사람이 이런 것들에 검토 시간을 쏟을 수 있게 해주며, 달러 기호를 찾아 헤매는 데 시간을 쓰지 않게 해준다.
일부 사이트는 국가별로 다른 동의 및 개인정보 레이어를 보여주기도 하는데, 이는 사용자가 보는 것뿐 아니라 자동화된 테스트가 도달할 수 있는 범위도 바꾼다. 국가별 동의 장벽에 대한 당사의 연구는 EU 전역에서 이것이 얼마나 다양한지 보여준다.
FAQ
로컬라이제이션 QA란 무엇인가?
사이트의 각 언어 및 시장 버전이 현지 방문자에게 올바르게 작동하고 올바르게 읽히는지 테스트하는 것이다. 번역, 통화 및 가격 형식, 레이아웃, 법적 공지, 리디렉션, 그리고 검색 엔진이 각 버전을 찾는 데 사용하는 신호들이 포함된다.
VPN으로 다른 시장을 테스트할 수 없는 이유는?
간단히 살펴보는 용도로는 가능하지만, 많은 사이트가 VPN과 데이터센터 주소를 인식하여 가정용 연결과 다르게 취급하기 때문에 실제 현지 고객이 보는 것을 보지 못할 수 있다. 해당 시장의 레지덴셜 IP가 실제 경험에 더 가깝다.
모든 시장에서 어떤 페이지를 테스트해야 하는가?
최소한 홈페이지, 카테고리 페이지, 제품 페이지, 장바구니와 결제 페이지, 그리고 가격이나 법적 텍스트가 있는 모든 페이지. 최근 변경된 페이지의 순환 샘플로 범위를 넓힌다.
로컬라이제이션 버그는 SEO에 어떤 영향을 미치는가?
잘못된 lang 속성, 깨진 hreflang 대체 링크, 강제 지역 리디렉션은 검색 엔진이 잘못된 언어 버전을 색인하게 하거나, 아예 해당 버전을 놓치게 만들어 해당 시장에서의 노출도를 떨어뜨릴 수 있다.
결론
로컬라이제이션 버그는 아무도 테스트하지 않는 시장에 숨어 있다. IP, 언어, 시간대가 서로 일치하는 상태에서 각 시장을 현지 방문자처럼 보고, 모든 릴리스 이후 모든 시장에 동일한 자동화 검사를 실행하라. 기계적인 문제(언어 속성, 남아 있는 문자열, 통화, hreflang)는 기계로 잡아내고, 인간의 검토는 현지 독자만이 판단할 수 있는 것을 위해 남겨두라.