Shopify에 schema 마크업 추가하는 방법 (테마 손상 없이)

Schema 마크업이란 무엇이며, Shopify에는 이미 무엇이 있습니까?

Schema 마크업은 구조화 데이터입니다. 검색 엔진과 AI 답변 엔진이 페이지의 성격을 추측하지 않고 파악할 수 있도록 JSON-LD 형식으로 정보를 표시하는 블록입니다. 상품 페이지에서는 이것이 상품임을 명시하고, 가격, 평점, 리뷰를 함께 기술합니다. Google은 이를 바탕으로 검색 결과에 별점, 가격, 재고 여부를 표시합니다.

Shopify 테마에는 기본 Product 블록 형태의 구조화 데이터가 이미 포함되어 있습니다. 그러나 Review나 aggregateRating은 대부분 포함되어 있지 않습니다. 테마 자체에는 설명할 리뷰 데이터가 없기 때문입니다. 이것이 바로 채워야 할 빈 곳입니다. 리뷰 데이터를 Product 마크업에 연결하여 별점이 검색 결과에 표시될 수 있도록 하는 것입니다.

상품 리뷰에 실제로 필요한 schema는 무엇입니까?

리치 결과를 위해 Google은 Review, aggregateRating, 또는 둘 다를 포함한 Product가 필요합니다. Product 블록에는 name, image, offers가 포함됩니다. aggregateRating에는 평균 점수와 리뷰 수가 포함됩니다. 각 Review에는 author, rating, 리뷰 본문이 포함됩니다.

많은 사람이 놓치는 규칙이 있습니다. 마크업에 기재된 리뷰와 평점은 반드시 페이지에서 실제로 보여야 합니다. 리뷰가 하나도 표시되지 않는 페이지에서 aggregateRating을 200개 리뷰 기준 4.8로 마크업할 수는 없습니다. Google은 이를 오해의 소지가 있다고 판단하여 해당 페이지 전체의 리치 결과를 제거합니다.

• Product: name, image, offers (가격, 통화, 재고 여부).
• aggregateRating: ratingValue와 reviewCount, 페이지에 표시된 값과 일치해야 합니다.
• Review: author, reviewRating, reviewBody, 페이지에 표시된 개별 리뷰 기준.

테마 JSON-LD 직접 수정, 앱 사용, 생성 도구 중 무엇을 선택해야 합니까?

세 가지 방법이 있으며, 각각 제어 수준과 안전성을 서로 다르게 절충합니다. 테마 JSON-LD를 직접 수정하면 완전한 제어가 가능하지만 Liquid 코드를 건드려야 하므로, 쉼표 하나만 잘못되어도 블록 전체가 조용히 손상될 수 있습니다. 리뷰 앱이 schema를 자동 삽입하도록 하면 작업량이 가장 적지만, 앱이 출력하는 형식을 그대로 따라야 하며 일부 앱은 클라이언트 측에서 삽입하므로 크롤러가 놓칠 수 있습니다. Schema 생성 도구는 중간 방법입니다. 실제 값을 입력하면 유효한 JSON-LD를 반환하며, 이를 페이지에 하나의 블록으로 추가할 수 있습니다.

테마 코드가 익숙하지 않다면 생성 도구 방법으로 시작하십시오. 테마를 수정하지 않고도 올바른 블록을 페이지에 추가할 수 있는 가장 위험 부담이 낮은 방법이며, 출력 결과를 Custom Liquid 섹션에 바로 붙여넣을 수 있습니다.

• 테마 JSON-LD: 제어 수준 가장 높음, 조용한 문법 오류 위험도 가장 높음.
• 앱 삽입: 작업량 가장 적음, 단 페이지 소스에 실제로 렌더링되는지 확인 필요.
• 생성 도구: 실제 값 입력 후 검증된 JSON-LD를 반환, 블록 하나로 추가.

테마를 손상시키지 않고 마크업을 추가하는 방법

기존 JSON-LD 블록 중간에 schema를 붙여넣지 마십시오. 독립적인 스크립트로 별도 추가해야 합니다. 테마 편집기에서 Custom Liquid 섹션을 추가하거나 상품 템플릿을 수정하여, Product 블록을 포함한 새로운 application/ld+json 타입의 스크립트를 별도로 배치하십시오. 분리된 상태로 유지하면 작성한 블록에 오류가 발생해도 테마 블록에 영향을 주지 않으며, 반대 경우도 마찬가지입니다.

저장하기 전에 테마를 복제하여 롤백용 사본을 만들어 두십시오. 블록을 추가하고 저장한 뒤, 실제 상품 페이지의 소스를 통해 JSON-LD가 스크립트 실행 이후가 아닌 원시 HTML에 포함되어 있는지 확인하십시오. 앱이 로드 이후에 리뷰를 삽입하는 경우, 가장 안전한 방법은 앱이 서버 측에서 렌더링하도록 하거나, 이미 페이지에 출력된 값을 기반으로 생성 도구 출력을 연동하는 것입니다.

유효성 검사 방법과 실패 시 나타나는 현상

모든 상품 템플릿을 두 가지로 확인하십시오. 리치 결과 적합성을 위한 Google Rich Results Test와, 문법 검사를 위한 Schema.org 검증 도구입니다. Rich Results Test는 Product가 별점 표시 조건을 충족하는지 알려주고 누락된 필수 항목을 표시합니다. Schema.org 검증 도구는 Rich Results Test가 통과시키는 경우에도 잘못된 JSON을 잡아냅니다.

가장 자주 발생하는 문제는 문법 오류가 아닙니다. 페이지에 보이는 리뷰가 없는데 평점이 마크업에 포함되어 있거나, 마크업의 값과 페이지 내용이 일치하지 않는다는 경고입니다. 마크업이 구매자가 실제로 볼 수 있는 내용을 정확히 반영하도록 수정한 뒤 재검증하십시오.

• Rich Results Test: Product 적합성 확인 및 누락된 항목 표시.
• Schema.org 검증 도구: Rich Results Test가 놓친 잘못된 JSON 검사.
• 실제 페이지 소스 확인: 블록이 원시 HTML에 포함되어 있는지 확인.

Schema를 조용히 무효화하는 실수들

무효화된 schema의 대부분은 기술적으로는 유효하지만, 페이지에 표시되지 않는 내용을 기술하고 있기 때문에 거부됩니다. 대표적인 사례는 다음과 같습니다. 페이지에 렌더링된 리뷰가 없는데 aggregateRating이 있는 경우, 마크업의 리뷰 수가 화면의 수와 일치하지 않는 경우, 단일 상품이 아닌 카테고리 페이지나 홈페이지에 상품 또는 리뷰 마크업을 적용한 경우입니다.

더 근본적인 문제는 가독성입니다. 많은 리뷰 앱은 페이지 방문자를 위해 만들어졌고 그 수준에서 멈춥니다. 브라우저에서는 별점이 올바르게 보이지만, 리뷰 텍스트와 평점이 크롤러와 AI 답변 엔진이 읽을 수 없는 widget 안에 갇혀 있어, 마크업이 기계가 전혀 볼 수 없는 내용을 기술하게 됩니다. 기존 리뷰를 검색과 AI에서 읽을 수 있고, 검증 가능하며, 인용 가능하도록 만드는 것이 BeyondReviews가 해결하려는 과제입니다.

• aggregateRating은 있지만 페이지에 실제로 렌더링된 리뷰가 없음.
• 마크업의 리뷰 수 또는 평균이 화면에 표시된 숫자와 불일치.
• 단일 상품이 아닌 페이지에 Product 또는 Review 마크업 적용.
• 크롤러가 읽을 수 없는 클라이언트 측 widget 안에 갇힌 리뷰.

정리

깔끔한 Shopify schema는 세 가지로 이루어집니다. 독립적인 Product 블록, 페이지에 실제로 표시된 리뷰, 그리고 구매자가 볼 수 있는 내용과 모든 값이 일치하는 마크업입니다. 테마를 손상시키지 않도록 별도 스크립트로 추가하고, 직접 입력하는 대신 실제 데이터를 바탕으로 생성하며, 완료하기 전에 모든 템플릿을 검증하십시오.

이를 모두 갖추면 별점, 가격, 리뷰 수가 Google 검색 결과에 표시될 조건을 충족합니다. 일치 규칙을 무시하면 마크업은 유효하지만 무시되는 최악의 상황이 됩니다. 작업은 했지만 아무것도 표시되지 않는 것입니다.