사용자 선택을 유지하면서 언어와 지역 제안하기
이용 가능한 방문자 정보를 활용해 언어, 지역, 통화의 유용한 출발점을 제시한 뒤, 방문할 때마다 위치로부터 다시 추정하는 대신 방문자의 명시적인 선호를 기억하세요.
선호도 우선순위
먼저 명시적으로 저장된 선택(쿠키, 계정 설정, 방문자가 직접 설정한 쿼리 파라미터)이 있는지 확인하세요. 명시적인 선택이 없을 때만 IP 기반 제안으로 대체하고, 새로운 /v1/geo 호출이 방문자가 이미 선택한 선호도를 절대 덮어쓰지 않도록 하세요.
IP 국가와 브라우저 언어의 차이
이 둘은 서로 다른 질문에 답하며 일치하지 않을 수 있습니다. 캐나다에서 연결하는 프랑스어 사용 방문자는 /v1/geo에서 country: "CA"로 확인되지만, 브라우저의 Accept-Language 헤더(locale.suggestedLocale에서 사용)는 이미 "fr"을 반영하고 있을 수 있습니다 — 국가 코드만으로 언어를 추측하지 말고 국가와 응답 자체의 locale.suggestedLocale을 함께 사용하며, 결과는 리디렉션 대상이 아니라 제안으로 취급하세요.
로케일 및 통화 필드
geo.locale.suggestedLocale, measurementSystem, firstDayOfWeek, dateFormat은 지역별 형식 기본값을 제공하며, geo.currency는 초기 통화 추정값을 제공합니다. 이 모든 것은 국가와 요청 헤더로부터 파생된 초기 제안값이며 검증된 선호도가 아닙니다.
위치 정보가 없을 때
locale, currency, country는 null이 될 수 있습니다 — 해석할 수 없는 네트워크에서의 요청은 추측값이 아니라 null을 반환합니다. 값이 도착하지 않을 수도 있는데 페이지를 차단하기보다는 사이트 자체의 기본 언어와 형식으로 대체하세요.
언어별 URL을 안정적이고 색인 가능하게 유지하기
방문할 때마다 자동으로 리디렉션하는 대신 눈에 보이는 전환 스위처를 제공하세요. IP 기반의 영구 리디렉션은 VPN이나 호텔 네트워크 같은 예상치 못한 네트워크에 있는 검색 엔진과 방문자 모두에게 특정 언어 버전을 안정적인 URL에서 접근할 수 없게 만듭니다.
보장하지 않는 것
IP 기반 국가는 언어 선호, 시민권, 물리적 소재에 대한 증거가 아닙니다 — 여행자, VPN 사용자, 공유 기업 네트워크는 모두 방문자가 실제로 선호 언어와 연관 짓지 않는 곳으로 확인될 수 있습니다. 모든 제안을 되돌릴 수 있는 것으로 취급하세요.