본문으로 건너뛰기
화면과 마크업이 어긋나는 네 가지 유형을 나열한 그림

마크업과 화면이 다를 때 — 구조화 데이터에서 실제로 위험한 실수

속성 몇 개가 빠진 것보다 위험한 것은 화면에 없는 내용을 마크업에 적는 것입니다. 가격·평점·페이월에서 자주 나오는 불일치 유형과, 자동 생성 구조에서 어긋남을 막는 점검 방법을 정리했습니다.

구조화 데이터 점검에서 속성 누락은 고치기 쉬운 문제입니다. 필수 속성이 없으면 그 기능이 동작하지 않을 뿐입니다. 실제로 위험한 것은 화면에 없는 내용을 마크업에 적어 둔 상태입니다. 이쪽은 정책에 어긋나고, 대개 사람이 의도해서 만든 것이 아니라 자동 생성 과정에서 남습니다.

자주 나오는 네 가지 유형

1. 화면에 없는 가격

할인 기간이 끝나 화면 가격은 12,000원으로 돌아갔는데, 마크업에는 9,000원이 남아 있는 상태입니다. 가격이 CMS 필드와 마크업 템플릿 두 곳에서 각각 관리되면 반드시 생깁니다.

화면 가격과 마크업 가격이 다른 상황을 비교한 그림

2. 자사가 만든 평점

내부에서 정한 별점이나 자체 설문 결과를 리뷰 마크업으로 넣는 경우입니다. 자사가 만든 리뷰·평점 마크업은 허용되지 않습니다. 외부에서 수집해 옮겨 붙인 평점도 대상이 아닙니다.

3. 목록 페이지에 개별 제품 정보

카테고리 페이지에 첫 번째 상품의 Product 블록이 붙는 경우입니다. 목록 페이지는 판매자 등록정보 대상이 아닙니다. 상품 카드 컴포넌트가 마크업을 함께 출력하도록 만들어져 있으면 목록에서도 그대로 나갑니다.

4. 페이월 콘텐츠를 표시하지 않음

로그인 뒤에만 본문이 보이는 페이지에서, 수집기에는 전체 본문을 주고 사용자에게는 일부만 보여 주는 구조입니다. 이때 구독 콘텐츠임을 표시하는 마크업이 없으면 서로 다른 내용을 보여 주는 것으로 판단될 수 있습니다.

어긋남이 생기는 이유

구조왜 어긋나는가
마크업을 별도 템플릿 변수로 관리화면 값과 마크업 값의 출처가 둘이어서 한쪽만 바뀝니다
마크업을 사람이 직접 작성콘텐츠 수정 시 마크업을 함께 고치는 절차가 없습니다
컴포넌트가 마크업을 내장그 컴포넌트를 쓰는 모든 페이지에서 함께 출력됩니다
플러그인이 자동 생성설정이 페이지 역할을 구분하지 못합니다

해결 방향은 하나입니다. 화면에 값을 그리는 데이터와 마크업이 쓰는 데이터를 같은 출처로 만드는 것입니다. 가격 하나를 두 곳에서 관리하는 구조를 없애면 이 유형의 문제는 대부분 사라집니다.

점검 절차

배포 시 구조화 데이터를 점검하는 절차 그림

  1. 템플릿을 바꾼 배포에서는 표본 3개 페이지의 마크업을 확인합니다. 목록, 상세, 홈 각각 한 개면 됩니다.
  2. 가격·재고·평점이 바뀌는 이벤트에서는 마크업 동기화를 확인합니다. 할인 시작일보다 종료일이 더 자주 어긋납니다.
  3. 분기마다 페이지 역할별 표본을 점검합니다. 목록 페이지에 상세용 마크업이 붙지 않았는지, 폐기된 타입이 남아 있지 않은지 봅니다.

확인 순서

  • 페이지 소스에서 application/ld+json을 찾아 값 하나하나를 화면과 비교합니다.
  • 특히 숫자를 봅니다. 가격, 통화, 평점, 개수는 어긋나도 화면에서는 보이지 않습니다.
  • 마크업에만 있고 화면에 없는 속성이 있으면, 그 속성을 지우거나 화면에 값을 표시합니다.

오늘 할 일

가격이 표시되는 페이지 한 개를 골라 화면 값과 마크업 값을 직접 비교해 보십시오. 두 값이 같으면 그 페이지는 넘어가고, 다르면 값의 출처가 몇 개인지부터 확인하시면 됩니다.

게시일
수정일

이 글의 내용을 우리 사이트에 적용하고 싶다면

진단 결과 해석, 도입 문의는 geotracker@humuson.com으로 보내 주세요.

구조화 데이터