Koleksi produk

Koleksi produk memungkinkan Anda menentukan kelompok produk yang akan digunakan dengan format lengkap, seperti Gambar Langsung-Belanja. Masing-masing koleksi dapat berisi hingga 100 produk. Anda dapat membuat koleksi dengan Google Merchant Center atau Content API.

Panduan ini menunjukkan cara menggunakan koleksi produk melalui Content API, termasuk contoh cara membuat koleksi untuk Gambar Langsung-Belanja dan caranya untuk memeriksa status pengumpulan gambar.

Menggunakan koleksi produk

Content API mencakup dua layanan untuk mengelola koleksi produk:

  • collections: Memungkinkan Anda mendapatkan, mencantumkan, menyisipkan, dan menghapus koleksi produk.

  • collectionstatuses: Memungkinkan Anda mendapatkan dan mencantumkan status koleksi ke mengetahui apakah koleksi memiliki masalah yang dapat menyebabkan koleksi tidak valid untuk tujuan, seperti Iklan Shopping.

Contoh: Membuat koleksi untuk Gambar Langsung-Belanja

Gambar Langsung-Belanja tinggi- gambar berkualitas yang menunjukkan satu atau beberapa produk yang dianotasi, dan dikonfigurasi menggunakan koleksi. Untuk menggunakan Gambar Langsung-Belanja, Anda harus menentukan nilai untuk Kolom imageLink dan featuredProduct, selain kolom yang wajib diisi untuk semua koleksi. Untuk informasi selengkapnya tentang kolom yang wajib diisi, lihat Dokumentasi referensi Content API.

Untuk menggunakan Gambar Langsung-Belanja, Anda harus membuat koleksi produk dan menggunakan Kolom imageLink untuk menentukan gambar yang berisi hingga sepuluh produk. Rab sebaiknya gunakan gambar persegi (dengan rasio aspek 1:1).

Anda juga harus menentukan produk yang ditampilkan dalam gambar menggunakan Kolom featuredProduct, termasuk koordinat produk dalam gambar menggunakan kolom x dan y. Kolom ini hanya diperlukan untuk koleksi digunakan dengan Gambar Langsung-Belanja. Nilai x dan y harus antara 0 dan 1, inklusif.

Setiap koleksi dapat berisi maksimum 100 produk. Namun, untuk Gambar Langsung-Belanja, sebaiknya tentukan koordinat tidak lebih dari 10 produk per gambar untuk memastikan ada cukup ruang pada gambar untuk menampilkan info produk. Tujuan offerId kolom yang merupakan bagian dari objek featuredProduct harus cocok dengan offerId pada resource products, yang berbeda dari resource Nilai id pada resource products.

Selain kolom imageLink dan featuredProduct, yang wajib diisi untuk Gambar Langsung-Belanja, Anda juga dapat menentukan judul koleksi menggunakan kolom headline opsional. Sebaiknya sertakan judul untuk memberikan pelanggan dengan detail tambahan tentang koleksi.

Untuk membuat koleksi baru bagi Gambar Langsung-Belanja, buat permintaan POST ke Endpoint collections.insert menggunakan URL dan isi permintaan berikut:

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

Contoh: Memeriksa status koleksi

Untuk mengetahui apakah koleksi yang Anda buat di atas memiliki masalah yang akan batalkan pengumpulan agar tidak menayangkan iklan, buat permintaan GET ke Endpoint collectionsstatuses.get menggunakan URL berikut, dan menyertakan id koleksi yang statusnya ingin Anda ambil. Anda tidak perlu memberikan isi permintaan.

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

Contoh respons status pengumpulan

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