스키마 검증 오류 구조화된 데이터 해결 방법

Index

스키마 를 적용했는데, Google Search Console에서 오류 메시지가 뜨셨나요?

구조화된 데이터는 검색 엔진이 웹사이트의 정보를 더 잘 이해하도록 도와주는 중요한 요소입니다. 

그런데 마크업을 적용했음에도 불구하고 리치 스니펫이 표시되지 않거나, “필수 필드 누락”, “잘못된 값 형식” 같은 오류가 발생한다면 어떻게 해야 할까요?

이러한 오류는 생각보다 흔하게 발생하는데요. JSON-LD와 Microdata 중 어떤 방식을 선택해야 할지, 스키마 업데이트를 따라가야 하는지 고민되는 경우도 많죠. 

게다가 검증 오류가 SEO에 어떤 영향을 미치는지 명확하지 않아 혼란스러울 수 있습니다.

이번 글에서는 구조화된 데이터에서 발생하는 스키마 검증 오류의 원인과 해결 방법을 알아보고, Google의 Search Console을 활용해 오류를 수정하는 방법까지 설명해 드리겠습니다. 

스키마 검증 오류란 무엇인가?

스키마는 웹사이트의 콘텐츠를 구조화하여 검색 엔진이 더 쉽게 이해할 수 있도록 돕는 마크업 기술입니다. 

이를 올바르게 적용하면 검색 결과에서 리치 스니펫과 같은 고급 기능이 활성화되어 SEO 최적화에 긍정적인 영향을 줄 수 있습니다. 

그러나 스키마 마크업을 설정하는 과정에서 검증 오류가 발생하는 경우가 많은데요. 

이러한 오류가 해결되지 않으면 구조화된 데이터가 정상적으로 반영되지 않으며, 검색 엔진이 정보를 정확하게 해석하는 데 혼선을 줄 수 있습니다. 

따라서 스키마 검증 오류를 정확히 이해하고 해결하는 것이 중요합니다.

스키마 검증 오류
출처 – microsoft

스키마와 구조화된 데이터의 역할

구조화된 데이터는 웹페이지의 내용을 명확하게 정의하여 검색 엔진이 정보를 효과적으로 처리할 수 있도록 돕습니다. 

때문에 스키마에서는 다양한 유형의 데이터를 지원하며, 각 유형에 적합한 속성과 필드를 제공하죠. 

예를 들어, 제품 페이지에는 가격과 재고 정보가 포함될 수 있으며, 블로그 글에는 작성자와 게시 날짜가 들어갈 수 있습니다. 

이러한 데이터를 정확하게 정의하면 검색 엔진은 콘텐츠를 더욱 신뢰할 수 있으며, 검색 결과에서 보다 가시적인 형태로 노출될 가능성이 높아집니다. 

하지만 마크업이 올바르게 적용되지 않으면 오류가 발생하며, 이로 인해 SEO 성능이 저하될 수 있습니다.

검색 엔진에서 스키마 검증 오류가 발생하는 이유

스키마를 적용하는 과정에서 검증 오류가 발생하는 주요 원인은 여러 가지가 있습니다. 

첫째, 필수 필드가 누락되었거나 잘못된 데이터 형식이 사용된 경우입니다. 예를 들어, 날짜 형식이 ISO 8601 규격을 따르지 않으면 오류가 발생할 수 있습니다. 

둘째, 스키마에서 제공하는 최신 버전을 사용하지 않거나, 지원되지 않는 속성을 사용할 경우에도 문제가 발생할 수 있습니다. 

마지막으로, JSON-LD, Microdata, RDFa 등의 마크업 방식이 올바르게 적용되지 않은 경우에도 검증 오류가 발생할 수 있습니다. 이러한 오류를 방치하면 검색 엔진이 구조화된 데이터를 올바르게 해석하지 못하여 SEO 효과를 기대하기 어려워집니다.

스키마 검증 오류의 주요 유형과 원인

필수 필드 누락 오류

스키마를 적용할 때 특정 필드는 필수적으로 포함되어야 합니다. 그 예로, Article 유형에서는 “headline” 필드가 반드시 필요하며, Product 유형에서는 “price”와 “availability” 필드가 요구됩니다. 

이러한 필드가 누락되면 Google Search Console에서 오류 메시지를 표시하며, 리치 결과 반영이 어려워질 수 있어요. 따라서 마크업을 작성할 때 스키마의 공식 문서를 참고하여 필수 필드가 빠지지 않도록 주의해야 합니다.

잘못된 데이터 형식 오류

구조화된 데이터에서 특정 필드는 정해진 형식을 따라야 합니다. 날짜는 “YYYY-MM-DD” 형식으로 입력해야 하며, 가격 정보는 숫자로만 입력해야 하죠. 

만약 규칙을 위반하면 검증 오류가 발생하며, 검색 엔진이 해당 데이터를 처리하지 못할 수 있습니다. 따라서 스키마를 적용하기 전에 각 속성의 데이터 형식을 미리 확인하고, 오류가 발생하지 않도록 입력 값을 정확하게 설정하는 것이 중요합니다.

비지원되는 속성 및 버전 문제

스키마는 지속적으로 업데이트되며, 일부 속성은 새로운 버전에서 추가되거나 제거될 수 있습니다. 오래된 마크업을 사용할 경우 특정 속성이 더 이상 지원되지 않을 수 있으며, 이에 따라 검증 오류가 발생할 수 있습니다. 그렇기 때문에 스키마의 공식 사이트에서 최신 버전을 확인하고, 사용 중인 마크업이 최신 표준과 호환되는지 점검하는 것이 필요합니다.

JSON-LD, Microdata, RDFa 형식 오류

구조화된 데이터를 적용하는 방식에는 JSON-LD, Microdata, RDFa 등이 있습니다. 이 중에서 Google은 JSON-LD 방식을 권장하지만, 일부 웹사이트에서는 Microdata 또는 RDFa를 사용하기도 합니다. 

그러나 각 방식마다 적용 방식이 다르며, 태그가 올바르게 닫히지 않거나 속성값이 잘못 입력되면 오류가 발생할 수 있는데요. 마크업을 적용할 때는 반드시 검증 도구를 사용하여 오류를 사전에 점검하는 것이 중요합니다.

스키마 검증 오류 해결 방법
출처 – google developers

스키마 검증 오류 해결 방법

Google 구조화된 데이터 테스트 도구 및 Search Console 활용

스키마 검증 오류를 해결하기 위해서는 Google에서 제공하는 구조화된 데이터 테스트 도구와 Search Console을 적극 활용해야 합니다. 

구조화된 데이터 테스트 도구를 사용하면 적용한 마크업의 오류 여부를 실시간으로 확인할 수 있으며, 오류가 있는 부분을 구체적으로 알려주기 때문이죠. 

또한, 사이트 전체의 구조화된 데이터 오류를 모니터링하고, 필요한 경우 문제를 해결한 후 다시 검증 요청을 할 수 있습니다. 

JSON-LD 및 Microdata 마크업 수정 방법

검증 오류가 발생한 경우, JSON-LD 또는 Microdata에서 해당 문제를 해결해야 합니다. 

우선, 누락된 필드를 추가하고, 데이터 형식을 올바르게 수정하는 것이 중요합니다. 예를 들어, 날짜 형식이 올바르지 않다면 ISO 8601 표준을 따라야 하며, 가격 정보에는 반드시 숫자 값만 입력해야 합니다. 

또한, 최신 스키마 버전과 비교하여 사용 중인 속성이 지원되는지 확인하는 것도 필요합니다.

최신 스키마 버전과의 호환성 체크

스키마는 지속적으로 업데이트되므로, 사용 중인 마크업이 최신 버전과 호환되는지 주기적으로 점검해야 합니다. 

최신 버전에서는 기존 속성이 변경되거나 새로운 속성이 추가될 수 있으며, 이를 반영하지 않으면 검증 오류가 발생할 가능성이 높습니다. 따라서 스키마의 공식 문서를 참고하여 마크업을 최신 표준에 맞게 유지하는 것이 바람직합니다.

Picture of 박예원 - GP / SEO Content Specialist
박예원 - GP / SEO Content Specialist
언제나 새로운 눈으로 세상을 바라보는 6년차 콘텐츠 마케터 & SEO 전문가입니다. 다양한 고객사의 맞춤형 콘텐츠를 제작하고 있습니다.
Recent articles

Stay tuned for new articles.