JSON-LD가 하는 일

JSON-LD는 페이지 내용을 검색엔진이 기계적으로 이해할 수 있는 형식으로 별도 요약해주는 스크립트입니다. 방문자에게는 보이지 않고, 검색엔진 크롤러만 읽어 "이 페이지는 회사 정보다", "이 페이지는 상품이고 가격은 얼마다" 같은 사실을 명확히 전달합니다. 같은 정보를 본문에 텍스트로만 써두는 것보다 구조화된 형식으로 제공하면 리치 결과로 노출될 확률이 높아집니다.

기업/조직(Organization) 스키마

로고와 회사 정보를 검색 결과에 노출시키려면 Organization 스키마가 기본입니다.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "다빈치웹",
  "url": "https://example.com",
  "logo": "https://example.com/img/logo.png",
  "contactPoint": {
    "@type": "ContactPoint",
    "telephone": "+82-2-547-4666",
    "contactType": "customer service"
  }
}
</script>

지역 업체(LocalBusiness) 스키마로 위치·영업시간 노출

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "LocalBusiness",
  "name": "매장명",
  "address": {
    "@type": "PostalAddress",
    "streetAddress": "도로명주소",
    "addressLocality": "서울",
    "postalCode": "00000"
  },
  "openingHours": "Mo-Fr 09:00-18:00",
  "telephone": "+82-2-000-0000"
}
</script>

매장·병원·학원처럼 오프라인 위치가 중요한 업종은 이 스키마가 지도·지역 검색 노출에 직접적인 영향을 줍니다.

리뷰·평점(AggregateRating) 노출 시 주의할 점

별점을 노출하고 싶다고 임의의 점수를 코드에 박아 넣으면 스팸 구조화 데이터로 판단되어 리치 결과 자격이 박탈될 수 있습니다. 반드시 실제 사용자 리뷰 데이터를 기반으로 값을 채워야 합니다.

{
  "@type": "AggregateRating",
  "ratingValue": "4.7",
  "reviewCount": "128"
}

리뷰 시스템이 없는 사이트는 이 스키마를 아예 사용하지 않는 것이 안전합니다.

빵부스러기(BreadcrumbList) 스키마

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [
    {"@type": "ListItem", "position": 1, "name": "홈", "item": "https://example.com/"},
    {"@type": "ListItem", "position": 2, "name": "제작 가이드", "item": "https://example.com/guide/"},
    {"@type": "ListItem", "position": 3, "name": "현재 페이지"}
  ]
}
</script>

검색 결과에 URL 대신 계층형 경로가 표시돼, 방문자가 사이트 구조를 검색 결과에서부터 미리 파악할 수 있습니다.

스키마 타입별 활용 우선순위

검증 및 오류 점검

1. 구글 리치 결과 테스트 도구에 URL 입력
2. 인식된 스키마 타입과 필수 항목 누락 여부 확인
3. 경고(warning)는 선택 항목 누락, 오류(error)는 필수 항목 누락이므로 오류부터 우선 해결
4. 실제 검색 결과 반영은 며칠~몇 주 소요될 수 있어 재크롤링을 기다림

동적 페이지에서 JSON-LD를 자동 생성하는 구조

상품·게시글이 계속 추가되는 사이트는 스키마를 페이지마다 손으로 쓰는 대신, DB 값을 기반으로 자동 생성하는 구조가 유지보수에 유리합니다.

<?php
$schema = array(
    "@context" => "https://schema.org",
    "@type" => "Article",
    "headline" => $post['subject'],
    "datePublished" => $post['wr_datetime'],
);
echo '<script type="application/ld+json">'
   . json_encode($schema, JSON_UNESCAPED_UNICODE)
   . '</script>';
?>

값이 비어 있는 필드는 스키마에서 제외하거나 기본값으로 대체해, 빈 문자열이 그대로 들어가 오류로 판정되는 것을 막아야 합니다.

실무 정리

구조화 데이터는 실제 존재하는 정보만 정확히 반영해야 효과와 신뢰도가 유지됩니다. FAQ 스키마는 시맨틱 헤딩 구조와 함께 페이지 정보 구조를 명확히 하는 데 도움이 됩니다. 스키마 설계·코딩이 필요하면 무료 견적요청으로 노출시키고 싶은 정보를 알려주세요.