Memanfaatkan tingkat performa penelusuran

Halaman ini menjelaskan kasus penggunaan penelusuran, tingkat performanya masing-masing, dan cara memeriksa konsol Search for Retail untuk menilai kualitas data dan tingkat performa yang telah Anda buka. Halaman ini menunjukkan cara mendaftar untuk menerima notifikasi kualitas data.

Kasus penggunaan penelusuran

Penelusuran memberikan hasil penelusuran untuk dua kasus penggunaan:

  • Penelusuran kueri teks, digunakan saat pembeli mencari item di aplikasi Anda dengan memasukkan kueri teks dan mendapatkan serangkaian hasil yang relevan.
  • Penelusuran penelusuran, digunakan saat pembeli diarahkan ke halaman kategori tertentu, seperti halaman web kategori "Appliances" dari situs retail toko renovasi rumah dan menjelajahi item yang diurutkan dalam kategori tersebut.

Untuk mengetahui informasi selengkapnya tentang perbedaan antara kasus penggunaan tersebut, lihat Tentang penelusuran teks dan penelusuran penjelajahan.

Tingkatan performa

Penelusuran dan penelusuran kueri teks memiliki tingkat performa yang berbeda yang semakin meningkatkan hasil penelusuran Anda. Untuk mencapai tingkat performa, bergantung pada data peristiwa dan katalog pengguna yang Anda upload ke Vertex AI Search untuk retail.

Setiap tingkat performa otomatis diaktifkan setelah Anda memenuhi semua persyaratan data yang memblokir upgrade. Anda juga harus memenuhi persyaratan untuk semua tingkat sebelumnya agar dapat melakukan upgrade ke tingkat berikutnya.

Tingkat performa berikut tersedia untuk setiap kasus penggunaan:

  • Kasus penggunaan penelusuran kueri teks

    • Relevansi: Hasil ditampilkan hanya berdasarkan relevansi dengan kueri
    • Relevansi dan popularitas: Hasil ditampilkan berdasarkan relevansi dengan kueri. Produk yang sama relevannya diberi peringkat berdasarkan popularitas produk di situs Anda
    • Dioptimalkan untuk pendapatan: Hasil yang relevan diberi peringkat berdasarkan kemungkinan produk dibeli berdasarkan aktivitas seluruh situs
    • Dipersonalisasi dan dioptimalkan untuk pendapatan: Hasil yang relevan diberi peringkat berdasarkan preferensi setiap pengguna dan kemungkinan produk untuk dibeli berdasarkan aktivitas di seluruh situs

  • Jelajahi kasus penggunaan penelusuran

    • Popularitas: Hasil ditampilkan hanya berdasarkan relevansi dengan kategori
    • Dioptimalkan untuk pendapatan: Hasil yang relevan diberi peringkat berdasarkan kemungkinan produk dibeli berdasarkan aktivitas seluruh situs
    • Dipersonalisasi dan dioptimalkan untuk pendapatan: Hasil yang relevan diberi peringkat berdasarkan preferensi setiap pengguna dan kemungkinan produk untuk dibeli berdasarkan aktivitas di seluruh situs

Konsol Penelusuran Retail menyediakan halaman Kualitas Data tempat Anda dapat memeriksa apakah Anda telah memenuhi persyaratan data setiap tingkat.

Memeriksa kualitas data

Setelah mengupload data Anda, buka Search for Retail console guna melihat metrik pemeriksaan data untuk setiap tingkat performa untuk kasus penggunaan Anda.

  1. Buka halaman Kualitas data di Search for Retail console.

    Buka halaman Kualitas Data

  2. Lihat metrik pemeriksaan data untuk kasus penggunaan penelusuran Anda:

    • Untuk metrik penelusuran teks, klik tab Penelusuran.
    • Untuk melihat metrik penelusuran, klik tab Jelajahi.

  3. Periksa setiap kartu skor masalah tingkat performa di bagian atas halaman.

    • Jika berlabel "Sedang digunakan": Anda telah menyelesaikan semua masalah pemblokiran untuk tingkat tersebut dan telah membuka kuncinya.
    • Jika ada 0 masalah pemblokiran: Anda telah memenuhi pemeriksaan data untuk tingkat tersebut. Jika tidak ada masalah pemblokiran untuk tingkat ini dan semua tingkat sebelumnya, diperlukan waktu sekitar 24 jam untuk melatih dan menyiapkan model serta mengaktifkan tingkat yang baru dibuka.
    • Jika ada masalah pemblokiran: Periksa metrik tingkat tersebut untuk melihat masalah data yang harus diatasi untuk membuka tingkat tersebut.

  4. Lihat tabel metrik pemeriksaan data setiap tingkat performa untuk mengetahui daftar masalah yang dapat memblokir upgrade tingkat atau memengaruhi performa penelusuran.

  5. Periksa kolom Status untuk mengetahui tingkat prioritas setiap metrik pemeriksaan data:

    • Pemblokiran upgrade: Mengidentifikasi masalah data yang mencegah penelusuran mengupgrade kasus penggunaan Anda ke tingkat performa berikutnya. Untuk membuka paket, selesaikan semua pemeriksaan data pemblokiran upgrade untuk tingkat performa tersebut (dan tingkat sebelumnya).
    • Penting bagi performa: Mengidentifikasi masalah data yang tidak memblokir upgrade, tetapi dapat berdampak signifikan terhadap penelusuran teks atau performa penelusuran saat menjelajah.
    • Mematuhi: Menunjukkan bahwa pemeriksaan data ini telah lulus.
    • Tidak tersedia: Menunjukkan bahwa pemeriksaan data pemblokiran non-upgrade belum selesai. Nilai untuk metrik ini ditampilkan sebagai T/A. Perlu waktu hingga 24 jam setelah mengimpor data untuk menghitung beberapa pemeriksaan data.

  6. Untuk informasi selengkapnya tentang metrik, klik Detail untuk melihat panel detail yang menampilkan deskripsi metrik, stempel waktu pemeriksaan data, dan nilai batas.

  7. Periksa nilai minimum di panel Details metrik untuk mengetahui nilai yang diperlukan guna memenuhi pemeriksaan data metrik tersebut dan meningkatkan hasil. Tidak semua batas berlaku untuk semua metrik:

    • Batas pemblokiran: Nilai minimum yang diperlukan untuk memenuhi pemeriksaan data metrik ini.
    • Batas kritis: Nilai minimum yang sangat direkomendasikan untuk dipenuhi. Tidak memenuhi batas ini dapat berdampak negatif secara signifikan terhadap performa.
    • Nilai minimum peringatan: Nilai minimum yang direkomendasikan untuk dipenuhi. Tidak memenuhi batas ini dapat berdampak kecil pada performa.

Untuk mengimpor lebih banyak data guna menyelesaikan masalah data, lihat Mengimpor peristiwa pengguna historis atau Mengimpor informasi katalog dalam dokumentasi publik.

Praktik terbaik

  • Pada permintaan penelusuran dan di peristiwa pengguna, berikan ID pengguna selain ID pengunjung untuk pengguna yang login. Hal ini memungkinkan penelusuran mempersonalisasi hasil bagi pengguna berdasarkan peristiwa login pengguna di seluruh perangkat.
  • Mengirim peristiwa pengguna secara real time, bukan dalam upload banyak, dengan penundaan. Hal ini membantu personalisasi penelusuran menggunakan aktivitas terbaru pengguna di situs Anda.
  • Upload semua peristiwa pengguna. Misalnya, jangan hanya mengirimkan peristiwa yang dapat diatribusikan ke penelusuran.

Menonaktifkan personalisasi

Untuk menonaktifkan personalisasi, tetapkan ServingConfig.personalizationSpec ke mode.DISABLED.

Notifikasi kualitas data

Pemberitahuan kualitas data dipicu jika nilai metrik di dasbor berubah dari memuaskan menjadi tidak memuaskan. Notifikasi dikirim melalui email.

Jika Anda ingin melihat pemberitahuan terkait Cloud Monitoring, buka Menyiapkan pemberitahuan.

Lihat kualitas data

Buka halaman Kualitas data di Search for Retail console.

Buka halaman Kualitas Data

Satu baris sesuai dengan satu metrik, dan satu metrik sesuai dengan satu pemberitahuan.

Siapkan notifikasi kualitas data

REST

Panggil UpdateAlertConfig API.

curl -X PATCH -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" -H "X-GFE-SSL: yes" -H "X-Goog-User-Project: PROJECT_ID" \
 "https://retail.googleapis.com/v2alpha/projects/PROJECT_ID/alertConfig" \
--data '
{
  "alertPolicies": [
    {
      "alertGroup": "search-data-quality",
      "enrollStatus": "ENROLLED",
      "recipients": [
        {
          "emailAddress": "EMAIL_ADDRESS_1"
        },
        {
          "emailAddress": "EMAIL_ADDRESS_2"
        }
      ]
    }
  ]
}'

Ganti kode berikut:

  • PROJECT_ID: ID project Google Cloud Anda.
  • EMAIL_ADDRESS_1, EMAIL_ADDRESS_2: Alamat email yang ingin Anda gunakan untuk mendaftar untuk notifikasi. Aplikasi tersebut harus sesuai dengan SMTP (Simple Mail Transfer Protocol). Anda dapat menambahkan maksimal 20 alamat email ke satu kebijakan pemberitahuan.

Nonaktifkan pemberitahuan kualitas data

REST

Panggil UpdateAlertConfig API.

curl -X PATCH -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" -H "X-GFE-SSL: yes" -H "X-Goog-User-Project: PROJECT_ID" \
 "https://retail.googleapis.com/v2alpha/projects/PROJECT_ID/alertConfig" \
--data '
{
  "alertPolicies": [
    {
      "alertGroup": "search-data-quality",
      "enrollStatus": "DECLINED",
      "recipients": [
      ]
    }
  ]
}'

Ganti kode berikut:

  • PROJECT_ID: ID project Google Cloud Anda.

Memecahkan masalah

Berikut ini beberapa masalah umum dan cara mengatasinya:

Pemeriksaan data tidak berhasil

Jika pemeriksaan data tidak lulus, klik Detail untuk metrik tersebut di halaman Kualitas Data untuk melihat deskripsi yang lebih mendetail tentang metrik tersebut dan nilai minimum untuk memenuhi pemeriksaan data tersebut.

Jika Anda telah memenuhi persyaratan data, periksa bagian Timestamp untuk mengetahui kapan metrik tersebut terakhir dihitung. Jika baru-baru ini Anda memformat ulang atau menyerap data dalam jumlah besar, perlu waktu beberapa jam untuk menghitung ulang metrik tersebut.

Jika belum memenuhi persyaratan data, Anda mungkin perlu memformat ulang data atau mengumpulkan lebih banyak data untuk memenuhi persyaratan pemeriksaan data. Setelah memastikan bahwa data Anda akan memenuhi nilai minimum metrik, impor ulang data yang diformat ulang atau impor data tambahan, lalu tunggu hingga metrik dihitung ulang.

Nilai metrik ditampilkan sebagai T/A

Nilai metrik ditampilkan sebagai T/A jika tidak ada data yang diupload atau jika metrik belum dihitung. Perlu waktu hingga 24 jam setelah mengimpor data untuk menghitung beberapa pemeriksaan data.

Tingkat performa tidak memiliki masalah pemblokiran, tetapi tidak digunakan

Untuk memecahkan masalah, ikuti langkah-langkah berikut:

  1. Periksa apakah ada masalah pemblokiran data untuk tingkat sebelumnya. Anda harus memenuhi persyaratan untuk semua tingkat sebelumnya agar dapat melakukan upgrade ke tingkat berikutnya.

  2. Tunggu selama 24 jam. Setelah semua pemeriksaan data yang memblokir upgrade selesai, perlu waktu sekitar 24 jam untuk melatih dan menyiapkan model serta mengaktifkan tingkat yang baru dibuka.

Jika tingkat performa tidak ditandai sebagai tidak digunakan dalam waktu dua hari setelah lulus semua pemeriksaan data yang memblokir upgrade, hubungi Vertex AI Search untuk mendapatkan dukungan retail dengan nomor project dan project ID Anda untuk mendapatkan bantuan.

Informasi persyaratan data tambahan

Untuk mengetahui informasi selengkapnya tentang Vertex AI Search terkait persyaratan data retail, lihat dokumentasi:

Langkah selanjutnya