Tentang atribut produk

Vertex AI Search untuk retail dapat memanfaatkan atribut produk untuk pengindeksan, facet dinamis, kemampuan penelusuran, pemfilteran, dan kualitas model. Halaman ini membahas cara menetapkan konfigurasi atribut produk dan cara perlakuannya, 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 standar adalah kolom Product yang ada dan memberikan informasi selengkapnya tentang produk. Hal 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, ini dapat mencakup nama toko, vendor, atau gaya. Untuk mengetahui contoh dan batas atribut kustom, lihat dokumentasi referensi Product.attributes.

  • Atribut tingkat inventaris: Atribut sistem atau kustom yang memberikan informasi tingkat toko tentang produk. Anda dapat menggunakan atribut tingkat inventaris untuk produk yang propertinya bervariasi secara signifikan di antara toko dan wilayah, seperti item bahan makanan, 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 retail. Anda dapat membuat atribut tingkat inventaris kustom, yang dapat berupa teks atau angka. Atribut tingkat inventaris dapat diindeks secara default. Menetapkan pengelompokan dinamis dan yang 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 membuat facet menggunakan atribut ini.
  • Pengelompokan berdimensi dinamis: Penelusuran dapat otomatis menggunakan atribut ini sebagai dimensi dinamis berdasarkan perilaku pengguna sebelumnya seperti klik dan tampilan dimensi. Untuk mengaktifkan pembuatan susunan facet dinamis untuk atribut, Indexable harus disetel ke true untuk atribut tersebut.
  • Dapat ditelusuri: Atribut ini dapat ditelusuri dengan kueri penelusuran, yang meningkatkan recall untuk atribut tersebut. Kontrol ini hanya berlaku untuk atribut teks.
  • Dapat diambil: Jika ditetapkan ke benar (true), penelusuran akan menampilkan atribut ini dalam respons terhadap kueri penelusuran. Jika semua atribut memiliki Retrieveable ditetapkan ke salah, 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 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 ditetapkan ke dapat diindeks, penelusuran dapat memfilter dan membuat facet menggunakan atribut tersebut.

  • Atribut sistem: Kemampuan 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 kemampuan pengindeksan untuk atribut kustom apa pun. Jika Anda berencana membuat atribut kustom yang 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 segera diterapkan setelah Anda mengimpor data katalog. Jika tidak, perubahan dapat memerlukan waktu hingga 12 jam atau lebih untuk diterapkan. Anda dapat menguji apakah perubahan telah diterapkan di halaman Evaluasi.

Pembagian berdasarkan atribut dinamis

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

  • Atribut sistem: Diaktifkan secara default jika pengindeksan disetel ke benar. Anda dapat menonaktifkan pembuatan faceted dinamis untuk atribut sistem apa pun.
  • Atribut kustom: Diaktifkan secara default jika pengindeksan ditetapkan ke benar. Anda dapat menonaktifkan pembuatan susunan facet dinamis untuk atribut kustom apa pun.
  • Atribut tingkat inventaris: Tidak didukung.
  • Dependensi: Untuk mengaktifkan pembuatan susunan facet dinamis untuk atribut, Anda harus mengaktifkan kemampuan pengindeksan untuk atribut tersebut terlebih dahulu.

Menetapkan pengelompokan 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 pengelompokan berdimensi 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, recall untuk atribut tersebut dalam kueri penelusuran akan ditingkatkan.

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

  • Atribut sistem: Atribut sistem tekstual standar untuk Product memiliki setelan kemampuan penelusuran yang dikonfigurasi oleh Vertex AI Search untuk retail. Setelan ini tidak dapat diubah.
  • Atribut kustom: Dinonaktifkan secara default. Anda dapat mengaktifkan konfigurasi ini untuk setiap atribut kustom tekstual.
  • Atribut tingkat inventaris: Tidak didukung.
  • Dependensi: T/A
  • Dapat ditelusuri persis: Penelusuran yang ditargetkan ditampilkan untuk kueri penelusuran yang cocok dengan produk tertentu di katalog Anda. Opsi ini berfungsi dengan baik untuk nomor seri. Lihat informasi selengkapnya tentang opsi yang dapat ditelusuri persis.

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

Pemfilteran rekomendasi

Jika diaktifkan, atribut 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 standar 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 apa pun untuk Product. Tidak didukung untuk atribut numerik.
  • Atribut tingkat inventaris: Hanya didukung untuk nilai availability IN_STOCK.
  • Dependensi: T/A

Mode konfigurasi

Mode konfigurasi menentukan cara perlakuan konfigurasi atribut dan konfigurasi atribut 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 tepercaya.

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 Retail. Jika opsi Dapat diindeks tersedia sebagai kolom di tab Kontrol seluruh situs, berarti model konfigurasinya adalah tingkat katalog. Jika kolom Dapat diindeks tidak tersedia di tab Kontrol seluruh situs, berarti model konfigurasinya adalah tingkat produk.

Metode konfigurasi

Anda dapat menetapkan konfigurasi atribut dengan cara berikut:

  • Konsol Penelusuran untuk Retail: Tetapkan konfigurasi atribut di tingkat katalog menggunakan konsol Penelusuran untuk Retail. Tindakan ini akan mengonfigurasi atribut secara global di semua produk. Setelan mana yang tersedia di konsol bergantung pada mode konfigurasi.

  • Metode AttributeConfig API: Menetapkan konfigurasi atribut di tingkat katalog menggunakan API. Tindakan ini akan mengonfigurasi atribut di semua produk.

  • Metode Product API (tidak digunakan lagi): Menetapkan atribut kustom di tingkat produk menggunakan metode Product API. 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 Kontrol di konsol Penelusuran Retail, pada tab Kontrol seluruh situs. Untuk mengetahui detail selengkapnya tentang cara menetapkannya di konsol, lihat Mengelola kontrol atribut seluruh situs.

Untuk menggunakan fitur ini, mode konfigurasi harus berupa tingkat katalog.

Perubahan pada setelan konfigurasi atribut untuk atribut yang dapat diindeks dan dapat ditelusuri akan langsung diterapkan setelah penyerapan katalog. Jika tidak, mungkin 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 AttributesConfig API 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, kolom tersebut akan diberi nilai default.

Jumlah maksimum atribut katalog yang diizinkan dalam permintaan adalah 1.000.

Memperbarui setiap atribut

Metode berikut digunakan untuk memperbarui setiap atribut katalog:

  • AddCatalogAttribute: Menambahkan konfigurasi atribut individual ke atribut katalog.

    Lihat dokumentasi referensi API untuk AddCatalogAttribute.

  • ReplaceCatalogAttribute: Mengubah konfigurasi atribut individual. Tindakan ini akan mengganti 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 ditetapkan ke True jika atribut digunakan oleh produk apa 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 melalui metode Product API: