Retail diganti namanya menjadi Vertex AI Search untuk retail. Kami sedang dalam proses memperbarui konten untuk mencerminkan branding baru ini.

Tentang katalog dan produk

Halaman ini memberikan praktik terbaik untuk membuat informasi katalog dan mengisi data katalog Anda.

Ringkasan

Data katalog yang Anda impor ke Vertex AI Search untuk retail memiliki dampak langsung terhadap kualitas model yang dihasilkan, serta terhadap kualitas hasil penelusuran dan rekomendasi. Secara umum, makin akurat dan spesifik informasi katalog yang dapat Anda berikan, makin tinggi kualitas model Anda.

Katalog Anda harus terus diperbarui. Anda dapat mengupload perubahan katalog sesering yang diperlukan; idealnya, setiap hari untuk katalog dengan tingkat perubahan yang tinggi. Anda dapat mengupload (patch) item produk yang sudah ada; hanya kolom yang diubah yang akan diperbarui. Mengupload informasi katalog tidak dikenai biaya. Untuk informasi selengkapnya, lihat Memastikan katalog Anda selalu yang terbaru.

Cabang katalog

Jika menggunakan penelusuran, Anda dapat menggunakan cabang katalog untuk menguji data baru yang telah diupload secara offline sebelum ditayangkan di situs Anda.

Anda dapat menggunakan hingga tiga cabang, yang diidentifikasi sebagai 0, 1, dan 2. Situs live Anda mengarah ke default_branch untuk data katalognya. Tentukan cabang yang saat ini merupakan default_branch live Anda (disetel ke cabang 0 secara default) menggunakan setDefaultBranch atau tab Data di konsol Search for Retail. Situs Anda kemudian menggunakan data katalog yang disediakan oleh cabang yang ditunjuk default_branch.

Misalnya, default_branch saat ini ditetapkan ke ID cabang 0, sehingga situs Anda menggunakan data katalog yang telah Anda upload ke cabang tersebut. Anda dapat mengupload data katalog baru ke cabang 1 dan melihat pratinjaunya. Setelah mengonfirmasi bahwa katalog telah diupload dengan benar, Anda dapat beralih ke cabang 1 sebagai default_branch live.

Cache katalog dapat memerlukan waktu hingga 30 menit untuk diperbarui setelah cabang beralih.

Jika Anda menggunakan rekomendasi, sebaiknya hanya gunakan cabang default karena penundaan update selama peralihan cabang. Jika perbedaan data antar-cabang besar, penundaan update dapat berdampak negatif terhadap hasil prediksi.

Produk

Katalog adalah kumpulan objek produk.

Informasi produk yang diperlukan

Kolom berikut wajib diisi; Anda harus memberikan nilai untuknya saat membuat item produk dalam katalog. Nilai ini juga harus sesuai dengan nilai yang digunakan dalam database produk internal Anda, dan harus secara akurat mencerminkan produk yang direpresentasikan, karena disertakan dalam pelatihan model Anda.

Dalam beberapa kasus, kolom lain juga diperlukan. Lihat daftar lengkap semua kolom produk di halaman referensi Product.

Semua informasi produk yang Anda berikan dapat digunakan untuk meningkatkan kualitas rekomendasi dan hasil penelusuran. Pastikan untuk memberikan kolom sebanyak mungkin.

Kolom	Notes
`name`	Nama resource lengkap dan unik produk. Wajib untuk semua metode `Product` kecuali untuk `import`. Selama impor, nama akan otomatis dibuat dan tidak perlu diberikan secara manual.
`id`	ID produk yang digunakan oleh database produk Anda. Kolom ID harus unik di seluruh katalog Anda. Nilai yang sama digunakan saat Anda merekam peristiwa pengguna, dan juga ditampilkan oleh metode `predict` dan `search`.
`title`	Judul produk dari database produk Anda. String berenkode UTF-8. Dibatasi hingga 1.250 karakter.
`categories`	Kategori produk. Setiap produk harus ditetapkan ke setidaknya satu kategori. Jika produk termasuk dalam lebih dari satu kategori, ulangi kolom untuk setiap kategori. Nilai ini harus berupa string berenkode UTF-8 yang tidak kosong dengan batas panjang 5.000 karakter. Selalu tentukan jalur kategori lengkap, misalnya: `["Sports & Fitness > Athletic Clothing > Shoes"]`.

Atribut produk

Berikan nilai untuk atribut sistem yang telah ditentukan sebelumnya di Product seperti merek, warna, dan ukuran sangat dianjurkan. Anda juga dapat menyertakan atribut khusus yang Anda tentukan dengan Product.attributes.

Jika Anda menggunakan penelusuran, atribut akan disertakan dengan produk dalam respons penelusuran jika Anda menandainya sebagai dapat diambil di Product.retrievableFields. Mereka kemudian dapat digunakan untuk fitur pencarian lainnya seperti penyaringan dan {i>facet.<i}

Untuk mengetahui informasi selengkapnya, lihat artikel Tentang atribut produk.

Tingkat produk

Tingkat produk menentukan hierarki dalam katalog Anda. Biasanya, Anda perlu memilih antara katalog satu tingkat atau katalog dua tingkat.

Misalnya, Anda dapat memiliki katalog satu tingkat dengan setiap item produk memiliki SKU. Atau, Anda dapat memilih katalog dua tingkat yang berisi grup SKU dan masing-masing SKU.

Jenis tingkat produk

Ada tiga jenis tingkat produk:

Item utama ditampilkan di rekomendasi atau hasil penelusuran. Prioritas dapat berupa item individual (tingkat SKU) dan kelompok item serupa (grup SKU).
Item Variant adalah versi produk utama grup SKU. Varian hanya dapat berupa item individual (tingkat SKU). Misalnya, jika produk utamanya adalah "Kemeja V-neck", variannya dapat berupa "Kemeja V-neck cokelat, ukuran XL" dan "Kemeja V-neck putih, ukuran S". Utama dan varian terkadang dijelaskan sebagai item parent dan parent.
Item koleksi adalah koleksi produk. Koleksi adalah paket produk utama atau produk varian. Misalnya, koleksi bisa berupa set perhiasan dengan kalung, anting, dan cincin. Koleksi hanya tersedia di penelusuran dan tidak digunakan secara luas.

Tentang hierarki katalog

Saat merencanakan hierarki katalog, Anda perlu memutuskan apakah katalog Anda hanya boleh berisi warna primer atau primer dan varian. Poin utama yang perlu diingat adalah prediksi dan hasil penelusuran hanya menampilkan item utama.

Misalnya, katalog khusus utama mungkin berfungsi dengan baik untuk menjual buku, dengan panel rekomendasi yang menampilkan pilihan buku, masing-masing dengan SKU-nya sendiri. Namun, katalog khusus utama untuk kaus kemungkinan akan menampilkan kaus yang sama dalam setiap ukuran yang tersedia di panel rekomendasi.

Katalog kaus primer akan lebih baik jika memiliki varian primer dan varian, dengan SKU sebagai varian (satu varian untuk setiap ukuran) dan varian primer mewakili grup SKU untuk ukuran setiap gaya kaus. Katalog dua tingkat ini memungkinkan panel rekomendasi menampilkan berbagai gaya kaus yang serupa. Pembeli dapat melihat perincian utama (gaya) tertentu untuk memilih varian (ukuran) yang akan dibeli.

Ada juga jenis katalog khusus varian, yang sekarang tidak digunakan lagi. Jenis katalog ini hanya dapat digunakan dengan rekomendasi. Untuk katalog khusus varian, ingestionProductType ditetapkan ke variant selama impor. Atribut primer disimpulkan untuk setiap varian, berdasarkan ID produk utama yang ditentukan untuk setiap varian.

Produk utama minimal

Jika Anda menentukan bahwa katalog Anda harus memiliki primer dan varian, yaitu grup SKU dan SKU, tetapi saat ini Anda hanya memiliki SKU, Anda perlu membuat prioritas untuk grup SKU. Hasil primer ini terkadang disebut "awalan virtual" atau "awalan palsu".

Hasil primer ini hanya perlu berisi sedikit informasi: id, title, dan categories.

Jika type tidak ditentukan, tipe produk akan ditetapkan secara default ke utama. Jika sedang mengimpor, Anda tidak perlu menentukan name. Untuk informasi selengkapnya, lihat bagian sebelumnya, Informasi produk yang diperlukan.

Jenis tidak dapat diubah

Anda tidak dapat mengubah jenis produk, misalnya, dari varian ke primer atau dari primer ke varian.

Jika Anda perlu mengubah jenis produk, hapus produk tersebut dan buat ulang produk dengan jenis yang berbeda. Sebelum Anda dapat menghapus produk utama, varian terkait harus dihapus.

Impor katalog

Jika saat ini Anda memiliki katalog di Merchant Center, sebaiknya impor katalog dengan menautkan akun Merchant Center Anda.

Jika katalog Anda tidak ada di Merchant Center, tetapi ada di Cloud Storage atau BigQuery atau penyimpanan lain, lakukan impor data massal.

Jika Anda berencana mengimpor data katalog dari Merchant Center di masa mendatang, tinjau data seperti yang dijelaskan untuk impor Merchant Center guna memastikan Anda membuat pilihan yang benar terkait katalog. Hal ini penting karena mengubah konfigurasi katalog yang ada memerlukan penghapusan katalog dan upload lagi (lihat Mengubah konfigurasi tingkat produk).

Untuk mengetahui informasi selengkapnya tentang cara mengupload katalog, lihat Mengimpor informasi katalog.

Inventaris produk

Inventaris produk meliputi:

Harga, harga saat ini dan harga asli
Ketersediaan, seperti tersedia, stok habis, dipesan kembali, dan dipraorder
Jumlah tersedia
Informasi pemenuhan pesanan seperti pengambilan di toko, pengiriman ke toko, dan pengiriman hari berikutnya

Ada dua tingkat inventaris: tingkat produk dan lokal.

Inventaris tingkat produk

Untuk retailer yang hanya menjual secara online, inventaris ditentukan di tingkat produk. Data harga, ketersediaan, dan inventaris lainnya ditetapkan untuk setiap produk di katalog.

Untuk mengetahui informasi selengkapnya tentang inventaris tingkat produk, termasuk cara mengelola data inventaris, lihat Memperbarui inventaris untuk Vertex AI Search untuk retail.

Inventaris lokal

Retailer yang memiliki toko fisik dan toko online harus menyimpan informasi inventaris per toko. Mereka menggunakan inventaris lokal untuk melakukannya.

Ada dua kolom produk yang dapat digunakan untuk menyimpan inventaris lokal. Kedua kolom tersebut adalah daftar lokasi (ID tempat) dengan informasi inventaris terkait:

Product.fulfillmentInfo. Metode pengambilan dan pengiriman di setiap lokasi toko
Product.localInventories. Informasi harga, atribut produk, serta metode pengambilan dan pengiriman di setiap lokasi toko

Anda dapat menggunakan salah satu atau kedua kolom untuk informasi tingkat toko.

Untuk mengetahui informasi selengkapnya tentang inventaris lokal, lihat Memperbarui inventaris lokal untuk Vertex AI Search untuk retail.

Metrik kualitas data katalog

Halaman Kualitas data di Search for Retail Console menilai apakah Anda perlu memperbarui data katalog untuk meningkatkan kualitas hasil penelusuran dan membuka tingkat performa penelusuran.

Tabel berikut menjelaskan metrik kualitas yang digunakan Vertex AI Search untuk retail guna membantu Anda mengevaluasi data produk. Untuk mengetahui detail tentang cara melihat metrik kualitas data dan tingkat performa penelusuran di Search for Retail Console, lihat Membuka tingkat performa penelusuran.

Metrik kualitas katalog	Aturan kualitas	Notes
URI ada dan dapat diakses	Produk memiliki `Product.uri` yang valid. URI harus dapat diakses dan cocok dengan domain Anda.	Penelusuran menggunakan sinyal web yang di-crawl melalui URI ini untuk meningkatkan kualitas penelusuran.
Memenuhi kesesuaian waktu	`Product.availableTime` adalah sebelum waktu saat ini, dan `Product.expireTime` adalah setelah waktu saat ini.	Hanya produk yang memenuhi kesesuaian waktu yang tersedia untuk penelusuran.
Terdapat atribut yang dapat ditelusuri	Produk memiliki setidaknya satu `attribute` yang ditetapkan ke dapat ditelusuri.	Atribut khusus yang ditandai sebagai dapat ditelusuri dapat ditelusuri oleh kueri teks.
Deskripsi ada	Produk memiliki `Product.description` yang tidak kosong.	Deskripsi yang komprehensif membantu meningkatkan kualitas penelusuran.
Judul terdiri dari setidaknya dua kata	`Product.title` terdiri dari setidaknya dua kata.	Judul yang komprehensif membantu meningkatkan kualitas penelusuran.
Memiliki varian dengan gambar	Produk `variant` memiliki setidaknya satu `Product.image`. Anda dapat mengabaikan metrik ini jika semua produk Anda berada di level `primary`.	Metrik ini untuk tujuan informasi dan tidak memengaruhi kualitas penelusuran.
Memiliki varian dengan info harga	Produk `variant` telah menetapkan `Product.priceInfo`. Anda dapat mengabaikan metrik ini jika semua produk Anda berada di level `primary`.	Metrik ini untuk tujuan informasi dan tidak memengaruhi kualitas penelusuran.

Skema produk untuk Vertex AI Search untuk retail

Saat mengimpor katalog dari BigQuery, gunakan Vertex AI Search untuk skema produk retail di bawah ini guna membuat tabel BigQuery dengan format yang benar dan memuatnya dengan data katalog Anda. Kemudian, impor katalog.

Vertex AI Search untuk skema produk retail

BigQuery

[
  {
    "name": "name",
    "type": "STRING",
    "mode": "NULLABLE"
  },
  {
    "name": "id",
    "type": "STRING",
    "mode": "REQUIRED"
  },
  {
    "name": "type",
    "type": "STRING",
    "mode": "NULLABLE"
  },
  {
    "name": "primaryProductId",
    "type": "STRING",
    "mode": "NULLABLE"
  },
  {
    "name": "collectionMemberIds",
    "type": "STRING",
    "mode": "REPEATED"
  },
  {
    "name": "gtin",
    "type": "STRING",
    "mode": "NULLABLE"
  },
  {
    "name": "categories",
    "type": "STRING",
    "mode": "REPEATED"
  },
  {
    "name": "title",
    "type": "STRING",
    "mode": "REQUIRED"
  },
  {
    "name": "brands",
    "type": "STRING",
    "mode": "REPEATED"
  },
  {
    "name": "description",
    "type": "STRING",
    "mode": "NULLABLE"
  },
  {
    "name": "languageCode",
    "type": "STRING",
    "mode": "NULLABLE"
  },
  {
    "name": "attributes",
    "type": "RECORD",
    "mode": "REPEATED",
    "fields": [
      {
        "name": "key",
        "type": "STRING",
        "mode": "NULLABLE"
      },
      {
        "name": "value",
        "type": "RECORD",
        "mode": "NULLABLE",
        "fields": [
          {
            "name": "text",
            "type": "STRING",
            "mode": "REPEATED"
          },
          {
            "name": "numbers",
            "type": "FLOAT",
            "mode": "REPEATED"
          }
        ]
      }
    ]
  },
  {
    "name": "tags",
    "type": "STRING",
    "mode": "REPEATED"
  },
  {
    "name": "priceInfo",
    "type": "RECORD",
    "mode": "NULLABLE",
    "fields": [
      {
        "name": "currencyCode",
        "type": "STRING",
        "mode": "NULLABLE"
      },
      {
        "name": "price",
        "type": "FLOAT",
        "mode": "NULLABLE"
      },
      {
        "name": "originalPrice",
        "type": "FLOAT",
        "mode": "NULLABLE"
      },
      {
        "name": "cost",
        "type": "FLOAT",
        "mode": "NULLABLE"
      },
      {
        "name": "priceEffectiveTime",
        "type": "STRING",
        "mode": "NULLABLE"
      },
      {
        "name": "priceExpireTime",
        "type": "STRING",
        "mode": "NULLABLE"
      }
    ]
  },
  {
    "name": "rating",
    "type": "RECORD",
    "mode": "NULLABLE",
    "fields": [
      {
        "name": "ratingCount",
        "type": "INTEGER",
        "mode": "NULLABLE"
      },
      {
        "name": "averageRating",
        "type": "FLOAT",
        "mode": "NULLABLE"
      },
      {
        "name": "ratingHistogram",
        "type": "INTEGER",
        "mode": "REPEATED"
      }
    ]
  },
  {
    "name": "expireTime",
    "type": "STRING",
    "mode": "NULLABLE"
  },
  {
    "name": "ttl",
    "type": "RECORD",
    "mode": "NULLABLE",
    "fields": [
      {
        "name": "seconds",
        "type": "INTEGER",
        "mode": "NULLABLE"
      },
      {
        "name": "nanos",
        "type": "INTEGER",
        "mode": "NULLABLE"
      }
    ]
  },
  {
    "name": "availableTime",
    "type": "STRING",
    "mode": "NULLABLE"
  },
  {
    "name": "availability",
    "type": "STRING",
    "mode": "NULLABLE"
  },
  {
    "name": "availableQuantity",
    "type": "INTEGER",
    "mode": "NULLABLE"
  },
  {
    "name": "fulfillmentInfo",
    "type": "RECORD",
    "mode": "REPEATED",
    "fields": [
      {
        "name": "type",
        "type": "STRING",
        "mode": "NULLABLE"
      },
      {
        "name": "placeIds",
        "type": "STRING",
        "mode": "REPEATED"
      }
    ]
  },
  {
    "name": "uri",
    "type": "STRING",
    "mode": "NULLABLE"
  },
  {
    "name": "images",
    "type": "RECORD",
    "mode": "REPEATED",
    "fields": [
      {
        "name": "uri",
        "type": "STRING",
        "mode": "REQUIRED"
      },
      {
        "name": "height",
        "type": "INTEGER",
        "mode": "NULLABLE"
      },
      {
        "name": "width",
        "type": "INTEGER",
        "mode": "NULLABLE"
      }
    ]
  },
  {
    "name": "audience",
    "type": "RECORD",
    "mode": "NULLABLE",
    "fields": [
      {
        "name": "genders",
        "type": "STRING",
        "mode": "REPEATED"
      },
      {
        "name": "ageGroups",
        "type": "STRING",
        "mode": "REPEATED"
      }
    ]
  },
  {
    "name": "colorInfo",
    "type": "RECORD",
    "mode": "NULLABLE",
    "fields": [
      {
        "name": "colorFamilies",
        "type": "STRING",
        "mode": "REPEATED"
      },
      {
        "name": "colors",
        "type": "STRING",
        "mode": "REPEATED"
      }
    ]
  },
  {
    "name": "sizes",
    "type": "STRING",
    "mode": "REPEATED"
  },
  {
    "name": "materials",
    "type": "STRING",
    "mode": "REPEATED"
  },
  {
    "name": "patterns",
    "type": "STRING",
    "mode": "REPEATED"
  },
  {
    "name": "conditions",
    "type": "STRING",
    "mode": "REPEATED"
  },
  {
    "name": "retrievableFields",
    "type": "STRING",
    "mode": "NULLABLE"
  },
  {
    "name": "publishTime",
    "type": "STRING",
    "mode": "NULLABLE"
  },
  {
    "name": "promotions",
    "type": "RECORD",
    "mode": "REPEATED",
    "fields": [
      {
        "name": "promotionId",
        "type": "STRING",
        "mode": "NULLABLE"
      }
    ]
  }
]