Powrót do panelu

Dokumentacja

Dowiedz się, jak korzystać z Asyntai

Pasek wyszukiwania AI

Pasek wyszukiwania dla Twojej strony, który rozumie znaczenie - odwiedzający natychmiast znajdują produkty i strony z Twojej bazy wiedzy

Otwórz pasek wyszukiwania AI
Standard, Pro i Enterprise

Przegląd

Pasek wyszukiwania AI to samodzielny widżet wyszukiwania dla Twojej strony. Odwiedzający piszą własnymi słowami, a pasujące wyniki pojawiają się pod paskiem, gdy tylko przerwą pisanie: produkty z Twojego kanału danych w czasie rzeczywistym jako karty ze zdjęciem i ceną oraz strony z Twojej bazy wiedzy z tytułem, krótkim podglądem i linkiem. Ponieważ wyszukuje według znaczenia, a nie tylko dokładnych słów kluczowych, odwiedzający, który wpisze opis, i tak znajdzie właściwą pozycję.

Korzysta z tej samej bazy wiedzy co Twój chatbot, więc nie trzeba niczego dodatkowo indeksować ani utrzymywać. Oba widżety są niezależne: używaj samego paska wyszukiwania, samego widżetu czatu albo obu razem na tych samych stronach.

Szukanie...

Dodawanie do Twojej strony

Pasek wyszukiwania AI wymaga planu Standard lub wyższego. W niższym planie pasek pojawia się na stronie, ale nigdy nie zwraca wyników, więc jeśli nic się nie dzieje, sprawdź najpierw swój plan.

Twój identyfikator widżetu znajdziesz na stronie Pasek wyszukiwania AI w panelu.

Najprościej: zastąp pole wyszukiwania, które już masz

Jeśli Twoja witryna ma już wyszukiwarkę - wyszukiwanie motywu Shopify, formularz WordPressa lub własne - nie musisz nic umieszczać ani edytować motywu. Dodaj data-replace do znacznika script, a widżet znajdzie istniejący formularz, ukryje go i pojawi się dokładnie w jego miejscu:

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

Ten skrypt może być w dowolnym miejscu strony, więc wystarczy dowolna wtyczka dodająca kod do nagłówka lub stopki. Naciśnięcie Enter bez wyboru wyniku nadal otwiera Twoją starą stronę wyników, więc nic znanego odwiedzającym nie przestaje działać. Jeśli automatyczne wykrywanie wybierze zły element w nietypowym motywie, podaj selektor CSS zamiast auto, na przykład data-replace=".header-search". Gdy nic nie pasuje, widżet zostawia stronę bez zmian.

Umieść go samodzielnie

Jeśli nie masz jeszcze paska wyszukiwania albo chcesz go w konkretnym miejscu, wklej obie linijki tam, gdzie pasek ma się pojawić - na przykład w nagłówku obok logo. Pasek wypełnia szerokość elementu, w którym go umieścisz, co zwykle oznacza edycję szablonu motywu.

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

Jeśli coś nie działa

  • Pasek w ogóle się nie pojawia. Sprawdź, czy identyfikator widżetu w skrypcie zgadza się z tym na stronie Pasek wyszukiwania AI i czy kod naprawdę jest na opublikowanej stronie, a nie tylko w wersji roboczej lub podglądzie.
  • Pasek się pojawia, ale nigdy nie zwraca wyników. Prawie zawsze chodzi o plan: wyszukiwanie działa od Standard w górę. To samo widzisz po wyczerpaniu miesięcznego limitu odpowiedzi AI.
  • Dostajesz strony, ale bez produktów. Produkty pochodzą z Real-Time Data Feed. Podłącz go na stronie Pasek wyszukiwania AI i sprawdź, czy pole wyboru tego źródła jest zaznaczone.
  • Nie dostajesz nic, przy żadnym wyszukiwaniu. Twoja baza wiedzy może być jeszcze pusta. Najpierw przeskanuj witrynę lub dodaj treści w panelu i spróbuj ponownie.
  • data-replace nie znalazł Twojego pola wyszukiwania. Niektóre motywy chowają wyszukiwarkę za przyciskiem lub okienkiem. Zamiast auto podaj selektor CSS wybranego elementu i sprawdź stronę w zwykłym oknie przeglądarki, a nie w edytorze motywu.

Źródła wyszukiwania

Dwa pola wyboru na stronie Paska wyszukiwania AI w Twoim panelu określają, z czego może korzystać wyszukiwanie: strony witryny (zeskanowane strony i dodane adresy URL) oraz Twój kanał danych w czasie rzeczywistym. Oba są domyślnie włączone. Kanał nie ogranicza się do produktów - wszystko, co tam indeksujesz, na przykład artykuły czy ogłoszenia, może pojawić się jako wynik. Zmiana obowiązuje na Twojej stronie natychmiast.

Wyniki produktowe wymagają podłączonego kanału danych. Działają oba rodzaje: Dane w czasie rzeczywistym w planie Standard i wyższych oraz Dane w czasie rzeczywistym Max w planie Pro. Bez kanału wyszukiwanie nadal działa, po prostu zwraca tylko strony Twojej witryny, a strona panelu oznacza kanał jako niepodłączony, żebyś wiedział, dlaczego nie pojawiają się produkty.

Analityka wyszukiwania

Strona Pasek wyszukiwania AI w panelu pokazuje wyszukiwania z ostatnich 30 dni: ile ich było, ile z nich nic nie znalazło i jak często odwiedzający otworzył wynik. Dwie tabele pokazują Twoje najczęstsze wyszukiwania oraz wyszukiwania bez wyników. Druga tabela jest tą przydatną, bo mówi dokładnie, czego odwiedzający oczekują i nie mogą znaleźć.

Zapisywanie jest domyślnie włączone i możesz je wyłączyć jednym polem wyboru na tej samej stronie. Po wyłączeniu żaden tekst wyszukiwania nie jest przechowywany, a tabele przestają się aktualizować, natomiast samo wyszukiwanie działa dokładnie tak jak wcześniej.

Wyszukiwania, które wykonujesz na stronie w panelu, nigdy nie są liczone. Witryny z trybem zerowego przechowywania w ogóle nie zapisują treści wyszukiwania, a jeśli ustawisz politykę przechowywania danych, zapisy wyszukiwań są usuwane według tego samego harmonogramu co Twoje rozmowy.

Jak wyglądają wyniki

Dwa ustawienia na stronie AI Search Bar w panelu zmieniają wygląd paska i jego wyników. Oba zapisują się od razu i żadne nie wymaga zmiany kodu.

Szczegóły wyniku produktu

Pod nazwą każdego produktu pasek może wyświetlić jeden wiersz opisu z Twojego kanału danych. Czy to pomaga, zależy wyłącznie od zawartości kanału. Kanał turystyczny podający długość wyjazdu i wolne miejsca warto pokazać. Kanał zawierający listę atrybutów czyta się natomiast jak zrzut z bazy danych.

Wybór należy więc do Ciebie: sama nazwa, jeden wiersz albo dwa wiersze. Domyślny jest jeden wiersz i pasuje do większości kanałów, bo wystarcza, by odróżnić dwa podobne produkty bez zaśmiecania listy. Dotyczy to tylko wyników produktów - wynik strony zawsze pokazuje tekst pasujący do wyszukiwania odwiedzającego.

Rozmiar paska

Pasek ma trzy wysokości: kompaktowy 38 pikseli do wąskiego nagłówka, domyślny 44 piksele i duży 52 piksele do strony opartej na wyszukiwaniu. Rozmiar tekstu zmienia się razem z nim.

Szerokości nigdy nie ustalamy my. Pasek zawsze wypełnia element, w którym go umieścisz, więc szerokością sterujesz własnym układem. Panel wyników dopasowuje się do paska automatycznie.

Po zmianie rozmiaru skopiuj kod osadzenia ponownie. Nowy kod zawiera rozmiar, więc pasek jest poprawny już od załadowania strony. Jeśli go nie skopiujesz ponownie, pasek i tak zmieni rozmiar, ale dopiero po pierwszym wyszukiwaniu.

Gdy wyszukiwanie nic nie znajdzie

Jeśli widget czatu jest na tej samej stronie, pasek wyszukiwania proponuje przekazanie pytania Twojemu asystentowi za każdym razem, gdy wyszukiwanie nie zwróci wyników. Pytanie odwiedzającego zostaje zachowane i trafia on do czatu z już wpisanym pytaniem, więc ślepy zaułek zamienia się w rozmowę. Ta opcja pojawia się tylko wtedy, gdy widget czatu jest obecny na stronie.

Opcje

Pasek automatycznie używa języka przeglądarki odwiedzającego dla tekstu zastępczego, nagłówków wyników i tekstu ładowania. Ustaw je tylko wtedy, gdy chcesz użyć własnych sformułowań.

Oba nagłówki można też zmienić na stronie Pasek wyszukiwania AI w panelu, bez zmiany kodu. To prostszy sposób, jeśli Twój kanał danych zawiera artykuły lub ogłoszenia zamiast produktów. Atrybut na znaczniku script nadal ma pierwszeństwo przed ustawieniem w panelu.

Wszystkie atrybuty są opcjonalne i umieszcza się je w tagu script:

  • data-placeholder="Search products..." - tekst wyświetlany w pustym pasku wyszukiwania
  • data-accent="#0a7d4f" - kolor fokusu i wyróżnienia, dopasowany do Twojej marki
  • data-max-results="8" - ile wyników pokazywać, od 1 do 20
  • data-new-tab="true" - otwieraj wyniki w nowej karcie przeglądarki
  • data-size="sm" - wysokość paska: sm, md lub lg. Ma pierwszeństwo przed rozmiarem ustawionym w panelu
  • data-label-products="Products" - nagłówek nad wynikami z kanału, w Twoim języku - na przykład Artykuły, jeśli Twój kanał zawiera artykuły
  • data-label-pages="Pages" - nagłówek nad wynikami stron, w Twoim języku
  • data-label-empty="No results found" - komunikat, gdy nic nie pasuje
  • data-label-searching="Searching..." - tekst wyświetlany podczas ładowania wyników
  • data-label-ask-ai="Ask our assistant" - treść opcji, która przekazuje nieudane wyszukiwanie do Twojego chatbota
  • data-target=".my-container" - renderuj pasek wewnątrz tego elementu zamiast domyślnego kontenera
  • data-replace="auto" - zastępuje pasek wyszukiwania, który Twój motyw już ma, opisany powyżej

Użycie i rozliczenia

Każde wyszukiwanie wykonane przez odwiedzającego zużywa 1 odpowiedź AI z miesięcznego limitu Twojego planu - tego samego limitu, z którego korzystają odpowiedzi Twojego chatbota. Wyszukiwanie uruchamia się, gdy odwiedzający przerwie pisanie, a nie po każdej literze. Wyszukiwania, które wykonujesz na stronie Paska wyszukiwania AI w swoim panelu, nie są liczone. Po osiągnięciu miesięcznego limitu pasek wyszukiwania po prostu nie pokazuje wyników, dopóki limit się nie odnowi.

Warto wiedzieć

  • Odwiedzający mogą szukać w dowolnym języku, nawet jeśli Twoja treść jest napisana w innym.
  • Literówki i niedokończone słowa i tak trafiają w cel, więc wyszukanie jaket znajdzie Twoje kurtki.
  • Ceny produktów są pokazywane z Twoim symbolem waluty, pobranym z waluty w Twoim kanale.
  • Ta sama strona w kilku językach pojawia się tylko raz - wygrywa wersja pasująca do języka wyszukiwania.
  • Wyniki otwierają prawdziwe strony w Twojej witrynie, więc pasek wyszukiwania działa też jako nawigacja.
  • Widżet to jeden mały skrypt bez zależności i nie spowalnia Twojej strony.
  • Sterowanie klawiaturą działa od razu: strzałki do poruszania się, Enter do otwierania, Escape do zamykania.