Meningkatkan dan menyembunyikan rekomendasi media

Halaman ini menjelaskan cara mengubah posisi peringkat rekomendasi media yang ditampilkan oleh model menggunakan kontrol penayangan peningkat (juga disebut kontrol).

Kontrol peningkat mengubah urutan rekomendasi setelah rekomendasi tersebut ditampilkan oleh model. Anda menerapkan ekspresi filter ke hasil untuk mengidentifikasi rekomendasi mana yang ingin Anda tingkatkan atau sembunyikan, lalu Anda menerapkan nilai peningkatan antara -1 dan +1. Nilai peningkat +1 memberikan peningkatan terbesar pada rekomendasi, sehingga menempatkannya di bagian atas rekomendasi yang ditampilkan. Nilai -1 mengubur rekomendasi di bagian bawah daftar rekomendasi yang ditampilkan.

Peningkatan adalah kontrol waktu penayangan. Pertama, model rekomendasi menampilkan daftar rekomendasi. Dengan menggunakan konfigurasi penayangan, kontrol peningkatannya kemudian diterapkan ke daftar tersebut untuk menyesuaikan peringkat rekomendasi. Kontrol peningkatan tidak menambahkan atau menghapus rekomendasi, tetapi mengontrol urutan rekomendasi ditampilkan kepada pengguna.

Meningkatkan versus memfilter rekomendasi

Peningkatan adalah filter lembut. Sementara itu, filter reguler untuk rekomendasi, yang dijelaskan dalam Memfilter rekomendasi adalah filter keras.

Jika Anda menerapkan filter berat pada rekomendasi, Anda tidak akan pernah melihat dokumen yang difilter. Namun, dengan filter ringan, Anda tidak menghapus dokumen dari daftar rekomendasi. Sebagai gantinya, filter digunakan untuk menentukan dokumen mana yang harus berada di posisi lebih tinggi atau lebih rendah dalam daftar rekomendasi yang ditampilkan.

Menghindari membanjiri model rekomendasi Anda

Saat menerapkan filter naikkan atau turunkan, sebaiknya gunakan nilai kecil yang mendekati nol. Nilai yang mendekati +1 atau -1 cenderung membebani model rekomendasi, sehingga peringkat rekomendasi yang diterapkan oleh model tidak tercermin dalam urutan rekomendasi yang dilihat pengguna.

Misalnya, jika Anda meningkatkan film animasi dengan +1, pengguna hanya akan melihat film animasi di bagian atas daftar rekomendasi; hal ini akan mendorong film non-animasi yang sangat direkomendasikan oleh model ke bagian bawah daftar tempat pengguna mungkin tidak melihatnya.

Menurunkan peringkat versus menyembunyikan

Menurunkan dan menyembunyikan rekomendasi pemindahan akan memindahkan rekomendasi tersebut ke posisi yang lebih rendah dalam daftar rekomendasi yang ditampilkan.

Namun, penurunan peringkat didasarkan pada usia konten atau apakah pengguna telah menonton sebagian konten. Untuk mengetahui informasi selengkapnya tentang penurunan promosi, lihat Menurunkan promosi rekomendasi media.

Menyembunyikan berlaku untuk konten yang diidentifikasi oleh filter. Filter dapat berupa kolom data apa pun yang ditandai sebagai dapat difilter dalam skema. Untuk informasi umum tentang filter rekomendasi, termasuk cara menandai kolom sebagai dapat difilter, lihat Memfilter rekomendasi.

Tentang kontrol peningkat dan konfigurasi inferensi

Setiap kontrol penayangan peningkat terdiri dari filter dan nilai peningkat. Misalnya, satu kontrol peningkat menaikkan film dengan judul yang mengandung kata Natal dengan nilai 0.1 dan kontrol peningkat lainnya menyembunyikan film horor dengan nilai -0.2.

Setelah membuat satu atau beberapa kontrol pendorong, Anda melampirkan kontrol ke konfigurasi penayangan. Saat aplikasi Vertex AI Search dibuat, konfigurasi penayangan default juga akan otomatis dibuat. Konfigurasi penayangan dirujuk pada waktu penayangan untuk menentukan hasil yang dihasilkan aplikasi. Selain kontrol peningkat, konfigurasi penayangan dapat berisi jenis kontrol lain, seperti kontrol diversifikasi dan penurunan.

Konfigurasi penayangan dapat diterapkan saat Anda memanggil metode rekomendasi. Semua kontrol dalam konfigurasi penayangan kemudian diterapkan ke rekomendasi yang ditampilkan oleh panggilan metode.

Selain itu, Anda dapat memiliki beberapa konfigurasi penayangan yang terkait dengan aplikasi Anda. Hal ini memungkinkan Anda menerapkan berbagai set kontrol dalam berbagai keadaan. Misalnya, jika permintaan rekomendasi berasal dari akun anak, tingkatkan film dalam kategori yang sesuai untuk anak-anak dan sembunyikan film yang tidak sesuai. Demikian pula, jika permintaan berasal dari akun yang ditandai sebagai akun dewasa, promosikan judul atau kategori yang populer di kalangan dewasa. Atau, Anda dapat memilih untuk memiliki konfigurasi penayangan yang berbeda untuk lokasi geografis yang berbeda dan meningkatkan konten sesuai dengan konten yang populer di wilayah tersebut. Untuk mengetahui informasi selengkapnya tentang konfigurasi penayangan, lihat Membuat dan mengelola konfigurasi penayangan media.

Nilai penguatan bersifat menambah

Jika Anda telah melampirkan beberapa kontrol penayangan ke konfigurasi penayangan, peningkatan dan penyembunyian akan bersifat aditif.

Misalnya, jika Anda meningkatkan film animasi anak-anak sebesar 0,3 dan film petualangan animasi sebesar 0,4, maka film yang dikategorikan sebagai film petualangan animasi anak-anak akan ditingkatkan sebesar 0,7.

Demikian pula, jika film horor ditingkatkan sebesar 0,2 oleh satu kontrol dan diturunkan sebesar -0,3 oleh kontrol lain dalam konfigurasi penayangan yang sama, hasil bersihnya adalah menurunkan film sebesar -0,1.

Jumlah peningkat dapat melebihi +1. Misalnya, jika kontrol meningkatkan film animasi anak-anak sebesar 0,6 dan film petualangan animasi sebesar 0,5, maka film petualangan animasi anak-anak akan ditingkatkan sebesar +1,1.

Contoh filter

Berikut beberapa contoh filter untuk rekomendasi media.

Filter pada properti kunci umum

Contoh filter pada properti string kunci umum (category, image_name, image_uri, language, title, dan uri).

• Animasi untuk anak-anak:
  "filter": "categories: ANY(\"animation\") AND categories: ANY(\"children\")"

• Media menakutkan:
  "filter": "categories: ANY(\"horror\", \"thriller\", \"crime\")

• Media dengan judul "Christmas":
  "filter": "title: ANY(\"Christmas\")"

• Media dengan item pertama dalam array images yang memiliki name "bola pantai":
  "filter": "images[0].name: ANY(\"beach ball\")"

Filter pada properti utama media

Contoh filter pada properti utama media. Properti tombol media diawali dengan media_, dan, dalam sintaksis filter, nama kolom diawali dengan media_key_properties.. Untuk mengetahui daftar properti tombol media, lihat Skema yang telah ditentukan Google versus skema kustom.

• Media dengan jenis audio:
  "filter": "media_key_properties.media_type: ANY(\"audio\")"

• Media dengan array hash_tags yang berisi string #winter:
  "filter": "media_key_properties.hash_tags: ANY(\"#winter\")"

• Media dengan elemen pertama array hash_tags adalah string #winter:
  "filter": "media_key_properties.hash_tags[0]: ANY(\"#winter\")"

Kolom kustom

Contoh filter pada kolom kustom. Untuk atribut khusus, awali nama kolom dengan attributes..

• Anda memiliki kolom string kustom, festival, dalam skema untuk merepresentasikan festival film tempat film ditayangkan perdana. Untuk memfilter hanya film yang ditayangkan perdana di Cannes:
  "filter": "attributes.festival: ANY(\"Cannes\")

• Anda memiliki kolom boolean kustom, audio_desc, yang bernilai benar jika media menyertakan deskripsi audio untuk penonton tunanetra. Untuk memfilter media dengan deskripsi audio:
  "filter": "attributes.audio_desc: ANY(true)"

Batasan pada kolom yang dapat difilter

Batasan berikut berlaku untuk kontrol penayangan promosi:

• Hanya kolom properti jenis string dan boolean yang dapat digunakan dalam ekspresi filter untuk peningkat.

• Anda tidak dapat memfilter kolom yang bertingkat lebih dari satu tingkat. Misalnya, Anda dapat memfilter persons.name, tetapi Anda tidak dapat memfilter kolom persons.name.stage (meskipun kolom tersebut ada).

• Filter harus berupa kecocokan persis. Artinya, dalam contoh, film yang berjudul "Christmas Story" atau "CHRISTMAS" tidak akan dipromosikan.

Sebelum memulai

• Pastikan Anda telah membuat aplikasi rekomendasi media dan penyimpanan data. Untuk mengetahui informasi selengkapnya, lihat Membuat aplikasi rekomendasi media dan penyimpanan data.

• Opsional: Jika Anda tidak ingin menggunakan konfigurasi penayangan default, buat konfigurasi penayangan baru dengan mengikuti langkah 1-5 dan 7 di Membuat konfigurasi penayangan. Jika aplikasi Anda dalam produksi, Google merekomendasikan agar Anda membuat konfigurasi penayangan terpisah untuk menguji kontrol peningkat sebelum menerapkan kontrol ke konfigurasi penayangan produksi.

• Pastikan semua kolom yang ingin Anda gunakan dalam kontrol peningkat ditandai sebagai Dapat difilter dalam skema. Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi setelan kolom. Lihat juga Batas pemfilteran.

Mempromosikan atau menyembunyikan rekomendasi

Prosedur ini menjelaskan cara membuat kontrol pendorong dan melampirkan kontrol ke konfigurasi penayangan.

Setelah kontrol dilampirkan ke konfigurasi penayangan, Anda dapat menentukan konfigurasi penayangan saat memanggil metode servingConfigs.recommend dan kontrol peningkat akan digunakan untuk memengaruhi urutan rekomendasi yang ditampilkan.

Memperbarui kontrol peningkat

Prosedur ini menjelaskan cara memperbarui kontrol pendorong yang ada untuk mengubah nilai pendorong atau filter.

Setelah menguji kontrol peningkat, Anda mungkin ingin membuat peningkat lebih kuat atau lebih lemah. Atau, Anda dapat mengubah string filter.

Saat memperbarui nilai atau filter peningkat, Anda memanggil metode engines.controls.patch.

Metode patch menggantikan nilai boost dan filter dengan nilai baru yang Anda berikan. Prosedur ini menunjukkan cara mengedit nilai boost (langkah 3) dan nilai filter (langkah 4) secara terpisah. Namun, jika Anda ingin mengedit keduanya, Anda dapat melakukannya dalam satu perintah curl.

Menghapus kontrol peningkat

Prosedur ini menjelaskan cara menghapus kontrol peningkat. Jika Anda tidak menggunakan kontrol peningkat, sebaiknya hapus kontrol tersebut agar Anda tidak mencapai atau melampaui kuota untuk jumlah kontrol yang diizinkan.

Saat menghapus kontrol peningkat, Anda memanggil metode engines.controls.delete.

Kontrol peningkat yang terlampir pada konfigurasi penayangan tidak dapat dihapus. Jika Anda mencoba menghapus kontrol peningkat, pesan error akan memberi Anda nama konfigurasi penayangan. Kemudian, Anda perlu menghapus konfigurasi penyaluran tersebut atau melepaskan kontrol tersebut dari konfigurasi penyaluran.

Memperbarui konfigurasi penayangan untuk menghapus kontrol peningkat

Sebelum dapat menghapus kontrol peningkat, Anda harus melepaskannya dari semua kontrol penayangan. Lakukan ini dengan memperbaiki kontrol penayangan untuk menghapus ID kontrol peningkatan.

Untuk melepaskan kontrol peningkat dari konfigurasi penayangan, ikuti langkah-langkah berikut:

1. Cari tahu kontrol peningkat yang dilampirkan ke konfigurasi penayangan dengan membuat permintaan engines.servingConfigs.get dan melihat kolom boostControlIds dalam respons.

   curl -X GET \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   -H "X-Goog-User-Project: PROJECT_ID" \
   "https://discoveryengine.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/servingConfigs/CONFIG_ID"
   

   Ganti kode berikut:

   • PROJECT_ID: ID Google Cloud project Anda.

   • APP_ID: ID aplikasi Vertex AI Search.

   • CONFIG_ID: ID konfigurasi penayangan yang ingin Anda ketahui lebih lanjut.

   Contoh perintah dan hasil

   curl -X GET \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   -H "X-Goog-User-Project: my-project-123" \
   "https://discoveryengine.googleapis.com/v1beta/projects/my-project-123/locations/global/collections/default_collection/engines/my-app/servingConfigs/my_app-1234567_id"
   

   {
     "name": "projects/123456/locations/global/collections/default_collection/engines/my-app/servingConfigs/my_app-1234567_id",
     "displayName": "jane-day-test-serving-config-for-boost-bury",
     "solutionType": "SOLUTION_TYPE_RECOMMENDATION",
     "modelId": "my-app",
     "diversityLevel": "no-diversity",
     "diversityType": "RULE_BASED_DIVERSITY",
     "mediaConfig": {},
     "createTime": "2024-11-22T23:54:45.613178Z",
     "updateTime": "2024-11-26T20:28:11.967439Z",
     "boostControlIds": [
       "boost-kids",
       "bury-horror"
     ]
   }
   

   Perintah ini mencantumkan informasi tentang konfigurasi penayangan my_app-1234567_id, khususnya, perintah ini menunjukkan bahwa konfigurasi penayangan memiliki dua kontrol peningkat yang terlampir: boost-kids dan bury-horror.

2. Untuk memperbarui konfigurasi penayangan guna menghapus satu kontrol peningkat, gunakan metode engines.servingConfigs.patch.

   curl -X PATCH -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   -H "X-Goog-User-Project: PROJECT_ID" \
   "https://discoveryengine.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/servingConfigs/CONFIG_ID?update_mask=boost_control_ids" \
   -d '{
     "boostControlIds": ["CONTROL_ID"]
   }'
   

   Ganti kode berikut:

   • CONFIG_ID: ID konfigurasi penayangan yang ingin Anda lampirkan kontrol peningkatannya—misalnya, my_app-1234567_id. Lihat langkah sebelumnya.

   • CONTROL_ID: berisi ID satu atau beberapa kontrol peningkat yang Anda inginkan untuk dimiliki oleh konfigurasi penayangan. Pastikan untuk menghapus kontrol peningkat yang ingin Anda hapus. Ini adalah array string. Jika Anda memiliki lebih dari satu ID, jangan lupa untuk menggunakan tanda petik dan koma sebagai pemisah—misalnya, boost-1", "boost-2.

   Contoh perintah dan hasilnya: meninggalkan satu kontrol

   curl -X PATCH \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   -H "X-Goog-User-Project: my-project-123" \
   "https://discoveryengine.googleapis.com/v1beta/projects/my-project-123/locations/global/collections/default_collection/engines/my-app/servingConfigs/my_app-1234567_id?update_mask=boost_control_ids" \
   -d '{
     "boostControlIds": ["bury-horror"]
   }'
   

   {
     "name": "projects/123456/locations/global/collections/default_collection/engines/my-app/servingConfigs/my_app-1234567_id",
     "displayName": "jane-day-test-serving-config-for-boost-bury",
     "solutionType": "SOLUTION_TYPE_RECOMMENDATION",
     "modelId": "my-app",
     "diversityLevel": "no-diversity",
     "diversityType": "RULE_BASED_DIVERSITY",
     "mediaConfig": {},
     "boostControlIds": [
       "bury-horror"
     ]
   }
   

   Perintah ini mempertahankan kontrol peningkat bury-horror yang terlampir ke konfigurasi penayangan dan menghapus kontrol boost-kids. Dengan asumsi bahwa boost-kids tidak dilampirkan ke konfigurasi penayangan lainnya, boost-kids kini dapat dihapus. Lihat Menghapus kontrol peningkat.

   Contoh perintah dan hasilnya: menghapus semua kontrol

   curl -X PATCH \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   -H "X-Goog-User-Project: my-project-123" \
   "https://discoveryengine.googleapis.com/v1beta/projects/my-project-123/locations/global/collections/default_collection/engines/my-app/servingConfigs/my_app-1234567_id?update_mask=boost_control_ids" \
   -d '{
   "boostControlIds": []
   }'
   

   {
   "name": "projects/123456/locations/global/collections/default_collection/engines/my-app/servingConfigs/my_app-1234567_id",
   "displayName": "jane-day-test-serving-config-for-boost-bury",
   "solutionType": "SOLUTION_TYPE_RECOMMENDATION",
   "modelId": "my-app",
   "diversityLevel": "no-diversity",
   "diversityType": "RULE_BASED_DIVERSITY",
   "mediaConfig": {}
   }
   

   Perintah ini menghapus semua kontrol peningkat dari konfigurasi penayangan, my_app-1234567_id