Menelusuri dan menjelajah

Dokumen ini bertujuan untuk mengklarifikasi perbedaan antara fungsi penelusuran dan penjelajahan dalam AI Commerce Search untuk mempelajari cara mengonfigurasi setiap fungsi secara efektif dan mendapatkan hasil maksimal.

Memahami perbedaan inti

Meskipun penelusuran dan penjelajahan membantu pelanggan menemukan produk, keduanya melayani perjalanan pengguna yang berbeda dan memerlukan konfigurasi yang berbeda.

Didorong oleh niat pengguna, saat pembeli memasukkan kueri tertentu, seperti sepatu lari merah. AI Commerce Search menganalisis kueri ini untuk memahami kebutuhan pengguna dan menampilkan produk relevan yang dioptimalkan untuk pendapatan.

Singkatnya, untuk penelusuran, AI Commerce Search bertanggung jawab atas relevansi produk dan peringkatnya (dioptimalkan untuk pendapatan).

Penjelajahan

Dipandu oleh kategori yang telah ditentukan, saat pembeli menavigasi listingan produk yang diatur berdasarkan atribut seperti merek, kategori, atau promosi, seperti Kemeja dalam kategori Pakaian Pria. Anda menentukan kategori ini, yang menampilkan produk di dalamnya.

Anda bertanggung jawab atas relevansi produk yang tercantum (melalui filter), dan AI Commerce Search bertanggung jawab atas peringkatnya (dioptimalkan untuk pendapatan).

Mengonfigurasi penelusuran dan penjelajahan

Keunggulan AI Commerce Search terletak pada API terpadunya untuk permintaan penelusuran dan penjelajahan.

Mengonfigurasi penelusuran

Peristiwa pengguna untuk penelusuran harus memiliki kolom ini, beserta kolom wajib standar lainnya untuk peristiwa pengguna (eventType = "search"):

  • Kueri teks: Inti dari permintaan penelusuran. Kueri ini menangkap niat penelusuran pengguna.
  • Filter (Opsional): Memungkinkan pengguna mempersempit hasil penelusuran dengan menerapkan aspek seperti merek, rentang harga, atau warna.
  • Peringkat dan Personalisasi: AI Commerce Search secara otomatis mengoptimalkan peringkat hasil penelusuran berdasarkan relevansi dan potensi pendapatan. Personalisasi lebih lanjut menyesuaikan hasil berdasarkan perilaku pengguna perorangan.

  # Construct the search request
  search_request = {
      "query": "red running shoes", # User's search query
      "filter": "brand:ANY('Nike')", # Optional filter
      "page_size": 10 # Number of results per page
  }



# Send the request to the VAIS:Commerce API
  search_response = client.search(search_request)



# Process the search results
  for product in search_response.results:
      print(product.title, product.price)

Untuk kueri dasar dengan penelusuran, termasuk penelusuran kueri teks, penelusuran penjelajahan, penomoran halaman, pengoptimalan, dan hasil yang dipersonalisasi, lihat Mendapatkan hasil penelusuran.

Mengonfigurasi penjelajahan

Peristiwa pengguna untuk penelusuran penjelajahan harus memiliki kolom ini, beserta kolom wajib standar lainnya untuk peristiwa pengguna (eventType = "search" untuk peristiwa penjelajahan):

  • Kategori halaman: page_categories mewakili kategori atau banner tempat produk muncul. Meskipun, di library klien fisik atau API lama, kolom ini mungkin masih muncul sebagai page_category tunggal. Bentuk jamak dapat secara opsional sama dengan categories[] dalam katalog. Kolom ini hanya harus mewakili kategori yang diwakili oleh filter.

  • Filter wajib: Menentukan kriteria agar produk disertakan dalam hasil penjelajahan. Hal ini memastikan hanya produk yang relevan yang muncul dalam kategori.

  • Keselarasan antara peristiwa dan permintaan: Peristiwa pengguna yang sesuai dengan tindakan penjelajahan harus berisi nilai page_categories dan filter yang sama dengan nilai yang diteruskan dalam permintaan API.

  • Penjelajahan dan filter ditetapkan dengan nilai yang sama: Untuk menetapkan kolom pageCategories (penjelajahan) dan attributes.pageCategories (filter) dengan nilai yang sama, buat objek attributes.pageCategories yang tidak dapat ditelusuri, dan cantumkan setiap halaman tempat produk ini harus muncul untuk memfasilitasi pemfilteran.

Untuk filter penjelajahan, kolom seperti category atau categoryid, seperti yang ditunjukkan dalam contoh ini, biasanya merupakan atribut kustom yang Anda berikan.

Berikut adalah empat contoh opsi permintaan penjelajahan yang disebutkan di atas. (Cukup pilih satu format.).

  # a browse request with a custom category attribute
  browse_request = {
      "page_categories": ["Men's > Clothing > Shirts"], # Represents full taxonomy Path on the site
      "filter": "category:ANY('Shirts') AND gender: ANY('Male')", # Compulsory filter on custom attribute
      "page_size": 10
  }
  # a browse request showing category ID (Men's shirts custom id)
  browse_request = {
      "page_categories": ["Men's > Clothing > Shirts"],
      "filter": "categoryid:ANY(1234)", # Another custom attribute for categories
      "page_size": 10
  }
  # another example showing category ID's (Men's shirts custom id)
  browse_request = {
      "page_categories": ["1234"],  # Also ok to use unique category id's here
      "filter": "categoryid:ANY(1234)",
      "page_size": 10
  }
  # browse and filter set with the same value
  browse_request = {
      "page_category": ["Men's > Clothing > Shirts"], # Browse category
      "filter": "attributes.pageCategories:ANY('Men's > Clothing > Shirts')", # Compulsory filter
      "page_size": 10 # Number of results per page
  }
  # Send the request to the API
  browse_response = client.search(browse_request)
  # Process the browse results
  for product in browse_response.results:
      print(product.title, product.price)