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 định dạng đa dạng thức, 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á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 và cách kiểm tra trạng thái của một bộ sưu tập.

Lưu ý: Hiện tại, Hình ảnh có thể nhấp vào để mua hàng là định dạng quảng cáo duy nhất hỗ trợ bộ sưu tập. Tuy nhiên, bạn có thể thêm các định dạng khác để 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 có hai dịch vụ để quản lý bộ sưu tập sản phẩm:

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

• collectionstatuses: Cho phép bạn lấy và liệt kê trạng thái của các bộ sưu tập để phát hiện 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 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 đối với mọi 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à dùng trường imageLink để chỉ định một bức ảnh có chứa tối đa 10 sản phẩm. Bạn nên sử dụng ảnh hình vuông (với tỷ lệ khung hình 1:1).

Lưu ý quan trọng: Trường imageLink cho các bộ sưu tập chấp nhận một mảng các giá trị liên kết 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ể 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 trường featuredProduct, bao gồm cả toạ độ của các sản phẩm trong hình ảnh bằng các trường x và y. Các trường này chỉ bắt buộc đối với các bộ sưu tập dù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.

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 nên chỉ định toạ độ không quá 10 sản phẩm cho mỗi hình ảnh để đảm bảo có đủ không gian trên hình ảnh nhằm hiển thị chú thích sản phẩm. Trường offerId thuộc đối tượng featuredProduct phải khớp với giá trị offerId trên tài nguyên products. Giá trị này khác với 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 dòng tiêu đề để cung cấp thêm thông tin chi tiết về bộ sưu tập cho khách hàng.

Lưu ý quan trọng: Trường headline cho bộ sưu tập chấp nhận một mảng giá trị dòng 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ể 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 gửi yêu cầu POST đến điểm cuối collections.insert bằng URL sau và nội dung yêu cầu:

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 một tập hợp tồn tại với cùng một id, việc yêu cầu collections.insert sẽ thay thế toàn bộ tài nguyên.

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

Để tìm hiểu xem bộ sưu tập bạn đã tạo ở trên có vấn đề khiến bộ sưu tập không thể phân phát quảng cáo hay không, hãy tạo 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 có trạng thái bạn muốn truy xuất. Bạn không 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 về 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"
    }
  ]
}