Koleksi produk

Koleksi produk memungkinkan Anda menentukan grup produk untuk digunakan dengan format multimedia, 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 yang Dapat Dibeli 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 ulang koleksi di berbagai format iklan.

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 tidak valid untuk 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 dianotasikan, dan dikonfigurasi menggunakan koleksi. Untuk menggunakan Gambar Langsung-Belanja, Anda harus menentukan nilai untuk kolom imageLink dan featuredProduct, selain kolom yang diperlukan 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 aspek 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 wajib diisi untuk koleksi yang 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 Anda menentukan koordinat untuk tidak lebih dari 10 produk per gambar untuk 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 diisi 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, membuat 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 agar tidak menayangkan iklan, buat permintaan GET ke endpoint collectionsstatuses.get menggunakan URL berikut, dan sertakan id koleksi yang statusnya ingin Anda ambil. Anda tidak harus 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"
    }
  ]
}