기술 가이드
구조화 데이터 및 JSON-LD 마크업 검증 가이드
문법적으로 유효한 JSON 코드는 최소한의 조건일 뿐입니다. 마크업은 실제 화면에 보이는 페이지 내용을 정직하게 반영해야 하며 검색 포털의 최신 정책을 충족해야 합니다.
JSON-LD 구문을 파싱하여 엔티티 속성을 화면 본문과 철저히 대조하십시오. 이후 목표로 하는 리치 결과 전용 유효성 검사기를 실행해 규격 준수를 확인해야 합니다.
모든 JSON-LD 스크립트 블록의 구문 오류를 엄격히 검증하세요
페이지 내의 모든 <script type='application/ld+json'> 블록이 표준 JSON 문법을 완벽히 준수하는지 점검해야 합니다. 닫는 괄호 누락, 문자열 설명 내의 이스케이프되지 않은 따옴표, 불필요한 후행 쉼표(trailing comma), @context 및 @type 선언 오류 같은 사소한 문법 실수가 전체 엔티티 그래프를 검색 봇이 해석할 수 없게 만듭니다.
페이지의 본질을 정확히 반영하는 대표 엔티티를 모델링하세요
페이지의 중심 주제와 정확히 일치하는 올바른 Schema.org 유형(Article, Product, Organization, FAQPage 등)을 선택하십시오. 페이지와 무관한 스키마 타입을 무분별하게 남발하지 말고, @id와 URL 속성을 활용하여 연관된 엔티티 노드들을 유기적이고 논리적인 그래프로 상호 연결해야 합니다.
화면에 노출된 실제 본문 텍스트와의 100% 일치성을 유지하세요
구조화 데이터에 선언된 모든 질문, 답변, 가격, 별점 평점, 리뷰 본문, 작성자 이름 및 게시 시간은 일반 방문자의 화면에 명확하게 노출되어 있어야 합니다. 실제 본문에서 숨겨진 FAQ나 조작된 가짜 평점 데이터를 스키마로 선언하는 행위는 검색 엔진 가이드라인을 정면으로 위반하는 것으로, 수동 조치 페널티의 직접적인 원인이 됩니다.
표준 정식 URL과 엔티티 고유 식별자의 일관성을 확립하세요
구조화 마크업의 @id, url 및 mainEntityOfPage 속성을 문서의 대표 정식 표준 URL(Canonical URL)과 빈틈없이 일치시키십시오. HTTPS 프로토콜, 서브도메인 및 후행 슬래시 표기가 완전히 일치해야 검색 크롤러가 엔티티의 식별성을 모호함 없이 단일 노드로 정확하게 해석할 수 있습니다.
검색 기능 자격 요건과 표시 알고리즘의 한계를 올바르게 인식하세요
완벽한 JSON-LD 문법과 Schema.org 규격 준수는 리치 결과 표시를 위한 기본 전제 조건일 뿐, Google 검색 결과에서의 리치 스니펫 노출을 무조건적으로 보장하지 않습니다. 검색 기능 정책은 수시로 변경되며, 실제 노출 여부는 검색 엔진의 종합적인 사이트 품질 평가 기준에 따라 최종 결정됩니다.
구조화 데이터: JSON-LD 문법, Schema.org 엔티티 및 표시 콘텐츠 일치성.
무료 진단 시작 →