Mengelola model

Halaman ini menjelaskan cara menyesuaikan, menjeda, melanjutkan, menghapus, dan mencantumkan model rekomendasi. Untuk mendapatkan bantuan terkait cara membuat model rekomendasi baru, lihat Membuat model rekomendasi.

Rekomendasi umum untuk kualitas model

Peristiwa umumnya harus diupload setidaknya setiap hari untuk mempertahankan kualitas data yang baik.

• Batas usia data: Peristiwa pengguna yang lebih lama dari tahun 2015 tidak diterima. Untuk saran pembelajaran otomatis, sistem menggunakan peristiwa pengguna dari 180 hari terakhir. Demikian pula, metrik untuk peristiwa pengguna yang lebih lama dari 180 hari atau yang dibuat lebih dari 180 hari yang lalu tidak dapat diekspor.

• ID pengunjung unik: Jumlah total ID pengunjung unik untuk setiap jenis peristiwa harus minimal 100 untuk memastikan data yang cukup untuk hasil berkualitas.

Sebagian besar model memiliki performa terbaik dengan setidaknya tiga bulan tampilan halaman produk, tampilan halaman beranda, dan peristiwa add-to-cart.

Untuk model Sering Dibeli Bersama, sebaiknya gunakan histori pembelian satu hingga dua tahun. Model ini secara khusus memerlukan salah satu hal berikut:

• Rata-rata 10 kejadian per item katalog (dengan periode satu tahun peristiwa pembelian selesai).

• Baik peristiwa pembelian selesai selama 90 hari dalam setahun terakhir maupun 1.000 peristiwa pembelian selesai pada tahun yang sama.

Tampilan halaman detail selama satu hingga dua minggu dapat memadai untuk mulai melatih model Lainnya yang Mungkin Anda Suka dan Direkomendasikan untuk Anda.

Menyesuaikan model

AI Commerce Search menggunakan data input yang Anda berikan ke model untuk menyesuaikan hyperparameter untuk pelatihan.

Penyesuaian memerlukan waktu 2-4 hari, dan selama itu model akan terus berfungsi seperti biasa. Untuk mengetahui detail biaya penyesuaian, lihat Harga.

Menetapkan frekuensi penyesuaian model

Sebaiknya sesuaikan model Anda secara berkala. Hal ini akan menjaga pelatihan model tetap optimal seiring perubahan data dan perilaku pelanggan yang berbeda sepanjang tahun. Selain itu, beberapa upgrade model utama internal hanya dapat diterapkan setelah model disesuaikan.

Saat membuat model, Anda dapat menetapkannya untuk menyesuaikan secara otomatis setiap tiga bulan, atau memilih untuk hanya menyesuaikannya secara manual. Terlepas dari setelan yang Anda pilih, model akan otomatis disesuaikan satu kali setelah dibuat.

Anda dapat mengubah setelan status penyesuaian kapan saja. Mengubah setelan ini tidak memengaruhi proses penyesuaian yang sedang berjalan.

Untuk mengedit setelan status penyesuaian model:

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d '{
  "name": "projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/models/MODEL_ID",
  "PeriodicTuningState": "NEW_TUNING_STATE_VALUE"
}' \
'https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/models/MODEL_ID?updateMask=PeriodicTuningState'

Menyesuaikan model secara manual

Penyesuaian manual memicu penyesuaian model Anda satu kali. Anda dapat menyesuaikan model secara manual jika ada perubahan signifikan dalam katalog Anda (seperti peningkatan ukuran atau perubahan hierarki katalog) atau peristiwa (seperti pengisian ulang peristiwa historis atau perubahan distribusi data setelah mempromosikan grup item tertentu).

Untuk menyesuaikan model secara manual:

curl -X POST \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/models/MODEL_ID:tune'

Menjeda dan melanjutkan pelatihan untuk model

Jika model Anda aktif (tidak dijeda), model akan dilatih ulang setidaknya sekali seminggu, tetapi tidak lebih sering dari sekali sehari. Untuk pelatihan ulang yang konsisten, pastikan Anda mengupload data peristiwa pengguna tidak lebih dari 24 jam setelah peristiwa terjadi.

Anda dapat menjeda model untuk menghentikan pelatihan ulang. Anda mungkin ingin melakukannya jika telah mengimpor data yang buruk atau untuk tetap berada di bawah batas 10 model aktif per project. Jika memiliki kurang dari 10 model aktif, Anda dapat memulai ulang model yang dijeda kapan saja.

Untuk mengetahui detail biaya pelatihan, lihat Harga.

Anda dapat memulai hingga lima operasi model per menit. Operasi model terbatas mencakup pembuatan, penghapusan, jeda, dan melanjutkan.

Untuk menjeda atau memulai ulang model:

curl -X POST \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/models/MODEL_ID:pause'

curl -X POST \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/models/MODEL_ID:resume'

Melihat detail model

Lihat detail model di konsol atau menggunakan metode API Models.get.

Untuk melihat konfigurasi penayangan yang terkait dengan model tertentu, gunakan prosedur ini. Semua detail model lainnya tersedia di konsol dan respons API.

curl -X GET \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/models/MODEL_ID'

Mencantumkan model Anda

Lihat daftar model Anda di konsol atau menggunakan metode API Models.list.

curl -X GET \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/models?pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN'

Menghapus model

Anda dapat memulai hingga lima operasi model per menit. Operasi model terbatas mencakup pembuatan, penghapusan, jeda, dan melanjutkan.

Hapus model di konsol atau menggunakan metode API Models.delete.

curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/models/MODEL_ID'