Retail diganti namanya menjadi Vertex AI Search untuk retail. Kami sedang dalam proses memperbarui konten untuk mencerminkan branding baru ini.

Membuat kontrol penayangan

Halaman ini menjelaskan cara membuat kontrol penayangan.

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

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

Anda dapat membuat kontrol penayangan di Search for Retail console yang terdiri dari kondisi, yang memicu kontrol, dan tindakan yang terjadi saat kondisi dipicu. Selanjutnya, Anda dapat menambahkan 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 penyajian, 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 mana 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 "shoes" ditelusuri dan kontrol bernama "More Shoes" yang memperluas kueri yang menggunakan istilah "sepatu lari" untuk menyertakan "sepatu olahraga". Jika Anda hanya menyertakan kontrol "gShoe Sale" ke konfigurasi penayangan, permintaan penelusuran yang menggunakan konfigurasi penayangan tersebut akan meningkatkan hasil gShoe untuk kueri yang menggunakan istilah "shoes", tetapi kontrol "More Shoes" tidak berpengaruh karena tidak dilampirkan ke konfigurasi penayangan yang Anda gunakan.

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

Buat atau ubah kontrol penayangan kapan saja di halaman Kontrol atau secara inline menggunakan metode Controls.create. Di konsol, Anda dapat memilih untuk membuat kontrol 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:

Boost/hampir: Memengaruhi peringkat dan urutan hasil dalam daftar hasil yang ditampilkan. Tersedia untuk penelusuran dan rekomendasi.
Filter: Menghapus hasil yang tidak lolos 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. Tersedia beberapa jenis kontrol linguistik:
- Sinonim: Memperluas sinonim yang dipertimbangkan untuk kueri penelusuran.
- Sinonim satu arah: Memperluas sinonim yang dipertimbangkan secara searah untuk istilah tertentu.
- Jangan kaitkan: Mencegah penggunaan grup istilah dalam penelusuran saat istilah tertentu muncul.
- Abaikan: Mencegah istilah digunakan dalam penelusuran.
- Penggantian: Mengganti istilah di kueri penelusuran.

Untuk mengetahui contoh kontrol ini, lihat artikel Tentang kontrol penayangan.

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:

Buat kontrol boost/pengurangan
Membuat kontrol filter
Membuat kontrol pengalihan
Membuat kontrol sinonim dua arah
Membuat kontrol sinonim satu arah
Membuat kontrol jangan kaitkan
Membuat kontrol pengabaian
Membuat kontrol pengganti

Buat kontrol boost/pengurangan

Lihat Kontrol peningkatan/pengurangan untuk informasi selengkapnya tentang jenis kontrol ini.

Jenis kontrol ini tersedia untuk penelusuran dan rekomendasi.

Membuat kontrol peningkatan/pengurangan penelusuran
Membuat kontrol peningkatan/pengurangan rekomendasi

Buat kontrol peningkatan/pengurangan penelusuran

Untuk membuat kontrol peningkatan/pengurangan penelusuran:

Konsol

Buka halaman Controls di Search for Retail console.

Buka halaman Kontrol
Di tab Penyaluran kontrol, klik Create control.

Panel Create control akan terbuka.

Di bagian Preferensi:

Di kolom Nama kontrol, masukkan nama untuk kontrol baru.
Opsional: Untuk mengubah ID kontrol yang dibuat secara otomatis, klik Edit, lalu masukkan ID kontrol baru.
Di bagian Pilihan produk, pilih Telusuri.
Pilih Kontrol peningkatan/pengurangan sebagai jenis kontrol.
Klik lanjutkan untuk melanjutkan ke bagian Pemicu.

Di bagian Pemicu, tetapkan kondisi yang memicu kontrol:

Pilih jenis perilaku pengguna yang memicu kontrol ini:
- Jelajahi kategori: Aturan ini 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).
Anda dapat menetapkan kategori atau kueri tertentu yang dapat memicu kontrol ini pada langkah berikut. Untuk menetapkan kontrol ini agar terpicu saat ada kategori yang dijelajahi atau ada kueri yang ditelusuri, lewati langkah berikut.
Opsional: Tetapkan kondisi kontrol yang memicu aturan berdasarkan apakah kategori tertentu dijelajahi atau kueri tertentu ditelusuri.

Untuk menetapkan kontrol ini agar terpicu pada kategori atau kueri apa pun, lewati langkah ini.

Opsi yang tersedia bergantung pada apakah Anda memilih Jelajahi kategori atau Penelusuran:
- Jika Anda memilih Jelajahi kategori: Di kolom Kategori, masukkan kategori yang akan memicu kontrol ini saat dijelajahi.
- Jika Anda memilih Search: Klik tombol Add query untuk menambahkan istilah kueri (misalnya, running shoes) yang akan difilter, dan pilih salah satu opsi berikut untuk setiap istilah:
  - Pencocokan sebagian: Kontrol ini diterapkan jika kueri berisi sebagian yang cocok dengan istilah kueri ini.
  - Pencocokan penuh: Kontrol ini hanya berlaku jika kueri berisi kecocokan penuh dengan istilah kueri ini.
  Jika salah satu istilah ini disertakan dalam kueri, kontrol akan diterapkan.
Jika Anda menentukan kondisi rentang waktu selain jenis kondisi ini, kontrol hanya diterapkan jika kedua kondisi terpenuhi.
Opsional: Klik tombol Add Time Range untuk menambahkan satu atau beberapa rentang waktu selama kontrol ini dapat diterapkan.

Jika Anda menentukan kategori atau kondisi istilah kueri selain kondisi rentang waktu, kontrol hanya akan diterapkan saat kedua kondisi terpenuhi.
Klik Lanjutkan untuk melanjutkan ke bagian Tindakan.

Di bagian Tindakan:

Tambahkan filter untuk atribut produk di kolom Boost/Kubur 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"))
Untuk Nilai peningkatan/penguatan, gunakan penggeser untuk menyetel kekuatan peningkatan. Nilai positif akan meningkatkan hasil, dan nilai negatif akan menyembunyikannya.
Klik Lanjutkan untuk melanjutkan ke bagian Konfigurasi penayangan.

Di bagian Konfigurasi penayangan:

Pilih konfigurasi penayangan mana yang akan diberi kontrol.
Kirimkan setelan kontrol Anda.

Perlu waktu beberapa menit agar kontrol yang baru dibuat atau diperbarui agar siap untuk menyalurkan traffic langsung. Anda dapat menguji apakah perubahan telah diterapkan di halaman Evaluate konsol.

Anda dapat menemukan kontrol baru tersebut 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 boost/buram 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 menampilkan 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 menampilkan 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 agar siap untuk menyalurkan traffic langsung. Anda dapat menguji apakah perubahan telah diterapkan di halaman Evaluate 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.

Buat rekomendasi boost/pengendalian operasi

Untuk membuat rekomendasi boost/pengendalian:

Konsol

Buka halaman Controls di Search for Retail console.

Buka halaman Kontrol
Di tab Penyaluran kontrol, klik Create control.

Panel Create control akan terbuka.

Di bagian Preferensi:

Di kolom Nama kontrol, masukkan nama untuk kontrol baru.
(Opsional) Untuk mengubah ID kontrol yang dibuat secara otomatis, klik Edit, lalu masukkan ID kontrol baru.
Di bagian Pilihan produk, pilih Rekomendasi.
Pilih Kontrol peningkatan/pengurangan sebagai jenis kontrol.
Klik Lanjutkan untuk melanjutkan ke bagian Tindakan.

Di bagian Tindakan:

Tambahkan filter untuk atribut produk di kolom Boost/Kubur produk.

Gunakan sintaksis ekspresi filter yang didokumentasikan dalam Rekomendasi filter.

Misalnya, untuk menentukan versi merah dan biru "product1" dan "product2": (id: ANY("product1","product2")) AND (colorFamily: ANY("Red","Blue"))
Untuk Nilai peningkatan/penguatan, gunakan penggeser untuk menyetel kekuatan peningkatan. Nilai positif akan meningkatkan hasil, dan nilai negatif akan menyembunyikannya.
Klik Lanjutkan untuk melanjutkan ke bagian Konfigurasi penayangan.

Di bagian Konfigurasi penayangan:

Pilih konfigurasi penayangan mana yang akan diberi kontrol.
Kirimkan setelan kontrol Anda.

Perlu waktu beberapa menit agar kontrol yang baru dibuat atau diperbarui agar siap untuk menyalurkan traffic langsung. Anda dapat menguji apakah perubahan telah diterapkan di halaman Evaluate konsol.

Anda dapat menemukan kontrol baru tersebut 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 dalam 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"

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

Buka halaman Controls di Search for Retail console.

Buka halaman Kontrol
Di tab Penyaluran kontrol, klik Create control.

Panel Create control akan terbuka.

Di bagian Preferensi:

Di kolom Nama kontrol, masukkan nama untuk kontrol baru.
Opsional: Untuk mengubah ID kontrol yang dibuat secara otomatis, klik Edit, lalu masukkan ID kontrol baru.
Pilih Kontrol filter sebagai jenis kontrol.
Klik lanjutkan untuk melanjutkan ke bagian Pemicu.

Di bagian Pemicu:

Pilih jenis perilaku pengguna yang memicu kontrol ini:
- Jelajahi kategori: Aturan ini 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).
Opsional: Tetapkan kondisi kontrol yang memicu aturan berdasarkan kategori yang dijelajahi, atau kueri yang ditelusuri. Opsi yang tersedia bergantung pada jika Anda memilih Browse category atau Search:
- Jika Anda memilih Jelajahi kategori: Di kolom Kategori, masukkan kategori yang akan memicu kontrol ini saat dijelajahi.
- Jika Anda memilih Search: Klik tombol Add query untuk menambahkan istilah kueri (misalnya, running shoes) yang akan difilter, dan pilih salah satu opsi berikut untuk setiap istilah:
  - Pencocokan sebagian: Kontrol ini diterapkan jika kueri berisi sebagian yang cocok dengan istilah kueri ini.
  - Pencocokan penuh: Kontrol ini hanya berlaku jika kueri berisi kecocokan penuh dengan istilah kueri ini.
  Jika salah satu istilah ini disertakan dalam kueri, kontrol akan diterapkan.
Jika Anda menentukan kondisi rentang waktu selain kondisi ini, kontrol hanya diterapkan jika kedua kondisi terpenuhi.
Opsional: Klik tombol Add Time Range untuk menambahkan satu atau beberapa rentang waktu selama kontrol ini dapat diterapkan.

Jika Anda menentukan kategori atau kondisi istilah kueri selain kondisi rentang waktu ini, kontrol hanya diterapkan saat kedua kondisi terpenuhi.
Klik Lanjutkan untuk melanjutkan ke bagian Tindakan.

Di bagian Tindakan:

Tambahkan filter untuk atribut produk di kolom Filter tindakan.

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"))
Klik Lanjutkan untuk melanjutkan ke bagian Konfigurasi penayangan.

Di bagian Konfigurasi penayangan:

Pilih konfigurasi penayangan mana yang akan diberi kontrol.
Kirimkan setelan kontrol Anda.

Perlu waktu beberapa menit agar kontrol yang baru dibuat atau diperbarui agar siap untuk menyalurkan traffic langsung. Anda dapat menguji apakah perubahan telah diterapkan di halaman Evaluate konsol.

Anda dapat menemukan kontrol baru tersebut 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 menelusuri di situs Anda (search.request.query tidak kosong).

Contoh berikut menampilkan 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 menampilkan 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 informasi selengkapnya tentang jenis kontrol ini.

Konsol

Buka halaman Controls di Search for Retail console.

Buka halaman Kontrol
Di tab Penyaluran kontrol, klik Create control.

Panel Create control akan terbuka.

Di bagian Preferensi:

Di kolom Nama kontrol, masukkan nama untuk kontrol baru.
Opsional: Untuk mengubah ID kontrol yang dibuat secara otomatis, klik Edit, lalu masukkan ID kontrol baru.
Pilih Kontrol pengalihan sebagai jenis kontrol.
Klik lanjutkan untuk melanjutkan ke bagian Pemicu.

Di bagian Pemicu, buat setidaknya satu istilah kueri atau pemicu rentang waktu. Kontrol pengalihan memerlukan setidaknya satu pemicu:

Pilih jenis perilaku pengguna yang memicu kontrol ini:
- Jelajahi kategori: Aturan ini 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).
Tetapkan kondisi kontrol yang memicu aturan berdasarkan kategori yang dijelajahi, atau kueri yang ditelusuri. Opsi yang tersedia bergantung pada jika Anda memilih Browse category atau Search:
- Jika Anda memilih Jelajahi kategori: Di kolom Kategori, masukkan kategori yang akan memicu kontrol ini saat dijelajahi.
- Jika Anda memilih Search: Klik tombol Add query untuk menambahkan istilah kueri (misalnya, running shoes) yang akan difilter, dan pilih salah satu opsi berikut untuk setiap istilah:
  - Pencocokan sebagian: Kontrol ini diterapkan jika kueri berisi sebagian yang cocok dengan istilah kueri ini.
  - Pencocokan penuh: Kontrol ini hanya berlaku jika kueri berisi kecocokan penuh dengan istilah kueri ini.
  Jika salah satu istilah ini disertakan dalam kueri, kontrol akan diterapkan.
Jika Anda menentukan kondisi rentang waktu selain kondisi ini, kontrol hanya diterapkan jika kedua kondisi terpenuhi.
Klik tombol Add Time Range untuk menambahkan satu atau beberapa rentang waktu saat kontrol ini dapat diterapkan.

Jika Anda menentukan kategori atau kondisi istilah kueri selain kondisi rentang waktu ini, kontrol hanya diterapkan saat kedua kondisi terpenuhi.
Klik Lanjutkan untuk melanjutkan ke bagian Tindakan.

Di bagian Tindakan:

Masukkan URI yang menjadi tujuan pengalihan saat kontrol ini dipicu.
Klik Lanjutkan untuk melanjutkan ke bagian Konfigurasi penayangan.

Di bagian Konfigurasi penayangan:

Pilih konfigurasi penayangan mana yang akan diberi kontrol.
Kirimkan setelan kontrol Anda.

Perlu waktu beberapa menit agar kontrol yang baru dibuat atau diperbarui agar siap untuk menyalurkan traffic langsung. Anda dapat menguji apakah perubahan telah diterapkan di halaman Evaluate konsol.

Anda dapat menemukan kontrol baru tersebut 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 menampilkan 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 menampilkan 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

Buka halaman Controls di Search for Retail console.

Buka halaman Kontrol
Di tab Penyaluran kontrol, klik Create control.
Di kolom Nama kontrol, masukkan nama untuk kontrol baru.

Panel Create control akan terbuka.

Di bagian Preferensi:

Opsional: Untuk mengubah ID kontrol yang dibuat secara otomatis, klik Edit, lalu masukkan ID kontrol baru.
Pilih Kontrol sinonim dua arah sebagai jenis kontrol.
Klik lanjutkan untuk melanjutkan ke bagian Pemicu.

Di bagian Pemicu:

Opsional: Klik tombol Add Time Range untuk menambahkan satu atau beberapa rentang waktu selama kontrol ini dapat diterapkan.
Klik Lanjutkan untuk melanjutkan ke bagian Tindakan.

Di bagian Tindakan:

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

Jika salah satu istilah ini disertakan dalam kueri, penelusuran akan mempertimbangkan istilah kueri lainnya sebagai sinonim dari istilah yang disertakan.
Klik Lanjutkan untuk melanjutkan ke bagian Konfigurasi penayangan.

Di bagian Konfigurasi penayangan:

Pilih konfigurasi penayangan mana yang akan diberi kontrol.
Kirimkan setelan kontrol Anda.

Perlu waktu beberapa menit agar kontrol yang baru dibuat atau diperbarui agar siap untuk menyalurkan traffic langsung. Anda dapat menguji apakah perubahan telah diterapkan di halaman Evaluate konsol.

Anda dapat menemukan kontrol baru tersebut 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 untuk menayangkan konfigurasi secara inline.

Membuat kontrol sinonim satu arah

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

Konsol

Buka halaman Controls di Search for Retail console.

Buka halaman Kontrol
Di tab Penyaluran kontrol, klik Create control.

Panel Create control akan terbuka.

Di bagian Preferensi:

Di kolom Nama kontrol, masukkan nama untuk kontrol baru.
Opsional: Untuk mengubah ID kontrol yang dibuat secara otomatis, klik Edit, lalu masukkan ID kontrol baru.
Pilih Kontrol sinonim satu arah sebagai jenis kontrol.
Klik lanjutkan untuk melanjutkan ke bagian Pemicu.

Di bagian Pemicu:

Opsional: Klik tombol Add Time Range untuk menambahkan satu atau beberapa rentang waktu selama kontrol ini dapat diterapkan.
Klik Lanjutkan untuk melanjutkan ke bagian Tindakan.

Di bagian Tindakan:

Di kolom Istilah kueri, masukkan istilah (misalnya, shoes) yang harus memiliki sinonim yang terkait dengannya jika salah satu istilah tersebut disertakan dalam kueri.
Di kolom Synonyms, masukkan istilah yang akan digunakan sebagai sinonim untuk istilah kueri yang Anda tentukan (misalnya, sneakers dan sandals sebagai sinonim satu arah untuk istilah kueri shoes).
Klik Lanjutkan untuk melanjutkan ke bagian Konfigurasi penayangan.

Di bagian Konfigurasi penayangan:

Pilih konfigurasi penayangan mana yang akan diberi kontrol.
Kirimkan setelan kontrol Anda.

Perlu waktu beberapa menit agar kontrol yang baru dibuat atau diperbarui agar siap untuk menyalurkan traffic langsung. Anda dapat menguji apakah perubahan telah diterapkan di halaman Evaluate konsol.

Anda dapat menemukan kontrol baru tersebut 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

Buka halaman Controls di Search for Retail console.

Buka halaman Kontrol
Di tab Penyaluran kontrol, klik Create control.

Panel Create control akan terbuka.

Di bagian Preferensi:

Di kolom Nama kontrol, masukkan nama untuk kontrol baru.
Opsional: Untuk mengubah ID kontrol yang dibuat secara otomatis, klik Edit, lalu masukkan ID kontrol baru.
Pilih Jangan kaitkan kontrol sebagai jenis kontrol.
Klik lanjutkan untuk melanjutkan ke bagian Pemicu.

Di bagian Pemicu:

Opsional: Klik tombol Add Time Range untuk menambahkan satu atau beberapa rentang waktu selama kontrol ini dapat diterapkan.
Klik Lanjutkan untuk melanjutkan ke bagian Tindakan.

Di bagian Tindakan:

Di kolom Istilah kueri, masukkan istilah (misalnya, gShoe) yang ingin Anda jelaskan secara eksplisit dari istilah lain.
Di kolom Istilah kueri, masukkan istilah yang tidak boleh dikaitkan di hasil penelusuran dengan istilah kueri yang telah Anda tentukan.

Misalnya, Anda dapat memisahkan istilah kueri gShoe dari istilah cheap.
Klik Lanjutkan untuk melanjutkan ke bagian Konfigurasi penayangan.

Di bagian Konfigurasi penayangan:

Pilih konfigurasi penayangan mana yang akan diberi kontrol.
Kirimkan setelan kontrol Anda.

Perlu waktu beberapa menit agar kontrol yang baru dibuat atau diperbarui agar siap untuk menyalurkan traffic langsung. Anda dapat menguji apakah perubahan telah diterapkan di halaman Evaluate konsol.

Anda dapat menemukan kontrol baru tersebut 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 pengabaian

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

Konsol

Buka halaman Controls di Search for Retail console.

Buka halaman Kontrol
Di tab Penyaluran kontrol, klik Create control.

Panel Create control akan terbuka.

Di bagian Preferensi:

Di kolom Nama kontrol, masukkan nama untuk kontrol baru.
Opsional: Untuk mengubah ID kontrol yang dibuat secara otomatis, klik Edit, lalu masukkan ID kontrol baru.
Pilih Jangan kaitkan kontrol sebagai jenis kontrol.
Klik lanjutkan untuk melanjutkan ke bagian Pemicu.

Di bagian Pemicu:

Opsional: Klik tombol Add Time Range untuk menambahkan satu atau beberapa rentang waktu selama kontrol ini dapat diterapkan.
Klik Lanjutkan untuk melanjutkan ke bagian Tindakan.

Di bagian Tindakan:

Di kolom Abaikan istilah, masukkan istilah (misalnya, shoddy) yang ingin diabaikan oleh penelusuran saat dimasukkan sebagai istilah kueri.
Klik Lanjutkan untuk melanjutkan ke bagian Konfigurasi penayangan.

Di bagian Konfigurasi penayangan:

Pilih konfigurasi penayangan mana yang akan diberi kontrol.
Kirimkan setelan kontrol Anda.

Perlu waktu beberapa menit agar kontrol yang baru dibuat atau diperbarui agar siap untuk menyalurkan traffic langsung. Anda dapat menguji apakah perubahan telah diterapkan di halaman Evaluate konsol.

Anda dapat menemukan kontrol baru tersebut 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 informasi selengkapnya tentang jenis kontrol ini.

Konsol

Buka halaman Controls di Search for Retail console.

Buka halaman Kontrol
Di tab Penyaluran kontrol, klik Create control.

Panel Create control akan terbuka.

Di bagian Preferensi:

Di kolom Nama kontrol, masukkan nama untuk kontrol baru.
Opsional: Untuk mengubah ID kontrol yang dibuat secara otomatis, klik Edit, lalu masukkan ID kontrol baru.
Pilih Kontrol penggantian sebagai jenis kontrol.
Klik lanjutkan untuk melanjutkan ke bagian Pemicu.

Di bagian Pemicu:

Opsional: Klik tombol Add Time Range untuk menambahkan satu atau beberapa rentang waktu selama kontrol ini dapat diterapkan.
Klik Lanjutkan untuk melanjutkan ke bagian Tindakan.

Di bagian Tindakan:

Di kolom Istilah kueri, masukkan istilah kueri (misalnya, gShoe) yang ingin Anda ganti dengan istilah pengganti.
Di kolom Istilah penggantian, masukkan istilah yang akan menggantikan istilah kueri yang Anda tentukan.

Misalnya, Anda dapat mengganti istilah kueri gShoe dengan istilah pengganti Google Shoe.
Klik Lanjutkan untuk melanjutkan ke bagian Konfigurasi penayangan.

Di bagian Konfigurasi penayangan:

Pilih konfigurasi penayangan mana yang akan diberi kontrol.
Kirimkan setelan kontrol Anda.

Perlu waktu beberapa menit agar kontrol yang baru dibuat atau diperbarui agar siap untuk menyalurkan traffic langsung. Anda dapat menguji apakah perubahan telah diterapkan di halaman Evaluate konsol.

Anda dapat menemukan kontrol baru tersebut 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.