Membuat konfigurasi penayangan

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:

  1. Buka halaman Konfigurasi Penayangan di konsol Penelusuran Retail.

    Buka halaman Konfigurasi Penyajian

  2. Klik Buat konfigurasi penayangan.

    rekomendasi

    1. Pilih Rekomendasi sebagai produk yang akan menggunakan konfigurasi penayangan.

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

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

    4. Pilih atau buat model yang akan diberikan rekomendasi oleh konfigurasi penayangan ini.

      Pelajari lebih lanjut cara membuat model baru.

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

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

    7. Pilih seberapa banyak untuk mendiversifikasi hasil rekomendasi.

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

    1. Di halaman Buat Konfigurasi Penayangan, pilih Telusuri sebagai produk yang akan menggunakan konfigurasi penayangan.
    2. 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.
    3. 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.
    4. Klik Lanjutkan.
    5. Pilih apakah akan mengaktifkan faset dinamis untuk konfigurasi penayangan ini atau tidak.
    6. Pilih atau buat kontrol penayangan untuk mengoptimalkan penelusuran Anda.

      Untuk mengetahui informasi selengkapnya tentang kontrol, lihat Membuat dan mengelola kontrol.
  3. 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.

  4. 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 untuk ServingConfig Anda. Nilai ini harus terdiri dari 4-63 karakter. Karakter yang valid adalah /[a-z][0-9]-_/.
  • displayName: Wajib diisi. Nama ServingConfig 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 adalah no-price-reranking (nilai default jika tidak disetel), low-price-raranking, medium-price-reranking, dan high-price-reranking.
  • diversityLevel: Opsional. Menetapkan seberapa banyak yang akan mendiversifikasi hasil rekomendasi. Nilai yang diizinkan adalah no-diversity (default), low-diversity, medium-diversity, high-diversity, dan auto-diversity. Jika diversityLevel tidak ditetapkan, keberagaman akan dinonaktifkan.
  • diversityType: Opsional. Tetapkan ke RULE_BASED_DIVERSITY untuk mendiversifikasi hasil rekomendasi berdasarkan kategori produk. Tetapkan ke DATA_DRIVEN_DIVERSITY untuk mendiversifikasi rekomendasi berdasarkan pembelajaran dari metadata produk untuk menyeimbangkan relevansi dan keberagaman kategori. Jika diversityLevel ditetapkan tetapi diversityType 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 adalah relaxed-category-match (nilai default jika tidak ditetapkan) dan no-category-match.
  • solutionTypes: Wajib diisi. Tetapkan ke SOLUTION_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 untuk ServingConfig Anda. Nilai ini harus terdiri dari 4-63 karakter. Karakter yang valid adalah /[a-z][0-9]-_/.
  • displayName: Wajib diisi. Nama ServingConfig yang dapat dibaca manusia dan ditampilkan di Search for Retail console.
  • facetControlIds: Opsional. ID kontrol yang hanya memiliki FacetSpec set.
  • dynamicFacetSpec.mode: Opsional. Mode fitur DynamicFacet. Nilai yang diizinkan adalah DISABLED (default jika tidak ditetapkan) dan ENABLED.
  • 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 ke SOLUTION_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