Tentang atribut produk

Vertex AI Search untuk retail dapat memanfaatkan atribut produk untuk pengindeksan, facet dinamis, kemudahan penelusuran, pemfilteran, dan kualitas model. Halaman ini membahas setelan konfigurasi atribut produk dan cara penanganannya bergantung pada metode dan konfigurasi yang Anda gunakan.

Jenis atribut

Atribut produk dapat memiliki berbagai setelan default dan opsi yang diizinkan, tergantung jenisnya.

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

  • Atribut khusus: Atribut khusus adalah atribut tambahan yang Anda tentukan menggunakan kolom Product.attributes. Misalnya, nama ini dapat mencakup nama toko, vendor, atau gaya. Untuk mengetahui contoh dan batas atribut khusus, 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 sangat bervariasi antara toko dan wilayah, seperti barang sehari-hari, atau untuk produk yang memiliki promosi khusus toko.

    inventories.price dan inventories.originalPrice adalah atribut sistem numerik yang telah ditentukan oleh Vertex AI Search untuk retail. Anda dapat membuat atribut tingkat inventaris kustom, yang dapat berupa tekstual atau numerik. Atribut tingkat inventaris dapat diindeks secara default. Menyetel facet 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 membagi menggunakan atribut ini.
  • Facet dinamis: Penelusuran dapat otomatis menggunakan atribut ini sebagai faset dinamis berdasarkan perilaku pengguna terdahulu seperti tampilan dan klik faset. Guna mengaktifkan faset dinamis untuk suatu atribut, Indexable harus ditetapkan ke true untuk atribut tersebut.
  • Dapat ditelusuri: Atribut ini dapat ditelusuri oleh kueri penelusuran, yang meningkatkan perolehan untuk atribut tersebut. Kontrol ini hanya berlaku untuk atribut teks.
  • Dapat diambil kembali: Jika ditetapkan ke true, penelusuran akan menampilkan atribut ini sebagai respons terhadap kueri penelusuran. Jika semua atribut memiliki Retrievable yang ditetapkan ke false, hasil penelusuran hanya akan berisi nama produk atau (untuk varian) nama produk dan informasi warna.

Rekomendasi menggunakan setelan atribut berikut:

  • Filterable (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. Setelan ini tidak dapat dinonaktifkan untuk atribut sistem.
  • Atribut khusus: Diaktifkan secara default. Anda dapat menonaktifkan kemampuan untuk diindeks untuk atribut khusus apa pun. Jika Anda berencana membuat atribut khusus 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 langsung diterapkan setelah Anda mengimpor data katalog. Jika tidak, diperlukan waktu hingga 12 jam atau lebih agar perubahan diterapkan. Anda dapat menguji apakah perubahan telah diterapkan di halaman.

Facet dinamis

Jika faset dinamis diaktifkan untuk suatu atribut, penelusuran dapat menggunakan atribut tersebut sebagai faset dinamis. Facet dinamis dapat secara otomatis ditambahkan ke penelusuran berdasarkan perilaku pengguna terdahulu seperti tampilan dan klik faset.

  • Atribut sistem: Diaktifkan secara default jika kemampuan pengindeksan ditetapkan ke true. Anda dapat menonaktifkan facet dinamis untuk atribut sistem apa pun.
  • Atribut khusus: Diaktifkan secara default jika kemampuan pengindeksan ditetapkan ke benar (true). Anda dapat menonaktifkan facet dinamis untuk atribut khusus apa pun.
  • Atribut tingkat inventaris: Tidak didukung.
  • Dependencies: Guna mengaktifkan faset dinamis untuk suatu atribut, Anda harus mengaktifkan kemampuan terindeks untuk atribut tersebut terlebih dahulu.

Menetapkan facet dinamis untuk atribut selalu bersifat global. Konfigurasi faset dinamis yang Anda terapkan pada atribut tersebut digunakan oleh produk di seluruh katalog yang menggunakan atribut tersebut.

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

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

Dapat ditelusuri

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

Hanya nilai atribut tekstual yang dapat mengaktifkan kemampuan penelusuran. Ini tidak berlaku untuk atribut numerik.

  • Atribut sistem: Atribut sistem tekstual yang telah ditentukan sebelumnya untuk Product memiliki setelan kemampuan penelusurannya yang dikonfigurasi oleh Vertex AI Search untuk retail. Setelan ini tidak dapat diubah.
  • Atribut khusus: Dinonaktifkan secara default. Anda dapat mengaktifkan konfigurasi ini untuk atribut khusus tekstual.
  • Atribut tingkat inventaris: Tidak didukung.
  • Dependensi: T/A

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 suatu atribut mengaktifkan pemfilteran rekomendasi, 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 standar untuk Product, kecuali FulfillmentInfo dan title. Tidak didukung untuk atribut numerik.
  • Atribut khusus: Nonaktif secara default. Anda dapat mengaktifkan setelan ini untuk atribut tekstual kustom 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 konfigurasi atribut diperlakukan dan konfigurasi atribut mana yang dapat Anda tetapkan.

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

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

Untuk memeriksa mode konfigurasi, buka halaman Controls Search for Retail console. Jika opsi Indexable tersedia sebagai kolom pada tab Site-wide controls, berarti model konfigurasinya adalah level katalog. Jika kolom Indexable tidak tersedia di tab Site-wide controls, berarti model konfigurasinya adalah level produk.

Metode konfigurasi

Anda dapat menetapkan konfigurasi atribut dengan cara berikut:

  • Search for Retail console: Menetapkan konfigurasi atribut pada tingkat katalog menggunakan konsol Search for Retail. Tindakan ini akan mengonfigurasi atribut secara global di semua produk. Setelan mana yang tersedia di konsol bergantung pada mode konfigurasi.

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

  • Metode API Product (tidak digunakan lagi): Menetapkan atribut khusus pada 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 untuk semua produk dari halaman Kontrol Search for Retail Console, di tab Kontrol di seluruh situs. Untuk detail selengkapnya tentang cara menyetelnya di konsol, lihat Mengelola kontrol atribut seluruh situs.

Untuk menggunakan fitur ini, mode konfigurasi harus tingkat katalog.

Perubahan pada setelan konfigurasi atribut untuk konten yang 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 Evaluate.

Mengonfigurasi atribut dengan AttributesConfig

Resource API AttributesConfig memungkinkan Anda mengelola konfigurasi atribut pada 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 dalam 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 masing-masing atribut

Metode berikut digunakan untuk memperbarui atribut katalog individual:

  • AddCatalogAttribute: Menambahkan konfigurasi atribut satu per satu ke atribut katalog.

    Lihat dokumentasi referensi API untuk AddCatalogAttribute.

  • ReplaceCatalogAttribute: Memodifikasi 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 digunakan, RemoveCatalogAttribute tidak akan menghapusnya, tetapi mereset properti konfigurasinya ke nilai default. CatalogAttribute.inUse ditetapkan ke True jika atribut sedang digunakan oleh produk apa pun.

    Lihat dokumentasi referensi API untuk RemoveCatalogAttribute.

Mengonfigurasi atribut dengan metode Product (tidak digunakan lagi)

Menyetel atribut dengan metode ini tidak tersedia untuk pengguna baru dan tidak disarankan.

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