이 보고서는 심각한 구문 오류로 인해 파싱할 수 없는 구조화된 데이터가 사이트에서 발견되었음을 보여 줍니다. 파싱 오류로 인해 구조화된 데이터의 의도된 유형(채용 정보, 이벤트 등)을 확인할 수 없습니다.
보고서 사용
이 보고서에 나타난 모든 항목은 구조화된 데이터 오류입니다. 경고 또는 유효한 항목은 표시되지 않습니다.
오류는 가장 많은 영향을 받은 페이지 및 기타 요인에 따라 결정되는 심각도를 기준으로 자동 정렬됩니다.
하나의 오류가 여러 페이지에 영향을 미치는 경우 가장 흔한 원인은 근본적인 템플릿 오류입니다.
- 오류 행을 클릭하면 영향을 받은 페이지, 오류 세부정보, 디버깅 도구 링크를 볼 수 있습니다. 아래 표에서 오류 유형에 관한 전체 설명을 참조하세요.
- 리치 결과 테스트를 사용하여 구조화된 데이터의 문법을 수정하고 테스트합니다. 오류를 찾는 데 문제가 있는 경우 빈 객체에서 시작하여 오류를 찾을 때까지 손상된 코드의 콘텐츠를 다시 추가합니다. 결과 관련 오류를 수정하려면 특정 데이터 유형에 대한 구조화된 데이터 문서를 참고하세요.
- 문제를 수정한 후 오류 세부정보 페이지의 수정 결과 확인을 클릭합니다.
파싱 오류를 수정한 후에는 항목을 전혀 파싱할 수 없어서 숨겨져 있었던 추가 경고나 오류가 발생할 수 있습니다.
보고서 공유하기
페이지에서 공유 버튼을 클릭하여 범위 또는 개선사항 보고서에 표시된 문제 세부정보를 공유할 수 있습니다. 링크가 있는 모든 사용자는 현재 문제 세부정보 페이지 및 이 문제에 관한 유효성 검사 내역에만 액세스할 수 있습니다. 리소스의 다른 페이지에 액세스할 수는 없으며 공유 사용자는 속성이나 계정에 관한 작업을 할 수 없습니다. 언제든지 이 페이지의 공유를 사용 중지하여 링크를 취소할 수 있습니다.
보고서 데이터 내보내기
대부분의 보고서에서 내보내기 버튼 으로 보고서 데이터를 내보낼 수 있습니다. 차트 및 표 데이터를 모두 내보낼 수 있으며 보고서에 ~ 또는 - 기호(사용할 수 없거나 숫자 값이 아님)로 표시되는 값은 다운로드한 데이터에 0으로 나타납니다.
오류 유형
이 보고서에는 다음 오류 유형이 표시됩니다.
오류 유형 | 설명 |
---|---|
잘못된 JSON 문서 | JSON에 최상위 구문 오류가 있습니다. |
잘못된 값 유형 | 필드에 지정된 값의 유형이 잘못되었습니다. 예를 들어, 숫자 또는 배열이 있어야 할 자리에 문자열이 지정되어 있습니다. 특정 필드에 필요한 값 유형을 알아보려면 구조화된 데이터 문서를 참고하세요. |
파싱 오류: ':' 누락 | 필드와 값 사이에 ':' 표시가 누락되었습니다. |
파싱 오류: ',' 또는 '}' 누락 | 쉼표 또는 닫는 중괄호가 누락되었습니다. |
파싱 오류: '}' 또는 개체 구성 요소 이름 누락 |
닫는 중괄호 또는 개체 구성 요소 이름이 누락되었습니다. |
파싱 오류: 배열 선언에 ',' 또는 ']' 누락 | 배열 값 파싱 오류: 배열 선언에 쉼표 또는 닫는 대괄호가 누락되었습니다. |
토큰 길이를 파싱할 수 없음 | 어떤 이유로든 속성이나 값의 시작과 끝을 찾을 수 없습니다. |
잘못된 숫자 | 속성 값이 숫자여야 하나 다른 값 유형이 사용되었습니다. |
문자열의 이스케이프 시퀀스가 비어 있음 |
문자열 값에 빈 이스케이프 시퀀스 문자가 포함되어 있습니다. 예를 들면 다음과 같습니다.
이를 올바르게 고치면 다음과 같습니다.
|
문자열의 이스케이프 시퀀스가 잘못됨 |
문자열 값에 잘못된 이스케이프 시퀀스가 사용되었습니다. 예를 들면 다음과 같습니다. "description" : "Some \q unknown sequence" |
잘린 유니코드 문자 | 유니코드 서로게이트 쌍에 마지막 6자리 문자가 누락되었습니다. |
잘못된 유니코드 문자 | 유니코드 서로게이트 쌍의 뒤 절반 부분 시작 위치에 \u 토큰이 누락되었습니다. |
잘못된 유니코드 이스케이프 시퀀스: 4진수 필요 | 유니코드 이스케이프 시퀀스에 구문 오류가 있습니다. 4진수가 포함되어 있어야 합니다. |
잘못된 유니코드 이스케이프 시퀀스: 16진수 필요 | 유니코드 이스케이프 시퀀스에 구문 오류가 있습니다. 16진수를 사용해야 하는데 16진수가 입력되지 않았습니다. |
고유 속성 중복 | 구조화된 데이터 개체의 고유한 속성에 2개의 정의를 입력했습니다. 예를 들어 @context 값이 2개 있습니다. |
잘못된 최상위 요소 | JSON-LD의 최상위 요소가 잘못되었습니다. |
존재하지 않는 항목 참조 | itemref 속성이 존재하지 않는 식별자를 가리킵니다. |
문제 세부정보 페이지
리치 결과 요약 페이지에서 문제 행을 선택하면 문제의 세부정보가 포함된 페이지가 열립니다. 하나의 문제가 여러 다른 페이지의 항목에 영향을 주거나 단일 페이지의 여러 항목에 영향을 줄 수 있습니다.
문제 세부정보 페이지에는 다음과 같은 정보가 있습니다.
- 상태
- 이 문제의 유효성 상태입니다.
- 처음 감지된 날짜
- 사이트에서 이 문제가 처음 발견된 날짜입니다. 이 유형의 문제가 모두 해결되고 나서 마지막 사례가 수정된 이후 90일 이내에 이 문제의 새로운 사례가 나타나는 경우, 이 날짜는 새로 나타난 날짜가 아니라 원래 처음 감지된 날짜가 됩니다.
- 예
- 이 문제의 영향을 받은 리치 결과 목록입니다. 사이트의 마지막 크롤링 이후에 나타난 사례 또는 1,000개가 넘는 항목에 영향을 미치는 문제 등 다양한 이유로 사이트에서 발생하는 이 문제의 모든 사례가 목록에 표시되지는 않을 수도 있습니다.
- 최종 크롤링
- 이 문제가 있는 페이지가 언제 마지막으로 크롤링되었는지 표시됩니다.
수정 결과를 확인하는 이유
특정 상태의 문제 또는 특정 카테고리의 문제를 모두 해결했다고 Google에 알리면 다음과 같은 이점이 있습니다.
- Google로부터 모든 URL에서 수정 결과를 확인했다는 이메일 또는 해당 문제의 인스턴스가 남아 있음을 발견했다는 이메일을 받게 됩니다.
- Google의 수정 결과 확인이 얼마나 진행되었는지 추적할 수 있고, 확인을 위해 대기열에 추가된 모든 페이지의 기록 및 각 URL의 수정 상태도 살펴볼 수 있습니다.
웹사이트의 특정 문제를 수정하고 확인할 필요가 없는 경우도 있습니다. 예를 들어 robots.txt에 의해 차단된 URL은 의도적으로 차단되었을 가능성이 높습니다. 특정 문제를 해결해야 하는지는 스스로의 판단으로 결정하세요.
문제를 해결한 후 유효성 검사를 실행하지 않아도 됩니다. 수정 결과 확인을 명시적으로 요청했는지와 관계없이 Google에서는 알려진 문제가 있는 페이지를 크롤링할 때마다 인스턴스 수를 업데이트합니다.
수정 결과 확인 시작
Search Console에 문제를 해결했다고 알리려면 다음 단계를 따르세요.
- 사이트에서 문제의 모든 인스턴스를 수정합니다. 수정 시 누락되는 경우 해당 문제의 인스턴스가 하나만 남아 있더라도 Google에서 이를 발견하면 확인이 중지됩니다.
- 수정한 문제의 세부정보 페이지를 엽니다. 보고서의 문제 목록에서 문제를 클릭합니다.
- ⚠️ 보고서가 특정 사이트맵으로 필터링된 경우 검사를 요청한 시점의 사이트맵 항목에만 검사가 적용됩니다. 사용자의 실제 의도와 무관하게 적용되는 사항이므로 유의해 주시기 바랍니다.
- 수정 결과 확인을 클릭합니다. 확인에 성공하거나 실패할 때까지는 '수정 결과 확인'을 다시 클릭하지 마세요. Google에서 수정 결과를 확인하는 방법에 관해 자세히 알아보세요.
- 확인 진행 상황을 모니터링할 수 있습니다. 수정 결과를 확인하는 데는 일반적으로 최대 2주가 소요되지만 더 오래 걸리는 경우도 있으니 기다려 주시기 바랍니다. 확인에 성공하거나 실패하면 알림이 전송됩니다.
- 확인에 실패하면 문제 세부정보 페이지에서 세부정보 보기를 클릭하여 실패한 URL을 확인할 수 있습니다. 이 페이지를 수정하고 대기 중 상태인 모든 URL의 수정 결과를 확인한 후 확인을 다시 시작합니다.
URL이나 항목의 문제는 어떤 경우에 '수정됨' 상태로 간주되나요?
다음 조건을 하나라도 충족하면 URL이나 항목 문제가 수정됨으로 표시됩니다.
- URL이 크롤링되고 페이지에서 문제가 더 이상 발견되지 않는 경우: AMP 태그 오류라면 태그를 수정했거나 태그가 삭제되었다는(필요하지 않은 태그인 경우) 의미일 수 있습니다. 확인을 시도하는 동안에는 통과로 표시됩니다.
- 페이지 삭제, NOINDEX로 표시, 승인 필요 등 어떤 이유에서든 Google에서 페이지에 액세스할 수 없는 경우 해당 URL의 문제가 해결된 것으로 간주됩니다. 확인을 시도하는 동안에는 기타 확인 상태로 분류됩니다.
문제의 전체 기간
문제의 전체 기간은 사이트에서 문제의 인스턴스가 처음 감지된 시점부터 마지막 인스턴스가 해결된 것으로 표시된 후 90일까지입니다. 문제가 재발하지 않고 90일이 지나면 문제 표에서 삭제됩니다.
문제가 처음 감지된 날짜는 전체 기간 중 문제가 처음 감지된 시점이며 변경되지 않습니다. 따라서 날짜는 다음과 같이 계산합니다.
- 문제의 모든 인스턴스가 수정됐지만 15일이 지나서 새로운 인스턴스가 발생하는 경우, 문제가 '미해결'로 표시되고 처음 감지된 날짜는 원래 날짜로 유지됩니다.
- 마지막 인스턴스가 수정된 후 91일째에 같은 문제가 발생하는 경우 이전 문제는 종료되었으므로 새로운 문제로 기록되고 처음 감지된 날짜는 새롭게 감지된 날짜로 설정됩니다.
다음은 문제의 수정 결과 확인을 클릭한 후 진행되는 확인 프로세스의 개요입니다. 이 프로세스는 며칠이 넘게 걸릴 수 있으며 진행 상황 알림이 이메일로 전송됩니다.
- 수정 결과 확인을 클릭하면 Search Console에서 즉시 몇 개의 페이지를 확인합니다.
- 확인한 페이지에 현재 발생한 문제의 인스턴스가 있으면 확인이 종료되고 검사 상태는 변경되지 않습니다.
- 위의 샘플 페이지에 오류가 없으면 확인이 계속 진행되고 상태는 시작됨으로 유지됩니다. 확인 과정에서 이 수정과 관련이 없는 다른 문제가 발견된 경우 해당하는 문제 유형으로 간주되고 확인은 계속 진행됩니다.
- Search Console은 이 문제의 영향을 받는 알려진 URL 목록 전체를 확인합니다. 그런 다음 이 문제의 알려진 인스턴스가 포함된 URL만 재크롤링을 위해 대기열에 추가되며, 전체 사이트가 다시 크롤링되지는 않습니다. Search Console은 확인된 모든 URL의 기록을 확인 기록에 보관합니다. 기록은 문제 세부정보 페이지에서 볼 수 있습니다.
- URL 확인 후의 단계
- 문제가 발견되지 않으면 인스턴스 확인 상태가 통과로 변경됩니다. 확인을 시작하고 첫 번째로 확인한 인스턴스가 통과했다면 문제 확인 상태가 문제 없음으로 변경됩니다.
- URL에 더 이상 연결할 수 없으면 인스턴스 확인 상태가 기타로 변경됩니다. '기타'는 오류 상태가 아닙니다.
- 인스턴스가 계속 존재하는 경우 문제 상태는 실패로 변경되고 확인이 종료됩니다. 이 페이지가 정상적인 크롤링으로 발견된 새 페이지라면 기존 문제의 다른 인스턴스로 간주됩니다.
- 대기열에 추가된 URL에 문제가 있는지 확인하고 문제가 수정된 것으로 파악되면 문제 상태가 통과로 변경됩니다. 하지만 모든 인스턴스가 수정되더라도 문제의 심각도 라벨은 변경되지 않으며(오류 또는 경고) 영향을 받는 항목의 수만 0으로 변경됩니다.
'수정 결과 확인 시작'을 클릭하지 않아도 Google에서는 문제의 수정된 인스턴스를 감지할 수 있습니다. Google에서 정기적인 크롤링을 진행하는 동안 문제의 모든 인스턴스가 수정되었음을 감지하면 보고서에서 문제 수를 0으로 변경합니다.
⚠️ 현재 확인 주기 동안 일부 문제를 수정했더라도 이 주기가 완료되어야 다른 주기를 요청할 수 있습니다.
실패한 확인 절차를 다시 시작하려면 다음 단계를 따르세요.
- 확인 절차를 통과하지 못한 수정에 대한 확인 기록으로 이동: 확인 절차를 통과하지 못한 문제의 세부정보 페이지를 열고 세부정보 보기를 클릭합니다.
- 새로운 확인 시작을 클릭합니다.
- 대기 중 또는 실패로 표시된 모든 URL 및 마지막 확인 시도 이후 정상적인 크롤링을 통해 발견된 새로운 문제 인스턴스를 대상으로 확인 절차가 다시 시작됩니다. 통과나 기타로 표시된 URL은 다시 검사하지 않습니다.
- 수정 결과를 확인하는 데는 일반적으로 최대 2주가 소요되지만 더 오래 걸리는 경우도 있으니 기다려 주시기 바랍니다.
수정 확인 진행 상황 보기
현재 진행 중인 수정 확인 요청의 진행 상황을 확인하거나 마지막 요청의 기록을 보려면(수정 확인이 진행되지 않는 경우) 다음 단계에 따르세요.
- 문제의 세부정보 페이지를 엽니다. 기본 보고서 페이지에서 문제 행을 클릭하여 문제 세부정보 페이지를 엽니다.
- 문제 세부정보 페이지와 '세부정보' 표의 수정 확인 행 둘 다에 수정 확인 요청 상태가 표시됩니다.
- 세부정보 보기를 클릭하여 해당 요청의 수정 확인 세부정보 페이지를 엽니다.
문제에 적용되는 수정 확인 상태는 다음과 같습니다.
- 시작되지 않음: 문제 인스턴스 중 하나 이상이 이 문제에 대한 수정 확인 요청에 한 번도 포함되지 않았습니다.
다음 단계:- 문제를 클릭하여 오류의 세부정보를 살펴봅니다. 개별 페이지를 검사하여 라이브 페이지의 오류 예를 확인하세요.
- 세부정보 페이지에서 자세히 알아보기를 클릭하여 문제의 세부정보를 확인합니다.
- 표의 예시 URL 행을 클릭하여 해당 오류에 관한 세부정보를 확인합니다.
- 페이지를 수정한 다음 수정 결과 확인을 클릭하여 수정 확인을 시작합니다. 수정 확인에는 일반적으로 최대 2주가 소요되지만 더 오래 걸리는 경우도 있으니 기다려 주시기 바랍니다.
- 시작됨: 수정 확인을 시작했으며 해결되지 않은 문제 인스턴스는 아직 발견되지 않았습니다.
다음 단계: 필요하면 수정 확인이 진행되는 동안 Google에서 알림을 보내 취해야 할 조치를 알려 드립니다. - 문제 없음: 수정 확인을 시작했으며 지금까지 확인한 모든 문제 인스턴스가 해결되었습니다.
다음 단계: 특별히 해야 할 작업은 없으며, 수정 확인이 진행되는 동안 Google에서 알림을 보내 취해야 할 조치를 알려 드립니다. - 통과: 알려진 모든 문제 인스턴스가 해결되었거나 영향을 받은 URL을 더 이상 사용할 수 없습니다. 이 상태에 이르려면 수정 결과 확인을 클릭해야 합니다. 수정 확인을 요청하지 않았는데 인스턴스가 사라졌다면 상태가 '해당 사항 없음'으로 변경됩니다.
다음 단계: 더 해야 할 작업이 없습니다. - 해당 사항 없음: 수정 확인을 시작한 적이 없지만 Google에서 모든 URL의 문제가 해결되었음을 확인했습니다.
다음 단계: 더 해야 할 작업이 없습니다. - 실패: 수정 결과 확인을 클릭한 후 특정한 수(임계값)의 페이지에 여전히 문제가 남아 있습니다.
다음 단계: 문제를 수정하고 수정 확인을 다시 시작합니다.
수정 확인이 요청되면 모든 문제 인스턴스에 다음과 같은 수정 확인 상태 중 하나가 할당됩니다.
- 대기 중: 수정 확인 대기열에 추가되었습니다. Google에서 마지막으로 확인했을 때 문제 인스턴스가 존재했습니다.
- 통과: [일부 보고서에서는 제공되지 않음] Google에서 문제 인스턴스를 확인한 결과 문제가 더 이상 존재하지 않습니다. 문제 인스턴스에 대해 명시적으로 수정 결과 확인을 클릭한 경우에만 이 상태에 이를 수 있습니다.
- 실패: Google에서 확인한 결과 문제 인스턴스가 여전히 존재합니다. 문제 인스턴스에 대해 명시적으로 수정 결과 확인을 클릭한 경우에만 이 상태에 이를 수 있습니다.
- 기타: [일부 보고서에서는 제공되지 않음] Google에서 인스턴스를 호스팅하는 URL에 연결할 수 없거나 페이지에서 더 이상 해당 항목을 찾을 수 없습니다(구조화된 데이터의 경우). 통과와 같은 상태로 간주됩니다.
문제에 따라 하나의 URL에 여러 상태가 할당될 수 있습니다. 예를 들어 하나의 페이지에 문제 X와 문제 Y가 모두 있는 경우, 문제 X의 수정 확인 상태는 통과이고 문제 Y는 대기 중일 수 있습니다.
알려진 문제
다음은 Search Console에서 알려진 문제이며 Google에 신고할 필요는 없지만, 다른 기능이나 문제에 관한 의견이 있으면 탐색 메뉴에서 기본으로 제공되는 의견 제출 기능을 사용하세요.
- 이름이 길어서 이해하기 쉽지 않은 문제도 일부 있습니다.
- (활성화된 문제가 있는지에 관계없이) 사이트에 문제가 아주 많다면 보고서에는 첫 200개의 문제만 중요도 순으로 표시됩니다.