Bộ sưu tập sản phẩm

Bộ sưu tập sản phẩm cho phép bạn xác định các nhóm sản phẩm để sử dụng với các định dạng phong phú, chẳng hạn như Hình ảnh có thể nhấp vào để mua hàng. Mỗi bộ sưu tập có thể bao gồm tối đa 100 sản phẩm. Bạn có thể tạo một bộ sưu tập bằng Google Merchant Center hoặc Content API.

Hướng dẫn này trình bày cách sử dụng bộ sưu tập sản phẩm thông qua Content API, bao gồm cả ví dụ về cách tạo bộ sưu tập cho Hình ảnh có thể mua sắm và cách kiểm tra trạng thái của bộ sưu tập.

Lưu ý: Hình ảnh có thể nhấp vào để mua hàng hiện là định dạng quảng cáo duy nhất hỗ trợ bộ sưu tập. Tuy nhiên, chúng tôi có thể thêm các định dạng khác để bạn có thể sử dụng lại bộ sưu tập của mình trên nhiều định dạng quảng cáo.

Sử dụng bộ sưu tập sản phẩm

Content API bao gồm 2 dịch vụ để quản lý bộ sưu tập sản phẩm:

• collections: Cho phép bạn nhận, liệt kê, chèn và xoá bộ sưu tập sản phẩm.

• collectionstatuses: Cho phép bạn nhận và liệt kê trạng thái của bộ sưu tập để biết liệu bộ sưu tập có vấn đề nào có thể khiến bộ sưu tập không hợp lệ cho một vị trí xuất hiện hay không, chẳng hạn như quảng cáo Mua sắm.

Ví dụ: Tạo một bộ sưu tập cho Hình ảnh có thể nhấp vào để mua hàng

Hình ảnh có thể nhấp vào để mua hàng là hình ảnh chất lượng cao cho thấy một hoặc nhiều sản phẩm có chú thích và được định cấu hình bằng bộ sưu tập. Để sử dụng Hình ảnh có thể nhấp vào để mua hàng, bạn phải chỉ định giá trị cho các trường imageLink và featuredProduct, ngoài các trường bắt buộc cho tất cả bộ sưu tập. Để biết thêm thông tin về các trường bắt buộc, hãy xem Tài liệu tham khảo về Content API.

Để sử dụng Hình ảnh có thể nhấp vào để mua hàng, bạn phải tạo một bộ sưu tập sản phẩm và sử dụng trường imageLink để chỉ định một hình ảnh có chứa tối đa 10 sản phẩm. Bạn nên sử dụng hình ảnh vuông (có tỷ lệ khung hình 1:1).

Điểm chính: Trường imageLink cho bộ sưu tập chấp nhận một mảng các giá trị đường liên kết của hình ảnh. Tuy nhiên, chỉ giá trị đầu tiên trong mảng được dùng cho định dạng Hình ảnh có thể nhấp vào để mua hàng.

Bạn cũng phải chỉ định các sản phẩm xuất hiện trong hình ảnh bằng cách sử dụng trường featuredProduct, bao gồm cả toạ độ của các sản phẩm trong hình ảnh bằng cách sử dụng các trường x và y. Bạn chỉ cần điền những trường này cho bộ sưu tập được dùng với Hình ảnh có thể nhấp vào để mua hàng. Giá trị x và y phải nằm trong khoảng từ 0 đến 1, bao gồm cả hai giá trị này.

Mỗi bộ sưu tập có thể có tối đa 100 sản phẩm. Tuy nhiên, đối với Hình ảnh có thể nhấp vào để mua hàng, bạn nên chỉ định toạ độ cho không quá 10 sản phẩm trên mỗi hình ảnh để đảm bảo có đủ không gian trên hình ảnh để hiển thị phần chú thích sản phẩm. Trường offerId là một phần của đối tượng featuredProduct phải khớp với giá trị offerId trên tài nguyên products, khác với giá trị id trên tài nguyên products.

Ngoài các trường imageLink và featuredProduct (bắt buộc đối với Hình ảnh có thể nhấp vào để mua hàng), bạn cũng có thể chỉ định tiêu đề bộ sưu tập bằng trường headline (không bắt buộc). Bạn nên thêm tiêu đề để cung cấp cho khách hàng thông tin chi tiết bổ sung về bộ sưu tập.

Điểm chính: Trường headline cho bộ sưu tập chấp nhận một mảng các giá trị tiêu đề. Tuy nhiên, chỉ giá trị đầu tiên trong mảng được dùng cho định dạng Hình ảnh có thể nhấp vào để mua hàng.

Để tạo một bộ sưu tập mới cho Hình ảnh có thể nhấp vào để mua hàng, hãy đưa ra yêu cầu POST đến điểm cuối collections.insert bằng cách sử dụng URL và nội dung yêu cầu sau:

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"
}

Cảnh báo: Nếu có một tập hợp có cùng id, thì việc đưa ra yêu cầu đến collections.insert sẽ thay thế hoàn toàn tài nguyên.

Ví dụ: Kiểm tra trạng thái của một bộ sưu tập

Để biết bộ sưu tập bạn đã tạo ở trên có vấn đề gì khiến bộ sưu tập không thể phân phát quảng cáo hay không, hãy đưa ra yêu cầu GET đến điểm cuối collectionsstatuses.get bằng URL sau và thêm id của bộ sưu tập mà bạn muốn truy xuất trạng thái. Bạn không bắt buộc phải cung cấp nội dung yêu cầu.

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

Ví dụ về phản hồi trạng thái thu thập

{
  "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"
    }
  ]
}