hreflang 생성기 및 린터

같은 페이지의 로케일 버전마다 행을 하나씩 추가하세요. URL에서 로케일을 감지할 수 있으며 각 페이지에 선택적인 x-default를 따로 지정할 수 있습니다.

hreflang	URL	x-default (선택 사항, 페이지별)	삭제

x-default 추가

각 locale에 대해 {path}를 자리표시자로 사용하는 URL 템플릿을 정의한 다음 경로를 한 줄에 하나씩 붙여 넣으세요.

hreflang	URL 템플릿	x-default url 템플릿 (선택 사항, 페이지별)	삭제

경로(한 줄에 하나) 템플릿으로 x-default 추가:

이 결과의 의미 ↓

출력을 보려면 위에 locale과 URL을 추가하세요.

전체 과정이 브라우저에서 실행되며, 붙여넣은 내용은 업로드되거나 저장되지 않습니다. 익명 실행별 결과 계수는 종합 연구에 사용될 수 있습니다. URL, 도메인, IP 및 식별자는 절대 포함되지 않으며 100회 미만의 실행에 대한 통계는 공개하지 않습니다.

실제 URL 검사

이미 배포한 페이지를 가져옵니다. 실제 hreflang 주석을 읽고 선언된 각 대체 페이지(최대 25개)를 가져와 반환 링크와 자기 참조를 확인합니다.

피드백

검사는 당사 서버에서 실행됩니다. 입력한 URL을 가져오지만 결과는 보관하지 않습니다. 익명 실행별 결과 계수는 종합 연구에 사용될 수 있습니다. URL, 도메인, IP 및 식별자는 절대 포함되지 않으며 100회 미만의 실행에 대한 통계는 공개하지 않습니다.

샘플 보고서

미국 및 영국 영어 페이지에 일반 en 대체 항목과 x-default를 설정하면 다음과 같은 head 태그가 생성됩니다.

<link rel="alternate" hreflang="en-US" href="https://example.com/us/" />
<link rel="alternate" hreflang="en-GB" href="https://example.com/uk/" />
<link rel="alternate" hreflang="en" href="https://example.com/us/" />
<link rel="alternate" hreflang="x-default" href="https://example.com/" />

…이 클러스터를 내장 검사기로 확인한 결과는 다음과 같습니다.

코드는 자동으로 정규화됩니다. en-us 또는 en-US를 입력해도 생성기는 지역 코드를 대문자 형식(en-US)으로 출력합니다.
일반 en 항목은 미국과 영국 이외의 영어 사용자도 올바르게 연결합니다. 자세한 내용은 일반 대체 항목이 없는 지역 변형을 참조하세요.
x-default는 나머지 사용자를 처리합니다. 자세한 내용은 x-default 누락을 참조하세요.
한 페이지의 태그만으로는 양방향성을 확인할 수 없습니다. 생성기가 세트의 모든 페이지에 동일한 전체 블록을 출력하므로 나열된 각 URL도 자동으로 이 URL을 다시 참조합니다.
오류를 시험하려면 en-uk 대신 en-gb를 붙여 넣으세요. 검사기가 수정 방법을 포함한 오류를 표시합니다. 자세한 내용은 코드 형식을 참조하세요.

사용 방법

페이지마다 행을 추가하고 언어 또는 지역마다 열을 만든 뒤 각 URL을 입력합니다.
필요하면 행별 x-default를 설정하거나 기존 사이트맵을 가져와 클러스터를 만듭니다.
head 태그, 사이트맵 XML 또는 HTTP Link 헤더를 복사합니다. 각 페이지에는 완전한 양방향 클러스터가 포함됩니다.
배포된 마크업을 붙여 넣거나 실제 URL을 검사하여 게시 전에 흔한 오류를 찾습니다.

작동 방식과 hreflang 오류 원인

일반 웹페이지의 HTML 템플릿을 관리할 수 있을 때 사용합니다.

대개 가장 명확한 방식입니다. 모든 페이지의 head에 동일한 전체 클러스터를 출력하세요.

템플릿 변경이 어렵거나 많은 URL 변형을 중앙에서 관리할 때 사용합니다.

xhtml:link 항목을 일관되게 사용하고 크롤러가 사이트맵에 접근할 수 있게 유지하세요.

대체 항목이 PDF 또는 HTML이 아닌 리소스일 때 사용합니다.

HTML head가 없는 파일에 적합한 방법입니다. 이유 없이 여러 방식을 섞지 마세요.

hreflang은 페이지의 언어 및 지역 버전을 검색엔진에 알려 사용자에게 알맞은 버전을 제공합니다. 세 가지 전달 방식은 동등합니다. <head>의 <link rel="alternate"> 태그, XML 사이트맵의 xhtml:link 항목, HTTP Link 헤더입니다. 페이지마다 한 가지 방식을 선택하세요. 여러 방식을 섞으면 충돌할 수 있습니다.

구현을 가장 자주 망가뜨리는 규칙은 두 가지입니다. 모든 페이지에 자기 참조 항목이 있어야 하며 각 쌍이 양방향이어야 합니다. A가 B를 나열하면 B도 A를 다시 나열해야 합니다. 생성기는 모든 페이지에 전체 클러스터를 출력하므로 두 규칙을 자동으로 충족합니다.

일반 대체 항목이 없는 지역 변형

en-US와 en-GB를 게시하면서 일반 en 항목이 없으면 다른 지역의 영어 사용자는 일치하는 버전이 없습니다. 일반 en 항목을 추가하세요.

x-default 누락

x-default는 선언된 언어 및 지역과 일치하지 않는 사용자에게 제공할 페이지를 지정합니다. 보통 언어 선택기 또는 기본 버전입니다. 필수는 아니지만 알고리즘에 맡기는 것보다 명시하는 편이 좋습니다.

독립된 언어 선택기 페이지에도 주석이 필요합니다. 같은 head 태그 블록을 넣고 x-default 행을 자기 참조로 사용하면 클러스터가 양방향으로 유지됩니다. 사이트맵에서는 언어 페이지가 아닌 선택기 URL에도 주석이 있는 <url> 항목이 자동으로 추가됩니다.

x-default는 페이지별 주석이기도 합니다. 같은 클러스터의 페이지가 서로 다른 x-default를 가리킬 수 있으므로 행별 x-default 열을 사용하세요.

http/https 혼용 및 일관되지 않은 후행 슬래시

hreflang URL은 canonical URL과 정확히 일치해야 합니다. 일부 항목이 http://를 사용하거나 리디렉션되는 후행 슬래시를 생략하면 Google이 해당 대체 항목을 버릴 수 있습니다. 각 URL의 최종 canonical 형식을 사용하세요.

사용 중단된 언어 코드

일부 ISO 639-1 코드는 이름이 바뀌었지만 오래된 콘텐츠 관리 시스템 내보내기에 남아 있습니다. in → id(인도네시아어), iw → he(히브리어), ji → yi(이디시어)입니다. 최신 코드를 사용하세요.

코드 형식

값은 언어 또는 언어-지역 형식입니다. 두 글자 ISO 639-1 언어 코드에 선택적으로 ISO 3166-1 alpha-2 지역 코드를 붙입니다. 흔한 오류는 en-uk이며 영국 지역 코드는 GB입니다. zh-Hant 및 zh-Hans 같은 문자 체계 subtag도 유효하지만 en_US 같은 밑줄은 사용할 수 없습니다.

언어 및 지역 코드 찾아보기

생성기가 허용하는 ISO 639-1 언어 코드와 ISO 3166-1 지역 코드를 검색합니다. 사용 중단된 언어 별칭은 대체 코드와 함께 표시됩니다.

코드 필터

언어 (188)

aa ab ae af ak am an ar as av ay az ba be bg bh bi bm bn bo br bs ca ce ch co cr cs cu cv cy da de dv dz ee el en eo es et eu fa ff fi fj fo fr fy ga gd gl gn gu gv ha he hi ho hr ht hu hy hz ia id ie ig ii ik in → id io is it iu iw → he ja ji → yi jv ka kg ki kj kk kl km kn ko kr ks ku kv kw ky la lb lg li ln lo lt lu lv mg mh mi mk ml mn mo → ro mr ms mt my na nb nd ne ng nl nn no nr nv ny oc oj om or os pa pi pl ps pt qu rm rn ro ru rw sa sc sd se sg si sk sl sm sn so sq sr ss st su sv sw ta te tg th ti tk tl tn to tr ts tt tw ty ug uk ur uz ve vi vo wa wo xh yi yo za zh zu

지역 (249)

ADAEAFAGAIALAMAOAQARASATAUAWAXAZBABBBDBEBFBGBHBIBJBLBMBNBOBQBRBSBTBVBWBYBZCACCCDCFCGCHCICKCLCMCNCOCRCUCVCWCXCYCZDEDJDKDMDODZECEEEGEHERESETFIFJFKFMFOFRGAGBGDGEGFGGGHGIGLGMGNGPGQGRGSGTGUGWGYHKHMHNHRHTHUIDIEILIMINIOIQIRISITJEJMJOJPKEKGKHKIKMKNKPKRKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMEMFMGMHMKMLMMMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENFNGNINLNONPNRNUNZOMPAPEPFPGPHPKPLPMPNPRPSPTPWPYQARERORSRURWSASBSCSDSESGSHSISJSKSLSMSNSOSRSSSTSVSXSYSZTCTDTFTGTHTJTKTLTMTNTOTRTTTVTWTZUAUGUMUSUYUZVAVCVEVGVIVNVUWFWSYEYTZAZMZW

방법론

이 도구는 URL과 locale별로 한 행씩 입력받아 클러스터를 만들고 하위 태그를 정규화한 다음, 자기 참조를 포함한 동일한 완전 세트를 각 페이지에 출력합니다. 이어서 코드, URL, 중복, 프로토콜, 후행 슬래시, x-default 및 상호 참조에 결정론적 규칙을 적용합니다. 게시된 페이지 검사에서는 제공된 URL과 대체 URL 최대 25개를 가져와 반환 링크, 자기 참조 및 canonicalization을 비교합니다. 선택적인 게시 페이지 검사 요청을 제외한 모든 과정은 브라우저에서 이루어집니다.

기능

자기 참조를 포함하여 각 페이지 세트에 대한 완전한 양방향 클러스터를 생성합니다.
head 태그, 50,000 URL 초과 시 자동 분할되는 사이트맵 XML, HTTP Link 헤더 및 널리 쓰이는 웹 프레임워크용 코드 조각을 출력합니다.
언어 및 지역 코드를 정규화하고 밑줄, 폐기된 코드, 유효하지 않은 지역을 감지합니다.
중복 locale 및 URL, 혼합 프로토콜, 일관되지 않은 후행 슬래시, 상호 참조 오류, 누락된 x-default를 검사합니다.
CSV 또는 TSV 행이나 sitemap의 xhtml:link 항목을 가져와 분석 전체를 브라우저에서 실행합니다.
게시된 URL 하나와 선언된 대체 URL 최대 25개에서 반환 링크와 자기 참조를 확인합니다.

제한 사항

브라우저에서 실행되므로 붙여 넣은 입력과 로컬 생성 과정은 검색 데이터베이스를 조회하지 않습니다.
게시된 URL 검사는 페이지에 접근할 수 있어야 하며 대체 URL 25개와 디코딩된 본문 2 MiB로 제한됩니다.
린터는 제공된 데이터만 검증합니다. Google 색인 여부, 비공개 콘텐츠 또는 검색엔진이 선택할 URL은 확인할 수 없습니다.
sitemap 분할은 생성된 출력이 URL 50,000개를 초과할 때 적용되며 다운로드에는 인덱스와 모든 분할 파일이 포함됩니다.

자주 묻는 질문

hreflang 태그는 head, sitemap, HTTP 헤더 중 어디에 넣어야 하나요?

세 방법은 모두 사용할 수 있고 동등하지만 페이지마다 한 가지 방법을 선택하세요. HTML head의 <link rel="alternate"> 태그, XML sitemap의 xhtml:link 항목 또는 HTTP Link 헤더를 사용할 수 있습니다. PDF 같은 비 HTML 파일에는 HTTP Link 헤더만 사용할 수 있습니다. 한 페이지에서 여러 방법을 섞으면 충돌이 생길 수 있습니다.

x-default란 무엇이며 꼭 필요한가요?

x-default는 선언된 locale과 일치하지 않는 사용자에게 제공할 페이지를 지정합니다. 일반적으로 언어 선택기나 기본 버전입니다. 선택 사항이지만 알고리즘에 선택을 맡기는 것보다 명시하는 편이 좋으므로 대부분의 사이트에 권장됩니다.

hreflang 태그가 무시되는 이유는 무엇인가요?

대부분 세 가지 중 하나입니다. 주석이 양방향이 아니거나(A 페이지는 B를 나열하지만 B는 A를 되돌려 나열하지 않음), 페이지의 자기 참조가 빠졌거나, URL이 canonical 형식과 일치하지 않아(http와 https 차이 또는 사이트가 리디렉션하는 후행 슬래시 등) 리디렉션을 거칩니다. 이 생성기는 앞의 두 문제를 방지하도록 자기 참조가 포함된 완전한 양방향 클러스터를 출력합니다.

hreflang 태그와 canonical 태그가 충돌하나요?

둘은 서로 일치해야 합니다. 각 언어 버전에는 다른 언어가 아닌 자기 자신을 가리키는 canonical이 있어야 하며 모든 hreflang URL은 해당 페이지의 canonical 형식이어야 합니다. 비 canonical URL이나 리디렉션 URL을 가리키는 hreflang은 자주 제외됩니다.

en-uk는 유효한 hreflang 값인가요?

아닙니다. 영국의 지역 코드는 GB이므로 en-gb를 사용하세요. hreflang 값은 ISO 639-1 언어 코드와 선택적 ISO 3166-1 alpha-2 지역 코드로 이루어집니다. en-uk는 가장 흔한 오류입니다.

다음 단계SEO 사고 시뮬레이터 — practice the same investigation on labeled fixtures. 안내는 영어로 제공됩니다.

자주 발생하는 문제와 해결 방법

오류 언어 코드가 유효하지 않습니다 해결 방법: 언어 하위 태그를 en, fr, de 같은 유효한 ISO 639-1 코드로 바꾸세요.
오류 지역 코드가 유효하지 않습니다 해결 방법: 지역 하위 태그를 US 또는 GB 같은 유효한 대문자 ISO 3166-1 alpha-2 코드로 바꾸세요.
오류 hreflang에 하이픈 대신 밑줄이 사용되었습니다 해결 방법: locale 구분자를 밑줄에서 하이픈으로 바꾸세요. 예: en_US → en-US.
오류 locale이 중복되었습니다 해결 방법: 언어-지역 값마다 대체 URL 하나만 남기고 중복 locale 행을 삭제하거나 병합하세요.
경고 하나의 URL이 여러 locale에 지정되었습니다 해결 방법: 각 대체 URL을 실제 locale에 지정하고 동일한 현지화 페이지를 가리키는 두 번째 locale을 삭제하세요.
경고 x-default 대체 항목이 없습니다 해결 방법: 일치하지 않는 사용자를 위한 중립 언어 선택기나 가장 적절한 기본 페이지를 가리키는 x-default 대체 항목을 하나 추가하세요.
오류 대체 URL이 유효하지 않습니다 해결 방법: 공백이나 잘못된 문자가 없고 파싱 가능한 http:// 또는 https:// URL로 수정하세요.
오류 대체 URL이 절대 URL이 아닙니다 해결 방법: 상대 대체 URL을 호스트 이름과 경로가 포함된 전체 canonical https:// URL로 확장하세요.