제품 컬렉션

제품 컬렉션을 사용하면 쇼퍼블 이미지와 같은 리치 형식과 함께 사용할 제품 그룹을 정의할 수 있습니다. 각 컬렉션에는 최대 100개의 제품이 포함될 수 있습니다. Google 판매자 센터 또는 Content API를 사용하여 컬렉션을 만들 수 있습니다.

이 가이드에서는 쇼퍼블 이미지의 컬렉션을 만드는 방법과 컬렉션의 상태를 확인하는 방법에 관한 예를 포함하여 Content API를 통해 제품 컬렉션을 사용하는 방법을 설명합니다.

제품 컬렉션 사용

Content API에는 제품 컬렉션을 관리하는 두 가지 서비스가 포함되어 있습니다.

  • collections: 제품 컬렉션을 가져오고, 나열하고, 삽입하고, 삭제할 수 있습니다.

  • collectionstatuses: 컬렉션 상태를 가져오고 나열하여 컬렉션에 쇼핑 광고와 같이 컬렉션을 대상 위치에 적합하지 않게 만들 수 있는 문제가 있는지 확인할 수 있습니다.

예: 쇼퍼블 이미지 컬렉션 만들기

쇼퍼블 이미지는 주석이 달린 제품을 하나 이상 표시하는 고화질 이미지로, 컬렉션을 사용하여 구성됩니다. 쇼퍼블 이미지를 사용하려면 모든 컬렉션에 필요한 필드 외에 imageLink 및 featuredProduct 필드의 값을 지정해야 합니다. 필수 필드에 대한 자세한 내용은 Content API 참조 문서를 확인하세요.

쇼퍼블 이미지를 사용하려면 제품 컬렉션을 만들고 imageLink 필드를 사용하여 최대 10개의 제품이 포함된 이미지를 지정해야 합니다. 가로세로 비율이 1:1인 정사각형 이미지를 사용하는 것이 좋습니다.

또한 x 및 y 필드를 사용하는 이미지의 제품 좌표를 비롯하여 featuredProduct 필드를 사용하여 이미지에 표시되는 제품을 지정해야 합니다. 이 필드는 쇼퍼블 이미지와 함께 사용되는 컬렉션에만 필요합니다. x 및 y 값은 0 이상 1 이하여야 합니다.

각 컬렉션은 최대 100개의 제품을 포함할 수 있습니다. 그러나 쇼퍼블 이미지의 경우 이미지에 제품 콜아웃을 표시할 충분한 공간이 있도록 이미지당 10개 이하의 제품 좌표를 지정하는 것이 좋습니다. featuredProduct 객체의 일부인 offerId 필드는 products 리소스의 offerId 값과 일치해야 하며, 이는 products 리소스의 id 값과 다릅니다.

쇼퍼블 이미지에 필요한 imageLink 및 featuredProduct 필드 외에도 선택사항인 headline 필드를 사용하여 컬렉션 헤드라인을 지정할 수도 있습니다. 헤드라인을 포함하여 고객에게 컬렉션에 관한 추가 세부정보를 제공하는 것이 좋습니다.

쇼퍼블 이미지의 새 컬렉션을 만들려면 다음 URL 및 요청 본문을 사용하여 collections.insert 엔드포인트에 대한 POST 요청을 실행합니다.

https://shoppingcontent.googleapis.com/content/v2.1/merchantId/collections

{
  "id": "exampleCollection"
  "language": "en",
  "productCountry": "UK",
  "imageLink": ["www.imageLink.example"],
  "featuredProduct": [
{
  "offerId": '432',
  "x": 0.11,
  "y": 0.99
},
{ "offerId": '433',
  "x": 0.53,
  "y": 0.89
}
],
  "link": "www.link.example",
  "mobileLink": "www.mobileLink.example",
  "headline": "www.link.example",
  "customLabel0": "Organize",
  "customLabel1": "Your",
  "customLabel2": "Bidding/Reporting",
  "customLabel3": "With",
  "customLabel4": "Me"
}

예: 컬렉션 상태 확인하기

위에서 만든 컬렉션에 광고를 게재하지 못하도록 컬렉션을 무효화하는 문제가 있는지 알아보려면 다음 URL을 사용하여 collectionsstatuses.get 엔드포인트에 GET를 요청하고 상태를 가져오려는 컬렉션의 id를 포함합니다. 요청 본문을 제공할 필요는 없습니다.

https://shoppingcontent.googleapis.com/content/v2.1/merchantID/collectionstatuses/collection ID

컬렉션 상태 응답 예시

{
  "id": "exampleCollection",
  "creationDate": "2020-09-22T00:26:51Z",
  "lastUpdateDate": "2020-09-22T00:26:51Z",
  "collectionLevelIssues": [
    {
      "code": "invalid_url",
      "servability": "unaffected",
      "resolution": "merchant_action",
      "attributeName": "link",
      "description": "Invalid URL [link]",
      "detail": "Use a complete URL that starts with http:// or https:// and
          links to a valid destination such as an image or a landing page",
      "documentation": "https://support.google.com/merchants/answer/7052112"
    },
    {
      "code": "invalid_url",
      "servability": "unaffected",
      "resolution": "merchant_action",
      "attributeName": "imageLink",
      "description": "Invalid URL [imageLink]",
      "detail": "Use a complete URL that starts with http:// or https:// and
          links to a valid destination such as an image or a landing page",
      "documentation": "https://support.google.com/merchants/answer/7052112"
    }
  ]
}