Kembali ke Papan Pemuka

Dokumentasi

Ketahui cara menggunakan Asyntai

Bar Carian AI

Bar carian untuk laman web anda yang memahami maksud - pelawat menemui produk dan halaman daripada pangkalan pengetahuan anda serta-merta

Buka Bar Carian AI
Standard, Pro dan Enterprise

Gambaran Keseluruhan

Bar Carian AI ialah widget carian berdiri sendiri untuk laman web anda. Pelawat menaip dengan perkataan mereka sendiri dan hasil yang sepadan muncul di bawah bar apabila mereka berhenti seketika: produk daripada suapan data masa nyata anda sebagai kad dengan imej dan harga, dan halaman daripada pangkalan pengetahuan anda dengan tajuk, pratonton ringkas dan pautan. Oleh sebab ia mencari mengikut maksud dan bukan hanya kata kunci yang tepat, pelawat yang menaip penerangan masih menemui item yang betul.

Ia menggunakan pangkalan pengetahuan yang sama dengan chatbot anda, jadi tiada apa-apa tambahan untuk diindeks atau diselenggara. Kedua-dua widget adalah bebas: gunakan bar carian sahaja, widget sembang sahaja, atau kedua-duanya bersama di halaman yang sama.

Mencari...

Menambahkannya ke Laman Web Anda

Bar carian AI memerlukan pelan Standard atau lebih tinggi. Pada pelan yang lebih rendah, bar tetap muncul di laman anda tetapi tidak pernah memberikan hasil, jadi semak pelan anda dahulu jika tiada apa-apa berlaku.

ID widget anda dipaparkan pada halaman Bar Carian AI dalam papan pemuka anda.

Paling mudah: ganti kotak carian sedia ada

Jika laman anda sudah ada carian - carian tema Shopify, borang carian WordPress, atau milik anda sendiri - anda tidak perlu meletakkan apa-apa atau menyunting tema. Tambah data-replace pada tag skrip dan widget akan mencari borang carian sedia ada, menyembunyikannya, dan muncul tepat di tempatnya:

<script src="https://widget.asyntai.com/static/js/search-widget.js" data-asyntai-id="YOUR_WIDGET_ID" data-replace="auto" async></script>

Skrip ini boleh diletakkan di mana-mana pada halaman, jadi mana-mana pemalam yang menambah kod pada pengepala atau pengaki sudah memadai. Menekan Enter tanpa memilih hasil masih membuka halaman hasil carian lama anda, jadi tiada apa yang biasa bagi pelawat berhenti berfungsi. Jika pengesanan automatik memilih elemen yang salah pada tema luar biasa, berikan pemilih CSS dan bukannya auto, contohnya data-replace=".header-search". Apabila tiada yang sepadan, widget membiarkan halaman anda seperti sedia ada.

Letakkan sendiri

Jika anda belum ada bar carian, atau mahukannya di tempat tertentu, tampal kedua-dua baris di tempat bar itu patut muncul - contohnya pada pengepala di sebelah logo anda. Bar mengisi lebar elemen tempat anda meletakkannya, yang biasanya bermakna menyunting templat tema.

<div data-asyntai-search></div>
<script src="https://widget.asyntai.com/static/js/search-widget.js" data-asyntai-id="YOUR_WIDGET_ID" async></script>

Jika ada yang tidak berfungsi

  • Tiada bar muncul langsung. Pastikan ID widget dalam skrip sepadan dengan yang di halaman Bar Carian AI, dan kod itu benar-benar berada pada halaman yang diterbitkan, bukan hanya dalam draf atau pratonton.
  • Bar muncul tetapi tidak pernah memberikan hasil. Hampir selalu ia berkaitan pelan: carian berjalan pada Standard ke atas. Perkara sama berlaku apabila had balasan AI bulanan anda habis.
  • Anda mendapat halaman tetapi tiada produk. Produk datang daripada Real-Time Data Feed. Sambungkan satu di halaman Bar Carian AI, dan pastikan kotak semak sumber suapan ditanda.
  • Anda tidak mendapat apa-apa, untuk sebarang carian. Pangkalan pengetahuan anda mungkin masih kosong. Rangkak laman anda atau tambah kandungan dalam papan pemuka dahulu, kemudian cuba lagi.
  • data-replace tidak menemui kotak carian anda. Sesetengah tema menyembunyikan carian di sebalik butang atau tetingkap timbul. Berikan pemilih CSS untuk elemen yang anda mahu dan bukannya auto, dan periksa halaman dalam tetingkap pelayar biasa, bukan editor tema.

Sumber Carian

Dua kotak semak di halaman Bar Carian AI dalam papan pemuka anda mengawal apa yang boleh digunakan oleh carian: halaman laman web (halaman yang dirangkak dan URL yang ditambah) dan suapan data masa nyata anda. Kedua-duanya dihidupkan secara lalai. Suapan tidak terhad kepada produk - apa-apa sahaja yang anda indeks di sana, seperti artikel atau penyenaraian, boleh muncul sebagai hasil. Perubahan berkuat kuasa serta-merta di laman anda.

Hasil produk memerlukan suapan data yang disambungkan. Kedua-dua jenis berfungsi: Suapan Data Masa Nyata pada pelan Standard dan ke atas, serta Suapan Data Masa Nyata Maks pada Pro. Tanpa suapan data, carian tetap berfungsi, cuma ia hanya memulangkan halaman laman web anda, dan halaman papan pemuka menandakan suapan data sebagai belum disambungkan supaya anda tahu mengapa tiada produk muncul.

Analitik Carian

Halaman Bar Carian AI dalam papan pemuka anda memaparkan carian 30 hari lepas: berapa banyak carian dijalankan, berapa yang tidak menemui apa-apa, dan berapa kerap pelawat membuka hasil. Dua jadual menyenaraikan carian paling kerap dan carian yang tidak menemui apa-apa. Jadual kedua yang paling berguna, kerana ia memberitahu anda dengan tepat apa yang pelawat harapkan tetapi tidak dijumpai.

Rakaman dihidupkan secara lalai dan anda boleh mematikannya dengan satu kotak semak pada halaman yang sama. Apabila dimatikan, tiada teks carian disimpan langsung dan jadual berhenti dikemas kini, sementara carian itu sendiri terus berfungsi sama seperti sebelum ini.

Carian yang anda jalankan pada halaman papan pemuka tidak pernah dikira. Laman web yang menggunakan Mod tanpa simpanan langsung tidak merekod teks carian, dan jika anda menetapkan dasar pengekalan, rekod carian dipadam mengikut jadual yang sama dengan perbualan anda.

Rupa keputusan

Dua tetapan pada halaman AI Search Bar dalam papan pemuka anda mengubah rupa bar dan keputusannya. Kedua-duanya disimpan sebaik anda memilih, dan tiada satu pun memerlukan perubahan kod.

Perincian hasil produk

Di bawah setiap nama produk, bar boleh memaparkan satu baris penerangan daripada suapan data anda. Sama ada ia membantu bergantung sepenuhnya pada isi suapan. Suapan pelancongan yang menyatakan tempoh perjalanan dan tempat yang tinggal berbaloi dipaparkan. Suapan yang sebaliknya mengandungi senarai atribut kelihatan seperti cetakan pangkalan data.

Jadi anda yang memilih: nama sahaja, satu baris, atau dua baris. Satu baris ialah tetapan lalai dan sesuai untuk kebanyakan suapan, kerana ia cukup untuk membezakan dua produk yang serupa tanpa menyesakkan senarai. Ini hanya mempengaruhi keputusan produk - keputusan halaman sentiasa memaparkan teks yang sepadan dengan carian pelawat.

Saiz bar

Bar tersedia dalam tiga ketinggian: padat 38 piksel untuk pengepala sempit, lalai 44 piksel, dan besar 52 piksel untuk halaman yang dibina sekitar carian. Saiz teks turut berubah.

Lebar tidak pernah kami tetapkan. Bar sentiasa memenuhi elemen tempat anda meletakkannya, jadi lebarnya anda kawal melalui susun atur anda sendiri. Panel keputusan sepadan dengan bar secara automatik.

Selepas menukar saiz, salin semula kod benam anda. Kod baharu membawa saiz itu, jadi bar sudah betul sebaik halaman dimuatkan. Jika anda tidak menyalinnya semula, bar tetap akan mengubah saiznya, tetapi hanya selepas carian pertama berjalan.

Apabila Carian Tidak Menemui Apa-apa

Jika widget sembang anda berada pada halaman yang sama, bar carian menawarkan untuk menyerahkan soalan itu kepada pembantu anda setiap kali carian tidak menghasilkan apa-apa. Pelawat mengekalkan soalannya dan terus masuk ke sembang dengan soalan itu sudah ditaip, jadi jalan buntu bertukar menjadi perbualan. Pilihan ini hanya muncul apabila widget sembang ada.

Pilihan

Bar carian menggunakan bahasa pelayar pelawat secara automatik untuk teks ruang letak, tajuk kumpulan hasil dan teks pemuatan. Tetapkan nilai ini hanya jika anda mahu menggunakan perkataan anda sendiri.

Kedua-dua tajuk juga boleh ditukar nama di halaman Bar Carian AI dalam papan pemuka, tanpa mengubah kod. Ini cara yang lebih mudah jika suapan anda mengandungi artikel atau iklan dan bukannya produk. Atribut pada tag skrip masih mengatasi tetapan papan pemuka.

Semua atribut adalah pilihan dan diletakkan pada tag skrip:

  • data-placeholder="Search products..." - teks yang dipaparkan dalam bar carian kosong
  • data-accent="#0a7d4f" - warna fokus dan sorotan, untuk sepadan dengan jenama anda
  • data-max-results="8" - berapa banyak hasil untuk dipaparkan, 1 hingga 20
  • data-new-tab="true" - buka hasil dalam tab pelayar baharu
  • data-size="sm" - ketinggian bar: sm, md atau lg. Mengatasi saiz yang ditetapkan dalam papan pemuka anda
  • data-label-products="Products" - tajuk di atas hasil suapan, dalam bahasa anda - contohnya Artikel jika suapan anda mengandungi artikel
  • data-label-pages="Pages" - tajuk di atas hasil halaman, dalam bahasa anda
  • data-label-empty="No results found" - mesej apabila tiada padanan
  • data-label-searching="Searching..." - teks yang dipaparkan semasa hasil sedang dimuatkan
  • data-label-ask-ai="Ask our assistant" - ayat pilihan yang menyerahkan carian tanpa hasil kepada chatbot anda
  • data-target=".my-container" - paparkan bar di dalam elemen ini dan bukannya bekas lalai
  • data-replace="auto" - gantikan bar carian yang sedia ada pada tema anda, seperti diterangkan di atas

Penggunaan dan Pengebilan

Setiap carian yang dijalankan oleh pelawat menggunakan 1 balasan AI daripada had pelan bulanan anda - had yang sama digunakan oleh balasan chatbot anda. Carian dicetuskan apabila pelawat berhenti menaip, bukan pada setiap huruf. Carian yang anda jalankan di halaman Bar Carian AI dalam papan pemuka anda tidak dikira. Apabila had bulanan anda dicapai, bar carian hanya tidak menunjukkan sebarang hasil sehingga had ditetapkan semula.

Baik untuk Diketahui

  • Pelawat boleh mencari dalam sebarang bahasa, walaupun kandungan anda ditulis dalam bahasa lain.
  • Salah ejaan dan perkataan separuh taip tetap menemui perkara yang betul, jadi carian “jacket” tetap menemui jaket anda.
  • Harga produk dipaparkan dengan simbol mata wang anda, diambil daripada mata wang dalam suapan data anda.
  • Halaman yang sama dalam beberapa bahasa muncul sekali sahaja - salinan yang sepadan dengan bahasa carian akan menang.
  • Hasil membuka halaman sebenar di laman anda, jadi bar carian juga berfungsi sebagai navigasi.
  • Widget ini ialah satu skrip kecil tanpa kebergantungan dan tidak melambatkan halaman anda.
  • Kawalan papan kekunci berfungsi terus: kekunci anak panah untuk bergerak, Enter untuk membuka, Escape untuk menutup.