Mengelola kontrol penayangan

Halaman ini menjelaskan cara melihat, mengedit, menghapus, mengekspor, dan mengimpor kontrol penayangan.

Untuk mengetahui informasi umum tentang kontrol penayangan dan petunjuk cara membuat kontrol penayangan, lihat artikel Tentang kontrol penayangan dan Membuat kontrol penayangan.

Lihat dan edit kontrol penayangan

Anda dapat melihat kontrol penayangan untuk Vertex AI Search untuk retail menggunakan konsol dan API.

Lihat dan edit kontrol penayangan di konsol

Tab Kontrol Penayangan di halaman Kontrol mencantumkan semua kontrol penayangan Anda dan konfigurasi penayangan yang terkait. Klik ikon Edit control untuk kontrol guna mengubah setelannya dan konfigurasi penayangan terkait di panel Edit control. Klik ikon Hapus kontrol untuk kontrol yang akan menghapusnya, yang juga akan menghapusnya dari semua konfigurasi penayangan.

Anda juga dapat melihat dan mengedit kontrol untuk konfigurasi penayangan tertentu di halaman Konfigurasi Penayangan. Klik konfigurasi penayangan untuk melihat halaman Details-nya, yang mencantumkan semua kontrol penayangan untuk konfigurasi tersebut. Klik ikon Edit control untuk kontrol guna mengubah setelannya di panel Edit control. Klik ikon Hapus kontrol untuk memisahkan kontrol dari konfigurasi penayangan (tindakan ini tidak menghapus kontrol).

Perlu waktu beberapa menit agar kontrol yang baru dibuat atau diperbarui agar siap untuk menyalurkan traffic langsung. Anda dapat menguji apakah perubahan telah diterapkan di halaman Evaluate konsol.

Lihat kontrol penayangan inline

Untuk melihat satu kontrol penayangan secara inline, gunakan Control.get.

Untuk mengetahui informasi selengkapnya tentang metode ini, lihat Referensi API Control.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/controls/CONTROL_ID'

Untuk mencantumkan beberapa kontrol penayangan secara inline, gunakan Controls.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 mencantumkan hanya kontrol yang terkait dengan konfigurasi penayangan tertentu, gunakan parameter kueri filter untuk menentukan ID konfigurasi penayangan.

Untuk mengetahui informasi selengkapnya tentang metode ini, lihat Referensi API Control.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/controls?pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN&filter=servingConfig=SERVING_CONFIG_ID

Mem-patch kontrol penayangan secara inline

Untuk memperbarui kolom dalam kontrol penayangan, gunakan Controls.patch dan sertakan instance Control 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 Controls.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/controls/CONTROL_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/controls/CONTROL_ID?updateMask=FIELD_NAME_1,FIELD_NAME_2'

Menambahkan kontrol ke konfigurasi penayangan inline

Untuk menambahkan kontrol ke konfigurasi penayangan, gunakan ServingConfig.addControl.

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

Untuk contoh metode ini, lihat Mengelola konfigurasi penayangan.

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

Untuk contoh metode ini, lihat Mengelola konfigurasi penayangan.

Menghapus kontrol penayangan

Anda dapat menghapus kontrol penayangan dari konsol atau secara inline menggunakan metode Controls.delete.

Menghapus kontrol penayangan di konsol

Hapus kontrol penayangan untuk menghapus kontrol tersebut dari semua konfigurasi penayangan yang menggunakannya.

  1. Buka halaman Controls di Search for Retail console.

    Buka halaman Kontrol

  2. Di baris tabel kontrol yang ingin Anda hapus, klik Delete.

  3. Di jendela konfirmasi, klik Delete untuk menyelesaikan penghapusan.

Menghapus inline kontrol penayangan

Untuk menghapus kontrol penayangan secara inline, gunakan Controls.delete.

Untuk mengetahui informasi selengkapnya tentang metode ini, lihat Referensi API Controls.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/controls/SERVING_CONTROL_ID'

Ekspor kontrol penayangan

Anda dapat mengekspor kontrol penyaluran ke file di bucket Cloud Storage.

Ada dua alasan mengapa Anda mungkin ingin mengekspor dan mengimpor kontrol penayangan:

  • Untuk memindahkan kontrol penayangan dari satu project ke project lainnya.

  • Untuk melakukan pengeditan massal pada semua atau beberapa kontrol penayangan. Ekspor kontrol penayangan, edit file yang diekspor, lalu impor file untuk mengubah atau menambahkan kontrol penayangan.

Anda dapat mengekspor dan mengimpor melalui konsol Search for Retail. Saat mengekspor kontrol penayangan, Anda mengekspor semua kontrol penayangan dalam project.

Untuk mengekspor kontrol penayangan, lakukan tindakan berikut:

  1. Buka halaman Controls di Search for Retail console.

    Buka halaman Kontrol

  2. Di tab Kontrol penayangan, klik Kontrol ekspor.

  3. Di jendela Export Serve Controls, pilih bucket Cloud Storage tempat Anda ingin mengekspor file kontrol.

  4. Klik Ekspor.

    Kontrol yang diekspor disimpan ke file NDJSON di bucket yang dipilih dengan nama dalam format berikut:

    projects_PROJECT_ID_TIMESTAMP_exported_controls.ndjson
  5. Setelah operasi ekspor selesai, Anda dapat melihat status operasi di daftar Bulk import, export, delete activities di jendela Export activity. Buka jendela Export activity dengan mengklik Show di jendela pesan atau dengan mengikuti petunjuk di Melihat status untuk operasi integrasi tertentu.

Mengimpor kontrol penayangan

Untuk menambahkan kontrol penayangan atau mengubah yang ada secara massal, Anda dapat melakukan perubahan dalam file kontrol yang diekspor. Selanjutnya, Anda dapat mengimpornya ke project asli atau project yang berbeda.

Hal-hal yang perlu diketahui tentang cara mengimpor kontrol penayangan:

  • Anda tidak dapat mengimpor file kontrol penayangan jika file tersebut berisi kontrol penayangan penelusuran dan rekomendasi.

  • Saat Anda mengimpor kontrol penayangan, semua kontrol penayangan dalam file akan dikaitkan dengan konfigurasi penayangan yang Anda tentukan saat mengimpor. Jika kontrol penayangan sudah dikaitkan dengan konfigurasi penayangan lain dalam project, pengaitan tersebut juga akan dipertahankan.

Untuk mengimpor kontrol penayangan, lakukan tindakan berikut:

  1. Edit dan tinjau file kontrol penayangan yang diekspor, lalu tempatkan file tersebut dalam bucket Cloud Storage. (Untuk mengekspor kontrol penayangan, lihat tugas sebelumnya Mengekspor kontrol penayangan.)

    Pastikan file hanya berisi kontrol penayangan rekomendasi atau hanya kontrol penayangan rekomendasi. Anda tidak dapat mengimpor file yang berisi kedua jenis tersebut.

  2. Buka halaman Controls di Search for Retail console.

    Buka halaman Kontrol

  3. Di tab Kontrol penayangan, klik Kontrol impor.

  4. Di jendela Import Serve Controls:

    1. Jelajahi dan pilih bucket Cloud Storage dan file NDJSON yang berisi kontrol yang ingin Anda impor.

    2. Pilih konfigurasi penayangan yang ingin dikaitkan dengan kontrol penayangan yang diimpor.

    3. Tinjau rencana Pratinjau Impor. Kontrol yang akan dibuat ditampilkan di tab Baru dan kontrol yang akan diubah ditampilkan di tab Diubah.

  5. Klik Import.

    Operasi yang berjalan lama akan mulai mengimpor kontrol baru dan yang dimodifikasi.

  6. Setelah operasi impor selesai, Anda dapat melihat status operasi di tab Controls pada jendela Activity status. Buka jendela Activity status dengan mengklik Show di jendela pesan atau dengan mengikuti petunjuk di Melihat status untuk operasi integrasi tertentu.