Membuat konfigurasi inferensi

Halaman ini menjelaskan cara membuat konfigurasi penayangan. Konfigurasi penayangan adalah entitas penayangan yang mengaitkan model atau kumpulan kontrol yang digunakan untuk menghasilkan hasil penelusuran atau rekomendasi Anda.

Sebelum memulai

Rekomendasi dan konfigurasi penayangan penelusuran memiliki persyaratan dan opsi yang berbeda:

  • Konfigurasi penayangan rekomendasi memerlukan model. Jika Anda berencana untuk melampirkan model yang ada ke konfigurasi penayangan baru, dapatkan ID model yang ingin Anda gunakan (diperlukan saat menggunakan metode ServingConfig.create).

    Jika membuat konfigurasi penayangan menggunakan konsol, Anda dapat membuat model baru selama proses pembuatan, bukan melampirkan model yang ada.

    Anda dapat beralih model nanti, asalkan model tersebut memiliki jenis model yang sama.

  • Penelusuran dapat menggunakan kontrol penayangan, tetapi tidak wajib. Jika Anda berencana melampirkan kontrol yang ada ke konfigurasi penayangan baru, dapatkan ID kontrol yang ingin Anda gunakan.

    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 inferensi

Anda dapat membuat konfigurasi penayangan menggunakan:

Maksimal 100 konfigurasi penayangan diizinkan per katalog.

Jika Anda memiliki penempatan yang ada, atau membuat penempatan baru, konfigurasi penayangan yang terkait dengan setiap penempatan akan otomatis dibuat. 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.

Membuat konfigurasi penyajian di konsol

Tambahkan konfigurasi penayangan baru di halaman Konfigurasi Penayangan di konsol Penelusuran untuk Retail.

Untuk membuat konfigurasi penayangan baru:

  1. Buka halaman Serving Configs di konsol Penelusuran untuk Retail.

    Buka halaman Konfigurasi penayangan

  2. Klik Buat konfigurasi penayangan.

    Rekomendasi

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

    2. Berikan nama untuk konfigurasi penayangan Anda.

      Nama harus terdiri dari 1.024 karakter atau kurang, 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 Anda. Panjangnya harus 50 karakter atau kurang, dan tidak boleh berisi spasi.

    4. Pilih atau buat model yang Anda inginkan untuk rekomendasi konfigurasi penayangan ini.

      Pelajari lebih lanjut cara membuat model baru.

    5. Pilih seberapa besar pengaruh pengurutan ulang harga terhadap hasil rekomendasi, jika tersedia untuk model yang Anda pilih.

      Pengurutan ulang harga akan membuat produk yang direkomendasikan dengan rekomendasi serupa diurutkan menurut harga, dengan item berharga paling tinggi didahulukan. Relevansi juga masih digunakan untuk mengurutkan item, sehingga mengaktifkan pemeringkatan 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 kategori yang berbeda di katalog produk Anda.

      • Berbasis data: Diversifikasi berbasis data menggunakan machine learning untuk menyeimbangkan keberagaman dan relevansi kategori dalam hasil prediksi Anda.

      Untuk mengetahui informasi selengkapnya, lihat Diversifikasi.

    7. Pilih seberapa banyak Anda ingin mendiversifikasi hasil rekomendasi.

    8. Jika Anda memilih model Item Serupa untuk konfigurasi penayangan ini, pilih apakah akan mengaktifkan pencocokan kategori.

      Jika pencocokan kategori diaktifkan, satu-satunya hasil produk yang ditampilkan adalah produk yang memiliki setidaknya satu kategori dengan produk konteks. Pencocokan kategori dapat digunakan bersama dengan opsi pemfilteran lainnya, seperti harga, ketersediaan, dan tag filter.

    1. Di halaman Create Serving Config, pilih Search sebagai produk yang akan menggunakan konfigurasi penayangan.
    2. Berikan nama untuk konfigurasi penayangan Anda.

      Nama harus berisi 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 Anda. Panjangnya harus 50 karakter atau kurang, dan tidak boleh berisi spasi.
    4. Klik Lanjutkan.
    5. Pilih apakah akan mengaktifkan pembuatan susunan facet dinamis untuk konfigurasi penayangan ini.
    6. Pilih atau buat kontrol penayangan untuk mengoptimalkan penelusuran Anda.

      Untuk 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. Data ini langsung tersedia untuk rekomendasi.

  4. Opsional: Di halaman Konfigurasi Penayangan, klik nama konfigurasi penayangan dan buka tab Evaluasi untuk melihat pratinjau produk yang akan ditampilkan untuk konfigurasi ini.

    Pratinjau evaluasi dapat membantu Anda mengonfirmasi bahwa konfigurasi Anda berperforma seperti yang Anda harapkan.

Membuat konfigurasi penayangan dengan ServingConfig.create

Anda dapat membuat konfigurasi penayangan dengan metode API ServingConfig.create. Untuk dokumentasi referensi API untuk metode ini, lihat ServingConfig.create.

Kolom yang Anda gunakan bergantung pada apakah Anda membuat konfigurasi penayangan untuk rekomendasi atau penelusuran.

Untuk mengetahui 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 konsol Penelusuran untuk Retail.
  • modelID: Wajib diisi. ID model yang akan digunakan pada waktu penayangan.
  • priceRerankingLevel: Opsional. Menetapkan seberapa besar pengurutan ulang harga akan memengaruhi hasil rekomendasi. Nilai yang diizinkan adalah no-price-reranking (nilai default jika tidak ditetapkan), low-price-raranking, medium-price-reranking, dan high-price-reranking.
  • diversityLevel: Opsional. Menetapkan seberapa banyak untuk mendiversifikasi hasil rekomendasi. Nilai yang diizinkan adalah no-diversity (default), low-diversity, medium-diversity, high-diversity, dan auto-diversity. Jika diversityLevel tidak ditetapkan, keragaman 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 keragaman kategori. Jika diversityLevel ditetapkan, tetapi diversityType tidak ditetapkan, diversityType akan ditetapkan secara default ke berbasis aturan. Untuk mengetahui informasi selengkapnya, 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 konfigurasi penayangan rekomendasi.
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"

Telusuri

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 konsol Penelusuran untuk Retail.
  • facetControlIds: Opsional. ID kontrol yang hanya menetapkan FacetSpec.
  • dynamicFacetSpec.mode: Opsional. Mode fitur DynamicFacet. Nilai yang diizinkan adalah DISABLED (default jika tidak ditetapkan) dan ENABLED.
  • boostControlIds: Opsional. ID kontrol penayangan boost.
  • filterControlIds: Opsional. ID kontrol penayangan filter.
  • redirectControlIds: Opsional. ID kontrol penayangan pengalihan.
  • twowaySynonymsControlIds: Opsional. ID kontrol penayangan sinonim dua arah.
  • onewaySynonymsControlIds: Opsional. ID kontrol penayangan sinonim satu arah.
  • doNotAssociateControlIds: Opsional. ID kontrol penayangan jangan kaitkan.
  • replacementControlIds: Opsional. ID kontrol penayangan pengganti.
  • ignoreControlIds: Opsional. ID kontrol penayangan yang diabaikan.
  • solutionTypes: Wajib diisi. Tetapkan ke SOLUTION_TYPE_SEARCH untuk konfigurasi penayangan penelusuran.
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