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.

Jika Anda memiliki penempatan yang sudah ada, atau membuat penempatan baru, Vertex AI Search untuk retail 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 penayangan

Anda dapat mengedit konfigurasi penayangan menggunakan konsol Penelusuran untuk Retail atau API.

Catatan: Jika Anda membuat perubahan signifikan pada konfigurasi penayangan yang berisi model Page-Level Optimization, model Page-Level Optimization 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 penayangan 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 Details, yang mencantumkan semua kontrol penayangan dan seluruh situs untuk konfigurasi tersebut.

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

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

Mengedit konfigurasi penayangan secara inline

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

Menambahkan konfigurasi penayangan patch 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 ditetapkan 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 terkait. 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 penayangan

Anda dapat melihat konfigurasi penayangan menggunakan konsol Penelusuran untuk Retail atau API.

Melihat konfigurasi penayangan di konsol

Anda dapat melihat semua konfigurasi penayangan di halaman Konfigurasi Penayangan.

Melihat konfigurasi penayangan secara inline

Untuk melihat satu konfigurasi penayangan 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 yang tersedia, respons list akan menyertakan token halaman. Anda dapat meneruskan token halaman di 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 Retail atau API.

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

Menghapus konfigurasi penayangan di konsol

Untuk menghapus konfigurasi penayangan di konsol:

1. Buka halaman Serving Configs di konsol Penelusuran untuk Retail.
   
   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 penayangan

Anda dapat melihat detail untuk setiap konfigurasi penayangan di halaman Konfigurasi Penayangan. Untuk konfigurasi apa pun di 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 menggunakan zona waktu Pasifik. Misalnya, statistik harian mewakili data dari kemarin pada tengah malam Waktu Pasifik hingga hari ini pada tengah malam Waktu Pasifik.