Koleksi produk

Koleksi produk memungkinkan Anda menentukan kelompok produk yang akan digunakan dengan format lengkap, seperti Gambar Langsung-Belanja. Setiap 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 cara memeriksa status koleksi.

Catatan: Gambar Langsung-Belanja saat ini adalah satu-satunya format iklan yang mendukung koleksi. Namun, format tambahan dapat ditambahkan sehingga Anda dapat menggunakan kembali koleksi dalam berbagai format iklan yang berbeda.

Menggunakan koleksi produk

Content API menyertakan dua layanan untuk mengelola koleksi produk:

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

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

Contoh: Membuat koleksi untuk Gambar Langsung-Belanja

Gambar Langsung-Belanja adalah gambar berkualitas tinggi yang menampilkan 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 mengetahui informasi selengkapnya tentang kolom 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. Sebaiknya gunakan gambar persegi (dengan rasio lebar tinggi 1:1).

Poin Penting: Kolom imageLink untuk koleksi menerima array nilai link gambar. Namun, hanya nilai pertama dalam array yang digunakan untuk format Gambar Langsung-Belanja.

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 yang digunakan dengan Gambar Langsung-Belanja. Nilai x dan y harus antara 0 dan 1, inklusif.

Setiap koleksi dapat berisi maksimal 100 produk. Namun, untuk Gambar Langsung-Belanja, sebaiknya Anda menentukan koordinat tidak lebih dari 10 produk per gambar guna memastikan ada cukup ruang pada gambar untuk menampilkan info produk. Kolom offerId yang merupakan bagian dari objek featuredProduct harus cocok dengan nilai offerId pada resource products, yang berbeda dengan nilai id pada resource products.

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

Poin Penting: Kolom headline untuk koleksi menerima array nilai judul. Namun, hanya nilai pertama dalam array yang digunakan untuk format Gambar Langsung-Belanja.

Untuk membuat koleksi baru untuk 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"
}

Peringatan: Jika koleksi ada dengan id yang sama, permintaan ke collections.insert akan menggantikan resource sepenuhnya.

Contoh: Memeriksa status koleksi

Untuk mengetahui apakah koleksi yang Anda buat di atas memiliki masalah yang akan membatalkan validasi koleksi sehingga tidak menayangkan iklan, buat permintaan GET ke endpoint collectionsstatuses.get menggunakan URL berikut, dan sertakan 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 koleksi

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