Organization 구조화 데이터 검사: 오류→속성값→색인 HTML

구조화 데이터 검사로 Organization 마크업을 확인할 때는 세 가지를 차례로 봅니다. 리치 결과 테스트로 오류를 걸러 내고, 스키마 마크업 검사기로 속성값을 회사 기준 정보와 대조합니다. 마지막으로 Search Console URL 검사에서 Google이 가져간 HTML에 마크업이 들어 있는지 확인합니다.

Google Organization 문서는 이 유형에 필수 속성이 없다고 설명합니다. 그래서 검사기의 '유효' 표시는 값이 맞다는 뜻이 아닙니다. 속성값 대조까지 마쳐야 확인이 끝납니다.

Organization 마크업은 어떤 도구로 나눠 확인하나요?

Google 문서는 구조화 데이터 검사를 리치 결과 테스트부터 시작하라고 권합니다. Google 기능과 관계없는 schema.org 검증에는 스키마 마크업 검사기를 안내합니다. 리치 결과 테스트 도움말의 지원 유형 목록에는 Organization이 그대로 올라 있습니다. 도구마다 보여 주는 범위가 달라 아래처럼 역할을 나눕니다.

배포 전 코드 검사는 어떻게 진행하나요?

리치 결과 테스트 첫 화면에서 주소 대신 '코드'를 고르면 마크업을 붙여 넣어 검사할 수 있습니다. 구조화 데이터 일반 가이드라인은 지원 형식으로 JSON-LD, Microdata, RDFa를 들고, 이 가운데 JSON-LD를 권장합니다.

1. 블록을 붙여 넣고 실행합니다. script 태그를 포함해 Organization 블록 전체를 복사합니다. 결과 요약에 Organization 항목이 보이면 2번으로 넘어갑니다.
2. 구문 오류를 없앱니다. '구문 오류가 있는 구조화 데이터'가 나오면 유형을 판별하지 못한 상태입니다. Search Console 도움말은 콜론·쉼표·괄호 누락, 잘못된 이스케이프 문자, @context 값이 두 개인 중복 속성 등을 오류 유형으로 듭니다. 기준은 결과 화면에서 구문 오류 문구가 사라졌는지입니다.
3. JSON-LD 안의 주석을 지웁니다. 도움말은 리치 결과 테스트가 JSON-LD 안의 주석을 무시한다고 설명합니다. 테스트를 통과해도 주석이 그대로 남을 수 있다는 뜻입니다. JSON 문법은 주석을 허용하지 않으므로, 실무에서는 배포 전에 주석을 모두 지우는 방법을 권합니다.
4. 오류를 먼저 고치고 경고는 처리 여부를 정합니다. Organization 문서는 치명적 오류를 고치라고 합니다. 치명적이지 않은 항목은 필수는 아니지만 품질을 높일 수 있다고 설명합니다. 오류 0건에 경고마다 '수정' 또는 '보류 사유'가 정해지면 코드 검사를 마칩니다.

속성값이 맞는지는 무엇과 대조하나요?

같은 코드를 스키마 마크업 검사기에 넣으면 schema.org 항목과 속성이 모두 펼쳐집니다. Google 기능별 경고가 빠져 값 자체를 읽기 편합니다. 펼쳐진 값을 회사가 정한 기준 정보와 한 줄씩 비교합니다.

아래 표는 Organization 문서가 권장하는 속성 가운데 대조할 일이 많은 항목입니다. 예를 들어 가상의 한빛소재 주식회사라면, 가운데 열의 기준과 오른쪽 열의 메모처럼 값을 대조합니다.

일반 가이드라인은 페이지를 읽는 사람에게 보이지 않는 내용을 마크업하지 말라고 합니다. 따라서 마크업한 주소·전화번호가 회사 소개 페이지 본문에도 같은 값으로 보이는지 함께 봅니다. 표의 모든 줄에 '일치' 또는 '수정 완료'가 적히면 대조가 마무리됩니다.

배포한 페이지에서는 무엇을 다시 확인하나요?

리치 결과 테스트를 주소로 다시 실행합니다

Organization 문서는 이 마크업을 홈페이지나 조직을 설명하는 페이지 한 곳에 두라고 권합니다. 모든 페이지에 넣을 필요는 없다고도 설명합니다. 마크업을 넣은 바로 그 페이지 주소로 검사합니다.

도움말에 따르면 기본 사용자 에이전트는 스마트폰이고, 도구는 Google-InspectionTool로 접근합니다. 그래서 robots.txt가 막으면 검사할 수 없습니다. 페이지 리소스도 로그인 없이 열려야 합니다. 결과의 크롤링 항목에서 크롤링 성공과 robots.txt 허용부터 봅니다.

감지된 항목을 누르면 코드 탐색기가 해당 위치를 보여 줍니다. 도움말은 이 탐색기가 렌더링된 소스 코드를 쓴다고 설명합니다. 태그 관리 도구나 스크립트로 마크업을 넣는 사이트라면 이 화면에서 실제 삽입된 값을 확인합니다. 코드 검사와 같은 항목·같은 값이 나오면 URL 검사로 넘어갑니다.

URL 검사로 Google이 가져간 HTML을 확인합니다

URL 검사의 기본 화면은 현재 페이지가 아니라 가장 최근에 색인된 버전입니다. 실시간 테스트는 주소를 바로 가져오므로 수정 반영 여부를 볼 때 씁니다. '테스트된 페이지 보기'에서는 HTML, 응답 헤더, 자바스크립트 콘솔 출력과 스크린샷을 볼 수 있습니다.

URL 검사 도움말의 지원 유형 목록에는 Organization이 없습니다. 도움말은 아직 모든 리치 결과 유형을 지원하지는 않는다고도 밝힙니다. 그러므로 개선사항에 Organization이 보이지 않는다는 이유로 마크업이 없다고 판단하지 않습니다. 대신 HTML에서 Organization이라는 글자를 검색해 블록을 찾습니다. 실시간 테스트와 색인된 버전 양쪽 HTML에서 블록이 보이는지가 기준입니다.

값을 고쳤다면 결과 화면에서 색인 생성을 요청할 수 있습니다. 도움말은 요청에 하루 한도가 있고, 요청해도 색인이 보장되지 않는다고 설명합니다. Organization 문서는 게시 후 Google이 페이지를 찾아 크롤링하는 데 며칠이 걸릴 수 있다고 안내합니다.

사이트 단위 보고서 두 가지를 확인합니다

Search Console에 '파싱할 수 없는 구조화 데이터' 보고서가 있으면 문법 오류가 남아 있다는 뜻입니다. 도움말은 이 보고서의 항목이 모두 치명적 오류라고 설명합니다. 한 오류가 여러 페이지에 나오면 흔한 원인은 템플릿 오류라고도 밝힙니다. 고친 뒤 '수정사항 확인'을 누르면 검증은 보통 최대 2주 정도 걸리고, 더 오래 걸리는 경우도 있다고 안내합니다.

일반 가이드라인은 품질 가이드라인을 자동화 도구로 쉽게 검사할 수 없다고 설명합니다. 수동 조치 보고서 도움말은 사용자에게 보이지 않거나 오해를 부르는 내용을 마크업하면 수동 조치가 내려질 수 있다고 밝힙니다. 그래서 검사 때 수동 조치 보고서도 함께 엽니다. 도움말에 따르면 수동 조치가 없을 때는 보고서에 초록색 체크 표시가 나옵니다.

검사 결과는 어떻게 기록하나요?

리치 결과 테스트 도움말은 검사 기록과 결과 링크가 약 90일간 유지된다고 설명합니다. 실무에서는 링크만 남기지 말고 결과를 문서로 옮기는 방법을 권합니다. 그래야 다음 분기 재검사 때 달라진 점을 비교할 수 있습니다. 아래 양식을 복사해 검사할 때마다 채웁니다.

검사한 페이지 칸에 중복 페이지를 함께 적는 데는 이유가 있습니다. 일반 가이드라인은 대표 페이지만이 아니라 모든 중복 페이지에 같은 구조화 데이터를 두라고 권합니다.

정리

Organization 마크업은 검사기에서 '유효'가 나와도 값까지 맞다는 뜻은 아닙니다. 아래 순서로 오늘 바로 진행할 수 있습니다.

1. Organization JSON-LD를 리치 결과 테스트의 코드 모드에 붙여 넣고, 구문 오류와 오류를 0건으로 만듭니다.
2. 같은 코드를 스키마 마크업 검사기에 넣고 name·logo·sameAs·telephone 등을 회사 기준 정보와 한 줄씩 대조합니다.
3. 배포한 페이지 주소로 리치 결과 테스트를 다시 실행해 크롤링 성공과 robots.txt 허용을 확인합니다.
4. URL 검사 실시간 테스트의 HTML에서 Organization 블록을 찾고, 색인된 버전과 비교합니다.
5. 파싱 오류·수동 조치 보고서까지 확인해 기록 양식에 옮기고, 색인된 버전을 다시 볼 날짜를 정합니다.