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

Bộ sưu tập sản phẩm giúp bạn xác định các nhóm sản phẩm để sử dụng với định dạng nhiều định dạng, chẳng hạn như Hình ảnh có thể nhấp vào để mua hàng. Một 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ác ví dụ về cách tạo bộ sưu tập cho Hình ảnh có thể nhấp vào để mua hàng cũng như cách tạo bộ sưu tập để kiểm tra trạng thái của một bộ sưu tập.

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

Content API bao gồm 2 dịch vụ giúp 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 tìm hiểu xem một bộ sưu tập có vấn đề nào có thể khiến bộ sưu tập đó không hợp lệ đối với một đích đến, chẳng hạn như Quảng cáo Mua sắm.

Ví dụ: Tạo 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 mang lại hình ảnh chất lượng cao, hiển thị một hoặc nhiều sản phẩm có chú thích và được định cấu hình bằng cách sử dụ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 thuộc tính Trường imageLink và featuredProduct, ngoài các trường bắt buộc cho tất cả cá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 chứa tối đa 10 sản phẩm. T4 bạn nên dùng hình ảnh vuông (có tỷ lệ khung hình là 1:1).

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 toạ độ của các sản phẩm trong ảnh bằng cách sử dụng các trường x và y. Những trường này chỉ là trường bắt buộc đối với bộ sưu tập dùng cùng với Hình ảnh có thể nhấp vào để mua hàng. Các giá trị x và y phải nằm trong khoảng từ 0 đến 1, dành cho tất cả mọi người.

Mỗi bộ sưu tập có thể bao gồm 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 không nên chỉ định toạ độ cho tối đa 10 hình ảnh sản phẩm cho mỗi hình ảnh để đảm bảo rằng có đủ không gian trên hình ảnh để hiển thị chú thích sản phẩm. Chiến lược phát hành đĩa đơn offerId là một phần của đối tượng featuredProduct phải khớp với trường offerId trên tài nguyên products, giá trị này khác với giá trị Giá trị id trên tài nguyên products.

Ngoài các trường imageLink và featuredProduct là 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 dòng tiêu đề của bộ sưu tập bằng cách sử dụng trường headline không bắt buộc. Bạn nên thêm một dòng tiêu đề để cung cấp khách hàng với thông tin bổ sung về bộ sưu tập.

Để 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 gửi yêu cầu POST tới điểm cuối collections.insert bằ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"
}

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

Để tìm hiểu xem bộ sưu tập bạn đã tạo ở trên có vấn đề nào vô hiệu hoá việc thu thập dữ liệu khỏi hoạt động phân phát quảng cáo, hãy gửi yêu cầu GET cho điểm cuối collectionsstatuses.get bằng URL sau, đồng thời thêm id của bộ sưu tập có trạng thái bạn muốn truy xuất. Bạn không cần 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 cho trạng thái của bộ sưu tậ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"
    }
  ]
}