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.

Anda dapat membuat kontrol penayangan di konsol Penelusuran untuk Commerce 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 Diskon gShoe yang meningkatkan hasil untuk merek gShoe saat sepatu ditelusuri dan kontrol bernama Sepatu lainnya 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 Sepatu lainnya 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.

Video dan panduan memulai cepat

• Pengantar kontrol penayangan: Kontrol penayangan memungkinkan Anda membuat aturan yang menyesuaikan cara konfigurasi penayangan menampilkan hasil penelusuran.
• 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.

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

---

• 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 commerce tidak mendukung kontrol yang berjalan dalam urutan yang telah ditentukan.

Opsi konsol untuk membuat kontrol

Anda dapat memilih salah satu jalur konsol berikut untuk membuat semua kontrol penayangan di Vertex AI Search untuk Commerce.

Menggunakan konsol Google Cloud

Ikuti langkah-langkah Konsol merchandising di bagian setiap bagian kontrol penayangan.

Menggunakan konsol Merchandising

Jika Anda adalah administrator konsol Google Cloud, Anda dapat memberi merchandiser situs akses ke konsol Merchandising dan menetapkan peran Kreator atau Pengesah kepada mereka.

Mengakses konsol Merchandising sebagai pengguna

Jika telah diberi akses dengan URL, Anda memiliki opsi untuk menggunakan konsol Merchandising, bukan konsol Google Cloud standar. Untuk membuat kontrol menggunakan konsol Merchandising:

1. Login melalui login eksternal yang diberikan oleh administrator.

2. Ikuti langkah-langkah dokumentasi Konsol merchandising di bagian setiap bagian kontrol penayangan.

Mengaktifkan pengguna konsol Merchandising

Jika Anda adalah administrator konsol Google Cloud, Anda dapat memberikan akses kepada pemasar ke konsol Merchandising:

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

2. Buka tab Konsol merchandising.

3. Konfigurasikan setelan identitas.

4. Berikan peran Penyetuju atau Pembuat kepada pengguna.

5. Anda dapat melihat URL unik ke konsol Merchandising yang terkait dengan project Google Cloud saat ini. Salin link atau buka langsung di Konsol Google Cloud.

6. Pilih konfigurasi penayangan default untuk Pratinjau di konsol Merchandising.

7. (Opsional) Akses edit ke konsol Merchandising menggunakan fungsi ini:

   • Menambahkan pengguna: Berikan akses Pendukung atau Kreator kepada pengguna ke Konsol merchandising.

   • Menghapus pengguna: Cabut akses ke konsol Merchandising dengan menghapus Pemberi persetujuan atau Kreator.

8. Buka halaman Admin IAM di konsol Penelusuran untuk Commerce.
   
   Buka halaman Admin IAM

Langkah tambahan untuk Pemberi Persetujuan

1. Sesuaikan setelan konsol Merchandising dengan mengklik Create control.

2. Tambahkan pertanyaan ke aturan awal, atau hapus di layar Menentukan sasaran.

3. (Opsional) Setelah Anda menerima email yang berisi permintaan kontrol yang dikirimkan, ubah status, setujui, atau tolak permintaan di dasbor, tempat Anda menemukan permintaan yang tercantum.

4. Kelola persetujuan untuk setiap kontrol di bagian Tinjau dan setujui dengan mengklik Setujui, Tolak, atau Edit.

   • Opsi terakhir akan mengarahkan Anda ke layar berikutnya, tempat Anda dapat melakukan pengeditan dan mengklik Setujui dengan pengeditan.

   • Setiap kontrol yang Anda tambahkan sebagai Pemberi Persetujuan akan otomatis disetujui.

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

Jenis kontrol ini tersedia untuk penelusuran dan rekomendasi.

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

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

Membuat kontrol penguburan/peningkatan penelusuran

Untuk membuat kontrol dorong/sembunyikan penelusuran:

Konsol merchandising

1. Klik URL yang diberikan oleh administrator. Login.

   Tindakan ini akan mengarahkan Anda ke halaman Kontrol di Konsol merchandising.

2. Klik Buat kontrol.

3. Tentukan sasaran untuk pengguna akhir dan waktu yang diperlukan. Semua pertanyaan harus dijawab. Klik Berikutnya.

4. Pilih kontrol. Masukkan nama untuk kontrol Anda, pilih produk Penelusuran, lalu pilih jenis kontrol Dorong/Sembunyikan.

5. Konfigurasikan kontrol Boost/Bury:

   1. Di bagian Pemicu, tentukan atribut katalog yang memicu kontrol ini dengan memberikan kriteria ke kueri penelusuran terkait, seperti berisi atau tidak dalam rentang. Jika tidak ada atribut katalog yang dikonfigurasi, kontrol ini akan selalu berlaku.

   2. Tentukan Rentang waktu yang berlaku dengan memasukkan Rentang tanggal. Jika salah satu rentang waktu yang ditentukan terpenuhi, atribut katalog akan dicocokkan dengan kueri selama salah satu rentang waktu yang ditentukan. Tambahkan rentang waktu dengan Tambahkan rentang waktu.

   3. Tentukan tindakan Dorong/Sembunyikan yang ingin Anda picu dengan kontrol ini. Tindakan ini ditentukan oleh Atribut katalog seperti warna, Kriteria seperti berisi, dan Nilai seperti merah.

   4. Klik Tambahkan atribut untuk menambahkan atribut lainnya.

6. Gunakan penggeser untuk menetapkan Nilai dorong/sembunyikan. Angka negatif adalah bury, dan angka positif adalah boost.

7. Klik Kirim untuk mengirimkan permintaan kontrol Anda kepada Pemberi Persetujuan. Anda akan dapat melihat status permintaan yang dikirim di Konsol Merchandising. Jika berubah pikiran, Anda dapat menghapus permintaan kontrol.

Langkah-langkah pemberi persetujuan

1. Di bagian Konfigurasi penayangan,tetapkan kontrol Anda ke konfigurasi penayangan yang ada.
2. Setujui permintaan untuk kontrol Dorong/sembunyikan.

Cloud Console

1. Buka halaman Kontrol di konsol Penelusuran untuk Commerce.
   
   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 menetapkan kontrol ini agar terpicu 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 Pemfilteran dan pengurutan. Misalnya, untuk menentukan versi merah dan biru "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 agar 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 agar 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

Preview

This feature is subject to the "Pre-GA Offerings Terms" in the General Service Terms section of the Service Specific Terms. Pre-GA features are available "as is" and might have limited support. For more information, see the launch stage descriptions.

Untuk membuat kontrol rekomendasi dorong/sembunyikan:

Konsol merchandising

1. Klik URL yang diberikan oleh administrator. Login.

   Tindakan ini akan mengarahkan Anda ke halaman Kontrol di Konsol merchandising.

2. Klik Buat kontrol.

3. Tentukan sasaran untuk pengguna akhir dan waktu yang diperlukan. Semua pertanyaan harus dijawab. Klik Berikutnya.

4. Pilih kontrol. Masukkan nama untuk kontrol Anda, pilih produk Jelajahi, lalu pilih jenis kontrol Dorong/Sembunyikan.

5. Konfigurasikan kontrol Boost/Bury:

   1. Di bagian Pemicu, masukkan kategori halaman yang akan memicu kontrol. Jika tidak ada atribut katalog yang dikonfigurasi, kontrol ini akan selalu diterapkan.

   2. Tentukan Rentang waktu yang berlaku dengan memasukkan Rentang tanggal. Jika salah satu rentang waktu yang ditentukan terpenuhi, atribut katalog akan dicocokkan dengan kueri selama salah satu rentang waktu yang ditentukan. Tambahkan rentang waktu dengan Tambahkan rentang waktu.

   3. Tentukan tindakan Dorong/Sembunyikan yang ingin Anda picu dengan kontrol ini. Tindakan ini ditentukan oleh Atribut katalog seperti warna, Kriteria seperti berisi, dan Nilai seperti merah.

   4. Klik Tambahkan atribut untuk menambahkan atribut lainnya.

6. Gunakan penggeser untuk menetapkan Nilai dorong/sembunyikan. Angka negatif adalah penyembunyikan, angka positif adalah pengoptimalan.

7. Klik Kirim untuk mengirimkan permintaan kontrol Anda kepada Pemberi Persetujuan. Anda akan dapat melihat status permintaan yang dikirim di Konsol Merchandising. Jika berubah pikiran, Anda dapat menghapus permintaan kontrol.

Langkah-langkah pemberi persetujuan

1. Di bagian Konfigurasi penayangan,tetapkan kontrol Anda ke konfigurasi penayangan yang ada.
2. Setujui permintaan untuk kontrol Dorong/sembunyikan.

Cloud Console

1. Buka halaman Kontrol di konsol Penelusuran untuk Commerce.
   
   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 dorong/sembunyikan, gunakan penggeser untuk menetapkan kekuatan dorongan. 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 agar 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 agar 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 merchandising

1. Klik URL yang diberikan oleh administrator. Login.

   Tindakan ini akan mengarahkan Anda ke halaman Kontrol di Konsol merchandising.

2. Klik Buat kontrol.

3. Tentukan sasaran untuk pengguna akhir dan waktu yang diperlukan. Semua pertanyaan harus dijawab. Klik Berikutnya.

4. Pilih kontrol. Masukkan nama untuk kontrol Anda, pilih produk Telusuri atau Jelajahi, lalu pilih jenis kontrol Filter.

5. Konfigurasikan kontrol Filter:

   1. Di bagian Pemicu, tentukan atribut katalog yang memicu kontrol ini dengan memberikan kriteria ke kueri penelusuran atau kategori halaman terkait, seperti berisi atau tidak dalam rentang. Jika tidak ada atribut katalog yang telah dikonfigurasi, kontrol ini akan selalu berlaku.

   2. Tentukan Rentang waktu yang berlaku dengan memasukkan Rentang tanggal. Jika salah satu rentang waktu yang ditentukan terpenuhi, atribut katalog akan dicocokkan dengan kueri selama salah satu rentang waktu yang ditentukan. Tambahkan rentang waktu dengan Tambahkan rentang waktu.

   3. Tentukan Tindakan filter yang ingin Anda picu dengan kontrol ini. Tindakan ini ditentukan oleh Atribut katalog seperti warna, Kriteria seperti berisi, dan Nilai seperti merah.

   4. Klik Tambahkan atribut untuk menambahkan atribut lainnya.

6. Klik Kirim untuk mengirimkan permintaan kontrol Anda kepada Pemberi Persetujuan. Anda akan dapat melihat status permintaan yang dikirim di Konsol Merchandising. Jika berubah pikiran, Anda dapat menghapus permintaan kontrol.

Langkah-langkah pemberi persetujuan

1. Di bagian Konfigurasi penayangan,tetapkan kontrol Anda ke konfigurasi penayangan yang ada.
2. Setujui permintaan untuk kontrol Filter.

Cloud Console

1. Buka halaman Kontrol di konsol Penelusuran untuk Commerce.
   
   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 filter 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 agar 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 merchandising

1. Klik URL yang diberikan oleh administrator. Login.

   Tindakan ini akan mengarahkan Anda ke halaman Kontrol di Konsol merchandising.

2. Klik Buat kontrol.

3. Tentukan sasaran untuk pengguna akhir dan waktu yang diperlukan. Semua pertanyaan harus dijawab. Klik Berikutnya.

4. Pilih kontrol. Masukkan nama untuk kontrol Anda, pilih produk Penelusuran, lalu pilih jenis kontrol Alihan.

5. Konfigurasikan kontrol Pengalihan:

   1. Di bagian Pemicu, tentukan atribut katalog yang memicu kontrol ini dengan memberikan kriteria ke kueri penelusuran terkait, seperti berisi atau tidak dalam rentang. Jika tidak ada atribut katalog yang telah dikonfigurasi, kontrol ini akan selalu berlaku.

   2. Tentukan Rentang waktu yang berlaku dengan memasukkan Rentang tanggal. Jika salah satu rentang waktu yang ditentukan terpenuhi, atribut katalog akan dicocokkan dengan kueri selama salah satu rentang waktu yang ditentukan. Tambahkan rentang waktu dengan Tambahkan rentang waktu.

   3. Tentukan Tindakan pengalihan yang ingin Anda picu dengan kontrol ini dengan memasukkan URL pengalihan.

6. Klik Kirim untuk mengirimkan permintaan kontrol Anda kepada Pemberi Persetujuan. Anda akan dapat melihat status permintaan yang dikirim di Konsol Merchandising. Jika berubah pikiran, Anda dapat menghapus permintaan kontrol.

Langkah-langkah pemberi persetujuan

1. Di bagian Konfigurasi penayangan,tetapkan kontrol Anda ke konfigurasi penayangan yang ada.
2. Setujui permintaan untuk kontrol Alihan.

Cloud Console

1. Buka halaman Kontrol di konsol Penelusuran untuk Commerce.
   
   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 agar 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 merchandising

1. Klik URL yang diberikan oleh administrator. Login.

   Tindakan ini akan mengarahkan Anda ke halaman Kontrol di Konsol merchandising.

2. Klik Buat kontrol.

3. Tentukan sasaran untuk pengguna akhir dan waktu yang diperlukan. Semua pertanyaan harus dijawab. Klik Berikutnya.

4. Pilih kontrol. Masukkan nama untuk kontrol Anda, pilih produk Penelusuran, lalu pilih jenis kontrol Sinonim.

5. Konfigurasikan kontrol Sinonim dua arah:

   1. Di bagian Pemicu, tentukan atribut katalog yang memicu kontrol ini dengan memberikan kriteria ke kueri penelusuran terkait, seperti berisi atau tidak dalam rentang. Jika tidak ada atribut katalog yang telah dikonfigurasi, kontrol ini akan selalu berlaku.

   2. Tentukan Rentang waktu yang berlaku dengan memasukkan Rentang tanggal. Jika salah satu rentang waktu yang ditentukan terpenuhi, atribut katalog akan dicocokkan dengan kueri selama salah satu rentang waktu yang ditentukan. Tambahkan rentang waktu dengan Tambahkan rentang waktu.

   3. Tentukan Jenis sinonim yang ingin dipicu dengan kontrol ini. Pilih Dua arah. Lihat bagian Sinonim untuk mengetahui informasi selengkapnya tentang jenis sinonim.

6. Klik Kirim. Tindakan ini akan membawa Anda ke layar konfigurasi Sinonim dua arah yang mendetail.

7. Masukkan sinonim di kolom di bagian Tindakan sinonim dua arah. Tindakan ini menautkan istilah secara dua arah agar diperlakukan sama dalam hasil penelusuran, sehingga kueri sofa merah menghasilkan sofa merah marun, tetapi kueri sofa marun diperluas untuk menyertakan semua jenis sofa merah, seperti merah tua atau merah muda.

8. Kirim lagi untuk mengirim permintaan kontrol Anda kepada Pemberi Persetujuan. Anda akan dapat melihat status permintaan yang dikirim di Konsol Merchandising. Jika berubah pikiran, Anda dapat menghapus permintaan kontrol.

Langkah-langkah pemberi persetujuan

1. Di bagian Konfigurasi penayangan,tetapkan kontrol Anda ke konfigurasi penayangan yang ada.
2. Setujui permintaan untuk kontrol Sinonim dua arah.

Cloud Console

1. Buka halaman Kontrol di konsol Penelusuran untuk Commerce.
   
   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 agar 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 merchandising

1. Klik URL yang diberikan oleh administrator. Login.

   Tindakan ini akan mengarahkan Anda ke halaman Kontrol di Konsol merchandising.

2. Klik Buat kontrol.

3. Tentukan sasaran untuk pengguna akhir dan waktu yang diperlukan. Semua pertanyaan harus dijawab. Klik Berikutnya.

4. Pilih kontrol. Masukkan nama untuk kontrol Anda, pilih produk Penelusuran, lalu pilih jenis kontrol Sinonim.

5. Konfigurasikan kontrol Sinonim satu arah:

   1. Di bagian Pemicu, tentukan atribut katalog yang memicu kontrol ini dengan memberikan kriteria ke kueri penelusuran terkait, seperti berisi atau tidak dalam rentang. Jika tidak ada atribut katalog yang dikonfigurasi, kontrol ini akan selalu berlaku.

   2. Tentukan Rentang waktu yang berlaku dengan memasukkan Rentang tanggal. Jika salah satu rentang waktu yang ditentukan terpenuhi, atribut katalog akan dicocokkan dengan kueri selama salah satu rentang waktu yang ditentukan. Tambahkan rentang waktu dengan Tambahkan rentang waktu.

   3. Tentukan Jenis sinonim yang ingin dipicu dengan kontrol ini. Pilih Searah. Lihat bagian Sinonim untuk mengetahui informasi selengkapnya tentang jenis sinonim.

6. Klik Kirim. Tindakan ini akan mengarahkan Anda ke layar konfigurasi Sinonim satu arah yang mendetail.

7. Masukkan sinonim Anda di kolom di bagian Tindakan sinonim satu arah. Tindakan ini menautkan istilah secara searah agar diperlakukan sama dalam hasil penelusuran, sehingga kueri sofa merah mencakup sofa merah marun, tetapi kueri sofa merah marun tidak menampilkan jenis sofa merah lainnya, sehingga membatasi hasil hanya untuk sofa merah marun.

8. Klik Kirim lagi untuk mengirim permintaan kontrol Anda kepada Pemberi Persetujuan. Anda akan dapat melihat status permintaan yang dikirim di Konsol Merchandising. Jika berubah pikiran, Anda dapat menghapus permintaan kontrol.

Langkah-langkah pemberi persetujuan

1. Di bagian Konfigurasi penayangan,tetapkan kontrol Anda ke konfigurasi penayangan yang ada.
2. Setujui permintaan untuk kontrol Sinonim satu arah.

Cloud Console

1. Buka halaman Kontrol di konsol Penelusuran untuk Commerce.
   
   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 agar 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 merchandising

1. Klik URL yang diberikan oleh administrator. Login.

   Tindakan ini akan mengarahkan Anda ke halaman Kontrol di Konsol merchandising.

2. Klik Buat kontrol.

3. Tentukan sasaran untuk pengguna akhir dan waktu yang diperlukan. Semua pertanyaan harus dijawab. Klik Berikutnya.

4. Pilih kontrol. Masukkan nama untuk kontrol Anda, pilih produk Penelusuran, lalu pilih jenis kontrol Jangan kaitkan.

5. Konfigurasikan kontrol Jangan kaitkan:

   1. Di bagian Pemicu, tentukan atribut katalog yang memicu kontrol ini dengan memberikan kriteria ke kueri penelusuran terkait, seperti berisi atau tidak dalam rentang. Jika tidak ada atribut katalog yang telah dikonfigurasi, kontrol ini akan selalu berlaku.

   2. Tentukan Rentang waktu yang berlaku dengan memasukkan Rentang tanggal. Jika salah satu rentang waktu yang ditentukan terpenuhi, atribut katalog akan dicocokkan dengan kueri selama salah satu rentang waktu yang ditentukan. Tambahkan rentang waktu dengan Tambahkan rentang waktu.

   3. Di bagian Jangan kaitkan tindakan, tentukan istilah yang tidak boleh dikaitkan dengan istilah kueri yang Anda masukkan di bagian Pemicu sebelumnya. Masukkan istilah tersebut ke kolom istilah kueri dan istilah yang dihapus tautannya.

6. Klik Kirim untuk mengirim permintaan kontrol Anda kepada Pemberi Persetujuan. Anda akan dapat melihat status permintaan yang dikirim di Konsol Merchandising. Jika berubah pikiran, Anda dapat menghapus permintaan kontrol.

Langkah-langkah pemberi persetujuan

1. Di bagian Konfigurasi penayangan,tetapkan kontrol Anda ke konfigurasi penayangan yang ada.
2. Setujui permintaan untuk kontrol Jangan kaitkan.

Cloud Console

1. Buka halaman Kontrol di konsol Penelusuran untuk Commerce.
   
   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 agar 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 merchandising

1. Klik URL yang diberikan oleh administrator. Login.

   Tindakan ini akan mengarahkan Anda ke halaman Kontrol di Konsol merchandising.

2. Klik Buat kontrol.

3. Tentukan sasaran untuk pengguna akhir dan waktu yang diperlukan. Semua pertanyaan harus dijawab. Klik Berikutnya.

4. Pilih kontrol. Masukkan nama untuk kontrol Anda, pilih produk Penelusuran, lalu pilih jenis kontrol Abaikan.

5. Konfigurasikan kontrol Abaikan:

   1. Di bagian Pemicu, tentukan atribut katalog yang memicu kontrol ini dengan memberikan kriteria ke kueri penelusuran terkait, seperti berisi atau tidak dalam rentang. Jika tidak ada atribut katalog yang telah dikonfigurasi, kontrol ini akan selalu berlaku.

   2. Tentukan Rentang waktu yang berlaku dengan memasukkan Rentang tanggal. Jika salah satu rentang waktu yang ditentukan terpenuhi, atribut katalog akan dicocokkan dengan kueri selama salah satu rentang waktu yang ditentukan. Tambahkan rentang waktu dengan Tambahkan rentang waktu.

   3. Masukkan istilah yang ingin Anda abaikan di bagian Abaikan tindakan.

6. Klik Kirim untuk mengirimkan permintaan kontrol Anda kepada Pemberi Persetujuan. Anda akan dapat melihat status permintaan yang dikirim di Konsol Merchandising. Jika berubah pikiran, Anda dapat menghapus permintaan kontrol.

Langkah-langkah pemberi persetujuan

1. Di bagian Konfigurasi penayangan,tetapkan kontrol Anda ke konfigurasi penayangan yang ada.
2. Setujui permintaan untuk kontrol Abaikan.

Cloud Console

1. Buka halaman Kontrol di konsol Penelusuran untuk Commerce.
   
   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 agar 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 merchandising

1. Klik URL yang diberikan oleh administrator. Login.

   Tindakan ini akan mengarahkan Anda ke halaman Kontrol di Konsol merchandising.

2. Klik Buat kontrol.

3. Tentukan sasaran untuk pengguna akhir dan waktu yang diperlukan. Semua pertanyaan harus dijawab. Klik Berikutnya.

4. Pilih kontrol. Masukkan nama untuk kontrol Anda, pilih produk Penelusuran, lalu pilih jenis kontrol Penggantian.

5. Konfigurasikan kontrol Penggantian:

   1. Di bagian Pemicu, tentukan atribut katalog yang memicu kontrol ini dengan memberikan kriteria ke kueri penelusuran terkait, seperti berisi atau tidak dalam rentang. Jika tidak ada atribut katalog yang dikonfigurasi, kontrol ini akan selalu berlaku.

   2. Tentukan Rentang waktu yang berlaku dengan memasukkan Rentang tanggal. Jika salah satu rentang waktu yang ditentukan terpenuhi, atribut katalog akan dicocokkan dengan kueri selama salah satu rentang waktu yang ditentukan. Tambahkan rentang waktu dengan Tambahkan rentang waktu.

   3. Di bagian Tindakan penggantian, tentukan istilah kueri yang ingin Anda ganti di kolom pertama, dan penggantinya di kolom kedua.

6. Klik Kirim untuk mengirim permintaan kontrol Anda kepada Pemberi Persetujuan. Anda akan dapat melihat status permintaan yang dikirim di Konsol Merchandising. Jika berubah pikiran, Anda dapat menghapus permintaan kontrol.

Langkah-langkah pemberi persetujuan

1. Di bagian Konfigurasi penayangan,tetapkan kontrol Anda ke konfigurasi penayangan yang ada.
2. Setujui permintaan untuk kontrol Penggantian.

Cloud Console

1. Buka halaman Kontrol di konsol Penelusuran untuk Commerce.
   
   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 agar 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 merchandising

1. Klik URL yang diberikan oleh administrator. Login.

   Tindakan ini akan mengarahkan Anda ke halaman Kontrol di Konsol merchandising.

2. Klik Buat kontrol.

3. Tentukan sasaran untuk pengguna akhir dan waktu yang diperlukan. Semua pertanyaan harus dijawab. Klik Berikutnya.

4. Pilih kontrol. Masukkan nama untuk kontrol Anda, pilih produk Penelusuran, lalu pilih jenis kontrol Sematkan.

5. Konfigurasikan kontrol Sematkan:

   1. Di bagian Pemicu, tentukan atribut katalog yang memicu kontrol ini dengan memberikan kriteria ke kueri penelusuran terkait, seperti berisi atau tidak dalam rentang. Jika tidak ada atribut katalog yang dikonfigurasi, kontrol ini akan selalu berlaku.

   2. Tentukan Rentang waktu yang berlaku dengan memasukkan Rentang tanggal. Jika salah satu rentang waktu yang ditentukan terpenuhi, atribut katalog akan dicocokkan dengan kueri selama salah satu rentang waktu yang ditentukan. Tambahkan rentang waktu dengan Tambahkan rentang waktu.

   3. Tentukan Tindakan penyematan yang ingin Anda picu dengan kontrol ini. Tindakan ini ditentukan oleh ID Produk dan posisi pin, sebaiknya angka kurang dari 120 (ukuran halaman standar). Anda dapat mengklik Tambahkan produk dan menambahkan hingga 10 produk.

6. Klik Kirim untuk mengirimkan permintaan kontrol Anda kepada Pemberi Persetujuan. Anda akan dapat melihat status permintaan yang dikirim di Konsol Merchandising. Jika berubah pikiran, Anda dapat menghapus permintaan kontrol.

Langkah-langkah pemberi persetujuan

1. Di bagian Konfigurasi penayangan,tetapkan kontrol Anda ke konfigurasi penayangan yang ada.
2. Setujui permintaan untuk kontrol Sematkan.

Cloud Console

1. Buka halaman Kontrol di konsol Penelusuran untuk Commerce.
   
   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 commerce 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 agar 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.

Cloud Console

1. Buka halaman Evaluasi di konsol Penelusuran untuk Commerce.
   
   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.