Membuat kontrol inferensi

Konsol merchandising

1. Klik URL yang diberikan oleh administrator. Login.

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

2. Klik add_boxBuat kontrol.

3. Tentukan tujuan untuk pengguna akhir Anda 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 Promosikan/Sembunyikan.

5. Mengonfigurasi kontrol Naikkan/Turunkan:

   1. Di bagian Pemicu, tentukan atribut katalog yang memicu kontrol ini dengan memberikan kriteria pada kueri penelusuran terkait, seperti berisi atau tidak dalam rentang. 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 add_boxTambahkan rentang waktu.

   3. Tentukan Tindakan Promosikan/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 add_boxTambahkan atribut untuk menambahkan lebih banyak atribut.

6. Gunakan penggeser untuk menetapkan Nilai promosikan/sembunyikan. Angka negatif menyembunyikan, dan angka positif meningkatkan.

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

Cloud Console

1. Buka halaman Kontrol di konsol Penelusuran untuk e-commerce.
   
   Buka halaman Kontrol

2. Di tab Kontrol penayangan, klik add_boxBuat 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 Penelusuran.

6. Pilih Kontrol naikkan/tenggelamkan sebagai jenis kontrol. Klik Lanjutkan.

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

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

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

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

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

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

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

10. Klik Lanjutkan untuk melanjutkan ke bagian Tindakan.

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

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

12. Untuk Nilai promosikan/sembunyikan, gunakan penggeser untuk menetapkan kekuatan promosi. Nilai positif meningkatkan hasil, dan nilai negatif menguburnya. Klik Continue.

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

14. Kirim setelan kontrol Anda.

    Kontrol yang baru dibuat atau diperbarui memerlukan waktu beberapa menit agar siap untuk menayangkan traffic live. Anda dapat menguji apakah perubahan telah diterapkan di halaman Evaluate di konsol.

Anda kini 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 ada dalam isi permintaan.

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

Kontrol naik/turun 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 disetel 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"
  

Kontrol yang baru dibuat atau diperbarui memerlukan waktu beberapa menit agar siap untuk menayangkan traffic live. Anda dapat menguji apakah perubahan telah diterapkan di halaman Evaluate di 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.

Konsol merchandising

1. Klik URL yang diberikan oleh administrator. Login.

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

2. Klik add_boxBuat kontrol.

3. Tentukan tujuan untuk pengguna akhir Anda 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 Promosikan/Sembunyikan.

5. Mengonfigurasi kontrol Naikkan/Turunkan:

   1. Di bagian Pemicu, masukkan kategori halaman yang akan memicu kontrol. 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 add_boxTambahkan rentang waktu.

   3. Tentukan Tindakan Promosikan/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 add_boxTambahkan atribut untuk menambahkan lebih banyak atribut.

6. Gunakan penggeser untuk menetapkan Nilai promosikan/sembunyikan. Angka negatif adalah tenggelamkan, angka positif adalah tingkatkan.

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

Cloud Console

1. Buka halaman Kontrol di konsol Penelusuran untuk e-commerce.
   
   Buka halaman Kontrol

2. Di tab Serving controls, klik add_boxCreate control.

   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 dan masukkan ID kontrol baru.

5. Di bagian Pemilihan produk, pilih Rekomendasi.

6. Pilih Kontrol naikkan/tenggelamkan sebagai jenis kontrol.

7. Klik Lanjutkan untuk melanjutkan ke bagian Tindakan.

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

   Gunakan sintaksis ekspresi filter yang didokumentasikan dalam Filter rekomendasi.

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

9. Untuk Nilai promosikan/sembunyikan, gunakan penggeser untuk menetapkan kekuatan promosi. Nilai positif meningkatkan hasil, dan nilai negatif menguburnya.

10. Klik Lanjutkan untuk melanjutkan ke bagian Konfigurasi penayangan.

11. Pilih konfigurasi penayangan yang akan diterapkan kontrolnya.

12. Kirim setelan kontrol Anda.

    Kontrol yang baru dibuat atau diperbarui memerlukan waktu beberapa menit agar siap untuk menayangkan traffic live. Anda dapat menguji apakah perubahan telah diterapkan di halaman Evaluate di 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 ada 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"
   

Kontrol yang baru dibuat atau diperbarui memerlukan waktu beberapa menit agar siap untuk menayangkan traffic live. Anda dapat menguji apakah perubahan telah diterapkan di halaman Evaluate di 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.

Konsol merchandising

1. Klik URL yang diberikan oleh administrator. Login.

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

2. Klik add_boxBuat kontrol.

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

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

5. Konfigurasi kontrol Filter Anda:

   1. Di bagian Pemicu, tentukan atribut katalog yang memicu kontrol ini dengan memberikan kriteria pada kueri penelusuran atau kategori halaman terkait, seperti berisi atau tidak dalam rentang. 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 add_boxTambahkan 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 add_boxTambahkan atribut untuk menambahkan lebih banyak atribut.

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

Cloud Console

1. Buka halaman Kontrol di konsol Penelusuran untuk e-commerce.
   
   Buka halaman Kontrol

2. Di tab Serving controls, klik add_boxCreate control.

   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 membuka bagian Pemicu.

7. Pilih jenis perilaku pengguna yang memicu kontrol ini:

   • Jelajahi 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 Penelusuran: Klik tombol Tambahkan kueri untuk menambahkan istilah kueri (misalnya, running shoes) yang akan difilter, lalu pilih salah satu 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.

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

10. Klik Lanjutkan untuk melanjutkan ke bagian Tindakan.

11. Tambahkan filter untuk atribut produk di kolom Tindakan filter.

    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 diterapkan kontrolnya.

14. Kirim setelan kontrol Anda.

    Kontrol yang baru dibuat atau diperbarui memerlukan waktu beberapa menit agar siap untuk menayangkan traffic live. Anda dapat menguji apakah perubahan telah diterapkan di halaman Evaluate di 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 ada 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 disetel 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.

Konsol merchandising

1. Klik URL yang diberikan oleh administrator. Login.

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

2. Klik add_boxBuat kontrol.

3. Tentukan tujuan untuk pengguna akhir Anda 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 Pengalihan.

5. Konfigurasi kontrol Pengalihan Anda:

   1. Di bagian Pemicu, tentukan atribut katalog yang memicu kontrol ini dengan memberikan kriteria pada kueri penelusuran terkait, seperti berisi atau tidak dalam rentang. 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 add_boxTambahkan rentang waktu.

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

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

Cloud Console

1. Buka halaman Kontrol di konsol Penelusuran untuk e-commerce.
   
   Buka halaman Kontrol

2. Di tab Serving controls, klik add_boxCreate control.

   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 pengalihan sebagai jenis kontrol.

6. Klik lanjutkan untuk membuka bagian Pemicu.

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

8. Pilih jenis perilaku pengguna yang memicu kontrol ini:

   • Jelajahi 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 Penelusuran: Klik tombol Tambahkan kueri untuk menambahkan istilah kueri (misalnya, running shoes) yang akan difilter, lalu pilih salah satu 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.

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

11. Klik Lanjutkan untuk melanjutkan ke bagian Tindakan.

12. Masukkan URI untuk mengalihkan ke saat kontrol ini dipicu.

13. Klik Lanjutkan untuk melanjutkan ke bagian Konfigurasi penayangan.

14. Pilih konfigurasi penayangan yang akan diterapkan kontrolnya.

15. Kirim setelan kontrol Anda.

    Kontrol yang baru dibuat atau diperbarui memerlukan waktu beberapa menit agar siap untuk menayangkan traffic live. Anda dapat menguji apakah perubahan telah diterapkan di halaman Evaluate di 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 ada 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 melakukan penelusuran di situs Anda (search.request.query tidak kosong).

Contoh berikut menunjukkan kolom untuk kontrol yang dipicu penjelajahan, dengan searchSolutionUseCase disetel 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.

Konsol merchandising

1. Klik URL yang diberikan oleh administrator. Login.

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

2. Klik add_boxBuat kontrol.

3. Tentukan tujuan untuk pengguna akhir Anda 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. Konfigurasi kontrol Sinonim dua arah:

   1. Di bagian Pemicu, tentukan atribut katalog yang memicu kontrol ini dengan memberikan kriteria pada kueri penelusuran terkait, seperti berisi atau tidak dalam rentang. 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 add_boxTambahkan rentang waktu.

   3. Tentukan Jenis sinonim yang ingin Anda picu 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 akan menghasilkan sofa merah marun, tetapi kueri sofa marun akan 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 Anda berubah pikiran, Anda dapat menghapus permintaan kontrol Anda.

Cloud Console

1. Buka halaman Kontrol di konsol Penelusuran untuk e-commerce.
   
   Buka halaman Kontrol

2. Di tab Serving controls, klik add_boxCreate control.

3. Di kolom Nama kontrol, 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 membuka bagian Pemicu.

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

9. Klik Lanjutkan untuk melanjutkan ke bagian Tindakan.

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

    Jika salah satu istilah ini disertakan dalam kueri, penelusuran 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 diterapkan kontrolnya.

13. Kirim setelan kontrol Anda.

    Kontrol yang baru dibuat atau diperbarui memerlukan waktu beberapa menit agar siap untuk menayangkan traffic live. Anda dapat menguji apakah perubahan telah diterapkan di halaman Evaluate di 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 ada 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.

Konsol merchandising

1. Klik URL yang diberikan oleh administrator. Login.

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

2. Klik add_boxBuat kontrol.

3. Tentukan tujuan untuk pengguna akhir Anda 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. Konfigurasi kontrol Sinonim satu arah:

   1. Di bagian Pemicu, tentukan atribut katalog yang memicu kontrol ini dengan memberikan kriteria pada kueri penelusuran terkait, seperti berisi atau tidak dalam rentang. 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 add_boxTambahkan rentang waktu.

   3. Tentukan Jenis sinonim yang ingin Anda picu dengan kontrol ini. Pilih Satu arah. 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 satu arah 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 pada 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 Anda berubah pikiran, Anda dapat menghapus permintaan kontrol Anda.

Cloud Console

1. Buka halaman Kontrol di konsol Penelusuran untuk e-commerce.
   
   Buka halaman Kontrol

2. Di tab Serving controls, klik add_boxCreate control.

   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 membuka bagian Pemicu.

7. Opsional: Klik tombol Tambahkan Rentang Waktu untuk menambahkan satu atau beberapa rentang waktu saat 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 jika salah satu istilah tersebut 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 diterapkan kontrolnya.

13. Kirim setelan kontrol Anda.

    Kontrol yang baru dibuat atau diperbarui memerlukan waktu beberapa menit agar siap untuk menayangkan traffic live. Anda dapat menguji apakah perubahan telah diterapkan di halaman Evaluate di 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 ada 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.

Konsol merchandising

1. Klik URL yang diberikan oleh administrator. Login.

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

2. Klik add_boxBuat kontrol.

3. Tentukan tujuan untuk pengguna akhir Anda 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. Konfigurasi kontrol Jangan kaitkan:

   1. Di bagian Pemicu, tentukan atribut katalog yang memicu kontrol ini dengan memberikan kriteria pada kueri penelusuran terkait, seperti berisi atau tidak dalam rentang. 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 add_boxTambahkan 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 masing-masing istilah tersebut ke kolom istilah kueri dan istilah yang tidak terkait.

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

Cloud Console

1. Buka halaman Kontrol di konsol Penelusuran untuk e-commerce.
   
   Buka halaman Kontrol

2. Di tab Serving controls, klik add_boxCreate control.

   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 membuka bagian Pemicu.

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

8. Klik Lanjutkan untuk melanjutkan ke bagian Tindakan.

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

10. Di kolom Istilah yang tidak terkait, masukkan istilah yang akan dibatalkan kaitannya dari hasil penelusuran dengan istilah kueri yang telah Anda tentukan.

    Misalnya, Anda dapat membatalkan pengaitan istilah kueri gShoe dari istilah cheap.

11. Klik Lanjutkan untuk melanjutkan ke bagian Konfigurasi penayangan.

12. Pilih konfigurasi penayangan yang akan diterapkan kontrolnya.

13. Kirim setelan kontrol Anda.

    Kontrol yang baru dibuat atau diperbarui memerlukan waktu beberapa menit agar siap untuk menayangkan traffic live. Anda dapat menguji apakah perubahan telah diterapkan di halaman Evaluate di 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 ada 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.

Konsol merchandising

1. Klik URL yang diberikan oleh administrator. Login.

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

2. Klik add_boxBuat kontrol.

3. Tentukan tujuan untuk pengguna akhir Anda 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. Konfigurasi kontrol Abaikan:

   1. Di bagian Pemicu, tentukan atribut katalog yang memicu kontrol ini dengan memberikan kriteria pada kueri penelusuran terkait, seperti berisi atau tidak dalam rentang. 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 add_boxTambahkan rentang waktu.

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

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

Cloud Console

1. Buka halaman Kontrol di konsol Penelusuran untuk e-commerce.
   
   Buka halaman Kontrol

2. Di tab Serving controls, klik add_boxCreate control.

   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 membuka bagian Pemicu.

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

8. Klik Lanjutkan untuk melanjutkan ke bagian Tindakan.

9. Di kolom Istilah yang diabaikan, masukkan istilah (misalnya, shoddy) yang ingin Anda abaikan dalam penelusuran saat dimasukkan sebagai istilah kueri.

10. Klik Lanjutkan untuk melanjutkan ke bagian Konfigurasi penayangan.

11. Pilih konfigurasi penayangan yang akan diterapkan kontrolnya.

12. Kirim setelan kontrol Anda.

    Kontrol yang baru dibuat atau diperbarui memerlukan waktu beberapa menit agar siap untuk menayangkan traffic live. Anda dapat menguji apakah perubahan telah diterapkan di halaman Evaluate di 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 ada 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.

Konsol merchandising

1. Klik URL yang diberikan oleh administrator. Login.

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

2. Klik add_boxBuat kontrol.

3. Tentukan tujuan untuk pengguna akhir Anda 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. Konfigurasi kontrol Penggantian:

   1. Di bagian Pemicu, tentukan atribut katalog yang memicu kontrol ini dengan memberikan kriteria pada kueri penelusuran terkait, seperti berisi atau tidak dalam rentang. 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 add_boxTambahkan 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 Anda berubah pikiran, Anda dapat menghapus permintaan kontrol Anda.

Cloud Console

1. Buka halaman Kontrol di konsol Penelusuran untuk e-commerce.
   
   Buka halaman Kontrol

2. Di tab Serving controls, klik add_boxCreate control.

   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 pengganti sebagai jenis kontrol.

6. Klik lanjutkan untuk membuka bagian Pemicu.

7. Opsional: Klik tombol Tambahkan Rentang Waktu untuk menambahkan satu atau beberapa rentang waktu saat 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 harus 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 diterapkan kontrolnya.

13. Kirim setelan kontrol Anda.

    Kontrol yang baru dibuat atau diperbarui memerlukan waktu beberapa menit agar siap untuk menayangkan traffic live. Anda dapat menguji apakah perubahan telah diterapkan di halaman Evaluate di 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 ada 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.

Konsol merchandising

1. Klik URL yang diberikan oleh administrator. Login.

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

2. Klik add_boxBuat kontrol.

3. Tentukan tujuan untuk pengguna akhir Anda 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 Penyematan.

5. Konfigurasi kontrol Penyematan Anda:

   1. Di bagian Pemicu, tentukan atribut katalog yang memicu kontrol ini dengan memberikan kriteria pada kueri penelusuran terkait, seperti berisi atau tidak dalam rentang. 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 add_boxTambahkan 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 umum). Anda dapat mengklik add_boxTambahkan produk dan menambahkan hingga 10 produk.

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

Cloud Console

1. Buka halaman Kontrol di konsol Penelusuran untuk e-commerce.
   
   Buka halaman Kontrol

2. Di tab Serving controls, klik add_boxCreate control.

   Panel Buat kontrol akan terbuka.

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

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

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

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

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

   • Jelajahi kategori: Permintaan penjelajahan 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 memicu kontrol ini.

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

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

   • Penelusuran: 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 saat kontrol ini dapat diterapkan.

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

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

11. Klik Lanjutkan untuk melanjutkan ke bagian Konfigurasi penayangan. Pilih konfigurasi penayangan yang akan diterapkan kontrolnya, lalu kirimkan setelan kontrol Anda.

    Kontrol yang baru dibuat atau diperbarui memerlukan waktu beberapa menit agar siap untuk menayangkan traffic live. Anda dapat menguji apakah perubahan telah diterapkan di halaman Evaluate di 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 ada 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 dalam 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.

Cloud Console

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