Membuat kontrol inferensi

Halaman ini menjelaskan cara membuat kontrol penayangan.

Kontrol penayangan adalah aturan yang Anda tentukan dan terapkan ke setiap konfigurasi penayangan.

Anda dapat membuat kontrol penayangan di konsol AI Commerce Search di Gemini Enterprise for Customer Experience yang terdiri dari kondisi, yang memicu kontrol, dan tindakan yang terjadi saat kondisi memicu. Kemudian, Anda dapat melampirkan kontrol penayangan baru ke konfigurasi penayangan.

Hubungan antara kontrol dan konfigurasi penayangan

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

Saat membuat kontrol penayangan dan konfigurasi penayangan, Anda memilih produk (rekomendasi atau penelusuran) yang dapat menggunakan kontrol tersebut.

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

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 sepatu ditelusuri dan kontrol bernama Lebih banyak sepatu yang memperluas kueri menggunakan istilah sepatu lari untuk menyertakan sepatu olahraga. Jika Anda hanya melampirkan kontrol Penjualan gShoe ke konfigurasi penayangan, maka permintaan penelusuran menggunakan konfigurasi penayangan tersebut akan meningkatkan hasil gShoe untuk kueri yang menggunakan istilah sepatu, tetapi kontrol Lebih banyak sepatu tidak berpengaruh karena tidak dilampirkan ke konfigurasi penayangan yang Anda gunakan.

Untuk mengetahui informasi selengkapnya, lihat Tentang konfigurasi penayangan.

Video dan panduan memulai cepat

  • Pengantar kontrol penayangan: Kontrol penayangan memungkinkan Anda membuat aturan yang menyesuaikan cara konfigurasi penayangan menampilkan hasil penelusuran.
  • Meningkatkan/mengubur: Memengaruhi peringkat dan urutan hasil dalam daftar hasil yang ditampilkan. Tersedia untuk penelusuran dan rekomendasi.
  • Filter: Menghapus hasil yang tidak lulus filter dari daftar hasil yang ditampilkan. Hanya tersedia untuk penelusuran.
  • Pengalihan: Mengalihkan pengguna ke halaman tertentu, bergantung pada kueri penelusuran. Hanya tersedia untuk penelusuran.

Tutorial ini menunjukkan cara menggunakan kontrol pengalihan.

  • Linguistik: Menyesuaikan linguistik kueri penelusuran. Hanya tersedia untuk penelusuran.
    Beberapa jenis kontrol linguistik tersedia:
    • Sinonim: Memperluas sinonim yang dipertimbangkan untuk kueri penelusuran.
    • Sinonim satu arah: Memperluas sinonim yang dipertimbangkan secara satu arah untuk istilah tertentu.
    • Jangan kaitkan: Mencegah sekelompok istilah digunakan dalam penelusuran saat istilah tertentu muncul.
    • Abaikan: Mencegah istilah digunakan dalam penelusuran.
    • Penggantian: Mengganti istilah dalam kueri penelusuran.
  • Penyematan: Memengaruhi pengurutan hasil, menempatkan hasil pada posisi tertentu — misalnya, pada posisi 4. Tersedia untuk penelusuran dan penjelajahan.

Untuk contoh kontrol ini, lihat Tentang kontrol penayangan.

Opsi konfigurasi kontrol penayangan

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

Anda dapat membuat hingga 100 kontrol penayangan di Penelusuran AI Commerce. Jika Anda memerlukan kontrol penayangan lebih banyak, minta kuota tambahan. Untuk melakukannya, ikuti langkah-langkah di bagian Meningkatkan kuota.

Konfigurasi penayangan dapat memiliki hingga 100 kontrol penayangan jenis apa pun, kecuali kontrol pengalihan penelusuran, yang batasnya dapat mencapai 1.000 per konfigurasi penayangan. Perlu diingat bahwa kuota untuk kontrol pada satu konfigurasi penayangan dapat berbeda dengan kuota keseluruhan yang diizinkan untuk jenis kontrol di AI Commerce Search API Anda.

Anda dapat membuat kontrol penayangan dengan cara berikut:

Untuk menggunakan konsol Google Cloud guna membuat kontrol penayangan:

  1. Buka halaman Kontrol di konsol AI Commerce Search di Gemini Enterprise for Customer Experience.

    Buka halaman Kontrol

  2. Ikuti Google Cloud langkah-langkah konsol di bagian setiap kontrol penayangan.

Jenis kontrol

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

Membuat kontrol naikkan/tenggelamkan

Jenis kontrol ini tersedia untuk penelusuran dan rekomendasi.

Lihat Kontrol naikkan/tenggelamkan untuk mengetahui informasi selengkapnya tentang jenis kontrol ini.

Untuk membuat kontrol peningkatan/penguburan penelusuran:

Cloud Console

  1. Buka halaman Kontrol di konsol AI Commerce Search di Gemini Enterprise for Customer Experience.

    Buka halaman Kontrol

  2. Di tab Kontrol penayangan, klik Buat kontrol.

    Panel Buat kontrol akan terbuka.

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

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

  5. Di bagian Pemilihan produk, pilih 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 naik/turun, gunakan penggeser untuk menetapkan kekuatan peningkatan. Nilai positif akan meningkatkan hasil, dan nilai negatif akan menguburnya. Klik Continue.

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

  14. Kirim setelan kontrol Anda.

    Perlu waktu beberapa menit agar kontrol yang baru dibuat atau diperbarui siap untuk menayangkan traffic live. Anda dapat menguji apakah perubahan telah diterapkan di halaman Evaluasi 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 naikkan/turunkan 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"

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

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

Membuat kontrol peningkatan/penguburan rekomendasi

Untuk membuat kontrol peningkatan/penguburan rekomendasi:

Cloud Console

  1. Buka halaman Kontrol di konsol AI Commerce Search di Gemini Enterprise for Customer Experience.

    Buka halaman Kontrol

  2. Di tab Serving controls, klik Create 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 Memfilter rekomendasi.

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

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

  10. Klik Lanjutkan untuk melanjutkan ke bagian Konfigurasi penayangan.

  11. Pilih konfigurasi penayangan yang akan diterapkan kontrolnya.

  12. Kirim setelan kontrol Anda.

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

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

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

Membuat kontrol filter

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

Cloud Console

  1. Buka halaman Kontrol di konsol AI Commerce Search di Gemini Enterprise for Customer Experience.

    Buka halaman Kontrol

  2. Di tab Serving controls, klik Create 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.

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

Membuat kontrol pengalihan

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

Cloud Console

  1. Buka halaman Kontrol di konsol AI Commerce Search di Gemini Enterprise for Customer Experience.

    Buka halaman Kontrol

  2. Di tab Serving controls, klik Create 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.

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

Anda dapat menemukan kontrol baru yang tercantum di tab Serving controls di halaman Controls.

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",
                }
              }
    }'