제품 설명 페이지 (PDP)는 쇼핑객이 Google에서 구매로 구매를 완료하기 전에 제품의 기능과 이점을 알려 줍니다. Content API for Shopping을 통해 풍부한 제품 데이터를 업로드하여 풍부한 PDP를 만들 수 있습니다. 리치 제품 데이터에는 제품의 기능과 이점, 제품 옵션, 제품 이미지에 관한 정보가 포함됩니다.
리치 제품 데이터의 추가 이점은 다음과 같습니다.
- 고객이 필요에 맞는 제품을 찾을 수 있도록 더 자세한 제품 설명을 제공하여 제품 검색 가능성 개선
- 확신을 가지고 구매 결정을 내릴 수 있도록 정확한 제품 정보를 제공하여 고객 신뢰도 향상
- 고객에게 제품의 가치를 더 명확하게 전달하여 전환 개선
이 가이드에서는 products.insert
메서드를 사용하여 제품을 생성할 때 Content API를 사용하여 리치 제품 데이터를 업로드하는 방법을 설명합니다. 다음 섹션에서는 풍부한 제품 데이터를 구성하는 products
리소스의 속성이 포함된 부분 요청 본문을 제공합니다. 전체 JSON 요청은 예: products.insert를 사용하여 풍부한 제품 데이터 업로드를 참고하세요.
제품 ID 속성
제품의 id
속성(REST ID
이라고도 함)은 channel
, contentLanauge
, feedLabel
, offerId
속성에 입력한 값에서 파생된 고유 식별자입니다. 예를 들면 online:en:US:1111111111
입니다. 리치 제품 데이터의 경우 모든 제품 ID 속성의 값을 포함합니다.
channel
: 'online' 또는 'local'contentLanguage
: 두 글자 언어 코드(예: 'en', 'fr')feedLabel
: 2자리 언어 코드(예: 'US' 또는 'FR')offerId
: 판매자가 제공하는 고유 식별자 문자열
샘플 요청
"channel": "online",
"contentLanguage": "en",
"targetCountry": "US",
"feedLabel": "US",
"offerId": "1111111111"
제품 이름
title
속성에 브랜드, 성별, 사이즈, 색상과 같은 주요 제품 세부정보를 입력하면 고객이 올바른 제품을 보고 있는지 빠르게 확인할 수 있습니다. 제품 제목에 관한 추가 가이드라인 및 요구사항은 title: 정의를 참고하세요.
샘플 요청
"title": "Google Pixel 4 64GB Unlocked Smartphone 5.7' FHD Display 6GB RAM 4G Clear White"
제품 설명
description
속성을 통해 제공되는 풍부한 제품 설명은 사양과 이미지가 할 수 없는 방식으로 고객에게 제품에 대해 알리는 데 도움이 됩니다. 제품 설명에 관한 추가 가이드라인 및 요구사항은 설명: 정의를 참고하세요.
샘플 요청
"description": "The Google phone. MotionSense, an evolved camera, and the new
Google Assistant make Pixel 4 our most helpful phone yet. Studio-like photos.
Without the studio. Shoot without the flash. Capture rich detail and color, even
in the dark, with the next generation of Night Sight. Capture the cosmos. The
camera that can take photos of the Milky Way."
제품 이미지
imageLink
및 additionalImageLinks
속성을 통해 제품 이미지를 제공하여 제품 설명 페이지를 개선하세요. 다양한 각도와 맥락에서 제품을 보여주는 고품질 이미지를 여러 개 제공하는 것이 좋습니다. 제품 이미지에 관한 추가 가이드라인 및 요구사항은 image_link: 정의를 참고하세요.
샘플 요청
"imageLink": "https://example.com/gallery/500/image1.jpg",
"additionalImageLinks": [
"https://example.com/gallery/500/image2.jpg",
"https://example.com/gallery/500/image3.jpg",
"https://example.com/gallery/500/image4.jpg",
"https://example.com/gallery/500/image5.jpg"
]
제품 옵션
itemGroupId
속성을 사용하여 유사한 제품의 옵션에 대한 제품 그룹을 정의할 수 있습니다. 제품을 그룹화하는 방법과 시기, 요구사항, 권장사항에 관한 가이드라인은 item_group_id: 정의를 참고하세요.
샘플 요청
"itemGroupId": "pixels"
제품 특징
제품 설명 페이지의 제품 하이라이트 섹션에는 기본 제품 이미지 옆에 제품 세부정보의 짧은 글머리 기호 목록이 표시됩니다. productHighlights
속성을 사용하여 제품 하이라이트 섹션의 항목 목록을 제공합니다. 제품 특징을 5개 이상 제공하는 것이 좋습니다. 제품 특징에 관한 추가 가이드라인 및 요구사항은 product_highlights: 정의를 참고하세요.
샘플 요청
"productHighlights": [
"6GB RAM lets you enjoy multitasking conveniently",
"Touch screen feature offers user friendly interface",
"Its 16MP and 12MP rear cameras allow you capture high-quality pictures"
]
제품 세부정보
제품 설명 페이지의 제품 세부정보 섹션에는 제품 이미지 아래에 추가 제품 정보가 표시됩니다 (레이아웃은 데스크톱 페이지와 모바일 페이지 간에 다를 수 있음). productDetails
속성을 사용하여 제품 세부정보 객체 목록을 제공합니다. 각 객체에는 sectionName
, attributeName
, attributeValue
속성이 포함됩니다. 제품 세부정보를 6개 이상 제공하는 것이 좋습니다. 제품 세부정보에 관한 추가 가이드라인 및 요구사항은 product_detail: 정의를 참고하세요.
샘플 요청
"productDetails": [
{
"sectionName": "General",
"attributeName": "Product Type",
"attributeValue": "Smartphone"
},
{
"sectionName": "Display",
"attributeName": "Resolution",
"attributeValue": "FHD Display 6GB RAM"
}
]
제품 고유 식별자 (GTIN, 브랜드, MPN)
Google은 제품을 식별하기 위해 제품 고유 식별자를 사용합니다. 각 제품에 GTIN 값을 제공하는 것이 좋습니다. GTIN을 제공하지 않는 경우 Google에서 제품을 식별할 수 있도록 브랜드와 MPN 값을 모두 제공해야 합니다. 식별자 유형에 관한 자세한 내용은 제품 고유 식별자 정보를 참고하세요.
샘플 요청
"gtin": "842776114952",
"brand": "Google",
"mpn": "GA01188-US"
예: products.insert
를 사용하여 리치 제품 데이터 업로드
다음 JSON 샘플은 풍부한 제품 데이터를 업로드하기 위한 products.insert
호출 요청의 예를 보여줍니다.
POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products
{
"channel": "online",
"contentLanguage": "en",
"offerId": "pixel4",
"targetCountry": "US",
"feedLabel": "US",
"title": "Google Pixel 4 64GB Unlocked Smartphone 5.7' FHD Display 6GB RAM 4G Clear White",
"description": "The Google phone. Motion Sense, an evolved camera, and the new Google Assistant make Pixel 4 our most helpful phone yet. Studio-like photos. Without the studio. Shoot without the flash. Capture rich detail and color, even in the dark, with the next generation of Night Sight. Capture the cosmos. The camera that can take photos of the Milky Way.",
"imageLink": "https://example.com/gallery/500/image1.jpg",
"additionalImageLinks": [
"https://example.com/gallery/500/image2.jpg",
"https://example.com/gallery/500/image3.jpg",
"https://example.com/gallery/500/image4.jpg",
"https://example.com/gallery/500/image5.jpg"
],
"brand": "Google",
"googleProductCategory": "Electronics > Communications > Telephony > Mobile Phones",
"gtin": "842776114952",
"mpn": "GA01188-US",
"price": {
"currency": "USD",
"value": "549.99"
},
"salePrice": {
"currency": "USD",
"value": "549.99"
},
"productHighlights": [
"6GB RAM lets you enjoy multitasking conveniently",
"Touch screen feature offers user friendly interface",
"Its 16MP and 12MP rear cameras allow you capture high-quality pictures"
],
"productDetails": [
{
"sectionName": "General",
"attributeName": "Product Type",
"attributeValue": "Smartphone"
},
{
"sectionName": "Display",
"attributeName": "Resolution",
"attributeValue": "FHD Display 6GB RAM"
}
],
"availability": "in stock",
"condition": "new",
"includedDestinations": [
"Shopping Actions"
],
"excludedDestinations": [
"Shopping Ads"
],
"sellOnGoogleQuantity": 100,
"shippingLabel": "US_Test"
}