Mengelola model

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

Rekomendasi umum untuk kualitas model

Acara umumnya harus diupload setidaknya setiap hari untuk menjaga 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 dibuat lebih dari 180 hari yang lalu tidak dapat diekspor.

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

Sebagian besar model berperforma terbaik dengan minimal tiga bulan data penayangan halaman produk, penayangan halaman beranda, dan peristiwa add-to-cart.

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

  • Rata-rata, 10 kejadian per item katalog (dengan jangka waktu satu tahun untuk peristiwa pembelian selesai).

  • Kedua peristiwa penyelesaian pembelian selama 90 hari dalam setahun terakhir dan 1.000 peristiwa penyelesaian pembelian dalam tahun yang sama.

Satu hingga dua minggu penayangan halaman detail sudah cukup untuk mulai melatih model Orang Lain yang Mungkin Anda Sukai dan Direkomendasikan untuk Anda.

Menyesuaikan model

Vertex AI Search untuk commerce 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 membuat pelatihan model tetap optimal seiring perubahan data dan perbedaan perilaku pelanggan sepanjang tahun. Selain itu, beberapa upgrade model internal utama hanya dapat diterapkan setelah model disesuaikan.

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

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

Untuk mengedit setelan status penyesuaian model:

Konsol

  1. Buka halaman Model di konsol Search for Commerce.

    Buka halaman Models

    Anda dapat melihat status penyetelan setiap model di bagian Status penyetelan.

  2. Klik nama model untuk melihat halaman detailnya.

  3. Klik Edit di samping Status penyesuaian.

  4. Dari menu drop-down, pilih setelan:

    • Setiap tiga bulan. Menyetel secara otomatis jika penyetelan terakhir dilakukan 90 hari yang lalu.
    • Khusus tuning manual. Hanya menyetel saat Anda menyetel secara manual.

  5. Klik Selesai untuk menyimpan setelan Anda.

curl

Buat permintaan Models.patch menggunakan API. Lihat referensi API Models.patch.

Untuk mengetahui detail tentang semua kolom Models, lihat referensi API Models.

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 (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:

Konsol

  1. Buka halaman Model di konsol Search for Commerce.

    Buka halaman Models

  2. Klik nama model untuk melihat halaman detailnya.

  3. Klik Penyesuaian Manual di panel tombol.

    Penyesuaian memerlukan waktu 2-4 hari, dan selama itu model akan terus berfungsi seperti biasa.

curl

Buat permintaan Models.tune menggunakan API. Lihat referensi API Models.tune.

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 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 sebaiknya melakukannya jika Anda telah mengimpor data yang buruk atau agar tidak melebihi 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 lanjutkan.

Untuk menjeda atau memulai ulang model:

Konsol

  1. Buka halaman Model di konsol Search for Commerce.

    Buka halaman Models

    Anda dapat melihat status pelatihan setiap model di bagian Status pelatihan.

  2. Untuk menjeda model aktif (Status pelatihan PELATIHAN), klik Jeda .

  3. Untuk memulai model yang dijeda (Status pelatihan DIJEDA), klik Lanjutkan .

curl

Untuk menjeda model aktif, buat permintaan Models.pause menggunakan API. Lihat referensi API Models.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:pause'

Untuk memulai model yang dijeda, buat permintaan Models.resume menggunakan API.

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'

Lihat detail model

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

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

Konsol

  1. Buka halaman Model di konsol Search for Commerce.

    Buka halaman Models

  2. Halaman Model mencantumkan semua model Anda serta status pelatihan dan kuerinya.

  3. Klik nama model untuk melihat halaman Detail.

curl

Untuk mendapatkan informasi satu model, buat permintaan Models.get menggunakan API. Lihat referensi API Models.get.

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.

Konsol

  1. Buka halaman Model di konsol Search for Commerce.

    Buka halaman Models

  2. Halaman Model mencantumkan semua model Anda serta status pelatihan dan kuerinya.

curl

Untuk mencantumkan semua model dan detailnya secara inline, buat permintaan Models.list menggunakan API. Lihat referensi Models.list API.

Secara opsional, Anda dapat menggunakan parameter pageSize untuk menetapkan jumlah maksimum hasil yang akan ditampilkan. Jika ada hasil lainnya, respons list akan menyertakan token halaman. Anda dapat meneruskan token halaman di parameter pageToken dari permintaan list untuk mengambil halaman hasil berikutnya. Contoh ini menggunakan kedua parameter.

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 lanjutkan.

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

Konsol

  1. Buka halaman Model di konsol Search for Commerce.

    Buka halaman Models

  2. Klik nama model yang ingin Anda hapus untuk membuka halaman detailnya.

  3. Klik Hapus di panel tombol.

  4. Masukkan kembali nama model, lalu klik Konfirmasi.

curl

Buat permintaan Models.delete menggunakan API. Lihat referensi API Models.delete.

Untuk mengetahui detail tentang semua kolom Models, lihat referensi API Models.

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'