Membuat kontrol inferensi

Halaman ini menjelaskan cara membuat kontrol penayangan.

Kontrol penayangan adalah aturan yang Anda tentukan dan terapkan ke setiap konfigurasi penayangan. Untuk informasi selengkapnya tentang konfigurasi penayangan, lihat Tentang konfigurasi penayangan.

Kontrol penayangan memungkinkan Anda membuat aturan yang menyesuaikan cara konfigurasi penayangan menayangkan hasil.

Anda dapat membuat kontrol penayangan di konsol Penelusuran untuk Retail yang terdiri dari kondisi, yang memicu kontrol, dan tindakan yang dilakukan saat kondisi dipicu. Kemudian, Anda dapat melampirkan kontrol penayangan baru ke konfigurasi penayangan.

Konfigurasi penayangan memiliki hubungan multi-ke-multi dengan kontrol. Anda dapat menambahkan beberapa kontrol ke konfigurasi penayangan, dan satu kontrol dapat dikaitkan dengan beberapa konfigurasi penayangan.

Saat membuat kontrol penayangan dan konfigurasi penayangan, Anda memilih produk (rekomendasi atau penelusuran) yang dapat digunakan. Kontrol penayangan hanya dapat dikaitkan dengan konfigurasi penayangan dari jenis produk yang sama. Misalnya, kontrol penayangan yang dibuat untuk rekomendasi tidak dapat dikaitkan dengan konfigurasi penayangan yang dibuat untuk penelusuran.

Konfigurasi penayangan mengelola kontrol yang diterapkan selama permintaan penelusuran atau prediksi. Hanya kontrol pada konfigurasi penayangan aktif untuk permintaan yang dipertimbangkan pada waktu penayangan. Misalnya, Anda telah membuat dua kontrol: kontrol bernama "gShoe Sale" yang meningkatkan hasil untuk merek gShoe saat "sepatu" ditelusuri dan kontrol bernama "More Shoes" yang memperluas kueri menggunakan istilah "sepatu lari" untuk menyertakan "sepatu olahraga". Jika Anda hanya melampirkan kontrol "gShoe Sale" ke konfigurasi penayangan, permintaan penelusuran yang menggunakan konfigurasi penayangan tersebut akan meningkatkan hasil gShoe untuk kueri yang menggunakan istilah "sepatu", tetapi kontrol "More Shoes" tidak akan berpengaruh karena tidak disertakan ke konfigurasi penayangan yang Anda gunakan.

Anda dapat membuat kontrol, lalu menambahkan atau menukarnya ke konfigurasi penayangan live.

Buat atau ubah kontrol penayangan kapan saja di halaman Kontrol atau secara inline menggunakan metode Controls.create. Di konsol, Anda dapat membuat kontrol secara opsional selama proses pembuatan konfigurasi penayangan.

Anda dapat membuat hingga 100 kontrol penayangan. Jika Anda memerlukan lebih banyak kontrol penayangan, minta kuota tambahan. Untuk mengetahui cara meminta kuota tambahan, lihat Meningkatkan kuota. Konfigurasi penayangan dapat memiliki hingga 100 kontrol penayangan dari jenis apa pun selain kontrol pengalihan, yang batasnya adalah 1.000 per konfigurasi penayangan.

Kontrol penayangan tersedia untuk:

• Meningkatkan/menyembunyikan: Memengaruhi peringkat dan urutan hasil dalam daftar hasil yang ditampilkan. Tersedia untuk penelusuran dan rekomendasi.
• Filter: Menghapus hasil yang tidak lulus filter dari daftar hasil yang ditampilkan. Hanya tersedia untuk penelusuran.
• Redirect: Mengalihkan pengguna ke halaman tertentu bergantung pada kueri penelusuran. Hanya tersedia untuk penelusuran.
• Linguistik: Menyesuaikan linguistik kueri penelusuran. Hanya tersedia untuk penelusuran. Beberapa jenis kontrol linguistik tersedia:
  • Sinonim: Memperluas sinonim yang dipertimbangkan untuk kueri penelusuran.
  • Sinonim satu arah: Memperluas sinonim yang dianggap secara searah untuk istilah tertentu.
  • Jangan kaitkan: Mencegah sekelompok istilah digunakan dalam penelusuran saat istilah tertentu muncul.
  • Abaikan: Mencegah istilah digunakan dalam penelusuran.
  • Penggantian: Mengganti istilah dalam kueri penelusuran.
• Sematkan: Memengaruhi pengurutan hasil, menempatkan hasil di posisi tertentu — misalnya, di posisi 4. Tersedia untuk penelusuran dan penjelajahan.

Untuk contoh kontrol ini, lihat Tentang kontrol penayangan.

Catatan: Sebaiknya jangan membuat kontrol yang bertentangan atau berantai. Vertex AI Search untuk retail tidak mendukung kontrol yang berjalan dalam urutan yang telah ditentukan.

Tutorial kontrol pengalihan

Tutorial ini menunjukkan cara menggunakan kontrol pengalihan.

---

Untuk mengikuti panduan langkah demi langkah tugas ini langsung di Cloud Shell Editor, klik Pandu saya:

Pandu saya

---

Membuat kontrol penayangan baru

Buat kontrol penayangan baru di halaman Kontrol di Konsol Google Cloud atau secara inline menggunakan metode Controls.create.

Kontrol memiliki persyaratan yang berbeda-beda, bergantung pada jenisnya. Buka prosedur pembuatan untuk jenis kontrol yang ingin Anda buat:

• Membuat kontrol dorong/sembunyikan
• Membuat kontrol filter
• Membuat kontrol pengalihan
• Membuat kontrol penyematan
• Membuat kontrol sinonim dua arah
• Membuat kontrol sinonim satu arah
• Membuat kontrol jangan kaitkan
• Membuat kontrol abaikan
• Membuat kontrol pengganti

Membuat kontrol dorong/sembunyikan

Lihat Kontrol dorong/sembunyikan untuk mengetahui informasi selengkapnya tentang jenis kontrol ini.

Jenis kontrol ini tersedia untuk penelusuran dan rekomendasi.

• Membuat kontrol pendorong/penyembunyikan penelusuran
• Membuat kontrol rekomendasi untuk meningkatkan/menyembunyikan

Membuat kontrol penguburan/peningkatan penelusuran

Untuk membuat kontrol penguburan/peningkatan penelusuran:

Konsol

1. Buka halaman Kontrol di konsol Penelusuran untuk Retail.
   
   Buka halaman Kontrol

2. Di tab Kontrol penayangan, klik Buat kontrol.

   Panel Buat kontrol akan terbuka.

3. Di bagian Preferensi, di kolom Nama kontrol, masukkan nama untuk kontrol baru Anda.

4. Opsional: Untuk mengubah ID kontrol yang dibuat secara otomatis, klik Edit, lalu masukkan ID kontrol baru.

5. Di bagian Pemilihan produk, pilih Telusuri.

6. Pilih Kontrol dorong/sembunyikan sebagai jenis kontrol. Klik Lanjutkan

7. Di bagian Pemicu, pilih jenis perilaku pengguna yang memicu kontrol ini.

   • Menjelajahi kategori: Aturan dipicu saat pengguna menjelajahi kategori di situs Anda (search.request.query kosong).

   • Penelusuran: Aturan dipicu saat pengguna melakukan penelusuran di situs Anda (search.request.query tidak kosong). Untuk menyetel kontrol ini agar dipicu saat kategori apa pun dijelajahi, atau kueri apa pun ditelusuri, lewati langkah berikut.

8. Opsional: Tetapkan kategori atau kueri tertentu yang dapat memicu kontrol ini, bergantung pada apakah kategori tertentu dijelajahi atau kueri tertentu ditelusuri.

   • Jika Anda memilih Jelajahi kategori: Di kolom Kategori, masukkan kategori yang akan memicu kontrol ini saat dijelajahi.

   • Jika Anda memilih Telusuri: Klik tombol Tambahkan kueri untuk menambahkan istilah kueri (misalnya, running shoes) yang akan difilter. Untuk setiap istilah, pilih Pencocokan sebagian atau Pencocokan penuh.

   Catatan: Jika Anda menentukan kondisi kategori atau istilah kueri selain kondisi rentang waktu, kontrol hanya diterapkan jika kedua kondisi tersebut terpenuhi.

9. Opsional: Klik tombol Tambahkan Rentang Waktu untuk menambahkan satu atau beberapa rentang waktu selama kontrol ini dapat diterapkan.

   Catatan: Jika Anda menentukan kondisi rentang waktu selain jenis kondisi ini, kontrol hanya akan diterapkan jika kedua kondisi terpenuhi.

10. Klik Lanjutkan untuk melanjutkan ke bagian Tindakan.

11. Tambahkan filter untuk atribut produk di kolom Dorong/sembunyikan produk.

    Gunakan sintaksis ekspresi filter yang didokumentasikan dalam Memfilter dan mengurutkan. Misalnya, untuk menentukan versi merah dan biru dari "product1" dan "product2": (id: ANY("product1","product2")) AND (colorFamily: ANY("Red","Blue"))

12. Untuk Nilai peningkatan/penyamaran, gunakan penggeser untuk menetapkan kekuatan peningkatan. Nilai positif meningkatkan hasil, dan nilai negatif menguburnya. Klik Lanjutkan.

13. Di bagian Konfigurasi penayangan, pilih konfigurasi penayangan yang akan diterapkan kontrolnya.

14. Kirim setelan kontrol Anda.

    Perlu waktu beberapa menit hingga kontrol yang baru dibuat atau diperbarui siap untuk menayangkan traffic live. Anda dapat menguji apakah perubahan telah diterapkan di halaman Evaluasi konsol.

Sekarang Anda dapat menemukan kontrol baru yang tercantum di tab Kontrol penayangan di halaman Kontrol.

curl

Buat permintaan Control.create dengan ID kontrol dan instance Control yang terdapat dalam isi permintaan.

Untuk mengetahui detail kolom, lihat referensi API Controls dan referensi API Controls.create.

Kontrol dorong/sembunyikan dapat dipicu saat pengguna menjelajahi kategori di situs Anda (search.request.query kosong), atau saat pengguna melakukan penelusuran di situs Anda (search.request.query tidak kosong).

Contoh berikut menunjukkan kolom untuk kontrol yang dipicu penjelajahan, dengan searchSolutionUseCase ditetapkan ke SEARCH_SOLUTION_USE_CASE_BROWSE.

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",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "searchSolutionUseCase": [
                "SEARCH_SOLUTION_USE_CASE_BROWSE"
              ],
              "rule": {
                "condition": {
                  "pageCategories": [
                      "CATEGORY_ABC",
                      "CATEGORY_XYZ"
                  ],
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "boostAction": {
                  "boost": BOOST_NUMBER,
                  "productsFilter": "FILTER_EXPRESSION"
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

Contoh berikut menunjukkan kolom untuk kontrol yang dipicu penelusuran, dengan searchSolutionUseCase ditetapkan ke SEARCH_SOLUTION_USE_CASE_SEARCH.

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",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "searchSolutionUseCase": [
                "SEARCH_SOLUTION_USE_CASE_SEARCH"
              ],
              "rule": {
                "condition": {
                  "queryTerms": [
                    {
                      "value": "VALUE_1",
                      "fullMatch": "FULLMATCH_BOOLEAN_1"
                    },
                    {
                      "value": "VALUE_2",
                      "fullMatch": "FULLMATCH_BOOLEAN_2"
                    }
                  ],
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "boostAction": {
                  "boost": BOOST_NUMBER,
                  "productsFilter": "FILTER_EXPRESSION"
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"
  

Perlu waktu beberapa menit hingga kontrol yang baru dibuat atau diperbarui siap untuk menayangkan traffic live. Anda dapat menguji apakah perubahan telah diterapkan di halaman Evaluasi konsol.

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

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

• Untuk contoh metode ini, lihat Mengelola konfigurasi penayangan.

Membuat kontrol rekomendasi untuk meningkatkan/menyembunyikan

Pratinjau

Fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dalam Persyaratan Khusus Layanan. Fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Untuk membuat kontrol rekomendasi dorong/sembunyikan:

Konsol

1. Buka halaman Kontrol di konsol Penelusuran untuk Retail.
   
   Buka halaman Kontrol

2. Di tab Kontrol penayangan, klik Buat kontrol.

   Panel Buat kontrol akan terbuka.

3. Di bagian Preferensi, di kolom Nama kontrol, masukkan nama untuk kontrol baru Anda.

4. (Opsional) Untuk mengubah ID kontrol yang dibuat secara otomatis, klik Edit, lalu masukkan ID kontrol baru.

5. Di bagian Pemilihan produk, pilih Rekomendasi.

6. Pilih Kontrol dorong/sembunyikan sebagai jenis kontrol.

7. Klik Lanjutkan untuk melanjutkan ke bagian Tindakan.

8. Tambahkan filter untuk atribut produk di kolom Dorong/sembunyikan produk.

   Gunakan sintaksis ekspresi filter yang didokumentasikan dalam Rekomendasi filter.

   Misalnya, untuk menentukan versi merah dan biru dari "product1" dan "product2": (id: ANY("product1","product2")) AND (colorFamily: ANY("Red","Blue"))

9. Untuk Nilai peningkatan/penyamaran, gunakan penggeser untuk menetapkan kekuatan peningkatan. Nilai positif meningkatkan hasil, dan nilai negatif menguburnya.

10. Klik Lanjutkan untuk melanjutkan ke bagian Konfigurasi penayangan.

11. Pilih konfigurasi penayangan yang akan menerapkan kontrol.

12. Kirim setelan kontrol Anda.

    Perlu waktu beberapa menit hingga kontrol yang baru dibuat atau diperbarui siap untuk menayangkan traffic live. Anda dapat menguji apakah perubahan telah diterapkan di halaman Evaluasi konsol.

Anda dapat menemukan kontrol baru yang tercantum di tab Kontrol penayangan di halaman Kontrol.

curl

Buat permintaan Control.create dengan ID kontrol dan instance Control yang terdapat dalam isi permintaan.

Untuk mengetahui detail kolom, lihat referensi API Controls dan referensi API Controls.create.

Untuk membuat ekspresi filter, gunakan sintaksis ekspresi filter yang didokumentasikan di Rekomendasi filter.

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",
              "solutionTypes": [ "SOLUTION_TYPE_RECOMMENDATION" ],
                "boostAction": {
                  "boost": BOOST_NUMBER,
                  "productsFilter": "FILTER_EXPRESSION"
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"
   

Perlu waktu beberapa menit hingga kontrol yang baru dibuat atau diperbarui siap untuk menayangkan traffic live. Anda dapat menguji apakah perubahan telah diterapkan di halaman Evaluasi konsol.

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

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

• Untuk contoh metode ini, lihat Mengelola konfigurasi penayangan.

Membuat kontrol filter

Lihat Kontrol filter untuk mengetahui informasi selengkapnya tentang jenis kontrol ini.

Konsol

1. Buka halaman Kontrol di konsol Penelusuran untuk Retail.
   
   Buka halaman Kontrol

2. Di tab Kontrol penayangan, klik Buat kontrol.

   Panel Buat kontrol akan terbuka.

3. Di bagian Preferensi, di kolom Nama kontrol, masukkan nama untuk kontrol baru Anda.

4. Opsional: Untuk mengubah ID kontrol yang dibuat secara otomatis, klik Edit, lalu masukkan ID kontrol baru.

5. Pilih Filter controls sebagai jenis kontrol.

6. Klik lanjutkan untuk melanjutkan ke bagian Pemicu.

7. Pilih jenis perilaku pengguna yang memicu kontrol ini:

   • Menjelajahi kategori: Aturan dipicu saat pengguna menjelajahi kategori di situs Anda (search.request.query kosong).

   • Penelusuran: Aturan dipicu saat pengguna melakukan penelusuran di situs Anda (search.request.query tidak kosong).

8. Opsional: Tetapkan kondisi kontrol yang memicu aturan berdasarkan kategori yang dijelajahi, atau kueri yang ditelusuri. Opsi yang tersedia bergantung pada apakah Anda memilih Jelajahi kategori atau Telusuri:

   • Jika Anda memilih Jelajahi kategori: Di kolom Kategori, masukkan kategori yang akan memicu kontrol ini saat dijelajahi.

   • Jika Anda memilih Telusuri: Klik tombol Tambahkan kueri untuk menambahkan istilah kueri (misalnya, running shoes) yang akan difilter, lalu pilih salah satu dari opsi berikut untuk setiap istilah:

     • Kecocokan sebagian: Kontrol ini berlaku saat kueri berisi kecocokan sebagian dengan istilah kueri ini.
     • Pencocokan penuh: Kontrol ini hanya berlaku jika kueri berisi pencocokan penuh dengan istilah kueri ini.

     Jika salah satu istilah ini disertakan dalam kueri, kontrol akan diterapkan.

   Catatan: Jika Anda menentukan kondisi rentang waktu selain kondisi ini, kontrol hanya akan diterapkan jika kedua kondisi terpenuhi.

9. Opsional: Klik tombol Tambahkan Rentang Waktu untuk menambahkan satu atau beberapa rentang waktu selama kontrol ini dapat diterapkan.

   Catatan: Jika Anda menentukan kondisi kategori atau istilah kueri selain kondisi rentang waktu ini, kontrol hanya akan diterapkan jika kedua kondisi terpenuhi.

10. Klik Lanjutkan untuk melanjutkan ke bagian Tindakan.

11. Tambahkan filter untuk atribut produk di kolom Filter action.

    Gunakan sintaksis ekspresi filter yang didokumentasikan dalam Memfilter dan mengurutkan.

    Misalnya, untuk menentukan versi merah dan biru dari "product1" dan "product2": (id: ANY("product1","product2")) AND (colorFamily: ANY("Red","Blue"))

12. Klik Lanjutkan untuk melanjutkan ke bagian Konfigurasi penayangan.

13. Pilih konfigurasi penayangan yang akan menerapkan kontrol.

14. Kirim setelan kontrol Anda.

    Perlu waktu beberapa menit hingga kontrol yang baru dibuat atau diperbarui siap untuk menayangkan traffic live. Anda dapat menguji apakah perubahan telah diterapkan di halaman Evaluasi konsol.

Anda dapat menemukan kontrol baru yang tercantum di tab Kontrol penayangan di halaman Kontrol.

curl

Buat permintaan Control.create dengan ID kontrol dan instance Control yang terdapat dalam isi permintaan.

Untuk mengetahui detail kolom, lihat referensi API Controls dan referensi API Controls.create.

Kontrol filter dapat dipicu saat pengguna menjelajahi kategori di situs Anda (search.request.query kosong), atau saat pengguna melakukan penelusuran di situs Anda (search.request.query tidak kosong).

Contoh berikut menunjukkan kolom untuk kontrol yang dipicu penjelajahan, dengan searchSolutionUseCase ditetapkan ke SEARCH_SOLUTION_USE_CASE_BROWSE.

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",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "searchSolutionUseCase": [
                "SEARCH_SOLUTION_USE_CASE_BROWSE"
              ],
              "rule": {
                "condition": {
                  "pageCategories": [
                      "CATEGORY_ABC",
                      "CATEGORY_XYZ"
                  ],
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "filterAction": {
                  "filter": "FILTER_EXPRESSION"
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

Contoh berikut menunjukkan kolom untuk kontrol yang dipicu penelusuran, dengan searchSolutionUseCase ditetapkan ke SEARCH_SOLUTION_USE_CASE_SEARCH.

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",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "searchSolutionUseCase": [
                "SEARCH_SOLUTION_USE_CASE_SEARCH"
              ],
              "rule": {
                "condition": {
                  "pageCategories": [
                      "CATEGORY_ABC",
                      "CATEGORY_XYZ"
                  ],
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "filterAction": {
                  "filter": "FILTER_EXPRESSION"
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"
  

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

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

• Untuk contoh metode ini, lihat Mengelola konfigurasi penayangan.

Membuat kontrol pengalihan

Lihat Kontrol pengalihan untuk mengetahui informasi selengkapnya tentang jenis kontrol ini.

Konsol

1. Buka halaman Kontrol di konsol Penelusuran untuk Retail.
   
   Buka halaman Kontrol

2. Di tab Kontrol penayangan, klik Buat kontrol.

   Panel Buat kontrol akan terbuka.

3. Di bagian Preferensi, di kolom Nama kontrol, masukkan nama untuk kontrol baru Anda.

4. Opsional: Untuk mengubah ID kontrol yang dibuat secara otomatis, klik Edit, lalu masukkan ID kontrol baru.

5. Pilih Redirect controls sebagai jenis kontrol.

6. Klik lanjutkan untuk melanjutkan ke bagian Pemicu.

7. Buat minimal satu istilah kueri atau pemicu rentang waktu. Kontrol pengalihan memerlukan minimal satu pemicu:

8. Pilih jenis perilaku pengguna yang memicu kontrol ini:

   • Menjelajahi kategori: Aturan dipicu saat pengguna menjelajahi kategori di situs Anda (search.request.query kosong).

   • Penelusuran: Aturan dipicu saat pengguna melakukan penelusuran di situs Anda (search.request.query tidak kosong).

9. Tetapkan kondisi kontrol yang memicu aturan berdasarkan kategori yang dijelajahi, atau kueri yang ditelusuri. Opsi yang tersedia bergantung pada apakah Anda memilih Jelajahi kategori atau Telusuri:

   • Jika Anda memilih Jelajahi kategori: Di kolom Kategori, masukkan kategori yang akan memicu kontrol ini saat dijelajahi.

   • Jika Anda memilih Telusuri: Klik tombol Tambahkan kueri untuk menambahkan istilah kueri (misalnya, running shoes) yang akan difilter, lalu pilih salah satu dari opsi berikut untuk setiap istilah:

     • Kecocokan sebagian: Kontrol ini berlaku saat kueri berisi kecocokan sebagian dengan istilah kueri ini.
     • Pencocokan penuh: Kontrol ini hanya berlaku jika kueri berisi pencocokan penuh dengan istilah kueri ini.

     Jika salah satu istilah ini disertakan dalam kueri, kontrol akan diterapkan.

   Catatan: Jika Anda menentukan kondisi rentang waktu selain kondisi ini, kontrol hanya akan diterapkan jika kedua kondisi terpenuhi.

10. Klik tombol Tambahkan Rentang Waktu untuk menambahkan satu atau beberapa rentang waktu selama kontrol ini dapat diterapkan.

    Catatan: Jika Anda menentukan kondisi kategori atau istilah kueri selain kondisi rentang waktu ini, kontrol hanya akan diterapkan jika kedua kondisi terpenuhi.

11. Klik Lanjutkan untuk melanjutkan ke bagian Tindakan.

12. Masukkan URI yang akan dialihkan saat kontrol ini dipicu.

13. Klik Lanjutkan untuk melanjutkan ke bagian Konfigurasi penayangan.

14. Pilih konfigurasi penayangan yang akan menerapkan kontrol.

15. Kirim setelan kontrol Anda.

    Perlu waktu beberapa menit hingga kontrol yang baru dibuat atau diperbarui siap untuk menayangkan traffic live. Anda dapat menguji apakah perubahan telah diterapkan di halaman Evaluasi konsol.

Anda dapat menemukan kontrol baru yang tercantum di tab Kontrol penayangan di halaman Kontrol.

curl

Buat permintaan Control.create dengan ID kontrol dan instance Control yang terdapat dalam isi permintaan.

Untuk mengetahui detail kolom, lihat referensi API Controls dan referensi API Controls.create.

Kontrol pengalihan dapat dipicu saat pengguna menjelajahi kategori di situs Anda (search.request.query kosong), atau saat pengguna menelusuri di situs Anda (search.request.query tidak kosong).

Contoh berikut menunjukkan kolom untuk kontrol yang dipicu penjelajahan, dengan searchSolutionUseCase ditetapkan ke SEARCH_SOLUTION_USE_CASE_BROWSE.

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",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "searchSolutionUseCase": [
                "SEARCH_SOLUTION_USE_CASE_BROWSE"
              ],
              "rule": {
                "condition": {
                  "queryTerms": [
                    {
                      "value": "VALUE_1",
                      "fullMatch": "FULLMATCH_BOOLEAN_1"
                    },
                    {
                      "value": "VALUE_2",
                      "fullMatch": "FULLMATCH_BOOLEAN_2"
                    }
                  ],
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "redirectAction": {
                  "redirectUri": "REDIRECT_URI",
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

Contoh berikut menunjukkan kolom untuk kontrol yang dipicu penelusuran, dengan searchSolutionUseCase ditetapkan ke SEARCH_SOLUTION_USE_CASE_SEARCH.

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",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "searchSolutionUseCase": [
                "SEARCH_SOLUTION_USE_CASE_SEARCH"
              ],
              "rule": {
                "condition": {
                  "queryTerms": [
                    {
                      "value": "VALUE_1",
                      "fullMatch": "FULLMATCH_BOOLEAN_1"
                    },
                    {
                      "value": "VALUE_2",
                      "fullMatch": "FULLMATCH_BOOLEAN_2"
                    }
                  ],
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "redirectAction": {
                  "redirectUri": "REDIRECT_URI",
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"
  

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

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

• Untuk contoh metode ini, lihat Mengelola konfigurasi penayangan.

Membuat kontrol sinonim dua arah

Lihat Kontrol sinonim dua arah untuk mengetahui informasi selengkapnya tentang jenis kontrol ini.

Konsol

1. Buka halaman Kontrol di konsol Penelusuran untuk Retail.
   
   Buka halaman Kontrol

2. Di tab Kontrol penayangan, klik Buat kontrol.

3. Di kolom Control name, masukkan nama untuk kontrol baru Anda.

   Panel Buat kontrol akan terbuka.

4. Anda akan berada di bagian Preferensi.

5. Opsional: Untuk mengubah ID kontrol yang dibuat secara otomatis, klik Edit, lalu masukkan ID kontrol baru.

6. Pilih Kontrol sinonim dua arah sebagai jenis kontrol.

7. Klik lanjutkan untuk melanjutkan ke bagian Pemicu.

8. Opsional: Klik tombol Tambahkan Rentang Waktu untuk menambahkan satu atau beberapa rentang waktu selama kontrol ini dapat diterapkan.

9. Klik Lanjutkan untuk melanjutkan ke bagian Tindakan.

10. Di kolom Synonyms, masukkan 2 hingga 100 istilah kueri (misalnya, shirt dan top) yang harus merupakan sinonim satu sama lain.

    Jika salah satu istilah ini disertakan dalam kueri, penelusuran akan menganggap istilah kueri lainnya sebagai sinonim dari istilah yang disertakan.

11. Klik Lanjutkan untuk melanjutkan ke bagian Konfigurasi penayangan.

12. Pilih konfigurasi penayangan yang akan menerapkan kontrol.

13. Kirim setelan kontrol Anda.

    Perlu waktu beberapa menit hingga kontrol yang baru dibuat atau diperbarui siap untuk menayangkan traffic live. Anda dapat menguji apakah perubahan telah diterapkan di halaman Evaluasi konsol.

Anda dapat menemukan kontrol baru yang tercantum di tab Kontrol penayangan di halaman Kontrol.

curl

Buat permintaan Control.create dengan ID kontrol dan instance Control yang terdapat dalam isi permintaan.

Untuk mengetahui detail kolom, lihat referensi API Controls dan referensi API Controls.create.

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",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "rule": {
                "condition": {
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                    ]
                },
                "twoWaySynonymAction": {
                  "synonyms": [
                    "SYNONYM_1",
                    "SYNONYM_2"
                  ]
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"
  

Untuk menambahkan kontrol ke konfigurasi penayangan, gunakan metode ServingConfig.addControl. Lihat Menambahkan kontrol ke konfigurasi penayangan secara inline.

Membuat kontrol sinonim satu arah

Lihat Kontrol sinonim satu arah untuk mengetahui informasi selengkapnya tentang jenis kontrol ini.

Konsol

1. Buka halaman Kontrol di konsol Penelusuran untuk Retail.
   
   Buka halaman Kontrol

2. Di tab Kontrol penayangan, klik Buat kontrol.

   Panel Buat kontrol akan terbuka.

3. Di bagian Preferensi, di kolom Nama kontrol, masukkan nama untuk kontrol baru Anda.

4. Opsional: Untuk mengubah ID kontrol yang dibuat secara otomatis, klik Edit, lalu masukkan ID kontrol baru.

5. Pilih Kontrol sinonim satu arah sebagai jenis kontrol.

6. Klik lanjutkan untuk melanjutkan ke bagian Pemicu.

7. Opsional: Klik tombol Tambahkan Rentang Waktu untuk menambahkan satu atau beberapa rentang waktu selama kontrol ini dapat diterapkan.

8. Klik Lanjutkan untuk melanjutkan ke bagian Tindakan.

9. Di kolom Istilah kueri, masukkan istilah (misalnya, shoes) yang harus memiliki sinonim yang terkait dengannya saat salah satunya disertakan dalam kueri.

10. Di kolom Sinonim, masukkan istilah yang harus digunakan sebagai sinonim untuk istilah kueri yang Anda tentukan (misalnya, sneakers dan sandals sebagai sinonim satu arah untuk istilah kueri shoes).

11. Klik Lanjutkan untuk melanjutkan ke bagian Konfigurasi penayangan.

12. Pilih konfigurasi penayangan yang akan menerapkan kontrol.

13. Kirim setelan kontrol Anda.

    Perlu waktu beberapa menit hingga kontrol yang baru dibuat atau diperbarui siap untuk menayangkan traffic live. Anda dapat menguji apakah perubahan telah diterapkan di halaman Evaluasi konsol.

Anda dapat menemukan kontrol baru yang tercantum di tab Kontrol penayangan di halaman Kontrol.

curl

Buat permintaan Control.create dengan ID kontrol dan instance Control yang terdapat dalam isi permintaan.

Untuk mengetahui detail kolom, lihat referensi API Controls dan referensi API Controls.create.

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",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "rule": {
                "condition": {
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "oneWaySynonymAction": {
                  "synonyms": [
                    "queryTerms": [
                      "QUERY_TERM_1",
                      "QUERY_TERM_2"
                    ],
                    "synonyms": [
                      "SYNONYM_1",
                      "SYNONYM_2"
                    ]
                  ]
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"
  

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

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

• Untuk contoh metode ini, lihat Mengelola konfigurasi penayangan.

Membuat kontrol jangan kaitkan

Lihat Kontrol jangan kaitkan untuk mengetahui informasi selengkapnya tentang jenis kontrol ini.

Konsol

1. Buka halaman Kontrol di konsol Penelusuran untuk Retail.
   
   Buka halaman Kontrol

2. Di tab Kontrol penayangan, klik Buat kontrol.

   Panel Buat kontrol akan terbuka.

3. Di bagian Preferensi, di kolom Nama kontrol, masukkan nama untuk kontrol baru Anda.

4. Opsional: Untuk mengubah ID kontrol yang dibuat secara otomatis, klik Edit, lalu masukkan ID kontrol baru.

5. Pilih Jangan kaitkan kontrol sebagai jenis kontrol.

6. Klik lanjutkan untuk melanjutkan ke bagian Pemicu.

7. Opsional: Klik tombol Tambahkan Rentang Waktu untuk menambahkan satu atau beberapa rentang waktu selama kontrol ini dapat diterapkan.

8. Klik Lanjutkan untuk melanjutkan ke bagian Tindakan.

9. Di kolom Query terms, masukkan istilah (misalnya, gShoe) yang ingin Anda bedakan secara eksplisit dari istilah lainnya.

10. Di kolom Istilah yang dihapus tautannya, masukkan istilah yang akan dihapus tautannya dari hasil penelusuran dengan istilah kueri yang telah Anda tentukan.

    Misalnya, Anda dapat memisahkan istilah kueri gShoe dari istilah cheap.

11. Klik Lanjutkan untuk melanjutkan ke bagian Konfigurasi penayangan.

12. Pilih konfigurasi penayangan yang akan menerapkan kontrol.

13. Kirim setelan kontrol Anda.

    Perlu waktu beberapa menit hingga kontrol yang baru dibuat atau diperbarui siap untuk menayangkan traffic live. Anda dapat menguji apakah perubahan telah diterapkan di halaman Evaluasi konsol.

Anda dapat menemukan kontrol baru yang tercantum di tab Kontrol penayangan di halaman Kontrol.

curl

Buat permintaan Control.create dengan ID kontrol dan instance Control yang terdapat dalam isi permintaan.

Untuk mengetahui detail kolom, lihat referensi API Controls dan referensi API Controls.create.

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",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "rule": {
                "condition": {
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "doNotAssociateAction": {
                    "queryTerms": [
                      "QUERY_TERM_1",
                      "QUERY_TERM_2"
                    ],
                    "doNotAssociateTerms": [
                      "DISSOCIATED_TERM_1",
                      "DISSOCIATED_TERM_2"
                    ]
                  ]
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"
  

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

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

• Untuk contoh metode ini, lihat Mengelola konfigurasi penayangan.

Membuat kontrol abaikan

Lihat Mengabaikan kontrol untuk mengetahui informasi selengkapnya tentang jenis kontrol ini.

Konsol

1. Buka halaman Kontrol di konsol Penelusuran untuk Retail.
   
   Buka halaman Kontrol

2. Di tab Kontrol penayangan, klik Buat kontrol.

   Panel Buat kontrol akan terbuka.

3. Di bagian Preferensi, di kolom Nama kontrol, masukkan nama untuk kontrol baru Anda.

4. Opsional: Untuk mengubah ID kontrol yang dibuat secara otomatis, klik Edit, lalu masukkan ID kontrol baru.

5. Pilih Jangan kaitkan kontrol sebagai jenis kontrol.

6. Klik lanjutkan untuk melanjutkan ke bagian Pemicu.

7. Opsional: Klik tombol Tambahkan Rentang Waktu untuk menambahkan satu atau beberapa rentang waktu selama kontrol ini dapat diterapkan.

8. Klik Lanjutkan untuk melanjutkan ke bagian Tindakan.

9. Di kolom Abaikan istilah, masukkan istilah (misalnya, shoddy) yang ingin Anda abaikan saat dimasukkan sebagai istilah kueri.

10. Klik Lanjutkan untuk melanjutkan ke bagian Konfigurasi penayangan.

11. Pilih konfigurasi penayangan yang akan menerapkan kontrol.

12. Kirim setelan kontrol Anda.

    Perlu waktu beberapa menit hingga kontrol yang baru dibuat atau diperbarui siap untuk menayangkan traffic live. Anda dapat menguji apakah perubahan telah diterapkan di halaman Evaluasi konsol.

Anda dapat menemukan kontrol baru yang tercantum di tab Kontrol penayangan di halaman Kontrol.

curl

Buat permintaan Control.create dengan ID kontrol dan instance Control yang terdapat dalam isi permintaan.

Untuk mengetahui detail kolom, lihat referensi API Controls dan referensi API Controls.create.

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",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "rule": {
                "condition": {
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "ignoreAction": {
                  "ignoreTerms": [
                      "IGNORE_TERM_1",
                      "IGNORE_TERM_2"
                    ]
                  ]
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"
  

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

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

• Untuk contoh metode ini, lihat Mengelola konfigurasi penayangan.

Membuat kontrol pengganti

Lihat Kontrol penggantian untuk mengetahui informasi selengkapnya tentang jenis kontrol ini.

Konsol

1. Buka halaman Kontrol di konsol Penelusuran untuk Retail.
   
   Buka halaman Kontrol

2. Di tab Kontrol penayangan, klik Buat kontrol.

   Panel Buat kontrol akan terbuka.

3. Di bagian Preferensi, di kolom Nama kontrol, masukkan nama untuk kontrol baru Anda.

4. Opsional: Untuk mengubah ID kontrol yang dibuat secara otomatis, klik Edit, lalu masukkan ID kontrol baru.

5. Pilih Kontrol penggantian sebagai jenis kontrol.

6. Klik lanjutkan untuk melanjutkan ke bagian Pemicu.

7. Opsional: Klik tombol Tambahkan Rentang Waktu untuk menambahkan satu atau beberapa rentang waktu selama kontrol ini dapat diterapkan.

8. Klik Lanjutkan untuk melanjutkan ke bagian Tindakan.

9. Di kolom Istilah kueri, masukkan istilah kueri (misalnya, gShoe) yang ingin Anda ganti dengan istilah pengganti.

10. Di kolom Istilah pengganti, masukkan istilah yang akan menggantikan istilah kueri yang Anda tentukan.

    Misalnya, Anda dapat mengganti istilah kueri gShoe dengan istilah pengganti Google Shoe.

11. Klik Lanjutkan untuk melanjutkan ke bagian Konfigurasi penayangan.

12. Pilih konfigurasi penayangan yang akan menerapkan kontrol.

13. Kirim setelan kontrol Anda.

    Perlu waktu beberapa menit hingga kontrol yang baru dibuat atau diperbarui siap untuk menayangkan traffic live. Anda dapat menguji apakah perubahan telah diterapkan di halaman Evaluasi konsol.

Anda dapat menemukan kontrol baru yang tercantum di tab Kontrol penayangan di halaman Kontrol.

curl

Buat permintaan Control.create dengan ID kontrol dan instance Control yang terdapat dalam isi permintaan.

Untuk mengetahui detail kolom, lihat referensi API Controls dan referensi API Controls.create.

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",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "rule": {
                "condition": {
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "replacementAction": {
                    "queryTerms": [
                      "QUERY_TERM_1",
                      "QUERY_TERM_2"
                    ],
                    "replacementTerm": "REPLACEMENT_TERM"
                  }
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"
  

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

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

• Untuk contoh metode ini, lihat Mengelola konfigurasi penayangan.

Membuat kontrol penyematan

Untuk membuat kontrol penyematan:

Konsol

1. Buka halaman Kontrol di konsol Penelusuran untuk Retail.
   
   Buka halaman Kontrol

2. Di tab Kontrol penayangan, klik Buat kontrol.

   Panel Buat kontrol akan terbuka.

3. Di kolom Control name pada bagian Preferences, masukkan nama untuk kontrol baru Anda.

4. Opsional: Untuk mengubah ID kontrol yang dibuat secara otomatis, klik Edit, lalu masukkan ID kontrol baru.

5. Di bagian Pemilihan produk, pilih Telusuri atau Cari.

6. Pilih Kontrol penyematan sebagai jenis kontrol. Klik Lanjutkan.

7. Di bagian Pemicu, pilih perilaku pengguna yang memicu kontrol ini:

   • Jelajahi kategori: Permintaan jelajah harus memiliki kolom page_categories yang terisi selain search.request.query yang kosong.

   • Penelusuran: Permintaan penelusuran hanya memerlukan search.request.query untuk diisi.

     Secara default, semua kategori yang dijelajahi dan kueri yang ditelusuri akan memicu kontrol ini.

8. Opsional: Tetapkan kondisi yang memicu aturan berdasarkan kategori tertentu yang dijelajahi atau kueri yang ditelusuri:

   • Jelajahi kategori: Di kolom Kategori, masukkan kategori yang memicu kontrol.

   • Telusuri: Untuk menambahkan istilah kueri yang akan difilter (misalnya, running shoes), klik Tambahkan kueri. Untuk setiap istilah, pilih Pencocokan sebagian atau Pencocokan penuh.

9. Opsional: Klik Tambahkan Rentang Waktu atau Tambahkan Rentang Tanggal untuk menambahkan satu atau beberapa rentang waktu selama kontrol ini dapat diterapkan.

   Catatan: Jika Anda menentukan kategori atau istilah kueri beserta kondisi rentang waktu atau tanggal, kontrol hanya akan diterapkan jika kedua jenis kondisi terpenuhi.

10. Klik Lanjutkan untuk melanjutkan ke bagian Tindakan. Untuk Lokasi pin, gunakan penggeser untuk menentukan posisi yang akan digunakan untuk menyematkan produk. Penggeser nilai pin tidak akan menerima nilai 0, angka negatif, atau non-bilangan bulat.

    Vertex AI Search untuk retail mengizinkan 10 pin di peta pin dari satu kontrol. Posisi dapat berupa nilai apa pun antara 1 dan 120 (ukuran halaman permintaan maksimum).

    Catatan: Pin ke halaman kedua tidak dihormati jika posisinya lebih besar dari ukuran halaman permintaan. Misalnya, jika kueri penelusuran meminta ukuran halaman 50, tetapi Anda telah menyetel pin ke halaman 75, item penelusuran akan diabaikan dalam hasil.

11. Klik Lanjutkan untuk melanjutkan ke bagian Konfigurasi penayangan. Pilih konfigurasi penayangan yang akan menerapkan kontrol, lalu kirim setelan kontrol Anda.

    Perlu waktu beberapa menit hingga kontrol yang baru dibuat atau diperbarui siap untuk menayangkan traffic live. Anda dapat menguji apakah perubahan telah diterapkan di halaman Evaluasi konsol.

Anda dapat menemukan kontrol baru yang tercantum di tab Kontrol penayangan di halaman Kontrol.

curl

Buat permintaan Control.create dengan ID kontrol dan instance Control yang terdapat dalam isi permintaan.

Untuk mengetahui detail kolom, lihat referensi API Controls dan referensi API Controls.create.

curl -X POST \
 -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
 -H "Content-Type: application/json; charset=utf-8" \
 -H "X-Goog-User-Project: PROJECT_NUMBER" \
 --data '{
          "displayName": "DisplayName",
          "solutionTypes": "SOLUTION_TYPE_SEARCH",
          "searchSolutionUseCase": ["SEARCH_SOLUTION_USE_CASE_SEARCH"],
     "rule": {
            "condition": {
 "queryTerms": [
                {
                  "value": "Term1",
                  "fullMatch": "boolean: true / false"
                },
                {
                  "value": "Term2",
                  "fullMatch": "boolean: true / false"
                },
             ],
             "activeTimeRange": [
               {
                 "startTime": timestamp1,
                 "endTime": timestamp2
               },
               {
                 "startTime": timestamp3,
                 "endTime": timestamp4
               }
             ]
            },
            "pinAction": {
               "pinMap" :  {
                        "pin_position1": "product_id",
                      "pin_position2": "product_id>"
                    }
            }
              }
}' \
"https://retail.googleapis.com/v2alpha/projects/PROJECT_NUMBER/locations/LOCATION/catalogs/default_catalog/controls?controlId=CONTROL_ID"

pin_position harus berupa bilangan bulat antara [1,10] inklusif dan product_id harus ada di katalog Anda. Jumlah maksimum elemen yang diizinkan dalam peta pin adalah 10 untuk setiap kontrol.

Selanjutnya, lampirkan kontrol penyematan ke konfigurasi penayangan Anda:

curl -X POST \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-H "X-Goog-User-Project: PROJECT_NUMBER" \
-d '{
      "controlId": "CONTROL_ID"
  }' \
'https://retail.googleapis.com/v2alpha/projects/PROJECT_NUMBER/locations/LOCATION/catalogs/default_catalog/servingConfigs/SERVING_CONFIG_ID:addControl'

Dalam hal ini, CONTROL_ID harus berupa kontrol penyematan id yang Anda buat sebelumnya.

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

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

• Untuk contoh metode ini, lihat Mengelola konfigurasi penayangan.

Catatan: Ada penundaan lima menit sejak kontrol dilampirkan dan siap digunakan dalam penayangan. Halaman pratinjau dan permintaan penelusuran akan mencerminkan penundaan ini.

Terakhir, untuk menguji penyiapan Anda, buat permintaan penelusuran. Untuk memastikan bahwa kontrol penyematan berhasil diterapkan pada permintaan, gunakan istilah kueri (dalam penelusuran) atau kategori halaman (dalam penjelajahan) yang cocok dengan istilah/kategori yang diberikan dalam kontrol yang Anda buat pada langkah-langkah sebelumnya.

Konsol

1. Buka halaman Evaluasi di konsol Penelusuran untuk Retail.
   
   Buka halaman Evaluasi

2. Buka tab Penelusuran.

3. Masukkan kueri pengujian di kolom kueri penelusuran.

4. Klik Pratinjau penelusuran.

5. Lihat hasilnya untuk memastikan produk yang Anda pilih telah disematkan.

curl

curl -s -X POST -H "Authorization: Bearer " -H "Content-Type: application/json"
--data "{'query': '','visitorId': ''}" \ "https://retail.googleapis.com/v2/projects/PROJECT/locations/global/catalogs/CATALOG/placements/default_search:search"

Batasan untuk pemeriksaan error

Untuk pemeriksaan error, perhatikan batasan berikut:

• Dua produk tidak dapat disematkan ke posisi yang sama, yaitu produk "a" dan "b" tidak dapat menempati posisi #2.
• Sebaliknya, satu produk tidak dapat disematkan ke lebih dari satu lokasi, yaitu, produk "a" tidak dapat disematkan ke posisi #2 dan #3 secara bersamaan untuk kueri yang sama.
• product_id harus ada sebagai produk di katalog, dengan asumsi bahwa tidak ada filter atau pengurutan yang diterapkan.