제품 컬렉션

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

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

제품 컬렉션 사용

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

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

  • collectionstatuses: 컬렉션의 상태를 가져오고 나열하여 컬렉션이 쇼핑 광고와 같은 대상에 대해 무효화될 수 있는 문제가 있는지 확인할 수 있습니다.

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

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

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

featuredProduct 필드를 사용하여 이미지에 표시된 제품을 지정해야 합니다. 여기에는 x 및 y 필드를 사용하여 이미지에 있는 제품의 좌표가 포함됩니다. 이 필드는 쇼퍼블 이미지와 함께 사용되는 컬렉션에만 필요합니다. x 및 y 값은 0에서 1 사이여야 합니다(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"
    }
  ]
}