제품 컬렉션

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

이 가이드에서는 쇼퍼블 이미지용 컬렉션을 만드는 방법과 컬렉션 상태를 확인하는 방법을 비롯하여 Content API를 통해 제품 컬렉션을 사용하는 방법을 보여줍니다.

제품 컬렉션 사용

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

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

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

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

또한 featuredProduct 필드를 사용하여 이미지에 표시된 제품을 지정해야 하며, x 및 y 필드를 사용하여 이미지에서 제품의 좌표를 지정해야 합니다. 이러한 필드는 쇼퍼블 이미지에 사용되는 컬렉션에만 필요합니다. x 및 y 값은 0에서 1 사이의 값이어야 합니다(0과 1 포함).

각 컬렉션에는 최대 100개의 제품이 포함될 수 있습니다. 하지만 쇼퍼블 이미지의 경우 이미지에 제품 콜아웃을 표시할 공간이 충분하도록 이미지당 최대 10개의 제품에 대한 좌표를 지정하는 것이 좋습니다. offerId 필드는 featuredProduct 객체의 일부이며, 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"
    }
  ]
}