컬러미숍 템플릿에 구조화 데이터 넣는 법
컬러미숍 템플릿에 구조화 데이터 넣는 법
- Category
- Guides
- Reading Time
- 8분 분량
- Series
- 일본 EC 플랫폼별 검색·AI 검색 가이드
컬러미숍은 HTML/CSS 템플릿을 편집할 수 있어서 구조화 데이터를 직접 추가할 수 있어요. 다만 표준으로 출력되는 것과 중복시키면 역효과예요. 표준 출력 확인, 추가해도 되는 타입, 템플릿 변수로 동적으로 채우는 방법, 하면 안 되는 것을 정...
- URL
- searchos.io/ko/blog
- Copyright
- © 2026 Search OS
컬러미숍은 ASP 중에서는 드물게 HTML/CSS 편집을 열어 둔 서비스입니다. 그래서 상품 페이지에 JSON-LD를 직접 넣을 수 있는지 묻는 문의가 자주 들어옵니다.
결론부터 말하면 넣어도 됩니다. 구조화 데이터는 페이지의 내용을 기계가 읽는 형태로 적어 두는 기술입니다. 컬러미숍은 ASP 중에서는 드물게 HTML/CSS 편집이 열려 있어 구조화 데이터를 직접 추가할 수 있습니다. 이건 분명한 강점입니다. 다만 순서가 있습니다. 표준으로 무엇이 출력되고 있는지 먼저 확인해야 합니다. 같은 타입을 두 번 출력하면 검증 도구에서 오류가 납니다. 그러면 오히려 평가가 떨어질 수도 있습니다.
이 글에서는 표준 출력을 확인하는 방법과 추가해도 되는 타입, 템플릿 변수로 값을 채우는 방법, 하면 안 되는 것을 정리합니다.
결론: 표준 출력을 확인하고, 부족한 타입만 템플릿 변수로 동적으로 더한다
절차 | 내용 | 도구 |
|---|---|---|
1 | 상품·카테고리·메인 3종의 URL에서 현재 출력되는 구조화 데이터를 확인 | 리치 리절트 테스트 |
2 | 부족한 타입을 특정(대부분 BreadcrumbList, Article, Organization) | 절차 1의 결과 |
3 | 템플릿에 JSON-LD를 추가. 값은 고정 문자열이 아니라 템플릿 변수로 채운다 | 템플릿 편집 |
4 | 여러 상품 페이지에서 재검증. 가격·재고가 화면과 일치하는지 확인 | 리치 리절트 테스트 |
5 | 템플릿을 갱신할 때마다 절차 4를 반복 | 운영 |
Search OS 가이드 01
- Search OS
- 가이드 01
템플릿에 구조화 데이터를 더하는 순서
표준 출력을 확인하고 부족한 타입만 변수로 동적으로 더한다
| 단계 | 설명 |
|---|---|
| 표준 출력 확인 | 상품·카테고리·톱을 리치 결과 테스트 |
| 부족한 타입 특정 | 대개 BreadcrumbList Article·Organization |
| 변수로 추가 | 고정 문자열이 아니라 템플릿 변수로 |
| 여러 상품으로 검증 | 가격·재고가 화면과 일치하는가 |
| 갱신마다 재검증 | 템플릿 갱신 때마다 4단계 반복 |
- POINT
- 고정 문자열 JSON-LD는 상품이 늘어나는 순간 거짓이 된다
© 2026 Search OS
중요한 관점: 구조화 데이터의 가치는 오늘도 올바른 값이 출력되고 있느냐로 정해집니다. 고정 문자열로 쓴 JSON-LD는 상품이 하나 늘어나는 순간 거짓이 됩니다. 상품명을 손으로 써 둔 가격표를 전 상품에 붙이는 것과 같습니다. 값은 반드시 템플릿 변수로 채웁니다.
절차 1: 표준 출력을 확인한다
컬러미숍이 표준으로 내보내는 구조화 데이터 타입은 플랜이나 템플릿에 따라 다를 수 있습니다. 추측하지 말고 실제 페이지에서 확인합니다.
상품 페이지, 카테고리 페이지, 메인 페이지의 URL을 하나씩 리치 리절트 테스트에 넣는다
검출된 타입(Product, BreadcrumbList, Organization, WebSite 등)을 메모한다
오류·경고가 있으면 기록한다
여기서 Product가 이미 출력되고 있다면 Product는 직접 쓰지 않습니다. 같은 이름표를 두 장 붙이는 셈이라 이중 출력이 됩니다. 검출된 타입은 메모해 둡니다.
절차 2: 부족한 타입을 정한다
타입 | 넣는 자리 | 필요한 이유 |
|---|---|---|
BreadcrumbList | 상품·카테고리 페이지 | 사이트 구조를 기계에 전달한다. 표준으로 나오지 않는 경우가 많다 |
Article | 프리페이지(콘텐츠) | 선택 기준·비교 글이 인용되는 전제 |
Organization | 메인 페이지만 | 사업자의 동일성. 다른 페이지에는 넣지 않는다 |
Product | 상품 페이지 | 표준으로 나오지 않는 경우에만. 나오고 있으면 건드리지 않는다 |
절차 3: 템플릿 변수로 동적으로 채운다
상품명, 가격, 이미지 URL, 재고 상태는 컬러미숍의 템플릿 변수(독자 태그)로 불러옵니다. 템플릿 변수는 상품마다 값이 자동으로 바뀌어 들어가는 빈칸입니다. 변수명은 공식 템플릿 레퍼런스에서 확인합니다. 기본 방식은 이렇습니다.
상품명 → 변수로 채운다. 손으로 쓰지 않는다
가격 → 변수로 채운다. 세금 포함·세금 별도 처리를 화면 표시와 맞춘다
재고 → 화면의 재고 표시와 같은 조건 분기를 쓴다. 화면이 "재고 있음"이면 InStock, "품절"이면 OutOfStock
이미지 URL → 변수로 채운다. 절대 URL로 되어 있는지 확인한다
값을 하나라도 고정 문자열로 쓰면 다른 상품에서는 틀린 값이 나갑니다. 손으로 쓴 값이 남아 있지 않은지 확인합니다.
절차 4: 여러 상품에서 검증한다
템플릿은 전체 상품에 적용됩니다. 한 상품에서 맞아도 다른 상품에서 깨질 수 있습니다. 가격이 다른 상품, 품절된 상품, 이미지가 여러 장인 상품, 이 3종류를 골라 화면 표시와 구조화 데이터 값이 일치하는지 확인합니다.
이것만은 하지 않는다
행위 | 무슨 일이 일어나는가 |
|---|---|
표준 출력과 같은 타입을 추가한다 | 같은 페이지에 같은 타입이 2개 나와 검증 도구에서 오류. 블록 전체가 무시될 수 있다 |
화면에 없는 정보를 구조화 데이터에만 쓴다(가공의 평가, 비공개 가격) | 가이드라인 위반. 수동 조치 대상이 될 수 있다 |
FAQPage를 일반 상품 페이지에 넣는다 | Google은 일반 사이트의 FAQ 리치 리절트를 사실상 제한. 표시되지 않는 데다 수고만 늘어난다 |
전체 페이지에 Organization을 넣는다 | 메인 페이지만으로 충분. 중복은 평가를 분산시킨다 |
템플릿 갱신 후 검증하지 않는다 | 갱신으로 깨져도 알아차리지 못한다. 가장 흔한 실패 |
Search OS 가이드 02
구조화 데이터에서 하면 안 되는 것
각각 무슨 일이 생기나
| 번호 | 금지 사항 | 발생하는 문제 |
|---|---|---|
| 1 | 표준 출력과 같은 타입 추가 | 같은 타입이 2개 나와 검증 에러. 블록 전체가 무시될 수도 |
| 2 | 화면에 없는 정보 기재 | 가이드라인 위반. 수동 조치 대상이 될 수 있음 |
| 3 | 상품 페이지에 FAQPage | 일반 사이트 FAQ 리치 결과는 사실상 제한. 수고만 늘어남 |
| 4 | 전 페이지에 Organization | 톱만으로 충분. 중복은 평가를 분산 |
| 5 | 갱신 후 검증하지 않음 | 깨져도 못 알아챔. 가장 흔한 실패 |
© 2026 Search OS
템플릿 편집으로는 끝나지 않는 일
템플릿으로 구조화 데이터를 더할 수 있다는 건 컬러미숍의 분명한 강점입니다. 다만 더한 뒤가 남습니다. 화면과 값이 계속 일치하는지 지키는 일입니다. 봇이 실제로 페이지를 가져가는지 확인하는 일도 남습니다. 이 둘은 템플릿 편집만으로는 해결되지 않습니다.
Search OS는 컬러미숍을 포함한 기존 숍을 계속 검증합니다. 구조화 데이터·메타데이터·canonical 상태를 확인합니다. 화면과 어긋난 값, 이중 출력, 템플릿 갱신 후의 파손을 찾아 수정 대상으로 정리합니다. 봇 로그에서 검색 엔진과 AI 크롤러가 실제로 페이지를 수집하는지도 확인합니다. 템플릿을 쓰는 작업을 대신하는 층이 아니라, 쓴 것이 오늘도 올바른지 지켜보는 층입니다.
자주 묻는 질문
구조화 데이터를 넣으면 순위가 오르나요?
순위를 직접 올리는 장치는 아닙니다. 리치 리절트 표시와 AI 검색이 페이지를 정확히 분류하는 데 쓰는 재료입니다. 순위보다 올바르게 이해되는가에 작용합니다.
플랜에 따라 편집할 수 있는 범위가 다른가요?
템플릿 편집 가능 여부와 범위는 플랜에 따라 다를 수 있습니다. 관리 화면에서 확인합니다. 편집할 수 없는 플랜이라면 표준 출력 범위 안에서 운영합니다.
제작사에 맡긴 템플릿에 구조화 데이터가 들어 있는지 모를 때
리치 리절트 테스트에 URL을 넣어 보면 알 수 있습니다. 들어 있으면 타입이 검출되고, 없으면 아무것도 나오지 않습니다. 주력 상품 URL 하나를 테스트에 넣어 확인합니다.
함께 읽기
참고 자료
Google Search Central: Product structured data
Google Search Central: Breadcrumb structured data
Google Search Central: General structured data guidelines
Google: Rich Results Test