01DEFINITION
한 줄로 말하면
구조화 데이터에서 WebSite 는 사이트 전체를, WebPage 는 지금 이 문서를 가리킵니다. 둘이 있어야 기계가 "이 페이지는 이 사이트의 문서"라는 관계를 세울 수 있습니다. 회사 정보나 FAQ 만 마크업하고 이 뼈대를 빼 두는 경우가 많은데, 그러면 낱개 정보는 읽히지만 그것들이 한 사이트에 속한다는 사실은 전달되지 않습니다. 검색 결과의 사이트 검색창이나 사이트링크처럼 사이트 단위로 동작하는 표시도 이 선언 위에서 성립합니다.
02RISK
없으면 무슨 일이 생기나
구조화 데이터는 사실의 목록이 아니라 관계의 그물입니다. 회사 정보 블록 하나만 있으면 기계는 이 회사가 존재한다는 것만 압니다. 그 회사가 이 사이트를 운영하고 지금 이 문서가 그 사이트의 한 페이지라는 사실은 따로 적어야 전달됩니다. 그 자리가 비어 있으면 정보는 읽히지만 연결되지 않습니다.
사이트 단위로 동작하는 검색 표시들이 이 선언 위에서 성립합니다. 검색 결과에 사이트 내부 검색창이 붙거나 하위 페이지 목록이 같이 나오는 표시가 대표적입니다. 회사 정보만 마크업해 두고 왜 그런 표시가 안 나오느냐고 묻는 경우가 많은데, 그 표시가 보는 것은 회사가 아니라 사이트입니다.
테마와 플러그인이 만들어 주는 마크업은 대개 세간만 채웁니다. 상품 정보나 문답처럼 눈에 띄는 것부터 넣고 뼈대는 빠뜨립니다. 그래서 구조화 데이터를 적용했다고 알고 있는 사이트에서도 이 항목이 자주 실패로 나옵니다.
이 항목이 비어 있으면 다른 마크업의 값도 함께 깎입니다. 회사 정보와 상품과 문답이 각각 훌륭하게 적혀 있어도 그것들이 놓인 자리가 없으면, 검색엔진은 낱장의 카드를 받은 것이지 한 회사의 사이트를 이해한 것이 아닙니다. 뼈대를 먼저 세우는 것이 나머지 마크업의 효율을 올리는 방법이기도 합니다.
03CHECK IT YOURSELF
직접 확인하는 방법
아래는 저희를 거치지 않고 지금 해 보실 수 있는 방법입니다. 결과를 저희에게 보내실 필요도 없습니다.
-
01
선언된 종류를 전부 뽑아 본다
무엇이 있고 무엇이 없는지가 한 번에 보입니다. Organization 과 FAQPage 만 있고 WebSite 가 없는 모양이 가장 흔합니다.
$ curl -s https://example.com | grep -o '"@type":"[^"]*"' | sort | uniq -c 1 "@type":"Organization" 1 "@type":"FAQPage" ← WebSite 와 WebPage 계열이 없습니다
-
02
WebPage 계열이 있는지 넓게 본다
WebPage 라는 이름 그대로가 아니어도 됩니다. 목록 페이지나 소개 페이지나 문의 페이지처럼 성격이 정해진 종류들도 같은 자리를 채웁니다. 우리 판정도 그것들을 모두 인정합니다.
인정되는 종류 WebPage · CollectionPage · ItemPage AboutPage · ContactPage · FAQPage
-
03
구글 리치 결과 테스트로 읽힌 결과를 본다
문법 오류가 있으면 블록 전체가 무시되는데 화면에는 아무 표시가 없습니다. 도구에 주소를 넣어 실제로 인식된 항목 목록을 확인하십시오.
04HOW TO FIX
고치는 방법
서버 환경에 따라 적을 자리가 다릅니다. 아래는 가장 흔한 구성 기준이고, 적용 전에 현재 설정을 백업하십시오.
모든 페이지에 같은 값으로 들어갑니다. 이름과 주소만 있으면 성립하고, 내부 검색이 있다면 검색 동작을 같이 적을 수 있습니다.
{
"@context": "https://schema.org",
"@type": "WebSite",
"name": "회사이름",
"url": "https://example.com/"
} 이쪽은 페이지마다 값이 달라집니다. 제목과 주소를 그 페이지의 것으로 채우고, 성격이 분명한 페이지는 종류를 구체적으로 적으십시오.
{
"@context": "https://schema.org",
"@type": "ContactPage",
"name": "문의하기",
"url": "https://example.com/contact"
} 페이지마다 손으로 적으면 반드시 어긋납니다. 머리말 템플릿이 페이지 제목과 주소를 이미 알고 있으니 그 값으로 블록을 찍어 내게 하십시오. 새 페이지가 생겨도 저절로 따라옵니다.
05FAQ
자주 묻는 질문
홈에만 넣으면 되나요
- 사이트 선언은 홈에만 있어도 되지만 문서 선언은 페이지마다 있어야 합니다. 문서 선언이 가리키는 것은 지금 이 주소이기 때문입니다. 실제로는 두 블록을 함께 모든 페이지에 내보내는 편이 관리하기 쉽고, 그렇게 해도 문제가 없습니다.
이미 회사 정보 마크업이 있는데 또 필요한가요
- 역할이 다릅니다. 회사 정보는 누구인가를 말하고, 이 둘은 어디에 있는가를 말합니다. 둘을 함께 두고 서로 가리키게 하면 그때부터 그물이 됩니다. 그 연결을 실제로 거는 방법은 식별자 항목에서 다룹니다.
사이트 안에 검색 기능이 없어도 사이트 선언을 넣나요
- 넣습니다. 검색 동작은 선택 사항이고 이름과 주소만으로도 선언은 성립합니다. 오히려 없는 검색 기능을 있다고 적는 편이 문제입니다. 그 주소로 실제 검색이 되지 않으면 검색엔진은 그 선언 전체를 믿지 않습니다.
주의로 나왔는데 무엇이 빠진 건가요
- 둘 중 하나만 있는 상태입니다. 결과 화면의 근거 줄에 어느 쪽이 없는지 적혀 있습니다. 사이트 선언만 있고 문서 선언이 없는 경우가 더 흔하고, 그때는 페이지 템플릿에 블록 하나를 더하는 것으로 끝납니다.
GET STARTED
내 사이트는
이 항목을 통과할까요
주소만 넣으시면 이 항목을 포함해 39가지를 판정해 점수와 실패 개수를 보여 드립니다. 로그인도, 소유 확인도 필요 없습니다 — 전부 밖에서 관찰만 하는 항목이기 때문입니다.