Tentang atribut produk

Vertex AI Search untuk commerce dapat menggunakan atribut produk untuk pengindeksan, pengelompokan dinamis, kemampuan penelusuran, pemfilteran, dan kualitas model. Halaman ini membahas cara menyetel konfigurasi atribut produk dan cara penanganannya bergantung pada metode dan konfigurasi yang Anda gunakan.

Jenis atribut

Atribut produk dapat memiliki setelan default dan opsi yang diizinkan yang berbeda-beda, bergantung pada jenisnya.

  • Atribut sistem: Atribut sistem yang telah ditentukan adalah kolom Product yang ada dan memberikan informasi lebih lanjut tentang produk. Atribut ini mencakup atribut produk seperti merek, ketersediaan, warna, dan ukuran. Untuk semua atribut sistem yang tersedia untuk produk, lihat dokumentasi referensi Product.

  • Atribut khusus: Atribut khusus adalah atribut tambahan yang Anda tentukan menggunakan kolom Product.attributes. Misalnya, hal ini dapat mencakup nama toko, vendor, atau gaya. Untuk contoh dan batas atribut kustom, lihat dokumentasi referensi Product.attributes.

    Beberapa contoh 20 atribut kustom teratas adalah:

    • Lini produk asal produk ini
    • Volume penjualan di toko untuk produk ini
    • Acara untuk pakaian
    • Promo dan kupon yang berlaku untuk produk ini
    • Popularitas produk di seluruh situs

  • Atribut tingkat inventaris: Atribut sistem atau kustom yang memberikan informasi tingkat toko tentang produk. Anda dapat menggunakan atribut tingkat inventaris untuk produk yang propertinya sangat bervariasi di antara toko dan wilayah, seperti item grosir, atau untuk produk yang memiliki promosi khusus toko.

    inventories.price dan inventories.originalPrice adalah atribut sistem numerik yang telah ditentukan sebelumnya oleh Vertex AI Search untuk commerce. Anda dapat membuat atribut tingkat inventaris kustom, yang dapat berupa tekstual atau numerik. Atribut tingkat inventaris dapat diindeks secara default. Setelan aspek dinamis dan dapat ditelusuri tidak didukung untuk atribut tingkat inventaris.

Setelan konfigurasi yang tersedia

Setelan konfigurasi atribut memengaruhi perilaku penelusuran dan rekomendasi di seluruh situs Anda.

Penelusuran menggunakan setelan atribut berikut:

  • Dapat diindeks: Penelusuran dapat memfilter dan mengelompokkan menggunakan atribut ini.
  • Penetapan aspek dinamis: Penelusuran dapat otomatis menggunakan atribut ini sebagai aspek dinamis berdasarkan perilaku pengguna sebelumnya seperti klik dan tampilan aspek. Untuk mengaktifkan penyeleksian dinamis untuk suatu atribut, Dapat diindeks harus disetel ke benar (true) untuk atribut tersebut.
  • Dapat ditelusuri: Atribut ini dapat ditelusuri dengan kueri penelusuran, yang meningkatkan perolehan untuk atribut tersebut. Kontrol ini hanya berlaku untuk atribut teks.
  • Dapat Diambil: Jika disetel ke benar (true), penelusuran akan menampilkan atribut ini dalam respons terhadap kueri penelusuran. Jika semua atribut memiliki Dapat diambil ditetapkan ke salah (false), hasil penelusuran hanya berisi nama produk atau (untuk varian) nama produk dan informasi warna. Kolom REST RetrievableFields tidak digunakan lagi untuk produk. Sebagai gantinya, gunakan kontrol di seluruh situs yang dapat diambil.

Rekomendasi menggunakan setelan atribut berikut:

  • Dapat Difilter (Pratinjau Publik): Atribut ini dapat digunakan dalam ekspresi filter rekomendasi. Kontrol ini hanya berlaku untuk atribut teks.

Indexable

Jika atribut disetel agar dapat diindeks, penelusuran dapat memfilter dan membuat facet menggunakan atribut tersebut.

  • Atribut sistem: Pengindeksan selalu diaktifkan untuk atribut sistem yang telah ditentukan sebelumnya. Setelan ini tidak dapat dinonaktifkan untuk atribut sistem.
  • Atribut kustom: Diaktifkan secara default. Anda dapat menonaktifkan pengindeksan untuk atribut kustom apa pun. Jika Anda berencana membuat atribut kustom dapat diindeks, atribut tersebut harus mengikuti pola ekspresi reguler [a-zA-Z0-9][a-zA-Z0-9_]*. Misalnya, key0LikeThis atau KEY_1_LIKE_THIS.
  • Atribut tingkat inventaris: Selalu diaktifkan untuk atribut tingkat inventaris sistem; setelan ini tidak dapat diubah. Diaktifkan secara default untuk atribut tingkat inventaris kustom; setelan ini dapat dinonaktifkan.
  • Dependensi: T/A

Perubahan konfigurasi indeks akan langsung diterapkan setelah Anda mengimpor data katalog. Jika tidak, perubahan Anda dapat memerlukan waktu hingga 12 jam atau lebih untuk diterapkan. Anda dapat menguji apakah perubahan telah diterapkan di halaman Evaluasi.

Pengelompokan dinamis

Jika penentuan faset dinamis diaktifkan untuk suatu atribut, penelusuran dapat menggunakan atribut tersebut sebagai faset dinamis. Faset dinamis dapat ditambahkan secara otomatis ke penelusuran berdasarkan perilaku pengguna sebelumnya seperti klik dan penayangan faset.

  • Atribut sistem: Diaktifkan secara default jika indeksibilitas disetel ke benar (true). Anda dapat menonaktifkan penyesuaian dinamis untuk atribut sistem apa pun.
  • Atribut kustom: Diaktifkan secara default jika indeksibilitas disetel ke benar (true). Anda dapat menonaktifkan penelusuran berfacet dinamis untuk atribut kustom apa pun.
  • Atribut tingkat inventaris: Tidak didukung.
  • Dependensi: Untuk mengaktifkan penelusuran berfacet dinamis untuk suatu atribut, Anda harus mengaktifkan pengindeksan untuk atribut tersebut terlebih dahulu.

Menetapkan penyesuaian dinamis untuk atribut selalu bersifat global. Konfigurasi pengelompokan dinamis yang Anda terapkan ke atribut tersebut digunakan oleh produk di seluruh katalog yang menggunakan atribut tersebut.

Perubahan konfigurasi penelusuran dinamis memerlukan waktu hingga dua hari. Anda dapat menguji apakah perubahan telah diterapkan di halaman Evaluasi.

Untuk atribut kustom numerik, bucket harus ditentukan dalam permintaan. Nilai numerik tidak dikelompokkan secara otomatis.

Dapat ditelusuri

Jika atribut ditetapkan ke dapat ditelusuri, perolehan kembali untuk atribut tersebut dalam kueri penelusuran akan meningkat.

Hanya nilai atribut tekstual yang dapat diaktifkan penelusurannya. Atribut ini tidak berlaku untuk atribut numerik.

  • Atribut sistem: Atribut sistem tekstual yang telah ditentukan sebelumnya untuk Product telah mengonfigurasi setelan kemampuannya untuk ditelusuri oleh Vertex AI Search untuk commerce. Setelan ini tidak dapat diubah.
  • Atribut kustom: Dinonaktifkan secara default. Anda dapat mengaktifkan konfigurasi ini untuk atribut kustom tekstual apa pun.
  • Atribut tingkat inventaris: Tidak didukung.
  • Dependensi: T/A
  • Dapat ditelusuri persis: Hasil penelusuran yang ditargetkan untuk kueri penelusuran yang cocok dengan produk tertentu dalam katalog Anda. Opsi ini berfungsi dengan baik untuk nomor seri. Lihat informasi selengkapnya tentang opsi penelusuran persis.

Meskipun produk dengan atribut yang dapat ditelusuri lebih cenderung muncul di hasil penelusuran untuk atribut tersebut, produk tersebut tidak dijamin akan muncul.

Memfilter rekomendasi

Jika pemfilteran rekomendasi diaktifkan untuk suatu atribut, atribut tersebut dapat digunakan dalam ekspresi filter rekomendasi untuk memfilter produk dalam prediksi.

  • Atribut sistem: Nonaktif secara default. Anda dapat mengaktifkan setelan ini untuk atribut tekstual sistem yang telah ditentukan sebelumnya untuk Product, kecuali untuk FulfillmentInfo dan title. Tidak didukung untuk atribut numerik.
  • Atribut khusus: Nonaktif secara default. Anda dapat mengaktifkan setelan ini untuk atribut tekstual kustom mana pun untuk Product. Tidak didukung untuk atribut numerik.
  • Atribut tingkat inventaris: Hanya didukung untuk nilai availability IN_STOCK.
  • Dependensi: T/A

Opsi yang dapat ditelusuri persis

Anda dapat memberikan nilai tertentu untuk kueri string tertentu ke opsi exact-searchable, kolom atribut katalog. Jika kueri cocok dengan produk apa pun dalam katalog Anda yang nilai kolomnya adalah string yang diberikan dalam kueri, produk tersebut akan ditampilkan persis seperti dalam kueri penelusuran. Opsi ini berfungsi dengan baik untuk nomor seri, yang mana pelanggan mengharapkan pengalaman penelusuran yang ditargetkan.

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

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

Untuk mengetahui informasi selengkapnya, lihat Tentang atribut produk.

Perilaku atribut

Saat menyusun katalog produk menggunakan sebutan produk utama dan varian, ketahui cara penanganan atribut produk untuk pemfilteran. Perilakunya bergantung pada apakah Anda menggunakan penelusuran atau rekomendasi dan cara Anda mengonfigurasi taksonomi katalog.

Untuk memastikan perilaku pemfilteran yang dapat diprediksi dan akurat, pertahankan konsistensi dan kelengkapan dalam definisi atribut yang dapat difilter di seluruh produk utama dan varian. Pendekatan ini membantu pemfilteran yang akurat, yang meningkatkan penemuan produk dan relevansi penelusuran.

Perilaku varian utama dalam penelusuran versus rekomendasi

Meskipun hanya item utama yang ditampilkan dalam hasil penelusuran dan rekomendasi, Vertex AI Search untuk commerce mengoptimalkan kualitas penelusuran dan rekomendasi.

  • Untuk model penelusuran, atribut varian digunakan untuk produk utama dalam indeks penelusuran. Hasil penelusuran menampilkan beragam opsi untuk produk utama berdasarkan atribut variannya.

  • Untuk model rekomendasi, detail dan atribut produk tidak diwarisi dari produk utama ke varian. Untuk kualitas rekomendasi yang optimal, produk utama dan varian harus memiliki detail yang lengkap dan akurat untuk atribut utama seperti product.categories, product.title, product.attributes, dan product.prices.

Menangani atribut selama pengindeksan dan pemfilteran

Jika atribut yang sama ditentukan di Utama dan Varian, atribut dalam varian adalah bagian dari pemfilteran. Misalnya, atribut ditentukan untuk produk utama dan variannya (warna atau ukuran). Nilai atribut varian terutama digunakan untuk pemfilteran, yang selama prosesnya sistem akan memeriksa apakah ada varian utama yang cocok dengan nilai atribut. Ambil contoh ketersediaan produk: Produk utama dapat ditandai out-of-stock, tetapi jika setidaknya salah satu variannya in-stock, produk utama tersedia untuk hasil penelusuran jika filter in-stock diterapkan.

Untuk alasan berikut, tetapkan atribut yang dapat difilter yang sama di Utama dan Varian:

  • Atribut varian lebih diprioritaskan untuk pemfilteran. Jika atribut ditentukan pada produk utama dan variannya, atribut dari varian akan digunakan dalam pemfilteran. Misalnya, jika produk utama memiliki warna placeholder, tetapi variannya memiliki warna sebenarnya, warna varian harus diisi dan digunakan untuk memfilter.

  • Untuk atribut terkait inventaris seperti ketersediaan, jika produk utama memiliki varian, ketersediaan produk utama harus ditetapkan ke OUT_OF_STOCK, sedangkan ketersediaan sebenarnya (seperti IN_STOCK) harus ditetapkan di tingkat varian. Dengan cara ini, produk utama dianggap tersedia selama setidaknya satu varian tersedia. Jika ya, filter seperti availability: ANY("IN_STOCK") akan menampilkan produk utama dengan benar.

  • Jika ekspresi filter digunakan, respons prediksi akan menampilkan produk utama yang memiliki minimal satu produk utama atau varian yang cocok dengan nilai atribut filter.

Atribut opsional untuk pemfilteran

Pastikan kolom categories bersih dan dioptimalkan untuk taksonomi. Jika diperlukan lebih banyak pemfilteran, terapkan berdasarkan kategori luas menggunakan atribut kustom terpisah, bukan di kolom categories. Tindakan ini juga menghindari dampak negatif pada pelatihan pelengkapan otomatis untuk saran kategori.

Misalnya, Anda biasanya menetapkan kategori seperti [lvl1, lvl1>lvl2, lvl1>lvl2>lvl3] untuk memfilter. Pelengkapan otomatis menghitung kategori yang paling sering digunakan untuk kueri tertentu, sehingga Anda akan mendapatkan lvl1 dan lvl2 (semua produk Anda) sebagai kategori yang disarankan.

Praktik terbaik

Jika katalog Anda terdiri dari produk utama dan varian dan atribut yang sama ditentukan di keduanya, atribut dalam varian akan dipertimbangkan selama pemfilteran.

  • Isi atribut secara akurat: Pastikan produk utama dan varian memiliki detail yang lengkap dan akurat untuk atributnya, terutama yang digunakan untuk pemfilteran, guna memaksimalkan efektivitas.

  • Gunakan kolom bawaan: Jangan hanya mengandalkan atribut kustom. Petakan informasi produk Anda ke kolom Product bawaan (brands, colors, sizes, dan kolom wajib diisi). Kolom bawaan memiliki dampak yang lebih besar pada pengoptimalan kemudahan penelusuran, pengindeksan, dan relevansi. Atribut kustom (Product.attributes) digunakan untuk data produk yang tidak sesuai dengan atribut sistem yang telah ditentukan.

  • Menetapkan kontrol kolom yang dapat diambil di seluruh situs: API mendukung variantRollupKeys untuk varian, sehingga Anda dapat mengambil detail dalam respons penelusuran.

  • Bahasa katalog yang konsisten: Katalog produk hanya boleh menggunakan satu bahasa, dan kueri penelusuran harus dikirim dalam bahasa yang sama. Memiliki beberapa bahasa dalam katalog dapat menurunkan performa model. Tidak menyetel kode bahasa dapat memengaruhi fitur seperti koreksi ejaan.

  • Informasi harga: Isi informasi harga secara akurat untuk produk utama dan varian guna memastikan rekomendasi dan pemfilteran yang akurat. Jika produk tidak memiliki harga tingkat produk dan hanya mengandalkan harga inventaris lokal, isi harga produk utama dengan median dari harga tingkat inventaris.

Mode konfigurasi

Mode konfigurasi menentukan cara konfigurasi atribut diperlakukan dan konfigurasi atribut mana yang dapat Anda tetapkan.

  • Mode konfigurasi tingkat katalog (default): Dalam mode ini, konfigurasi atribut di tingkat katalog digunakan sebagai sumber tepercaya.
  • Mode konfigurasi tingkat produk (tidak digunakan lagi): Dalam mode ini, konfigurasi atribut di tingkat produk digunakan sebagai sumber kebenaran.

Sebelumnya, konfigurasi tingkat produk adalah mode default. Jika Anda masih menggunakan mode konfigurasi tingkat produk dan perlu beralih ke mode konfigurasi tingkat katalog, hubungi Dukungan. Penelusuran tidak mendukung kembali ke mode konfigurasi tingkat produk setelah Anda beralih.

Untuk memeriksa mode konfigurasi, buka halaman Kontrol di konsol Penelusuran untuk e-commerce. Jika opsi Dapat diindeks tersedia sebagai kolom di tab Kontrol di seluruh situs, maka model konfigurasi berada di tingkat katalog. Jika kolom Dapat diindeks tidak tersedia di tab Kontrol di seluruh situs, maka model konfigurasi adalah tingkat produk.

Metode konfigurasi

Anda dapat menetapkan konfigurasi atribut dengan cara berikut:

  • Konsol Penelusuran untuk e-commerce: Tetapkan konfigurasi atribut di tingkat katalog menggunakan konsol Penelusuran untuk e-commerce. Tindakan ini mengonfigurasi atribut secara global di semua produk. Setelan mana yang tersedia di konsol bergantung pada mode konfigurasi. Lihat bagian berikutnya untuk mengetahui detail selengkapnya tentang cara mengonfigurasi atribut di konsol.

  • Metode AttributeConfig API: Tetapkan konfigurasi atribut di tingkat katalog menggunakan API. Konfigurasi ini menetapkan atribut di semua produk.

  • Metode API Product (tidak digunakan lagi): Tetapkan atribut kustom di tingkat produk menggunakan metode API Product. Menetapkan atribut dengan metode ini tidak tersedia untuk pengguna baru dan tidak direkomendasikan.

Mengonfigurasi atribut di konsol

Anda dapat menetapkan opsi atribut secara global di semua produk dari halaman Search for commerce console Controls, di tab Site-wide controls. Untuk mengetahui detail selengkapnya tentang cara menyetelnya di konsol, lihat Mengelola kontrol atribut di seluruh situs.

Untuk menggunakan fitur ini, mode konfigurasi harus tingkat katalog.

Perubahan pada setelan konfigurasi atribut untuk dapat diindeks dan ditelusuri akan langsung diterapkan setelah penyerapan katalog. Jika tidak, diperlukan waktu hingga 12 jam atau lebih agar perubahan diterapkan. Anda dapat menguji apakah perubahan telah diterapkan di halaman Evaluasi.

Mengonfigurasi atribut dengan AttributesConfig

Resource API AttributesConfig memungkinkan Anda mengelola konfigurasi atribut di tingkat katalog.

Kolom berikut menetapkan opsi atribut di tingkat katalog:

Untuk mengambil semua konfigurasi atribut, gunakan metode GetAttributesConfig.

Memperbarui beberapa atribut

Gunakan metode updateAttributesConfig untuk memperbarui beberapa atribut di tingkat katalog.

Atribut katalog yang Anda sertakan dalam permintaan akan diperbarui di katalog, atau disisipkan jika tidak ada. Jika tidak ada nilai untuk kolom atribut katalog, nilai default akan ditetapkan.

Jumlah maksimum atribut katalog yang diizinkan dalam permintaan adalah 1.000.

Memperbarui atribut individual

Metode berikut digunakan untuk memperbarui atribut katalog individual:

  • AddCatalogAttribute: Menambahkan konfigurasi atribut individual ke atribut katalog.

    Lihat dokumentasi referensi API untuk AddCatalogAttribute.

  • ReplaceCatalogAttribute: Mengubah konfigurasi atribut individual. Tindakan ini menggantikan CatalogAttribute yang ditentukan di AttributesConfig dengan memperbarui atribut katalog dengan CatalogAttribute.key yang sama.

    Lihat dokumentasi referensi API untuk ReplaceCatalogAttribute.

  • RemoveCatalogAttribute: Menghapus konfigurasi atribut individual dari AttributesConfig.

    Hanya CatalogAttributes yang tidak digunakan oleh produk yang dapat dihapus. Jika CatalogAttribute sedang digunakan, RemoveCatalogAttribute tidak akan menghapusnya, tetapi mereset properti konfigurasinya ke nilai default. CatalogAttribute.inUse disetel ke True jika atribut digunakan oleh produk mana pun.

    Lihat dokumentasi referensi API untuk RemoveCatalogAttribute.

Mengonfigurasi atribut dengan metode Product (tidak digunakan lagi)

Menetapkan atribut dengan metode ini tidak tersedia untuk pengguna baru dan tidak direkomendasikan.

Kolom berikut menetapkan setelan yang dapat diindeks dan ditelusuri untuk produk tertentu menggunakan metode API Product: