페이지에 구조화된 데이터를 삽입하면 Google 검색결과에서 특별한 기능을 사용할 수 있게 되며, 리치 결과 테스트를 통해 구조화된 데이터를 테스트할 수 있습니다.
테스트 실행
URL |
테스트할 페이지의 전체 URL을 제출합니다. 중요: 인터넷에서 코드에 액세스하는 익명의 사용자가 모든 페이지 리소스에 액세스할 수 있어야 합니다. 방화벽이나 비밀번호로 보호된 리소스는 테스트할 수 없습니다. 페이지가 방화벽의 보호를 받거나 로컬 컴퓨터에 호스팅되어 있는 경우 터널을 노출하는 방법으로 테스트할 수 있습니다.
|
---|---|
코드 스니펫 | 이 도구를 사용하여 임의의 코드 스니펫을 테스트할 수 있습니다. 도구 방문 페이지에서 테스트 URL 대신 코드를 선택한 다음 테스트할 코드를 붙여넣으세요. 필요할 때마다 코드를 수정하고 테스트 실행을 클릭하여 테스트를 다시 실행할 수 있습니다. |
사용자 에이전트 선택(선택사항) | 페이지를 테스트할 때 사용할 사용자 에이전트를 선택할 수 있습니다. 다시 말해 페이지를 스마트폰으로 테스트할지 아니면 데스크톱 컴퓨터로 테스트할지 선택할 수 있습니다. 입력한 URL 또는 코드 입력 텍스트 상자 아래 목록에서 사용자 에이전트를 선택하세요. 오늘날 대부분의 사용자가 휴대기기로 웹을 이용하기 때문에 기본 사용자 에이전트는 스마트폰으로 설정되어 있습니다. |
지원되는 구조화된 데이터 형식
리치 결과 테스트에서는 JSON-LD, RDFa, 마이크로데이터 형식의 구조화된 데이터를 지원합니다.
결과 검토하기
테스트를 통해 페이지에서 발견된 리치 결과 유형은 물론 구조화된 데이터에 포함된 오류 및 구조화된 데이터와 관련된 제안사항을 확인할 수 있습니다.
오류나 경고가 있는 경우 각 항목을 펼쳐서 세부정보를 확인하고 설명을 클릭하여 해당 위치에서 코드 탐색기를 열 수 있습니다. 탐색기에는 렌더링된 소스 코드가 사용됩니다.
테스트 결과에는 다음 영역이 포함됩니다.
URL 상태
도구는 테스트된 URL에 대해 다음과 같은 상태 값을 보고할 수 있습니다. 여기서 N은 발견된 항목 수를 뜻합니다.
N개의 유효한 항목이 감지됨
감지된 항목 없음
N개의 경고 및 유효한 항목이 감지됨
N개의 유효한 항목이 감지됨: 모든 항목에 경고가 있음
N개의 유효한 항목이 감지됨: 일부 항목에 경고가 있음
N개의 항목이 감지됨: 일부 항목이 잘못됨
N개의 잘못된 항목이 감지됨
URL을 크롤링할 수 없음
문법 오류가 있는 구조화된 데이터가 감지됨
크롤링
이 섹션에서는 Google의 페이지 크롤링 허용 여부를 설명합니다. Google이 정기적인 크롤링 주기 내에 페이지를 크롤링하지 못한 경우(예: robots.txt 규칙 또는 NOINDEX 명령어로 인해 크롤링을 할 수 없음) 이 도구로 페이지를 테스트할 수 없습니다.
- 크롤링 완료 / 크롤링 실패: '크롤링 완료' 메시지는 Google에서 페이지에 액세스할 수 있었음을 의미하며, '크롤링 실패' 메시지는 Google에서 페이지에 액세스할 수 없었음을 의미합니다.
- 크롤링에 사용된 에이전트: 크롤링에 사용된 사용자 에이전트 유형(스마트폰 또는 데스크톱)을 표시합니다.
- 크롤링 허용 여부: 사이트의 robots.txt 규칙으로 인해 이 페이지가 크롤링되지 않는지 테스트합니다.
- 페이지 가져오기: 테스트에서 페이지를 가져올 수 있는지를 나타냅니다. 크롤링에 실패하면 이것도 항상 실패합니다.
감지된 항목/감지된 구조화된 데이터
페이지에서 구조화된 데이터 항목 발견 여부 구조화된 데이터를 찾았지만 파싱할 수 없는 경우 여기에 표시됩니다. 양호, 경고 또는 오류가 있거나 파싱할 수 없는 모든 항목은 항목 설명 및 문제와 함께 여기에 표시됩니다.
오류
어떤 이유로든 도구가 페이지에 액세스할 수 없는 경우 다음 오류 중 하나가 표시됩니다.
- DNS 서버가 응답하지 않음: 대개 일시적인 문제이며 몇 분 안에 저절로 해결됩니다.
- DNS 오류: 알 수 없는 호스트: DNS 서버에서 URL을 확인하지 못합니다. 이는 몇 분 내에 저절로 해결되는 일시적인 문제일 수 있습니다.
- DNS 오류: 비공개 IP 제공됨: DNS에서 RFC 1918 비공개 IP(예: 10.0.0.1)와 같이 특수/비공개 제외 범위에 있는 IP를 반환했습니다.
- 서버 연결 오류: 서버에 연결할 수 없거나 연결이 거부되었거나 연결에 실패했습니다. 자세히 알아보기
- 잘못된 서버 응답: 서버에서 요청된 프로토콜을 지원하지 않습니다. 응답 또는 헤더가 잘렸거나 응답을 파싱할 수 없습니다(예: 응답 데이터가 잘못 압축된 경우). 자세히 알아보기
- 잘못된 서버 SSL 인증서: 사이트의 SSL 인증서가 유효하지 않습니다. Google은 인증서가 유효하지 않으면 사이트의 HTTPS URL을 테스트하지 않습니다.
- Robots.txt를 찾을 수 없음: Google은 robots.txt 파일이 존재하지만 찾을 수 없는 경우 웹사이트를 크롤링하지 않습니다. robots.txt를 사용할 수 있는지는 크롤링 통계 보고서에서 확인할 수 있습니다.
- 호스트 로드 초과: 사이트가 Google 크롤링 또는 검사 요청의 최대 용량에 도달한 것으로 보입니다. Google에서 예상한 트래픽 로드가 감소할 때까지 Google에서 테스트를 실행할 수 없습니다.
테스트가 페이지에서 사용되는 모든 리소스를 로드할 수 없는 경우 경고 메시지가 표시됩니다. 리소스는 이미지, CSS 또는 스크립트 파일과 같이 페이지에 포함된 외부 요소입니다. 이 테스트에서는 특정 유형의 리소스만 로드하려고 시도합니다. 테스트에 영향을 주지 않는 다른 요소는 무시됩니다.
로드 문제는 다음과 같은 여러 가지 이유로 발생할 수 있습니다.
- 리소스를 적당한 시간 내에 로드할 수 없습니다. 이 경우 테스트를 다시 실행해 보세요. 문제가 계속 발생하면 다른 위치에서 리소스를 호스팅하거나, 호스트에서 응답이 느리거나 없는 이유를 찾아 수정하세요.
- 리소스가 명시된 위치에 존재하지 않습니다(404 오류). 페이지에서 리소스의 URL을 확인하고 수정합니다.
- 로그인하지 않은 사용자가 리소스에 액세스할 수 없습니다. 테스트는 익명의 사용자로서 페이지에 액세스하므로 익명의 사용자가 모든 리소스에 액세스할 수 있어야 합니다.
- robots.txt 파일로 인해 Googlebot이 리소스에 액세스하지 못하도록 차단되었습니다. 중요한 리소스(아래 참고)이고 리소스가 내 사이트에 있다면 Googlebot이 리소스에 액세스할 수 있도록 차단을 해제하는 것이 좋습니다. 리소스가 다른 사이트에 있다면 사이트의 웹마스터에게 문의하여 차단을 해제하도록 요청하는 것이 좋습니다.
중요한 리소스 차단 해제
중요한 리소스가 차단된 경우 Google에서 페이지를 이해하는 데 큰 영향을 줄 수 있습니다. 예를 들어 큰 이미지가 차단되면 페이지가 모바일 친화적이지 않은데도 그렇게 보일 수 있고, CSS 파일이 차단되면 잘못된 글꼴 스타일이 적용될 수 있습니다(예: 기기에 비해 너무 작은 글꼴). 이는 Google에서 페이지를 크롤링하는 기능에 영향을 미치며, Google 검색결과에 영향을 줄 수 있습니다. robots.txt로 인해 Googlebot이 중요한 리소스에 액세스하지 못하는 일이 없도록 확인하고 누구나 리소스에 액세스할 수 있도록 설정하시기 바랍니다.
일치하지 않는 테스트 결과/페이지 로드 문제
로드 불가능한 리소스가 있거나 다른 페이지 로드 문제가 있다면 테스트를 실행할 때마다 결과가 조금씩 달라질 수 있습니다. 로드되는 리소스 집합이 테스트를 실행할 때마다 달라질 수 있기 때문입니다. 아무것도 변경하지 않았는데도 테스트를 실행할 때마다 페이지 렌더링이 바뀐다면 '페이지 로드 문제' 경고가 있는지 확인하세요. 경고가 있다면 경고를 클릭하여 어떤 문제로 인해 페이지가 일관되고 정확하게 렌더링되지 않는지 자세히 알아볼 수 있습니다.
오류 유형 | 설명 |
---|---|
잘못된 JSON 문서 | JSON에 최상위 구문 오류가 있습니다. |
잘못된 값 유형 | 필드에 지정된 값의 유형이 잘못되었습니다. 예를 들어, 숫자 또는 배열이 있어야 할 자리에 문자열이 지정되어 있습니다. 특정 필드에 필요한 값 유형을 알아보려면 구조화된 데이터 문서를 참고하세요. |
파싱 오류: ':' 누락 | 필드와 값 사이에 ':' 표시가 누락되었습니다. |
파싱 오류: ',' 또는 '}' 누락 | 쉼표 또는 닫는 중괄호가 누락되었습니다. |
파싱 오류: '}' 또는 개체 구성 요소 이름 누락 |
닫는 중괄호 또는 개체 구성 요소 이름이 누락되었습니다. |
파싱 오류: 배열 선언에 ',' 또는 ']' 누락 | 배열 값 파싱 오류: 배열 선언에 쉼표 또는 닫는 대괄호가 누락되었습니다. |
토큰 길이를 파싱할 수 없음 | 어떤 이유로든 속성이나 값의 시작과 끝을 찾을 수 없습니다. |
잘못된 숫자 | 속성 값이 숫자여야 하나 다른 값 유형이 사용되었습니다. |
문자열의 이스케이프 시퀀스가 비어 있음 |
문자열 값에 빈 이스케이프 시퀀스 문자가 포함되어 있습니다. 예를 들면 다음과 같습니다.
이를 올바르게 고치면 다음과 같습니다.
|
문자열의 이스케이프 시퀀스가 잘못됨 |
문자열 값에 잘못된 이스케이프 시퀀스가 사용되었습니다. 예를 들면 다음과 같습니다. "description" : "Some \q unknown sequence" |
잘린 유니코드 문자 | 유니코드 서로게이트 쌍에 마지막 6자리 문자가 누락되었습니다. |
잘못된 유니코드 문자 | 유니코드 서로게이트 쌍의 뒤 절반 부분 시작 위치에 \u 토큰이 누락되었습니다. |
잘못된 유니코드 이스케이프 시퀀스: 4진수 필요 | 유니코드 이스케이프 시퀀스에 구문 오류가 있습니다. 4진수가 포함되어 있어야 합니다. |
잘못된 유니코드 이스케이프 시퀀스: 16진수 필요 | 유니코드 이스케이프 시퀀스에 구문 오류가 있습니다. 16진수를 사용해야 하는데 16진수가 입력되지 않았습니다. |
고유 속성 중복 | 구조화된 데이터 개체의 고유한 속성에 2개의 정의를 입력했습니다. 예를 들어 @context 값이 2개 있습니다. |
잘못된 최상위 요소 | JSON-LD의 최상위 요소가 잘못되었습니다. |
존재하지 않는 항목 참조 | itemref 속성이 존재하지 않는 식별자를 가리킵니다. |
지원되는 리치 결과 유형
테스트에서는 현재 다음의 리치 결과 유형이 제공됩니다.
테스트 기록 저장
Search Console은 테스트가 실행될 때마다 코드와 테스트 상태를 저장합니다. 코드 및 테스트의 버전 기록을 저장하려면 테스트를 실행한 후 페이지 URL을 북마크에 추가하세요. 테스트 기록은 약 90일 동안 저장됩니다. 이러한 북마크에는 누구나 액세스할 수 있습니다.
테스트 결과 공유
공유 버튼을 사용하여 테스트 결과의 브라우저 링크를 원하는 사용자와 공유할 수 있습니다. 테스트 결과를 보는 데는 권한이 필요하지 않습니다. 테스트 결과 링크는 약 90일 동안 유효합니다.
Google 검색결과에 페이지가 어떻게 표시되는지 확인
일부 리치 결과 유형의 경우 Google 검색 또는 Google 어시스턴트에서 검색결과가 어떻게 표시될지 미리 볼 수 있습니다. 다양한 검색결과 레이아웃이 가능한 페이지의 경우, 이 도구에 포함된 선택기를 사용하여 데스크톱 및 모바일 검색용 레이아웃 등 여러 레이아웃을 미리 볼 수 있습니다.
새 레이아웃을 만들 때 코드를 변경하고 테스트를 재실행하여 페이지를 실험할 수 있습니다. 브라우저의 URL을 다른 사용자와 공유하여 렌더링된 결과를 공유할 수도 있습니다.
도구가 페이지에서 찾은 내용에 따라 확인할 결과 유형을 선택하고 데스크톱 또는 모바일 버전 중에 선택할 수 있습니다.
Google은 페이지가 여기에 나타난 그대로 표시되거나 표시된 보기가 페이지 결과에 적용된다고 보장하지 않습니다. Google은 사용자의 검색 기록, 위치 및 기타 여러 변수를 바탕으로 검색 요청에 가장 적합한 결과를 표시합니다.
구조화된 데이터 리소스 더보기
다음은 구조화된 데이터 및 Google 검색결과 기능에 관한 추가 리소스입니다.
- 구조화된 데이터 갤러리에서는 Google 검색에서 지원되는 검색결과 기능을 확인할 수 있습니다.
- 이러한 기능을 사용 설정하려는 웹페이지 개발자는 Google의 구조화된 데이터 개요를 확인하면 됩니다.