JSON-LD 구조화된 데이터 기초
JSON-LD로 기계가 읽을 수 있는 구조화된 데이터 추가하기
JSON-LD 구조화된 데이터 기초은(는) CoddyKit의 무료 HTML Academy 강의입니다. 이것은 4개 중 3번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 HTML Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. HTML Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
구조화된 데이터란 무엇인가요?
구조화된 데이터는 페이지가 무엇에 관한 것인지 설명하는 기계 판독용 JSON입니다. 예를 들면 기사, 레시피, 제품, 이벤트 등이 있습니다. 검색 엔진은 이를 사용하여 단순한 파란색 링크 대신 별점, 레시피 카드, 이동 경로와 같은 풍부한 검색 결과를 표시합니다.
JSON-LD가 권장 형식인 이유
Google이 선호하는 형식은 JSON-LD입니다. 이는 하나 이상의 schema.org 객체를 포함하는 단일 <script type="application/ld+json"> 블록을 head 또는 body에 배치하는 방식입니다. 표시되는 HTML과 분리되어 있으므로 추가하거나 수정할 때 템플릿을 다시 작성할 필요가 없습니다.
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Article",
"headline": "Learn HTML",
"author": { "@type": "Person", "name": "Ada Lovelace" },
"datePublished": "2024-05-01"
}
</script>@context 및 @type
모든 JSON-LD 객체에는 @context(대부분 "https://schema.org")와 @type(스키마의 클래스: Article, Recipe, Product, FAQPage)가 필요합니다. @context는 속성 이름이 어떤 어휘에서 유래했는지 파서에 알려 줍니다.
일반적인 Article 속성
Article에는 headline, image(URL 또는 배열), datePublished, dateModified, author(Person 또는 Organization 객체), publisher(로고가 포함된 Organization)를 제공하십시오. 이는 Google의 주요 뉴스 캐러셀이 페이지를 고려하는 데 필요한 최소 필드입니다.
제품 스키마
제품 페이지는 name, image, description, brand, sku와 price, priceCurrency, availability를 포함하는 offers 하위 객체와 함께 @type Product를 선언합니다. aggregateRating과 결합하면 Google이 검색 결과에 별점과 가격 요약을 바로 표시할 수 있습니다.
{
"@context": "https://schema.org",
"@type": "Product",
"name": "Coddy Plus",
"offers": { "@type": "Offer", "price": "29.00", "priceCurrency": "USD" }
}이동 경로 스키마
BreadcrumbList는 탐색 계층 구조를 설명합니다. 각 itemListElement는 position, name, item(URL)을 포함하는 ListItem입니다. 이 정보가 있으면 Google은 검색 결과 요약의 URL 줄을 레이블이 붙은 이동 경로로 바꾸며, 이를 통해 더 많은 클릭을 얻을 수 있습니다.
FAQ 및 HowTo
FAQ 페이지 및 HowTo 스키마는 이전에는 SERP에서 리치 결과 위젯을 활성화했습니다. 이후 Google은 FAQ 리치 결과를 일부 사이트 카테고리(정부 기관, 교육 기관)로 제한했지만, 이 마크업은 음성 비서와 기타 소비자에게 여전히 유용하므로 실제 FAQ 페이지에는 그대로 유지하시기 바랍니다.
페이지에 표시되는 내용과 일치시키기
Google은 사용자에게 표시되는 내용과 일치하지 않는 마크업에 불이익을 줍니다. 페이지에 표시되지 않는 별 5개 평점을 선언하지 마시고, 사용자가 볼 수 없는 9.99달러 가격을 표시하지도 마십시오. 구조화된 데이터는 렌더링된 콘텐츠를 정확하게 설명해야 합니다.
리치 결과 테스트로 검증하기
Google의 리치 결과 테스트(search.google.com/test/rich-results)는 URL이나 붙여 넣은 코드를 분석하고, 감지된 스키마 유형을 나열하며, 필수 속성이 누락되었는지 경고합니다. 구조화된 데이터를 변경하기 전에 실행하시기 바랍니다.
페이지당 여러 스키마
같은 페이지에 여러 JSON-LD 블록(문서 + BreadcrumbList + 조직 등)을 선언하거나, 하나의 @graph 배열로 결합할 수 있습니다. 두 형식 모두 유효하므로 빌드 과정에서 템플릿으로 작성하기 더 쉬운 방식을 선택하시면 됩니다.
다시 렌더링하지 않고 업데이트하기
JSON-LD는 표시되는 콘텐츠와 분리된 스크립트 태그 안에 있습니다. 이를 업데이트하려면 JSON 블록을 다시 생성하십시오. Googlebot은 색인 생성 전에 JS를 항상 안정적으로 실행하는 것은 아니므로, 클라이언트 측 JavaScript만으로 구조화된 데이터를 주입하지 마십시오.
지식 확인
유효한 구조화된 데이터가 되려면 모든 JSON-LD 객체에 포함되어야 하는 최상위 속성 두 가지는 무엇인가요?
요약
JSON-LD는 하나의 application/ld+json 스크립트 블록에서 구조화된 데이터를 선언하며, @context와 @type이 각 객체를 식별합니다. 일반적인 스키마(문서, 제품, BreadcrumbList)는 마크업이 페이지에 표시되는 내용을 정확하게 반영할 때 리치 검색 결과를 활성화합니다. 배포하기 전에 리치 결과 테스트로 검증하십시오.
자주 묻는 질문
“JSON-LD 구조화된 데이터 기초” 강의는 무료인가요?
네 — “JSON-LD 구조화된 데이터 기초” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 HTML Academy 강의 전체를 잠금 해제할 수 있습니다. HTML Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
“JSON-LD 구조화된 데이터 기초”에서 뭘 배우나요?
JSON-LD로 기계가 읽을 수 있는 구조화된 데이터 추가하기 브라우저에서 직접 실행하는 실습 코드로 HTML Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
HTML Academy을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 HTML Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 3번째 강의입니다.
“JSON-LD 구조화된 데이터 기초” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 HTML Academy 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 HTML Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.