Mengelola konfigurasi penayangan

Halaman ini menjelaskan cara menghapus, mengedit, dan mencantumkan konfigurasi penayangan, serta meninjau statistik tentang setiap konfigurasi.

Untuk mendapatkan bantuan dalam membuat konfigurasi penayangan baru, lihat Membuat konfigurasi penayangan.

Anda tidak perlu mengonfigurasi konfigurasi penayangan agar penelusuran berfungsi. serving_config_id dapat ditempatkan sebagai bagian dari permintaan penelusuran, yang dalam hal ini, secara default akan menjadi kontrol penayangan kosong atau tidak dikonfigurasi. Katalog kemudian ditelusuri dengan kemampuan penelusuran default Vertex AI Search untuk commerce.

Jika Anda memiliki penempatan yang sudah ada, atau membuat penempatan baru, Vertex AI Search untuk e-commerce akan otomatis membuat konfigurasi penayangan yang terkait dengan setiap penempatan. Membuat konfigurasi penayangan tidak akan membuat penempatan yang sesuai. Menghapus konfigurasi penayangan akan menghapus penempatan yang sesuai, dan menghapus penempatan akan menghapus konfigurasi penayangan yang sesuai.

Mengedit konfigurasi inferensi

Anda dapat mengedit konfigurasi penayangan menggunakan konsol Penelusuran untuk e-commerce atau API.

Catatan: Jika Anda membuat perubahan signifikan pada konfigurasi penayangan yang berisi model Pengoptimalan Tingkat Halaman, model Pengoptimalan Tingkat Halaman mungkin menampilkan hasil yang kurang optimal saat dilatih ulang. Karena perlu waktu lama untuk melatih ulang model Pengoptimalan Tingkat Halaman, pertimbangkan untuk membuat ulang model Pengoptimalan Tingkat Halaman dan konfigurasi penayangannya yang terkait.

Mengedit konfigurasi penayangan di konsol

Anda dapat melihat dan mengedit kontrol untuk setiap konfigurasi penayangan di halaman Konfigurasi Penayangan. Klik konfigurasi penayangan untuk melihat halaman Detail, yang mencantumkan semua kontrol penayangan dan di seluruh situs untuk konfigurasi tersebut.

Di halaman ini, Anda dapat mengedit kontrol, membuat kontrol baru, atau menerapkan kontrol yang ada ke konfigurasi.

Konfigurasi penayangan yang baru dibuat atau diperbarui memerlukan waktu beberapa menit agar siap menayangkan traffic langsung. Anda dapat langsung menguji perubahan di halaman Evaluasi.

Mengedit konfigurasi inferensi secara inline

Anda dapat memperbarui kolom konfigurasi penayangan, menambahkan kontrol penayangan, dan menghapus kontrol penayangan secara inline menggunakan metode API.

Membuat patch konfigurasi inferensi secara inline

Untuk memperbarui kolom dalam konfigurasi penayangan, gunakan ServingConfig.patch dan sertakan instance ServingConfig dalam isi permintaan. Tentukan kolom yang akan diperbarui dengan parameter updateMask, atau biarkan tidak disetel untuk memperbarui semua kolom yang didukung.

Untuk mengetahui informasi selengkapnya tentang metode ini, lihat referensi API ServingConfig.patch.

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/servingConfigs/SERVING_CONFIG_ID",
      "FIELD_NAME_1": "NEW_FIELD_VALUE_1"
      "FIELD_NAME_2": "NEW_FIELD_VALUE_2"
    }' \
'https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/servingConfigs/SERVING_CONFIG_ID?updateMask=FIELD_NAME_1,FIELD_NAME_2'

Menambahkan kontrol ke konfigurasi penayangan secara inline

Untuk menambahkan kontrol ke konfigurasi penayangan, gunakan ServingConfig.addControl. Kontrol ditambahkan di posisi terakhir daftar kontrol yang menjadi bagiannya. Misalnya, kontrol facetSpec diterapkan di posisi terakhir servingConfig.facetSpecIds.

Untuk mengetahui informasi selengkapnya tentang metode ini, lihat referensi API ServingConfig.addControl.

curl -X POST \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d '{
      "controlID": "CONTROL_ID"
    }' \
'https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/servingConfigs/SERVING_CONFIG_ID:addControl'

Menghapus kontrol dari konfigurasi penayangan secara inline

Untuk menghapus kontrol dari konfigurasi penayangan, gunakan ServingConfig.removeControl.

Untuk mengetahui informasi selengkapnya tentang metode ini, lihat referensi API ServingConfig.removeControl.

curl -X POST \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d '{
      "controlID": "CONTROL_ID"
    }' \
'https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/servingConfigs/SERVING_CONFIG_ID:removeControl'

Melihat konfigurasi inferensi

Anda dapat melihat konfigurasi penayangan menggunakan konsol Search for Commerce atau API.

Melihat konfigurasi inferensi di konsol

Anda dapat melihat semua konfigurasi penayangan di halaman Konfigurasi Penayangan.

Melihat konfigurasi inferensi secara inline

Untuk melihat konfigurasi penayangan tunggal secara inline, gunakan ServingConfig.get.

Untuk mengetahui informasi selengkapnya tentang metode ini, lihat referensi API ServingConfig.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/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/servingConfigs/SERVING_CONFIG_ID'

Untuk mencantumkan semua konfigurasi penayangan secara inline, gunakan ServingConfig.list.

Secara opsional, Anda dapat menggunakan parameter pageSize untuk menetapkan jumlah maksimum hasil yang akan ditampilkan. Jika ada lebih banyak hasil, respons list akan menyertakan token halaman. Anda dapat meneruskan token halaman dalam parameter pageToken dari permintaan list untuk mengambil halaman hasil berikutnya.

Untuk mengetahui informasi selengkapnya tentang metode ini, lihat referensi API ServingConfig.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/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/servingConfigs?pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN'

Menghapus konfigurasi penayangan

Anda dapat menghapus konfigurasi penayangan menggunakan konsol Penelusuran untuk e-commerce atau API.

Catatan: Jika Anda menghapus konfigurasi penayangan yang digunakan oleh model Pengoptimalan Tingkat Halaman, hapus dan buat ulang model Pengoptimalan Tingkat Halaman tersebut. Jika tidak, model Pengoptimalan Tingkat Halaman akan menampilkan konfigurasi penayangan yang dihapus.

Menghapus konfigurasi inferensi di konsol

Untuk menghapus konfigurasi penayangan di konsol:

1. Buka halaman Serving Configs di konsol Penelusuran untuk e-commerce.
   
   Buka halaman Konfigurasi penayangan

2. Klik konfigurasi penayangan yang ingin Anda hapus untuk membuka halaman detailnya.

3. Klik Hapus di panel tombol di bagian atas halaman.

4. Jika konfigurasi penayangan dianggap aktif, Anda harus mengetik ulang ID-nya dan mengklik Konfirmasi untuk menyelesaikan penghapusan.

Menghapus konfigurasi penayangan secara inline

Untuk menghapus satu konfigurasi penayangan secara inline, gunakan ServingConfig.delete.

Untuk mengetahui informasi selengkapnya tentang metode ini, lihat referensi API ServingConfig.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/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/servingConfigs/SERVING_CONFIG_ID'

Meninjau statistik konfigurasi inferensi

Anda dapat melihat detail untuk setiap konfigurasi penayangan di halaman Konfigurasi Penayangan. Untuk konfigurasi apa pun dalam tabel, klik Lihat analisis untuk melihat statistiknya.

Rasio klik-tayang menunjukkan klik per penelusuran untuk konfigurasi penayangan. Rasio konversi menunjukkan pembelian per penelusuran untuk konfigurasi.

Catatan: Periode waktu untuk statistik berada di zona waktu Pasifik. Misalnya, statistik harian menampilkan data dari kemarin tengah malam Waktu Pasifik hingga hari ini tengah malam Waktu Pasifik.