Mengelola konfigurasi penayangan

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

Untuk mendapatkan bantuan terkait cara membuat konfigurasi penayangan baru, lihat Membuat konfigurasi penayangan.

Jika Anda sudah memiliki penempatan, 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 Search for Retail console atau API.

Catatan: Jika Anda melakukan perubahan yang signifikan pada konfigurasi penayangan yang berisi model Pengoptimalan Tingkat Halaman, model Pengoptimalan Tingkat Halaman mungkin menampilkan hasil yang kurang optimal saat pelatihan ulang dilakukan. Karena diperlukan waktu lama untuk melatih ulang model Pengoptimalan Tingkat Halaman, pertimbangkan untuk membuat ulang model Pengoptimalan Tingkat Halaman dan konfigurasi penayangan terkaitnya.

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-nya, 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.

Diperlukan waktu beberapa menit agar konfigurasi penayangan yang baru dibuat atau diperbarui agar siap untuk menyalurkan traffic langsung. Anda dapat langsung menguji perubahan di halaman Evaluate.

Mengedit konfigurasi penayangan secara inline

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

Melakukan patch pada konfigurasi penayangan 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 inline

Untuk menambahkan kontrol ke konfigurasi penayangan, gunakan ServingConfig.addControl. Kontrol ditambahkan di posisi terakhir dari daftar kontrol yang dimilikinya. 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 agar tidak menayangkan konfigurasi 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'

Lihat konfigurasi penayangan

Anda dapat melihat konfigurasi penayangan menggunakan Search for Retail console atau API.

Melihat konfigurasi penayangan di konsol

Anda dapat melihat semua konfigurasi penayangan di halaman Konfigurasi Penayangan.

Lihat konfigurasi penayangan 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.

Anda juga dapat menggunakan parameter pageSize untuk menetapkan jumlah hasil maksimum yang akan ditampilkan. Jika tersedia 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 Search for Retail Console atau API.

Catatan: Jika Anda menghapus konfigurasi penayangan yang sedang digunakan oleh model Pengoptimalan Tingkat Halaman, hapus juga 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 Konfigurasi Penayangan di konsol Penelusuran Retail.
   
   Buka halaman Konfigurasi Penyajian

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

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

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

Menghapus inline konfigurasi penayangan

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 semua konfigurasi dalam tabel, klik Lihat analisis guna melihat statistiknya.

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

Catatan: Jangka 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.