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

Halaman ini diterjemahkan oleh Cloud Translation API.

Tentang katalog dan produk

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

Ringkasan

Data katalog yang Anda impor ke Vertex AI Search untuk retail memiliki efek langsung pada kualitas model yang dihasilkan, sehingga memengaruhi kualitas hasil penelusuran dan rekomendasi. Secara umum, semakin akurat dan spesifik informasi katalog yang dapat Anda berikan, semakin 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 (mem-patch) item produk yang ada; hanya kolom yang diubah yang akan diperbarui. Tidak ada biaya untuk mengupload informasi katalog. Untuk informasi selengkapnya, lihat Memastikan katalog Anda selalu 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 aktif Anda mengarah ke default_branch untuk data katalognya. Tentukan cabang mana yang merupakan default_branch live Anda (default ditetapkan ke cabang 0) menggunakan setDefaultBranch atau tab Data di konsol Penelusuran untuk Retail. Kemudian, situs Anda akan menggunakan data katalog yang disediakan oleh cabang yang ditunjuk default_branch.

Misalnya, default_branch 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 aktif.

Perlu waktu hingga 30 menit untuk memperbarui cache katalog setelah peralihan cabang.

Jika Anda menggunakan rekomendasi, sebaiknya gunakan hanya cabang default karena penundaan update selama pengalihan cabang. Jika perbedaan data antara cabang besar, penundaan update dapat berdampak negatif pada hasil prediksi.

Produk

Katalog adalah kumpulan objek produk.

Informasi produk yang diperlukan

Kolom berikut wajib diisi; Anda harus memberikan nilai untuk kolom tersebut saat membuat item produk di katalog. Nilai ini juga harus sesuai dengan nilai yang digunakan dalam database produk internal Anda, dan harus mencerminkan secara akurat produk yang diwakili, karena nilai ini 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 sebanyak mungkin kolom.

Kolom	Catatan
`name`	Nama resource lengkap dan unik dari produk. Wajib untuk semua metode `Product` kecuali `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 yang dienkode UTF-8. Dibatasi hingga 1.250 karakter.
`categories`	Kategori produk. Setiap produk harus ditetapkan ke minimal satu kategori. Jika produk termasuk dalam lebih dari satu kategori, ulangi kolom untuk setiap kategori. Nilai 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

Sebaiknya berikan nilai untuk atribut sistem yang telah ditentukan sebelumnya di Product seperti merek, warna, dan ukuran. Anda juga dapat menyertakan atribut kustom yang ditentukan dengan Product.attributes.

Kolom yang dapat diambil

Jika Anda menggunakan penelusuran, atribut akan disertakan dengan produk dalam respons penelusuran jika Anda menandainya sebagai dapat diambil di Product.retrievableFields. Kemudian, kolom tersebut dapat digunakan untuk fitur penelusuran lainnya seperti pemfilteran dan facet.

Opsi yang dapat ditelusuri persis

Anda dapat memberikan nilai tertentu untuk kueri string tertentu ke opsi yang dapat ditelusuri persis, yaitu kolom atribut katalog. Jika kueri cocok dengan produk apa pun di katalog Anda dengan nilai untuk kolom tersebut adalah string yang diberikan dalam kueri, kueri akan menampilkan produk tersebut persis dalam kueri penelusuran. Opsi ini berfungsi dengan baik untuk nomor seri, tempat pelanggan mengharapkan pengalaman penelusuran yang ditargetkan.

Kolom yang berguna untuk atribut produk dengan nilai yang tepat (seperti ModelId atau ManufacturerId), kolom ExactSearchableOption biasanya digunakan untuk atribut kustom. Atribut seperti product_id adalah kolom indeks utama — dapat ditelusuri secara persis secara default. Kolom item_id selalu aktif untuk pencocokan persis dan tidak dapat dinonaktifkan.

Untuk menghindari item yang tidak terkait ditampilkan dalam penelusuran, jangan pernah menetapkan opsi yang dapat ditelusuri ke nilai umum seperti battery.
Untuk menghindari kueri penelusuran yang tidak ditayangkan, jangan tetapkan kolom khusus seperti tag — yang dapat memiliki salah satu nilai stringnya "iphone" — ke penelusuran persis. Tindakan tersebut dapat menyebabkan kueri tersebut membatasi hasil untuk semua iPhone di katalog produk.

Untuk mengetahui informasi selengkapnya, lihat Tentang atribut produk.

Tingkat produk

Penunjukan SKU produk menentukan hierarki dalam katalog Anda.

Jenis penetapan produk

Ada tiga jenis penetapan produk:

Item Utama ditampilkan di rekomendasi atau hasil penelusuran. Primer dapat berupa item individual (tingkat SKU) dan grup item serupa (grup SKU).
Item Varian adalah versi produk utama grup SKU. Varian hanya dapat berupa item individual (tingkat SKU). Misalnya, jika produk utama adalah "Kemeja V-neck", variannya dapat berupa "Kemeja V-neck cokelat, ukuran XL" dan "Kemeja V-neck putih, ukuran S". Primer dan varian terkadang dideskripsikan sebagai item induk dan turunan.
Item Koleksi adalah paket produk utama atau produk varian, seperti set perhiasan dengan kalung, anting, dan cincin. Struktur hierarkis yang mirip dengan produk dan varian, koleksi mengelompokkan produk utama terkait. Pelanggan tidak dapat membelinya secara langsung, tidak banyak digunakan, dan hanya tersedia di penelusuran.

Contoh produk

Misalnya, menurut jenis penetapan produk ini, item bahan makanan lebih baik dikatalogkan sebagai produk utama, yang masing-masing terdiri dari satu produk SKU, seperti"bananas, fresh".

Di sisi lain, kaus akan lebih baik disusun secara hierarkis, sebagai item utama dengan kumpulan varian yang sesuai. Setiap varian mewakili setiap SKU (untuk setiap ukuran) dan setiap item utama mewakili grup SKU, dengan setiap SKU memiliki ukuran yang berbeda untuk satu gaya kaos oblong menyeluruh. Pengelompokan berdasarkan struktur SKU ini memungkinkan hasil penelusuran dan panel rekomendasi menampilkan berbagai gaya kaos. Hal ini memungkinkan pembeli melihat perincian utama (gaya) tertentu untuk memilih varian (ukuran) yang akan dibeli.

Koleksi mengelompokkan produk terkait yang mungkin dibeli pelanggan. Untuk mewakilinya secara akurat dalam model pemeringkatan ulang, Vertex AI Search untuk retail memiliki logika yang memberi kredit pembelian. Misalnya: Pembeli mengklik produk dalam set seprai, lalu menambahkan ke keranjang atau membeli produk utama dalam koleksi tersebut. Koleksi dikreditkan dengan pembelian tersebut, dan model mewakili popularitas dan nilai koleksi secara akurat.

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. ID utama diinferensi untuk setiap varian, berdasarkan ID produk utama yang ditentukan untuk setiap varian.

Menyiapkan katalog produk

Saat merencanakan katalog produk, Anda harus memutuskan apakah katalog tersebut berisi produk yang ditetapkan sebagai produk utama saja, produk utama dan varian, atau campuran dari kedua pengaturan tersebut. Anggaplah hal ini dalam hal struktur SKU produk Anda. Produk Anda dapat berupa item utama, yang mungkin memiliki varian atau tidak.

Berdasarkan cara SKU produk Anda ditetapkan, pertimbangkan opsi untuk menyiapkan katalog produk:

Anda ingin SKU ditampilkan sebagai hasil penelusuran atau rekomendasi individual: SKU=primary
SKU Anda harus menjadi bagian dari grup SKU yang serupa: SKU=varian, grup SKU=utama
Gabungan dari kedua kombinasi tersebut: SKU=utama, SKU=varian, grup SKU=utama

Jika halaman detail produk Anda menampilkan pemilih opsi/ukuran/warna, opsi ini biasanya diupload sebagai varian ke katalog produk Anda. Pertimbangkan apakah Anda ingin jenis produk yang sama dengan atribut yang berbeda seperti ukuran dan warna muncul sebagai satu hasil penelusuran atau terpisah. Misalnya, untuk buku, Anda ingin memutuskan apakah ingin SKU edisi hardcover dan SKU edisi softcover dari buku yang sama muncul sebagai hasil penelusuran terpisah (SKU = utama), atau sebagai satu (SKU = varian, grup SKU = utama).

Saat menyiapkan katalog produk, perhatikan bahwa rekomendasi dan hasil penelusuran hanya menampilkan item utama.

Produk utama minimal

Jika Anda memutuskan bahwa katalog harus memiliki produk utama dan varian, yaitu grup SKU dan SKU, tetapi saat ini Anda hanya memiliki SKU, Anda harus membuat produk utama untuk grup SKU. Primary ini terkadang disebut "primary virtual" atau "primary palsu".

Primer ini hanya perlu berisi informasi minimal: id, title, dan categories.

Jika type tidak ditentukan, jenis produk akan ditetapkan secara default ke utama. Jika melakukan impor, 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 menjadi primer atau dari primer menjadi varian.

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

Impor katalog

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

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

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

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

Inventaris produk

Inventaris produk mencakup:

Harga, baik harga saat ini maupun harga asli
Ketersediaan, seperti tersedia, stok habis, inden, dan praorder
Jumlah yang tersedia
Informasi pemenuhan pesanan seperti ambil di toko, kirim ke toko, dan pengiriman pada 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. Harga, ketersediaan, dan data inventaris lainnya ditetapkan untuk setiap produk dalam katalog.

Untuk mengetahui informasi selengkapnya tentang inventaris tingkat produk, termasuk cara mempertahankan 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. Iklan Promo Toko 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 konsol Penelusuran untuk Retail 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 untuk membantu Anda mengevaluasi data produk. Untuk mengetahui detail tentang cara melihat metrik kualitas data dan tingkat performa penelusuran di konsol Search for Retail, lihat Memanfaatkan tingkat performa penelusuran.

Metrik kualitas katalog	Aturan kualitas	Catatan
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 menggunakan URI ini untuk meningkatkan kualitas penelusuran.
Memenuhi kepatuhan waktu	`Product.availableTime` adalah sebelum waktu saat ini, dan `Product.expireTime` adalah setelah waktu saat ini.	Hanya produk yang memenuhi kepatuhan waktu yang tersedia untuk penelusuran.
Atribut yang dapat ditelusuri ada	Produk memiliki minimal satu `attribute` yang ditetapkan untuk dapat ditelusuri.	Atribut kustom yang ditandai sebagai dapat ditelusuri dapat ditelusuri dengan kueri teks.
Deskripsi ada	Produk memiliki `Product.description` yang tidak kosong.	Deskripsi yang komprehensif membantu meningkatkan kualitas penelusuran.
Judul terdiri dari minimal dua kata	`Product.title` terdiri dari minimal dua kata.	Judul yang komprehensif membantu meningkatkan kualitas penelusuran.
Memiliki varian dengan gambar	Produk `variant` memiliki minimal satu `Product.image`. Anda dapat mengabaikan metrik ini jika semua produk Anda berada di tingkat `primary`.	Metrik ini ditujukan 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 tingkat `primary`.	Metrik ini ditujukan 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 berikut untuk skema produk retail guna membuat tabel BigQuery dengan format yang benar dan memuat data katalog Anda. Kemudian, impor katalog.

Skema produk Vertex AI Search untuk 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"
      }
    ]
  }
]