제품 방문 페이지에 구조화된 데이터 마크업을 사용하면 Google이 제품 및 서비스에 대한 최신 정보를 웹사이트에서 바로 가져올 수 있습니다. 판매자 센터에서 지원하는 모든 구조화된 데이터 마크업에는 해당하는 속성 및 허용되는 값이 있고, 이러한 데이터는 제품 데이터 사양에 등록되어 있는 습니다. 구조화된 데이터는 해당하는 값 및 속성과 일치해야 합니다.
이 페이지의 내용:
속성 및 schema.org 주석
속성은 판매자 센터에 제출하는 제품 데이터를 구성하는 방법 중 하나입니다. 각 속성에는 제품명이나 제품의 설명 등 제품에 대한 한 가지 정보가 포함됩니다. schema.org 값과 해당 제품 데이터 사양 속성이 정확히 일치하면 피드 유효성을 검사할 때 발생하는 오류가 줄어듭니다.
참고: 상품 자동 업데이트를 사용하는 경우 정확성을 높이려면 schema.org 속성 price
, priceCurrency
, availability
, condition
를 지정해야 합니다. 상품 자동 업데이트 자세히 알아보기
제품 데이터 속성
|
유형 및 설명 | ||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
schema.org Product 유형의 속성은 다음과 같습니다. |
|||||||||||||||||||||||||||||
텍스트 | |||||||||||||||||||||||||||||
텍스트 | |||||||||||||||||||||||||||||
텍스트 | |||||||||||||||||||||||||||||
URL | |||||||||||||||||||||||||||||
텍스트 동일한 제품 그룹에 속하는 모든 옵션 제품을 함께 그룹화하는 데 필요한 상위 SKU입니다. |
|||||||||||||||||||||||||||||
텍스트 GTIN은 제품의 고유한 식별 번호입니다. 이러한 schema.org 속성 중 하나만 지정합니다. GTIN 값을 사용하는 경우 길이 제한을 준수하고 적절한 검사 숫자를 포함해야 합니다. |
|||||||||||||||||||||||||||||
텍스트 | |||||||||||||||||||||||||||||
텍스트 | |||||||||||||||||||||||||||||
텍스트 | |||||||||||||||||||||||||||||
텍스트
|
|||||||||||||||||||||||||||||
텍스트
|
|||||||||||||||||||||||||||||
그리고 |
숫자(나이)
유효한 값은 다음과 같은
|
||||||||||||||||||||||||||||
텍스트 | |||||||||||||||||||||||||||||
또는 |
텍스트
|
||||||||||||||||||||||||||||
텍스트
유효한 값은
|
|||||||||||||||||||||||||||||
텍스트
유효한 값은 WearableSizeSystemEnumeration 유형에 속하는 값입니다. 이러한 값은 피드 값에 다음과 같이 매핑됩니다.
|
|||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||
다음 schema.org 속성은 Offer 유형에 나오는 속성으로 |
|||||||||||||||||||||||||||||
제품의 유효한 URL입니다. | |||||||||||||||||||||||||||||
또는 |
price: 숫자. 통화 기호, 천 단위 구분 기호, 공백 없이 숫자로만 제출되어야 합니다(예: '1498.99'). priceCurrency: 텍스트. 3자리 ISO 4217 형식(예: USD, GBP, EUR)이어야 하며 통화가 대상 국가의 언어 및 통화 요구사항을 충족해야 합니다. 참고: price 및 priceCurrency는 Offer 인스턴스 바로 아래에 제공되거나 UnitPriceSpecification 유형의 priceSpecification 속성을 통해 간접적으로 제공될 수 있습니다. sale_price가 지정되면 priceSpecification.priceType="ListPrice"와 함께 priceSpecification 속성을 사용해 price를 제공해야 합니다. sale_price는 Offer에 직접 지정하거나 priceSpecification.priceType 없이 UnitPriceSpecification 유형의 priceSpecification 속성을 사용해 지정할 수 있습니다. |
||||||||||||||||||||||||||||
유효한 값은
|
|||||||||||||||||||||||||||||
유효한 값은
|
|||||||||||||||||||||||||||||
제품의 유효한 결제 URL입니다. |
JSON-LD 사용 예시
단일 제품
예시
다음 예시는 최소 속성 집합을 포함하는 기본 제품을 보여줍니다.
{
"@context": "https://schema.org/",
"@type": "Product",
"sku": "trinket-12345",
"image": "https://example.com/trinket.jpg",
"name": "Nice trinket",
"description": "Trinket with clean lines",
"gtin": "12345678901234",
"brand": {
"@type": "Brand",
"name": "MyBrand"
},
"offers": {
"@type": "Offer",
"url": "https://example.com/trinket_offer",
"itemCondition": "https://schema.org/NewCondition",
"availability": "https://schema.org/InStock",
"price": 39.99,
"priceCurrency": "USD"
}
}
다음 예시는 schema.org를 사용하여 사이즈 유형 및 사이즈 체계를 지정하는 방법을 보여줍니다. 이 예시에서는 '빅&톨' 남성 패션 부문의 성인(13세 이상 연령대)을 대상으로 하는 파란색 티셔츠의 미국 사이즈 'XL'를 지정합니다.
{
"@context": "https://schema.org/",
"@type": "Product",
"sku": "12345",
"image": "https://example.com/tshirt.jpg",
"name": "Classic T-Shirt",
"description": "All-cotton t-shirt in classic cut",
"gtin": "12345678901234",
"brand": {
"@type": "Brand",
"name": "MyBrand"
},
"material": "cotton",
"color": "blue",
"size": {
"@type": "SizeSpecification",
"name": "XL",
"sizeSystem": "https://schema.org/WearableSizeSystemUS",
"sizeGroup": [
"https://schema.org/WearableSizeGroupBig",
"https://schema.org/WearableSizeGroupTall"
]
},
"audience": {
"@type": "PeopleAudience",
"suggestedGender": "male",
"suggestedMinAge": 13
},
"offers": {
"@type": "Offer",
"url": "https://example.com/tshirt",
"itemCondition": "https://schema.org/NewCondition",
"availability": "https://schema.org/InStock",
"price": 24.99,
"priceCurrency": "USD"
}
}
하나의 방문 페이지에 관련 없는 제품이 여러 개 있음
페이지에 관련 없는 제품이 여러 개 포함되어 있고 각 제품에 자체 구조화된 데이터 주석이 있는 경우, 각 주석에는 참조하는 제품을 식별하는 정보가 포함되어야 합니다.
예를 들어 각 주석에 SKU(ID [id]
속성) 또는 GTIN([gtin]
속성)을 제공하는 것이 좋습니다. 이 정보를 제공하지 않으면 방문 페이지의 제품이 구조화된 제품 데이터와 일치되지 않을 수 있습니다. 방문 페이지에 구조화된 데이터를 설정하는 방법 자세히 알아보기
예시
[
{
"@context": "https://schema.org/",
"@type": "Product",
"sku": "trinket-12345",
"image": "https://example.com/trinket.jpg",
"name": "Nice trinket",
"description": "Trinket with clean lines",
"gtin": "12345678901234",
"brand": {
"@type": "Brand",
"name": "MyBrand"
},
"offers": {
"@type": "Offer",
"url": "https://example.com/trinket_offer",
"itemCondition": "https://schema.org/NewCondition",
"availability": "https://schema.org/InStock",
"price": 39.99,
"priceCurrency": "USD"
}
},
{
"@context": "https://schema.org/",
"@type": "Product",
"sku": "racket-12345",
"image": "https://example.com/racket.jpg",
"name": "Nice racket",
"description": "Racket for Tennis",
"gtin": "12345678901235",
"brand": {
"@type": "Brand",
"name": "MyBrand"
},
"offers": {
"@type": "Offer",
"url": "https://example.com/racket_offer",
"itemCondition": "https://schema.org/NewCondition",
"availability": "https://schema.org/InStock",
"price": 59.99,
"priceCurrency": "USD"
}
}
]
할인가
다음은 할인가가 적용되는 기본 제품을 보여주는 예시입니다. 할인가를 표시하려면 /priceType 속성으로 지정된 원래 정가도 표시합니다.
예시
{
"@context": "https://schema.org/",
"@type": "Product",
"sku": "trinket-12345",
"image": "https://example.com/trinket.jpg",
"name": "Nice trinket",
"description": "Trinket with clean lines",
"gtin": "12345678901234",
"brand": {
"@type": "Brand",
"name": "MyBrand"
},
"offers": {
"@type": "Offer",
"url": "https://example.com/trinket_offer",
"itemCondition": "https://schema.org/NewCondition",
"availability": "https://schema.org/InStock",
"price": 10.00,
"priceCurrency": "USD",
"priceSpecification": {
"@type": "UnitPriceSpecification",
"priceType": "https://schema.org/ListPrice",
"price": 15.00,
"priceCurrency": "USD"
}
}
}
If a /UnitPriceSpecification is also used for the non sale-price, the encoding simply contains two /UnitPriceSpecifications:
{
"@context": "https://schema.org/",
"@type": "Product",
"sku": "trinket-12345",
"image": "https://example.com/trinket.jpg",
"name": "Nice trinket",
"description": "Trinket with clean lines",
"gtin": "12345678901234",
"brand": {
"@type": "Brand",
"name": "MyBrand"
},
"offers": {
"@type": "Offer",
"url": "https://example.com/trinket_offer",
"itemCondition": "https://schema.org/NewCondition",
"availability": "https://schema.org/InStock",
"priceSpecification": [
{
"@type": "UnitPriceSpecification",
"price": 10.00,
"priceCurrency": "USD"
},
{
"@type": "UnitPriceSpecification",
"priceType": "https://schema.org/ListPrice",
"price": 15.00,
"priceCurrency": "USD"
}
]
}
}
배송
제품의 배송비를 지정하려면(권장) Schema.org OfferShippingDetails
유형을 사용합니다. 이 유형은 shippingDetails
속성을 사용하여 'Offer' 내에 중첩되어야 하며 이는 제품 데이터 사양에 있는 shipping
속성에 매핑됩니다. 여러 shippingDetails
속성을 제공할 수 있습니다.
제품 데이터 속성
|
유형 및 설명 |
---|---|
schema.org OfferShippingDetails 유형의 속성은 다음과 같습니다. |
|
|
텍스트 2자리 ISO 3166-1 국가 코드
|
텍스트 국가 프리픽스 없이 2자리 또는 3자리의 ISO 3166-2 구역 코드. 미국, 오스트레일리아 또는 일본에서만 지원됩니다. 예: 'NY', 'NSW' 또는 '03'.
|
|
|
|
숫자(음수가 아닌 수, 자연수) 주문 상품 준비 및 운송을 위한 최단 및 최장 영업일 수를 지정합니다. 주문 상품 준비 시간은 제품을 주문한 때부터 운송업체에 제품이 핸드오프될 때까지 걸리는 시간을 지정합니다. 운송 기간은 제품이 운송업체에 핸드오프된 때부터 고객에게 배송될 때까지 걸리는 시간을 지정합니다.
|
예시
다음 예시는 schema.org를 사용하여 배송 정보를 지정하는 방법을 보여줍니다. 이 예시에서는 미국 캘리포니아, 네바다, 애리조나에 USD 3.49의 배송비를 지정합니다. 주문 상품 준비 시간이 영업일 기준 0~1일이고 운송 기간이 영업일 기준 1~5일입니다.
{
"@context": "https://schema.org/",
"@type": "Product",
"sku": "trinket-12345",
"gtin": "12345678901234",
"image": "https://example.com/trinket.jpg",
"name": "Nice trinket",
"description": "Trinket with clean lines",
"brand": {
"@type": "Brand",
"name": "MyBrand"
},
"offers": {
"@type": "Offer",
"url": "https://example.com/trinket_offer",
"itemCondition": "https://schema.org/NewCondition",
"availability": "https://schema.org/InStock",
"priceSpecification": {
"@type": "UnitPriceSpecification",
"price": 39.99,
"priceCurrency": "USD"
},
"shippingDetails": {
"@type": "OfferShippingDetails",
"shippingDestination": {
"@type": "DefinedRegion",
"addressCountry": "US",
"addressRegion": [ "CA", "NV", "AZ" ]
},
"shippingRate": {
"@type": "MonetaryAmount",
"value": 3.49,
"currency": "USD"
},
"deliveryTime": {
"@type": "ShippingDeliveryTime",
"handlingTime": {
"@type": "QuantitativeValue",
"minValue": 0,
"maxValue": 1,
"unitCode": "DAY"
},
"transitTime": {
"@type": "QuantitativeValue",
"minValue": 1,
"maxValue": 5,
"unitCode": "DAY"
}
}
}
}
}
반품
제품의 반품 기간과 비용을 지정하려면 Schema.org MerchantReturnPolicy 유형을 사용하세요. 이 유형은 hasMerchantReturnPolicy 속성을 사용하여 Offer 유형 내에 중첩되어야 합니다.
제품 데이터 속성
|
유형 및 설명 |
---|---|
다음 schema.org 속성은 MerchantReturnPolicy에 나오는 속성으로 offers 속성을 사용하여 제품 내에 중첩되어야 합니다(아래 예시 참조). | |
applicableCountry |
두 글자로 된 ISO 3166-1 alpha-2 국가 코드(예: 'US') 3글자 ISO 3166-1 alpha-3 국가 코드(예: 'USA') 특정 판매자 반품 정책이 적용되는 국가입니다. 제품 발송 국가와 다를 수 있습니다. 최대 50개 국가를 지정할 수 있습니다. |
유효한 값은 MerchantReturnEnumeration 유형에 속하는 값입니다. MerchantReturnFiniteReturnWindow 또는 MerchantReturnUnlimitedWindow로 지정된 경우 returnMethod와 returnShippingFeesAmount가 권장됩니다. 또한 MerchantReturnFiniteReturnWindow로 지정된 경우 merchantReturnDays가 필요합니다. |
|
merchantReturnDays |
제품을 반품할 수 있는 배송일로부터의 일수입니다. |
returnMethod |
유효한 값은 ReturnMethodEnumeration 유형에 속하는 값입니다.
|
returnFees | 유효한 값은 ReturnFeesEnumeration 유형의 FreeReturn입니다. |
returnShippingFeesAmount |
제품 반품 배송비에 관한 정보입니다. |
예시
{
"@context": "https://schema.org/",
"@type": "Product",
"sku": "trinket-12345",
"gtin": "12345678901234",
"image": "https://example.com/trinket.jpg",
"name": "Nice trinket",
"description": "Trinket with clean lines",
"brand": {
"@type": "Brand",
"name": "MyBrand"
},
"offers": {
"@type": "Offer",
"url": "https://example.com/trinket_offer",
"itemCondition": "https://schema.org/NewCondition",
"availability": "https://schema.org/InStock",
"priceSpecification": {
"@type": "UnitPriceSpecification",
"price": 39.99,
"priceCurrency": "USD"
},
"shippingDetails": {
"@type": "OfferShippingDetails",
"shippingRate": {
"@type": "MonetaryAmount",
"value": 2.99,
"currency": "USD"
},
"shippingDestination": {
"@type": "DefinedRegion",
"addressCountry": "US"
},
"deliveryTime": {
"@type": "ShippingDeliveryTime",
"handlingTime": {
"@type": "QuantitativeValue",
"minValue": 0,
"maxValue": 1,
"unitCode": "DAY"
},
"transitTime": {
"@type": "QuantitativeValue",
"minValue": 1,
"maxValue": 5,
"unitCode": "DAY"
}
}
},
"hasMerchantReturnPolicy": {
"@type": "MerchantReturnPolicy",
"applicableCountry": "US",
"returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow",
"merchantReturnDays": 60,
"returnMethod": "https://schema.org/ReturnByMail",
"returnFees": "https://schema.org/FreeReturn"
}
}
}
에너지 효율
Schema.org는 EnergyConsumptionDetails
유형을 사용하여 제품의 에너지 효율 라벨 지정을 지원합니다. 이 유형은 EnergyConsumptionDetails
속성을 사용하는 제품에 지정할 수 있습니다.
제품 데이터 속성
|
유형 및 설명 |
---|---|
다음 schema.org 속성은 EnergyConsumptionDetails 유형에 나오는 속성입니다. |
|
유효한 값은 schema.org |
|
energy_efficiency_class 속성을 지정하는 데 사용된 EnergyConsumptionDetails 인스턴스 아래에 추가하고 동일한 매핑 표를 사용해 값을 선택합니다. 값이 제공되지 않은 상태에서 energy_efficiency_class 를 지정하면 EUEnergyEfficiencyCategoryG 값이 가정됩니다. |
|
energy_efficiency_class 속성을 지정하는 데 사용된 EnergyConsumptionDetails 인스턴스 아래에 추가하고 동일한 매핑 표를 사용해 값을 선택합니다. 만일 값이 제공되지 않고 energy_efficiency_class 를 지정하면 EUEnergyEfficiencyCategoryA3Plus 값이 가정됩니다. |
energyEfficiencyScale
, energyEfficiencyScaleMin
, energyEfficiencyScaleMax
값은 schema.org EUEnergyEfficiencyEnumeration
열거형에 속하며 다음과 같이 제품 데이터 사양의 3가지 에너지 효율 속성 값에 매핑됩니다.
예시
다음 예시는 schema.org를 사용하여 에너지 효율 정보를 지정하는 방법을 보여줍니다. 이 예시에서는 온수기의 'A+'부터 'F'까지의 EU 에너지 효율 등급 중에서 'C'로 지정합니다.
{
"@context": "https://schema.org/",
"@type": "Product",
"sku": "1234-5678",
"image": "https://example.com/waterheater.jpg",
"name": "온수기",
"description": "대용량 온수기",
"gtin": "12345678901231",
"mpn": "WH1234",
"brand": {
"@type": "Brand",
"name": "ExampleWaterHeaterBrand"
},
"hasEnergyConsumptionDetails": {
"hasEnergyEffiencyCategory": "https://schema.org/EUEnergyEfficiencyCategoryC",
"energyEffiencyScaleMax":
"https://schema.org/EUEnergyEfficiencyCategoryA1Plus",
"energyEffiencyScaleMin": "https://schema.org/EUEnergyEfficiencyCategoryF"
},
"offers": {
"@type": "Offer",
"url": "https://example.com/hotwaterheater",
"itemCondition": "https://schema.org/NewCondition",
"availability": "https://schema.org/InStock",
"price": 1,799,000.00,
"priceCurrency": "KRW"
}
}
단가 책정
Schema.org는 UnitPriceSpecification
유형 아래 referenceQuantity
속성을 사용하여 제품의 단가 책정을 지원합니다. 이 속성은 'Offer'에서 priceSpecification
속성 사용 시 제공됩니다. 단가 요금을 지정할 때 priceSpecification
속성('Offer'에서 price
및 priceCurrency
속성을 직접 사용하는 대신)을 사용하여 제품의 가격과 통화를 지정합니다.
제품 데이터 속성
|
유형 및 설명 |
---|---|
다음 schema.org 속성은 UnitPriceSpec 유형에 나오는 속성입니다. |
|
제공 항목의 가격을 지정하는 데 사용되는
|
|
단가 책정 단위를 지정하는 데 사용된
|
예시
다음 예시는 1KG당 기본 표준 가격이 적용된 쌀 5KG 한 봉지의 3,990.00 KRW 가격을 보여줍니다. 즉, 소비자에게 제품이 킬로당 800.00 KRW로 표시될 수 있습니다.
{
"@context": "https://schema.org/",
"@type": "Product",
"sku": "basrice12345",
"image": "https://example.com/rice.jpg",
"name": "Basmati rice",
"description": "Large bag of Organic Basmati white rice, 5 Kilogram",
"gtin": "12345678901231",
"brand": {
"@type": "Brand",
"name": "ExampleRiceBrand"
},
"offers": {
"@type": "Offer",
"url": "https://example.com/basrice1kg",
"itemCondition": "https://schema.org/NewCondition",
"availability": "https://schema.org/InStock",
"priceSpecification": {
"@type": "UnitPriceSpecification",
"price": 3.99,
"priceCurrency": "EUR",
"referenceQuantity": {
"@type": "QuantitativeValue",
"value": 5,
"unitCode": "KGM",
"valueReference": {
"value": 1,
"unitCode": "KGM"
}
}
}
}
}
마크업 테스트
리치 결과 도구를 사용하여 schema.org 구현을 테스트할 수 있습니다('판매자 등록정보' 구조화된 데이터 보고 검토). 도구를 사용하는 방법, 문제를 디버깅하는 방법, 도구에서 결과를 해석하는 방법은 Google Search Console 고객센터를 참고하세요. 구조화된 제품 데이터에 대해 자세히 알아보세요.
구조화된 데이터 마크업 요구사항
- 구조화된 데이터 마크업은 웹 서버에서 반환된 HTML에 존재해야 합니다. 페이지가 로드된 후에는 구조화된 데이터 마크업을 JavaScript로 생성할 수 없습니다.
- 고객의 IP 주소 또는 브라우저 유형에 따라 가격을 조정하는 등 고객 관련 정보를 바탕으로 방문 페이지를 변경할 수 없습니다.
- 구조화된 데이터가 고객에게 표시되는 값과 일치해야 합니다. 제품 방문 페이지에 잘못된 데이터를 제공하는 것은 Google의 웹 개발자 가이드라인에 위배됩니다.
- 구조화된 데이터에는 JSON-LD를 사용하는 것이 좋습니다.