Vissza az irányítópultra

Dokumentáció

Ismerd meg az Asyntai használatát

AI keresősáv

Keresősáv a webhelyedre, amely érti a jelentést - a látogatók azonnal megtalálják a termékeket és oldalakat a tudásbázisodból

AI keresősáv megnyitása
Standard, Pro és Enterprise

Áttekintés

Az AI keresősáv egy önálló kereső widget a webhelyedre. A látogatók a saját szavaikkal gépelnek, és amint szünetet tartanak, a sáv alatt megjelennek az egyező találatok: a valós idejű adatforrásodból származó termékek képpel és árral ellátott kártyaként, a tudásbázisodból származó oldalak pedig címmel, rövid előnézettel és linkkel. Mivel jelentés alapján keres, nem csak pontos kulcsszavak alapján, a látogató akkor is megtalálja a megfelelő elemet, ha csak egy leírást gépel be.

Ugyanazt a tudásbázist használja, mint a chatbotod, így semmi extrát nem kell indexelni vagy karbantartani. A két widget független egymástól: használhatod csak a keresősávot, csak a chat widgetet, vagy mindkettőt együtt ugyanazokon az oldalakon.

Keresés...

Hozzáadás a webhelyedhez

Az AI keresősávhoz Standard vagy magasabb csomag kell. Alacsonyabb csomagban a sáv megjelenik a webhelyén, de sosem ad találatot, ezért ha semmi sem történik, először a csomagját nézze meg.

A widget azonosítója az irányítópult AI keresősáv oldalán látható.

A legegyszerűbb: cserélje le a meglévő keresőmezőt

Ha a webhelyén már van kereső - a Shopify sablon keresője, egy WordPress keresőűrlap vagy a sajátja - nem kell semmit elhelyeznie, és a sablont sem kell szerkesztenie. Adja hozzá a data-replace attribútumot a script címkéhez: a widget megtalálja a meglévő űrlapot, elrejti, és pontosan a helyén jelenik meg:

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

Ez a szkript bárhol lehet az oldalon, így bármelyik bővítmény megfelel, amely kódot tesz a fejlécbe vagy a láblécbe. Az Enter találat kiválasztása nélkül továbbra is a régi találati oldalt nyitja meg, tehát semmi sem szűnik meg működni, amit a látogatók ismernek. Ha az automatikus felismerés szokatlan sablonon rossz elemet választ, adjon meg CSS-szelektort az auto helyett, például data-replace=".header-search". Ha semmi nem illeszkedik, a widget érintetlenül hagyja az oldalt.

Helyezze el maga

Ha még nincs keresősávja, vagy egy adott helyre szeretné, illessze be mindkét sort oda, ahol a sávnak meg kell jelennie - például a fejlécbe, a logó mellé. A sáv kitölti annak az elemnek a szélességét, amelybe helyezi, ami rendszerint sablonfájl szerkesztését jelenti.

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

Ha valami nem működik

  • Egyáltalán nem jelenik meg sáv. Ellenőrizze, hogy a szkriptben lévő widget azonosító megegyezik-e az AI keresősáv oldalon lévővel, és hogy a kód valóban a közzétett oldalon van-e, nem csak piszkozatban vagy előnézetben.
  • A sáv megjelenik, de sosem ad találatot. Szinte mindig a csomag az ok: a keresés Standardtól felfelé működik. Ugyanezt látja akkor is, ha elfogyott a havi AI-válaszkerete.
  • Oldalakat kap, de terméket nem. A termékek Real-Time Data Feedből jönnek. Csatlakoztasson egyet az AI keresősáv oldalon, és nézze meg, hogy a forrás jelölőnégyzete be van-e pipálva.
  • Semmit sem kap, semmilyen keresésre. Lehet, hogy a tudásbázisa még üres. Először térképezze fel a webhelyét, vagy adjon hozzá tartalmat az irányítópulton, majd próbálja újra.
  • A data-replace nem találta a keresőmezőt. Egyes sablonok gomb vagy felugró ablak mögé rejtik a keresőt. Az auto helyett adja meg a kívánt elem CSS-szelektorát, és az oldalt normál böngészőablakban nézze meg, ne a sablonszerkesztőben.

Keresési források

Az irányítópult AI keresősáv oldalán két jelölőnégyzet szabályozza, mit használhat a keresés: a webhely oldalai (feltérképezett oldalak és hozzáadott URL-ek) és a valós idejű adatforrásod. Alapértelmezés szerint mindkettő be van kapcsolva. Az adatforrás nem korlátozódik termékekre - bármi, amit ott indexelsz, például cikkek vagy hirdetések, megjelenhet találatként. A módosítás azonnal érvénybe lép a webhelyeden.

A terméktalálatokhoz csatlakoztatott adatforrás szükséges. Mindkét fajta működik: a Valós idejű adatforrás a Standard csomagtól felfelé, és a Valós idejű adatforrás Max a Pro csomagban. Adatforrás nélkül a keresés továbbra is működik, csak a webhely oldalait adja vissza, és a vezérlőpult oldala nem csatlakoztatottként jelöli az adatforrást, így tudja, miért nem jelennek meg termékek.

Keresési elemzés

Az AI keresősáv oldal az irányítópulton az elmúlt 30 nap kereséseit mutatja: hány keresés futott, hány nem talált semmit, és milyen gyakran nyitott meg egy látogató egy találatot. Két táblázat sorolja fel a leggyakoribb kereséseket és a találat nélküli kereséseket. A második táblázat a hasznos, mert pontosan megmutatja, mit várnak a látogatók, és mit nem találnak meg.

A rögzítés alapértelmezetten be van kapcsolva, és egyetlen jelölőnégyzettel kikapcsolható ugyanazon az oldalon. Kikapcsolt állapotban semmilyen keresési szöveg nem kerül tárolásra, és a táblázatok nem frissülnek tovább, miközben maga a keresés pontosan ugyanúgy működik, mint korábban.

Az Ön által az irányítópult oldalán futtatott keresések soha nem számítanak bele. A Nulla megőrzés módot használó weboldalak egyáltalán nem rögzítik a keresések szövegét, és ha beállít egy adatmegőrzési szabályzatot, a keresési bejegyzések ugyanazon ütemezés szerint törlődnek, mint a beszélgetései.

Hogyan néznek ki a találatok

Az irányítópult AI Search Bar oldalán két beállítás módosítja a sáv és a találatok kinézetét. Mindkettő azonnal mentődik, és egyik sem igényel kódmódosítást.

Terméktalálat részletessége

Minden terméknév alatt a sáv megjeleníthet egy sort a leírásból, az adatcsatornából. Hogy ez segít-e, teljesen attól függ, mit tartalmaz a csatorna. Egy utazási csatorna, amely megadja az út hosszát és a szabad helyeket, érdemes megmutatni. Egy attribútumlistát tartalmazó csatorna viszont adatbázis-kivonatnak hat.

A választás tehát az Öné: csak a név, egy sor vagy két sor. Az egy sor az alapértelmezés, és a legtöbb csatornához illik, mert elég két hasonló termék megkülönböztetéséhez anélkül, hogy zsúfolttá tenné a listát. Ez csak a terméktalálatokat érinti - egy oldaltalálat mindig azt a szöveget mutatja, amely a látogató keresésére illeszkedett.

A sáv mérete

A sáv három magasságban érhető el: kompakt 38 képpont a szűk fejléchez, az alapértelmezett 44 képpont, és nagy 52 képpont a keresésre épülő oldalhoz. A szövegméret együtt változik vele.

A szélességet soha nem mi állítjuk be. A sáv mindig kitölti azt az elemet, amelybe elhelyezi, így a szélességet a saját elrendezésével szabályozza. A találati panel automatikusan igazodik a sávhoz.

A méret módosítása után másolja ki újra a beágyazókódot. Az új kód tartalmazza a méretet, így a sáv már az oldal betöltésekor helyes. Ha nem másolja ki újra, a sáv akkor is átméreteződik, de csak az első keresés után.

Ha a keresés nem talál semmit

Ha a chat widget ugyanazon az oldalon van, a keresősáv felajánlja, hogy átadja a kérdést az asszisztensének, valahányszor egy keresés nem hoz találatot. A látogató megtartja a kérdését, és már beírt szöveggel érkezik a chatbe, így a zsákutcából beszélgetés lesz. Ez a lehetőség csak akkor jelenik meg, ha a chat widget jelen van.

Opciók

A sáv automatikusan a látogató böngészőjének nyelvét használja a helyőrző szöveghez, az eredmények címsoraihoz és a betöltési szöveghez. Ezeket csak akkor állítsa be, ha saját szöveget szeretne.

A két címsor az irányítópult AI keresősáv oldalán is átnevezhető, kódmódosítás nélkül. Ez az egyszerűbb hely, ha az adatfolyama termékek helyett cikkeket vagy hirdetéseket tartalmaz. A script címke attribútuma továbbra is felülírja az irányítópult beállítását.

Minden attribútum opcionális, és a script tagre kerül:

  • data-placeholder="Search products..." - az üres keresősávban megjelenő szöveg
  • data-accent="#0a7d4f" - fókusz- és kiemelőszín, hogy illeszkedjen a márkádhoz
  • data-max-results="8" - hány találat jelenjen meg, 1-től 20-ig
  • data-new-tab="true" - a találatok új böngészőlapon nyílnak meg
  • data-size="sm" - a sáv magassága: sm, md vagy lg. Felülírja az irányítópulton beállított méretet
  • data-label-products="Products" - az adatforrás találatai feletti címsor, a saját nyelveden - például Cikkek, ha az adatforrásod cikkeket tartalmaz
  • data-label-pages="Pages" - az oldaltalálatok feletti címsor, a saját nyelveden
  • data-label-empty="No results found" - üzenet, ha nincs találat
  • data-label-searching="Searching..." - a találatok betöltése közben megjelenő szöveg
  • data-label-ask-ai="Ask our assistant" - annak a lehetőségnek a szövege, amely a sikertelen keresést átadja a chatbotodnak
  • data-target=".my-container" - a sáv ebben az elemben jelenik meg az alapértelmezett konténer helyett
  • data-replace="auto" - a téma meglévő keresősávjának cseréje, a fentiek szerint

Használat és számlázás

Minden látogatói keresés 1 MI-választ használ fel a havi csomagkeretedből - ugyanabból a keretből, amelyet a chatbotod válaszai is használnak. A keresés akkor indul, amikor a látogató szünetet tart a gépelésben, nem minden betűnél. Az irányítópult AI keresősáv oldalán futtatott kereséseid nem számítanak bele. Ha elérted a havi keretedet, a keresősáv egyszerűen nem mutat találatokat, amíg a keret vissza nem áll.

Jó tudni

  • A látogatók bármilyen nyelven kereshetnek, még akkor is, ha a tartalmad más nyelven íródott.
  • Az elgépelések és a félig beírt szavak is megtalálják a jó találatot, így a „kabt” keresés megtalálja a kabátjaidat.
  • A termékárak a saját pénznemed jelével jelennek meg, amelyet az adatforrásodban megadott pénznemből veszünk.
  • Ugyanaz az oldal több nyelven csak egyszer jelenik meg - a keresés nyelvéhez illő változat nyer.
  • A találatok valódi oldalakat nyitnak meg a webhelyeden, így a keresősáv navigációként is működik.
  • A widget egyetlen kis script függőségek nélkül, és nem lassítja az oldaladat.
  • A billentyűzetes vezérlés azonnal működik: nyílbillentyűk a mozgáshoz, Enter a megnyitáshoz, Escape a bezáráshoz.