페이지에 구조화된 데이터를 삽입하면 Google 검색결과에서 특별한 기능을 사용할 수 있게 되며, 리치 결과 테스트를 통해 구조화된 데이터를 테스트할 수 있습니다.
테스트 실행하기
URL
테스트할 페이지의 전체 URL을 제출합니다. 중요: 인터넷에서 코드에 액세스하는 익명의 사용자가 모든 페이지 리소스에 액세스할 수 있어야 합니다. 방화벽이나 비밀번호로 보호된 리소스는 테스트할 수 없습니다. 페이지가 방화벽의 보호를 받거나 로컬 컴퓨터에 호스팅되어 있는 경우 터널을 노출하는 방법으로 테스트할 수 있습니다.
코드 스니펫
이 도구를 사용하여 임의의 코드 스니펫을 테스트할 수 있습니다. 도구 방문 페이지에서 테스트 URL 대신 코드를 선택한 다음 테스트할 코드를 붙여넣으세요. 필요할 때마다 코드를 수정하고 테스트 실행을 클릭하여 테스트를 다시 실행할 수 있습니다.
사용자 에이전트 선택(선택 사항)
페이지를 테스트할 때 사용할 사용자 에이전트를 선택할 수 있습니다. 다시 말해 페이지를 스마트폰으로 테스트할지 아니면 데스크톱 컴퓨터로 테스트할지 선택합니다. 입력한 URL 또는 코드 입력 텍스트 상자 아래 목록에서 사용자 에이전트를 선택합니다.
휴대기기를 통해 웹페이지에 액세스하는 사용자의 증가 추세를 반영한 Google의 모바일 우선 정책으로 인해 기본 사용자 에이전트는 스마트폰으로 설정되어 있습니다. 사이트가 모바일 우선이라면 데스크톱 사용자 에이전트를 사용해야 할 특별한 이유가 없는 한 스마트폰 사용자 에이전트로 테스트하는 것이 좋습니다. 오늘날 대부분의 사용자가 휴대기기로 웹을 이용하기 때문에 Google에서는 모든 사이트에 모바일 사용자 에이전트 사용을 권장합니다.
속성의 설정 페이지에서 내 사이트가 모바일 우선 사이트인지 확인할 수 있습니다.
지원되는 구조화된 데이터 형식
리치 결과 테스트에서는 JSON-LD, RDFa, 마이크로데이터 형식의 구조화된 데이터를 지원합니다.
결과 검토하기
테스트를 통해 페이지에서 발견된 리치 결과 유형은 물론 구조화된 데이터에 포함된 오류 및 구조화된 데이터와 관련된 제안사항을 확인할 수 있습니다.
오류나 경고가 있는 경우 각 항목을 펼쳐서 세부정보를 확인하고 설명을 클릭하여 해당 위치에서 코드 탐색기를 열 수 있습니다. 탐색기에는 렌더링된 소스 코드가 사용됩니다.
테스트 결과에는 다음 영역이 포함됩니다.
URL 상태
도구는 테스트된 URL에 대해 다음과 같은 상태 값을 보고할 수 있으며 N은 발견된 항목 수를 뜻합니다.
N개의 유효한 항목이 감지됨
감지된 항목 없음
N개의 경고 및 유효한 항목이 감지됨
N개의 항목이 감지됨: 일부 항목이 잘못됨
N개의 유효한 항목이 감지됨크롤링
이 섹션에서는 Google의 페이지 크롤링 허용 여부를 설명합니다. Google이 정기적인 크롤링 주기 내에 페이지를 크롤링하지 못한 경우(예: robots.txt 규칙 또는 NOINDEX 명령어로 인해 크롤링을 할 수 없음) 이 도구로 페이지를 테스트할 수 없습니다.
- 크롤링 완료/크롤링 실패:
- 크롤링에 사용된 에이전트: 크롤링에 사용된 사용자 에이전트 유형(스마트폰 또는 데스크톱)을 표시합니다.
- 크롤링 허용 여부 사이트의 robots.txt 규칙으로 인해 이 페이지가 크롤링되지 않는지 테스트합니다.
- 페이지 가져오기: 테스트에서 페이지를 가져올 수 있는지를 나타냅니다. 크롤링에 실패하면 이것도 항상 실패합니다.
감지된 항목/감지된 구조화된 데이터
페이지에서 구조화된 데이터 항목 발견 여부 구조화된 데이터를 찾았지만 파싱할 수 없는 경우 여기에 표시됩니다. 양호, 경고 또는 오류가 있거나 파싱할 수 없는 모든 항목은 항목 설명 및 문제와 함께 여기에 표시됩니다.
어떤 이유로든 도구가 페이지에 액세스할 수 없는 경우에는 문제를 설명하는 오류 메시지가 표시됩니다. 액세스 문제에는 네트워크 연결 문제 또는 사이트 다운 등이 포함됩니다.
테스트가 페이지에서 사용되는 특정 리소스를 로드할 수 없는 경우 경고 메시지가 표시됩니다. 리소스는 자바스크립트 파일과 같이 페이지에 포함된 외부 요소입니다. 리치 결과 테스트는 특정 유형의 리소스만 로드하려고 시도하며 테스트에 영향을 주지 않는 다른 리소스는 무시됩니다.
다음은 리소스 로드 문제가 발생하는 일반적인 원인입니다.
- 리소스를 적당한 시간 내에 로드하지 못했습니다. 이 경우 테스트를 다시 실행해 보세요. 문제가 계속 발생하면 다른 위치에서 리소스를 호스팅하거나, 호스트에서 응답이 없는 이유를 찾아 수정하세요.
- 참조된 URL에 리소스가 존재하지 않습니다(404 오류). 리소스 URL을 수정하세요.
- 로그인하지 않은 사용자가 리소스에 액세스할 수 없습니다. 테스트는 익명의 사용자로서 페이지에 액세스하므로 익명의 사용자가 모든 리소스에 액세스할 수 있어야 합니다.
- robots.txt 파일로 인해 Googlebot이 리소스에 액세스하지 못하도록 차단되었습니다. 중요한 리소스(아래 참고)인 경우, 리소스가 내 사이트에 있다면 Googlebot이 리소스에 액세스할 수 있도록 차단을 해제하는 것이 좋습니다. 반면에 리소스가 다른 사이트에 있다면 사이트의 웹마스터에게 문의하여 차단을 해제하도록 요청하는 것이 좋습니다.
중요한 리소스 차단 해제
중요한 리소스가 차단된 경우 Google에서 페이지를 이해하는 데 큰 영향을 줄 수 있습니다. 예를 들어 페이지 DOM 생성을 처리하는 자바스크립트를 로드하지 못하면 문제가 발생할 수 있습니다. 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의 구조화된 데이터 개요를 확인하면 됩니다.
