Halaman ini menjelaskan cara membuat konfigurasi penayangan. Konfigurasi penayangan adalah entitas penayangan yang mengaitkan model atau kumpulan kontrol yang digunakan untuk membuat hasil penelusuran atau rekomendasi Anda.
Sebelum memulai
Rekomendasi dan konfigurasi penayangan penelusuran memiliki persyaratan dan opsi yang berbeda:
rekomendasi yang menyajikan konfigurasi memerlukan model. Jika Anda ingin menambahkan model yang sudah ada ke konfigurasi penayangan baru, dapatkan ID model yang ingin digunakan (diperlukan saat menggunakan metode
ServingConfig.create
).Jika membuat konfigurasi penayangan menggunakan konsol, Anda dapat membuat model baru selama proses pembuatan, bukan menambahkan model yang sudah ada.
Anda dapat beralih model nanti, selama jenis model tersebut sama.
penelusuran dapat menggunakan kontrol penayangan, tetapi tidak wajib. Jika Anda berencana untuk menambahkan kontrol yang sudah ada ke konfigurasi penayangan baru, dapatkan ID kontrol yang ingin digunakan.
Jika membuat konfigurasi penayangan menggunakan konsol, Anda juga dapat membuat kontrol baru selama proses pembuatan.
Anda dapat beralih atau menambahkan kontrol penayangan ke konfigurasi penayangan setelah membuatnya.
Membuat konfigurasi penayangan
Anda dapat membuat konfigurasi penayangan menggunakan:
Hingga 100 konfigurasi penayangan diizinkan per katalog.
Jika Anda memiliki penempatan yang ada, atau membuat penempatan baru, konfigurasi penayangan yang terkait dengan setiap penempatan akan dibuat secara otomatis. Membuat konfigurasi penayangan tidak membuat penempatan yang sesuai. Menghapus konfigurasi penayangan akan menghapus penempatannya yang sesuai, dan menghapus penempatan akan menghapus konfigurasi penayangan terkait.
Membuat konfigurasi penayangan di konsol
Tambahkan konfigurasi penayangan baru di halaman Konfigurasi Penayangan di Konsol Penelusuran Retail.
Untuk membuat konfigurasi penayangan baru:
Buka halaman Konfigurasi Penayangan di konsol Penelusuran Retail.
Buka halaman Konfigurasi PenyajianKlik add_boxBuat konfigurasi penayangan.
rekomendasi
Pilih Rekomendasi sebagai produk yang akan menggunakan konfigurasi penayangan.
Berikan nama untuk konfigurasi penayangan Anda.
Nama harus terdiri dari maksimal 1.024 karakter, dan hanya boleh berisi karakter alfanumerik, garis bawah, tanda hubung, dan spasi.
Opsional: Jika perlu, perbarui ID.
ID dibuat dari nama yang Anda berikan, dan harus unik di seluruh project. Panjangnya harus 50 karakter atau kurang, dan tidak boleh berisi spasi.
Pilih atau buat model yang akan diberikan rekomendasi oleh konfigurasi penayangan ini.
Pelajari lebih lanjut cara membuat model baru.
Pilih seberapa besar pengurutan ulang harga akan memengaruhi hasil rekomendasi, jika tersedia untuk model yang Anda pilih.
Pengurutan ulang harga menyebabkan produk yang direkomendasikan dengan probabilitas rekomendasi serupa diurutkan berdasarkan harga, dengan item dengan harga tertinggi terlebih dahulu. Relevansi juga masih digunakan untuk mengurutkan item, sehingga mengaktifkan pengurutan ulang harga tidak sama dengan mengurutkan berdasarkan harga.
Pilih apakah akan menggunakan diversifikasi berbasis aturan atau berbasis data:
Berbasis aturan: Diversifikasi berbasis aturan memengaruhi apakah hasil yang ditampilkan dari satu permintaan prediksi berasal dari berbagai kategori katalog produk Anda.
Berbasis data: Diversifikasi berbasis data menggunakan machine learning untuk menyeimbangkan keberagaman kategori dan relevansi dalam hasil prediksi Anda.
Untuk mengetahui informasi lebih lanjut, lihat Diversifikasi.
Pilih seberapa banyak untuk mendiversifikasi hasil rekomendasi.
Jika Anda memilih model Item Serupa untuk konfigurasi penayangan ini, pilih apakah akan mengaktifkan pencocokan kategori atau tidak.
Jika pencocokan kategori diaktifkan, satu-satunya hasil produk yang ditampilkan adalah hasil yang memiliki setidaknya satu kategori yang sama dengan produk konteks. Pencocokan kategori dapat digunakan bersama opsi pemfilteran lainnya, seperti tag harga, ketersediaan, dan filter.
penelusuran
- Di halaman Buat Konfigurasi Penayangan, pilih Telusuri sebagai produk yang akan menggunakan konfigurasi penayangan.
- Beri nama untuk konfigurasi penayangan Anda.
Nama harus terdiri dari 1.024 karakter atau kurang, dan hanya dapat berisi karakter alfanumerik, garis bawah, tanda hubung, dan spasi. - Opsional: Jika diperlukan, perbarui ID.
ID dibuat dari nama yang Anda berikan, dan harus unik di seluruh project. Panjangnya harus 50 karakter atau kurang, dan tidak boleh berisi spasi. - Klik Lanjutkan.
- Pilih apakah akan mengaktifkan faset dinamis untuk konfigurasi penayangan ini atau tidak.
- Pilih atau buat kontrol penayangan untuk mengoptimalkan penelusuran Anda.
Untuk mengetahui informasi selengkapnya tentang kontrol, lihat Membuat dan mengelola kontrol.
Klik Create untuk membuat konfigurasi baru.
Konfigurasi baru akan muncul di halaman Konfigurasi Penayangan.
Mungkin perlu waktu beberapa menit hingga konfigurasi tersedia untuk digunakan dalam permintaan penelusuran. Fitur ini langsung tersedia untuk direkomendasikan.
Opsional: Di halaman Serve Configs, klik nama konfigurasi penayangan, lalu buka tab Evaluate untuk melihat pratinjau produk yang akan ditampilkan untuk konfigurasi ini.
Pratinjau evaluasi dapat membantu Anda mengonfirmasi bahwa konfigurasi berperforma seperti yang diharapkan.
Membuat konfigurasi penayangan dengan ServingConfig.create
Anda dapat membuat konfigurasi penayangan dengan metode API
ServingConfig.create
. Untuk dokumentasi referensi API terkait metode ini, lihat ServingConfig.create
.
Kolom yang digunakan bergantung pada apakah Anda membuat konfigurasi penayangan untuk rekomendasi atau penelusuran.
Untuk detail selengkapnya tentang kolom ServingConfig
, lihat
referensi API ServingConfigs
.
rekomendasi
Buat permintaan ServingConfig.create
dengan ID konfigurasi penayangan dan
instance ServingConfig
yang terdapat dalam isi permintaan.
servingConfigId
: Wajib diisi. Membuat ID untukServingConfig
Anda. Nilai ini harus terdiri dari 4-63 karakter. Karakter yang valid adalah/[a-z][0-9]-_/
.displayName
: Wajib diisi. NamaServingConfig
yang dapat dibaca manusia dan ditampilkan di Search for Retail console.modelID
: Wajib diisi. ID model yang akan digunakan pada waktu inferensi.priceRerankingLevel
: Opsional. Menetapkan seberapa besar pemeringkatan harga akan memengaruhi hasil rekomendasi. Nilai yang diizinkan adalahno-price-reranking
(nilai default jika tidak disetel),low-price-raranking
,medium-price-reranking
, danhigh-price-reranking
.diversityLevel
: Opsional. Menetapkan seberapa banyak yang akan mendiversifikasi hasil rekomendasi. Nilai yang diizinkan adalahno-diversity
(default),low-diversity
,medium-diversity
,high-diversity
, danauto-diversity
. JikadiversityLevel
tidak ditetapkan, keberagaman akan dinonaktifkan.diversityType
: Opsional. Tetapkan keRULE_BASED_DIVERSITY
untuk mendiversifikasi hasil rekomendasi berdasarkan kategori produk. Tetapkan keDATA_DRIVEN_DIVERSITY
untuk mendiversifikasi rekomendasi berdasarkan pembelajaran dari metadata produk untuk menyeimbangkan relevansi dan keberagaman kategori. JikadiversityLevel
ditetapkan tetapidiversityType
tidak ditetapkan,diversityType
akan ditetapkan secara default ke berbasis aturan. Untuk mengetahui informasi lebih lanjut, lihat Diversifikasi.enableCategoryFilterLevel
: Opsional. Menetapkan apakah akan menambahkan filter kategori tambahan pada model Item Serupa. Nilai yang diizinkan adalahrelaxed-category-match
(nilai default jika tidak ditetapkan) danno-category-match
.solutionTypes
: Wajib diisi. Tetapkan keSOLUTION_TYPE_RECOMMENDATION
untuk rekomendasi yang menyajikan konfigurasi.
curl -X POST \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ --data '{ "displayName": "DISPLAY_NAME", "modelId": "MODEL_ID", "priceRerankingLevel": "PRICE_RERANKING_LEVEL", "diversityType": "DIVERSITY_TYPE", "diversityLevel": "DIVERSITY_LEVEL", "enableCategoryFilterLevel": "CATEGORY_FILTER_LEVEL", "solutionTypes": [ "SOLUTION_TYPE_RECOMMENDATION" ] }' \ "https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/servingConfigs?servingConfigId=SERVING_CONFIG_ID"
penelusuran
Buat permintaan ServingConfig.create
dengan ID konfigurasi penayangan dan
instance ServingConfig
yang terdapat dalam isi permintaan.
servingConfigId
: Wajib diisi. Membuat ID untukServingConfig
Anda. Nilai ini harus terdiri dari 4-63 karakter. Karakter yang valid adalah/[a-z][0-9]-_/
.displayName
: Wajib diisi. NamaServingConfig
yang dapat dibaca manusia dan ditampilkan di Search for Retail console.facetControlIds
: Opsional. ID kontrol yang hanya memilikiFacetSpec
set.dynamicFacetSpec.mode
: Opsional. Mode fiturDynamicFacet
. Nilai yang diizinkan adalahDISABLED
(default jika tidak ditetapkan) danENABLED
.boostControlIds
: Opsional. ID peningkatan kontrol penayangan.filterControlIds
: Opsional. ID kontrol penayangan filter.redirectControlIds
: Opsional. ID kontrol penayangan pengalihan.twowaySynonymsControlIds
: Opsional. ID sinonim dua arah yang menyajikan kontrol.onewaySynonymsControlIds
: Opsional. ID sinonim satu arah yang menyajikan kontrol.doNotAssociateControlIds
: Opsional. ID kontrol penayangan yang tidak dikaitkan.replacementControlIds
: Opsional. ID kontrol penayangan pengganti.ignoreControlIds
: Opsional. ID kontrol penayangan abaikan.solutionTypes
: Wajib diisi. Tetapkan keSOLUTION_TYPE_SEARCH
untuk menelusuri konfigurasi penayangan.
curl -X POST \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ --data '{ "displayName": DISPLAY_NAME, "facetControlIds": [ "FACET_CONTROL_ID_1", "FACET_CONTROL_ID_2" ], "dynamicFacetSpec": { "mode": "DYNAMIC_FACET_MODE" }, "boostControlIds": [ "BOOST_CONTROL_ID_1", "BOOST_CONTROL_ID_2" ], "filterControlIds": [ "FILTER_CONTROL_ID_1", "FILTER_CONTROL_ID_2" ], "redirectControlIds": [ "REDIRECT_CONTROL_ID_1", "REDIRECT_CONTROL_ID_2" ], "twowaySynonymsControlIds": [ "TWO_WAY_SYNONYM_CONTROL_ID_1", "TWO_WAY_SYNONYM_CONTROL_ID_2" ], "onewaySynonymsControlIds": [ "ONE_WAY_SYNONYM_CONTROL_ID_1", "ONE_WAY_SYNONYM_CONTROL_ID_2" ], "doNotAssociateControlIds": [ "DO_NOT_ASSOCIATE_CONTROL_ID_1", "DO_NOT_ASSOCIATE_CONTROL_ID_2" ], "replacementControlIds": [ "REPLACEMENT_CONTROL_ID_1", "REPLACEMENT_CONTROL_ID_2" ], "ignoreControlIds": [ "IGNORE_CONTROL_ID_1", "IGNORE_CONTROL_ID_2" ], "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ] }' \ "https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/servingConfigs?servingConfigId=SERVING_CONFIG_ID"
Langkah berikutnya
- Meminta prediksi dari penempatan baru Anda.