Înapoi la tabloul de bord

Documentație

Aflați cum să utilizați Asyntai

Bara de căutare AI

O bară de căutare pentru site-ul tău care înțelege sensul - vizitatorii găsesc instant produse și pagini din baza ta de cunoștințe

Deschide Bara de căutare AI
Standard, Pro și Enterprise

Prezentare generală

Bara de căutare AI este un widget de căutare de sine stătător pentru site-ul tău. Vizitatorii tastează cu propriile cuvinte, iar rezultatele potrivite apar sub bară în timp ce fac o pauză: produse din fluxul tău de date în timp real, sub formă de carduri cu imagine și preț, și pagini din baza ta de cunoștințe, cu titlu, o scurtă previzualizare și un link. Pentru că bara caută după sens, nu doar după cuvinte-cheie exacte, un vizitator care tastează o descriere găsește totuși elementul potrivit.

Folosește aceeași bază de cunoștințe ca și chatbot-ul tău, așa că nu ai nimic în plus de indexat sau de întreținut. Cele două widget-uri sunt independente: folosește doar bara de căutare, doar widget-ul de chat sau ambele împreună pe aceleași pagini.

Se caută...

Adăugarea pe site-ul tău

Bara de căutare AI necesită planul Standard sau superior. Pe un plan inferior bara apare pe site, dar nu returnează niciodată rezultate, așa că verificați întâi planul dacă nu se întâmplă nimic.

ID-ul widgetului este afișat pe pagina Bară de căutare AI din panoul dumneavoastră.

Cel mai simplu: înlocuiți caseta de căutare pe care o aveți deja

Dacă site-ul dumneavoastră are deja căutare - căutarea temei Shopify, un formular WordPress sau al dumneavoastră - nu trebuie să plasați nimic și nici să editați tema. Adăugați data-replace la eticheta script și widgetul găsește formularul existent, îl ascunde și apare exact în locul lui:

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

Acest script poate sta oriunde în pagină, deci este suficient orice plugin care adaugă cod în antet sau subsol. Apăsarea Enter fără a alege un rezultat deschide în continuare vechea pagină de rezultate, așa că nimic din ce știu vizitatorii nu încetează să funcționeze. Dacă detectarea automată alege elementul greșit pe o temă neobișnuită, transmiteți un selector CSS în loc de auto, de exemplu data-replace=".header-search". Când nimic nu se potrivește, widgetul lasă pagina neatinsă.

Plasarea manuală

Dacă nu aveți încă o bară de căutare, sau o doriți într-un loc anume, lipiți ambele linii acolo unde trebuie să apară bara - de exemplu în antet, lângă siglă. Bara ocupă lățimea elementului în care o plasați, ceea ce de obicei înseamnă editarea unui șablon al temei.

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

Dacă ceva nu funcționează

  • Nu apare nicio bară. Verificați dacă ID-ul widgetului din script corespunde celui de pe pagina Bară de căutare AI și dacă codul se află într-adevăr pe pagina publicată, nu doar într-o ciornă sau previzualizare.
  • Bara apare dar nu returnează niciodată rezultate. Aproape întotdeauna este planul: căutarea funcționează de la Standard în sus. Același lucru se vede și când limita lunară de răspunsuri AI s-a epuizat.
  • Primiți pagini, dar niciun produs. Produsele vin dintr-un Real-Time Data Feed. Conectați unul pe pagina Bară de căutare AI și verificați dacă este bifată caseta acelei surse.
  • Nu obțineți nimic, la nicio căutare. Baza dumneavoastră de cunoștințe poate fi încă goală. Parcurgeți întâi site-ul sau adăugați conținut în panou, apoi încercați din nou.
  • data-replace nu a găsit caseta de căutare. Unele teme ascund căutarea în spatele unui buton sau al unei ferestre. Transmiteți un selector CSS pentru elementul dorit în loc de auto și verificați pagina într-o fereastră obișnuită de browser, nu în editorul temei.

Surse de căutare

Două casete de bifat de pe pagina Bara de căutare AI din tabloul tău de bord controlează ce poate folosi căutarea: paginile site-ului (pagini scanate și URL-uri adăugate) și fluxul tău de date în timp real. Ambele sunt active în mod implicit. Fluxul nu este limitat la produse - orice indexezi acolo, cum ar fi articole sau anunțuri, poate apărea ca rezultat. O modificare se aplică imediat pe site-ul tău.

Rezultatele cu produse necesită un flux de date conectat. Funcționează ambele tipuri: Flux de date în timp real pe planul Standard și cele superioare, și Flux de date în timp real Max pe Pro. Fără flux, căutarea funcționează în continuare, doar că returnează numai paginile site-ului dvs., iar pagina din panou marchează fluxul ca neconectat, ca să știți de ce nu apar produse.

Analiza căutărilor

Pagina Bara de căutare AI din tabloul de bord arată căutările din ultimele 30 de zile: câte au fost făcute, câte nu au găsit nimic și cât de des un vizitator a deschis un rezultat. Două tabele arată cele mai frecvente căutări și căutările fără rezultate. Al doilea tabel este cel util, pentru că vă spune exact ce așteaptă vizitatorii și nu găsesc.

Înregistrarea este activată implicit și o puteți dezactiva cu o singură casetă de bifat pe aceeași pagină. Când este dezactivată, nu se stochează niciun text de căutare, iar tabelele nu se mai actualizează, în timp ce căutarea în sine funcționează exact ca înainte.

Căutările pe care le faceți dvs. pe pagina din tabloul de bord nu sunt niciodată numărate. Site-urile care folosesc Mod zero păstrare nu înregistrează deloc textul căutărilor, iar dacă setați o politică de retenție, înregistrările căutărilor sunt șterse după același program ca și conversațiile dvs.

Cum arată rezultatele

Două setări din pagina AI Search Bar a panoului tău schimbă aspectul barei și al rezultatelor. Ambele se salvează imediat ce le alegi și niciuna nu cere modificarea codului.

Detaliile rezultatului de produs

Sub numele fiecărui produs, bara poate afișa un rând din descrierea aflată în fluxul tău de date. Dacă ajută sau nu depinde în întregime de ce conține fluxul. Un flux de călătorii care indică durata excursiei și locurile rămase merită afișat. Un flux care conține în schimb o listă de atribute se citește ca un export de bază de date.

Deci alegi tu: doar numele, un rând sau două rânduri. Un rând este valoarea implicită și se potrivește majorității fluxurilor, pentru că e suficient să distingi două produse asemănătoare fără a aglomera lista. Aceasta afectează doar rezultatele de produs - un rezultat de pagină arată mereu textul care s-a potrivit cu căutarea vizitatorului.

Dimensiunea barei

Bara vine în trei înălțimi: compactă la 38 de pixeli pentru un antet îngust, cea implicită la 44 de pixeli și mare la 52 de pixeli pentru o pagină construită în jurul căutării. Mărimea textului se schimbă odată cu ea.

Lățimea nu o stabilim niciodată noi. Bara umple mereu elementul în care o plasezi, așa că lățimea o controlezi prin propriul aranjament. Panoul de rezultate se aliniază automat la bară.

După ce schimbi dimensiunea, copiază din nou codul de integrare. Codul nou conține dimensiunea, așa că bara e corectă din momentul încărcării paginii. Dacă nu îl copiezi din nou, bara tot se redimensionează, dar abia după prima căutare.

Când o căutare nu găsește nimic

Dacă widgetul de chat este pe aceeași pagină, bara de căutare se oferă să trimită întrebarea către asistentul dvs. ori de câte ori o căutare nu returnează rezultate. Vizitatorul își păstrează întrebarea și ajunge în chat cu ea deja scrisă, așa că un drum închis devine o conversație. Această opțiune apare doar când widgetul de chat este prezent.

Opțiuni

Bara folosește automat limba browserului vizitatorului pentru textul substituent, titlurile rezultatelor și textul de încărcare. Setați-le doar când doriți propria formulare.

Cele două titluri pot fi redenumite și pe pagina Bară de căutare AI din panou, fără modificări de cod. Este mai simplu dacă fluxul conține articole sau anunțuri în loc de produse. Un atribut pe eticheta script are în continuare prioritate față de setarea din panou.

Toate atributele sunt opționale și se pun pe tagul script:

  • data-placeholder="Search products..." - textul afișat în bara de căutare goală
  • data-accent="#0a7d4f" - culoarea de focus și evidențiere, ca să se potrivească brandului tău
  • data-max-results="8" - câte rezultate se afișează, de la 1 la 20
  • data-new-tab="true" - deschide rezultatele într-o filă nouă de browser
  • data-size="sm" - înălțimea barei: sm, md sau lg. Are prioritate față de dimensiunea setată în panou
  • data-label-products="Products" - titlul de deasupra rezultatelor din flux, în limba ta - de exemplu Articole dacă fluxul tău conține articole
  • data-label-pages="Pages" - titlul de deasupra rezultatelor cu pagini, în limba ta
  • data-label-empty="No results found" - mesajul afișat când nimic nu se potrivește
  • data-label-searching="Searching..." - textul afișat în timp ce se încarcă rezultatele
  • data-label-ask-ai="Ask our assistant" - formularea opțiunii care trimite o căutare fără rezultate către chatbotul dvs.
  • data-target=".my-container" - afișează bara în interiorul acestui element în loc de containerul implicit
  • data-replace="auto" - înlocuiește bara de căutare pe care tema dvs. o are deja, descrisă mai sus

Utilizare și facturare

Fiecare căutare făcută de un vizitator consumă 1 răspuns IA din limita lunară a planului tău - aceeași limită folosită de răspunsurile chatbot-ului. O căutare pornește când vizitatorul face o pauză din tastat, nu la fiecare literă. Căutările pe care le faci pe pagina Bara de căutare AI din tabloul tău de bord nu se contorizează. Când limita lunară este atinsă, bara de căutare pur și simplu nu mai arată rezultate până când limita se resetează.

Bine de știut

  • Vizitatorii pot căuta în orice limbă, chiar și atunci când conținutul tău este scris în alta.
  • Greșelile de scriere și cuvintele scrise pe jumătate găsesc tot ce trebuie, așa că o căutare după „jachte” găsește jachetele tale.
  • Prețurile produselor sunt afișate cu simbolul monedei tale, preluat din moneda din fluxul tău de date.
  • Aceeași pagină în mai multe limbi apare o singură dată - câștigă varianta care se potrivește cu limba căutării.
  • Rezultatele deschid pagini reale de pe site-ul tău, așa că bara de căutare funcționează și ca navigare.
  • Widget-ul este un singur script mic, fără dependențe, și nu îți încetinește pagina.
  • Comenzile de la tastatură funcționează din start: săgețile pentru deplasare, Enter pentru deschidere, Escape pentru închidere.