GrowSearchod GrowCommerce

Instrukcja dla właściciela sklepu

Uruchomienie i obsługa GrowSearch

GrowSearch to platforma wyszukiwania: podpowiedzi pod polem wyszukiwania lub pełnoekranowa wyszukiwarka, filtrowanie, merchandising i raport fraz. Nie modyfikuje natywnej wyszukiwarki sklepu.

Przed pierwszą publikacją przejdź kreator na Starcie. Import katalogu rozpoczyna się po instalacji. Sprawdź podgląd, wybierz wygląd i kliknij „Opublikuj”, gdy chcesz zastosować ustawienia w sklepie. Wyłączenie albo błąd oznacza brak podpowiedzi — wyszukiwarka sklepu działa dalej.

Własne konto i integracje

Załóż konto GrowSearch albo zaloguj się do panelu. W „Moje sklepy” połącz istniejącą instalację Shoper jednorazowym kodem lub dodaj własny katalog API.

IdoSell, WooCommerce, Shopify i inne platformy korzystają z API GrowSearch. Dodaj sklep, potwierdź jego domenę plikiem /.well-known/growsearch.txt, utwórz publiczny klucz widgetu oraz prywatny klucz importu. Wysyłaj do 200 produktów w paczce do POST /api/v1/ z nagłówkiem X-Api-Key. Klucza importu nie umieszczaj w przeglądarce. Pole wyszukiwania można oznaczyć data-growsearch-input.

Potwierdzenie domeny API działa przez 30 dni; odnowisz je przyciskiem „Sprawdź plik”. Wyszukiwarka i karuzele korzystają z tego samego indeksu i panelu ustawień.

Plan AI

Zakładka „AI i sprzedaż” przyjmuje CSV z kolumnami day,product_id,units,net_minor. Podaj pełny okres eksportu; brakujące dni w nim oznaczają zero sprzedaży dla wskazanych produktów. Import obejmuje maksymalnie 100 produktów i 5000 wierszy. Prognoza wymaga 28 dni historii; tygodniowe cechy pojawiają się po 56 dniach, roczne po 365. Raport pokazuje maksymalnie 100 produktów, błąd walidacji i orientacyjny zakres.

Pierwsze uruchomienie: cztery kroki

Otwórz GrowSearch przez Aplikacje i integracje → Zainstalowane aplikacje w panelu Shoper. Na Starcie kreator prowadzi do pierwszej publikacji; szczegółowe ustawienia pozostają w zakładkach.

  1. Katalog. Sprawdź liczbę zaimportowanych produktów i stan pełnego odczytu. Możesz ustawiać wygląd w trakcie importu.
  2. Szablon. Kliknij „Sprawdź stronę sklepu”. Rozpoznanie RWD lub Storefront jest wskazówką z publicznej strony. Brak potwierdzenia nie oznacza awarii — pole lub integracja mogą pojawiać się po uruchomieniu strony.
  3. Podgląd. Otwórz podgląd szkicu i wypróbuj frazy z własnego katalogu. Działa 15 minut; koszyk i statystyki są w nim wyłączone.
  4. Publikacja. Wybierz jedną z ośmiu skórek, kolor i widoczność wyszukiwarki. „Zapisz szkic” zachowuje ustawienia; „Opublikuj” je stosuje. Potem sprawdź podpowiedzi w sklepie na komputerze i telefonie.

Kreator wraca do pierwszego kroku po ponownym otwarciu panelu, dopóki nie opublikujesz ustawień. Zapisany szkic zostaje. Po ponownej instalacji sprawdź import i opublikuj zachowane ustawienia ponownie.

1. Publikacja i indeks

Po instalacji aplikacja rozpoczyna odczyt katalogu (nazwa, kod, producent, kategoria, cena, zdjęcie). Duży katalog odczytuje partiami i automatycznie wznawia przerwany odczyt. W panelu Start i Produkty zobaczysz postęp oraz datę ostatniego pełnego odczytu. „Katalog gotowy” oznacza odczyt do końca, a „0 produktów” przy zakończonym odczycie oznacza pusty katalog. Odświeżanie statusu zachowuje niezapisane ustawienia; przy ograniczeniu zakresu wyszukiwania panel pokazuje liczbę obsługiwanych produktów. Sklepy spoza Shopera indeksują przez API (zakładka Integracja: prywatny klucz importu + gotowa komenda curl; publiczny klucz ze snippetu służy wyłącznie wyszukiwaniu).

2. Dwa tryby wizualne

Podpowiedzi (overlay) — lista produktów pod polem wyszukiwania, z literówkami, synonimami i przyciskiem „Zobacz wszystkie wyniki” prowadzącym do natywnych wyników sklepu.

Pełny ekran (fullscreen) — kliknięcie pola wyszukiwania otwiera pełnoekranową wyszukiwarkę: duże pole, mikrofon (szukaj głosowo po polsku), filtry z lewej (kategorie, producenci, cena od–do, dostępność), siatkę produktów i „Pokaż więcej”. Zamykasz klawiszem Escape lub przyciskiem ✕. Tryb przełączasz w panelu w Ustawieniach — a w podglądzie na własnej stronie jednym kliknięciem w pasku u góry.

3. Merchandising: co klient zobaczy pierwszy

W Ustawieniach → Zaawansowane → Podbicie i obniżenie po polu połącz do sześciu warunków: wszystkie albo dowolny. Procent od −100 do 100 zmienia ocenę dopasowanych produktów raz na regułę. Opcjonalne daty obejmują całe dni według Europe/Warsaw, także ostatni dzień. Promocja wymaga potwierdzonej niższej ceny wybranej oferty. Dodaj regułę, sprawdź ją przyciskiem Przetestuj, a następnie zapisz szkic lub opublikuj ustawienia.

4. Raport fraz i analityka

W zakładce Analityka wybierz tydzień, miesiąc albo kwartał. Zobaczysz wyszukiwania, otwarcia produktów, dodania do koszyka i udział wyszukiwań bez wyników. „Kliknięcia / wyszukiwania” porównuje liczby zdarzeń; może przekroczyć 100%, gdy otwierasz kilka produktów. „Unikalne frazy” to różne wpisane frazy, nie osoby ani sesje. Średnia pozycja dotyczy kliknięć z zapisanym miejscem na liście.

Przy pierwszym uruchomieniu każda karta wyjaśnia brak danych. Kliknij Otwórz sklep, wyszukaj produkt w opublikowanej wyszukiwarce, a następnie Odśwież raport. Podgląd szkicu nie zapisuje statystyk. Jeśli wybrany okres jest pusty, sprawdź dłuższy okres. Dni raportu liczymy według UTC.

Lista „Czego nie znaleźli” pokazuje frazy bez wyników przy każdym wyszukiwaniu w wybranym okresie; kliknięcie otwiera dodawanie synonimu. Udział wyszukiwań bez wyników obejmuje także frazy, które czasem miały wyniki. „Dodania do koszyka” liczy pomyślne dodania z wyników, nie zamówienia. Trendy w Pro porównują ostatnie dwa tygodnie. Raport fraz pobierzesz po odczycie danych; przy błędzie użyj „Odśwież raport”.

5. Podgląd na własnej stronie (bezpłatnie)

Na growsearch.growcommerce.pl/podglad.html wpisujesz firmowy e-mail i adres sklepu — w kilka sekund generujemy podgląd: Kopia wyglądu strony z GrowSearch, na produktach możliwych do odczytania z publicznego HTML. Skrypty sklepu nie działają w tej kopii; podgląd znika po 48 godzinach. Możesz nim podzielić się ze współpracownikami.

6. Wygląd: skórki, logo, placeholder, adres w URL

W zakładce Wygląd wybierasz jedną z dziewięciu skórek (Studio, Market, Nocny, Bohater, Podpowiedzi, Moda, Katalog, Dwie kolumny, Sklepowy) i kolor akcentu. Każda skórka to inny układ warstwy: Studio i Katalog mają filtry i sortowanie, Bohater, Podpowiedzi, Dwie kolumny i Sklepowy mają lewą kolumnę z kategoriami i producentami (kliknięcie filtruje wyniki), Market i Nocny to zwarte listy pod polem, a Moda to cała strona z kaflami marek. Karta każdej skórki w panelu pokazuje jej prawdziwy kadr. Logo w pasku to adres https:// obrazka, pokazuje się po lewej od pola na pełnym ekranie. Animowany placeholder pisze w pustym polu podane frazy (do sześciu); przycisk „Wstaw najpopularniejsze frazy” bierze je z Analityki. Adres wyszukania w URL dopisuje do adresu strony #gs/q=fraza, więc link do wyszukania działa, a „wstecz” zamyka warstwę. Na karcie produktu w promocji pojawia się badge z procentem rabatu i cena przekreślona, o ile Shoper podaje cenę promocyjną.

7. Karuzele produktowe na stronach sklepu

Zakładka Karuzele produktowe dodaje karuzele produktów z danych wyszukiwarki poza samą warstwą: na stronie głównej, w kategorii, na stronach informacyjnych i 404. Sześć typów: Aktualnie poszukiwane (produkty najczęstszych fraz), Popularne teraz (najczęściej otwierane w 90 dni), Coraz częściej szukane (frazy rosnące tydzień do tygodnia) i Top oglądane (najczęściej otwierane w bieżącej kategorii), Dla Ciebie (kategorie i marki oglądanych produktów) oraz Ostatnio oglądane (powrót do produktów z tej sesji). Zwykłe karuzele są w Pro. W AI kolejność dodatkowo uczy się CTR i sezonowości tygodniowej na podstawie rzeczywistych wyświetleń i kliknięć. Karuzela produktowa wstawia się przed, za albo wewnątrz wskazanego elementu szablonu, np. #box_slider_131 na głównej albo #box_filter w kategorii; gotowe zestawy dodają typowe miejsca jednym klikiem. Bez panelu: wstaw w szablonie <div data-growsearch-widget="popular" data-title="Popularne teraz" data-limit="8"></div>. Karuzele produktowe nie pokazują produktów niedostępnych ani wykluczonych z podpowiedzi, a kliknięcia z karuzel produktowych nie wchodzą do raportu fraz.

8. Przenieś reguły przez CSV

W zakładce Słownik wybierz rodzaj danych: synonimy, przekierowania, reguły produktów lub frazy ukryte w podpowiedziach. Pobierz pełny CSV obejmuje całą aktywną listę i reguły zapisane w szkicu, także poza limitem listy w panelu.

Wybierz plik UTF-8, do 1 MiB i 1000 rekordów. Panel najpierw sprawdzi cały plik i pokaże wszystkie błędy albo podgląd z liczbą rekordów dodanych, zmienionych i bez zmian. Dopiero Zastosuj sprawdzony import zapisuje całą listę. Jeden błędny wiersz zatrzymuje import; poprawne wiersze nie zapiszą się częściowo. Import dodaje i aktualizuje rekordy, zachowując pozostałe.

Synonimy: fraza_a;fraza_b;kierunek;tryb; kierunek obie lub jedna. Przekierowania: fraza;cel;tryb; cel to ścieżka sklepu z / lub adres HTTPS. Reguły produktów: typ;fraza;sku;pozycja;od;do;format;tryb; typ pin, boost lub blacklist, pozycja 1–48, format growsearch-1. Daty są w UTC, np. 2026-12-01T08:00:00Z; puste oznaczają brak ograniczenia. Kod SKU musi wskazywać dokładnie jeden produkt w Twoim katalogu.

Kolumna tryb zachowuje od razu albo szkic. Starsze pliki bez tej kolumny działają od razu. Reguły w szkicu wymagają późniejszej publikacji. Frazy ukryte mają jedną kolumnę fraza, zawsze trafiają do szkicu i mieszczą do 50 pozycji. Ukrycie dotyczy podpowiedzi, popularnych fraz i trendów; klient nadal może wyszukać frazę.

Przed importem zapisz rozpoczęte zmiany edytora. Jeśli odpowiedź po zapisie zaginie, kliknij Sprawdź wynik zapisu. Panel potwierdzi pełny stan albo dopuści ponowienie tego samego pliku. Zmiana listy, szkicu lub katalogu wymaga nowego podglądu. Duży eksport podziel przed ponownym importem.

9. Pakiety Start, Pro i AI

Okres próbny (14 dni, bez karty) to pełny Pro. Potem w Shoperze wybierasz pakiet:

Na pakiecie Start karuzele produktowe można ustawić i opublikować, ale w sklepie pojawią się dopiero po zmianie pakietu na Pro. Zakładka Plan pokazuje aktualny pakiet i datę końca okresu.

Polskie odmiany słów

W zakładce Wyszukiwanie włącz Dopasowuj polskie odmiany słów, aby na przykład „kubków czarnych” znajdowało produkt „Kubek czarny”. Dopasowanie obejmuje nazwy produktów; kody, nazwy producentów i słowa chronione zachowują swoje brzmienie. Dosłowne trafienia mają wyższą punktację. Przełącznik jest domyślnie wyłączony.

Wpisz własną frazę w teście i kliknij Sprawdź odmiany na frazie. W szczegółach Dlaczego ten wynik? zobaczysz dopasowane odmiany. Zapisanie szkicu nie zmienia wyników klientów; użyj Opublikuj, gdy test jest zgodny z oczekiwaniami.

Słownik zapytań

W zakładce Słownik ustaw pomijane słowa pomocnicze, chronione słowa i kody oraz zamiany fraz. Wpisuj jedną pozycję w wierszu. Ochrona wyłącza korektę literówek; dokładne dopasowanie i początek słowa nadal działają. Możesz też chronić kody z aktualnego katalogu i słowa z cyframi.

Ustaw polskie słowa pomocnicze wybiera do, dla, na, z, w, i, oraz, lub i włącza ochronę kodów. Zachowuje własne chronione słowa i zamiany. „Bez”, „nie” i „oprócz” nadal wykluczają produkty. Ceny rozpoznajemy przed słownikiem, także z przecinkiem i „tys.”, np. „kubek do 0,05 tys. zł”. Górny limit ceny jest wyłączny: „do 50 zł” pokazuje ceny poniżej 50 zł.

Dodaj obie frazy zamiany do szkicu; rozpoczęta para wymaga dodania albo wyczyszczenia przed zapisem. Sprawdź na frazie testuje niezapisane reguły i pokazuje pominięte słowa, chronione kody oraz wykonaną zamianę. Zapisz szkic i opublikuj, aby zastosować reguły w sklepie. Istniejące Synonimy działające od razu zapisują się osobno. Same pomijane słowa nie dają dopasowanych produktów.

Propozycje synonimów z otwarć produktów

W zakładce Słownik znajdziesz Propozycje z otwarć produktów. Analiza porównuje frazy z ostatnich 30 dni UTC: proponuje parę, gdy obie frazy otwierały podobne produkty. Wymagamy minimum 5 wspólnych otwarć i 50% pokrycia zbiorów produktów; najwyższe pokrycie jest pierwsze. Przy większym ruchu analizujemy 200 najczęściej otwieranych fraz i pokazujemy do 20 nowych propozycji.

Pokrycie to liczba wspólnych produktów podzielona przez liczbę wszystkich różnych produktów obu fraz. Wspólne otwarcia to suma mniejszej liczby otwarć każdego wspólnego produktu. Liczymy zwykłe kliknięcia, bez zdarzeń koszyka i dodatkowych znaczników pozycji. Pomijamy produkty usunięte z indeksu, niewidoczne, wykluczone oraz ukryte aktywną regułą; dostępność magazynowa nie zmienia historycznego znaczenia tych kliknięć.

To podpowiedź do oceny, bez śledzenia osób lub sesji i bez gwarancji, że frazy zawsze znaczą to samo. Dodaj w obie strony zapisuje wybraną parę od razu. Otworzenie analizy nie zmienia ustawień ani wyników; istniejące pary nie są proponowane ponownie. Pary możesz później usunąć z listy synonimów. Gdy odpowiedzi nie uda się potwierdzić, otwórz ponownie zakładkę, aby odczytać aktualny stan.

Wagi i bestsellery

W zakładce Wyszukiwanie wybierz Zrównoważone, Nazwę produktu albo Kod produktu. W Własne wagi i premia bestsellerów dopasujesz suwaki od 0 do 200. Wagi wzmacniają dopasowanie, ale pokrycie frazy i przypięcia także wpływają na kolejność.

Oznaczaj bestsellery po nazwie lub kodzie produktu, bez wpisywania numerów. Podpowiedzi obejmują do 20 produktów klikanych w ostatnich 30 dniach lub przypiętych w zapisanych regułach. Kliknięcia nie są zamówieniami. Możesz oznaczyć do 500 produktów z bieżącego katalogu; premia 0 nie zmienia ich punktacji.

Sprawdź na frazie przechodzi do testu szkicu według trafności. Przy już wpisanej frazie uruchamia test nowych wag. Premia działa tylko dla oznaczonych produktów pasujących do frazy i filtrów. Kliknij Zapisz szkic, aby zachować zmiany, i Opublikuj, aby zastosować je w sklepie.

Kolejność produktów przy remisie

W zakładce Ustawienia rozwiń sekcję trafności. Gdy produkty mają takie samo dopasowanie i punktację, listę rozstrzyga do pięciu kryteriów: kliknięcia, dostępność, cena, data dodania i nazwa. Dla każdego wybierz kierunek. Przeciągnij pozycję lub użyj strzałek, aby zmienić jej priorytet. Kolejne kryterium działa, gdy poprzednie nadal daje remis.

Kliknięcia dotyczą szukanej frazy z ostatnich 30 dni. Podpowiedzi bestsellerów sumują wszystkie frazy. Nowość korzysta z daty dodania produktu w katalogu, a nie z daty importu do GrowSearch. Produkty bez daty albo ceny są na końcu w obu kierunkach tego kryterium. Przywróć domyślne zostawia więcej kliknięć najpierw.

Użyj Sprawdź na frazie, aby zobaczyć szkic, następnie zapisz i opublikuj ustawienia. Sama edycja lub zapis szkicu nie zmienia kolejności w sklepie. Przypięcia i lepsze dopasowanie mają pierwszeństwo; sortowanie klienta po cenie lub nazwie wybiera własną kolejność.

Terminy kampanii i banerów

W zakładce Reguły wybierz produkt po nazwie lub kodzie, frazę i efekt: przypięcie, podbicie albo ukrycie. Pusta fraza oznacza wszystkie wyszukiwania tylko przy ukrywaniu. Opcjonalny początek i koniec dotyczą czasu Europe/Warsaw; kampania działa od początku i kończy się o wskazanej godzinie. Bez terminów działa stale. Banery mają ten sam harmonogram. Lista pokazuje kampanie zaplanowane, w bieżącym terminie i zakończone; możesz je edytować, usuwać i filtrować.

Reguły zapisane w tej zakładce działają w sklepie w wybranym terminie. Reguły z testu wyników i reguły atrybutowe wymagają publikacji szkicu. Reguły atrybutowe pozwalają wybrać całe dni (ostatni dzień włącznie) albo dokładne godziny. Podczas jesiennej zmiany czasu powtórzona godzina oznacza pierwsze wystąpienie; nieistniejącej godziny wiosennej nie można zapisać.

Test wyników i reguły przed publikacją

Nad zakładkami panelu wpisz frazę i kliknij Testuj wyszukiwanie. Wybierz Szkic edytora, aby sprawdzić także niezapisane zmiany, albo Opublikowane, aby zobaczyć aktualną konfigurację sklepu. Test pokazuje kolejność podpowiedzi z indeksu i nie zwiększa statystyk. Możesz wybrać sortowanie oraz filtry ceny, kategorii, producenta, dostępności i zaimportowanych cech.

Przy produkcie otwórz Dlaczego ten wynik?, aby zobaczyć dopasowanie nazwy i kodu, wagi, podbicia, reguły cech, przypięcia oraz kolejność rozstrzygania remisów. Przypnij na początek zmienia priorytet dopasowanego produktu. W Więcej zmian podbijesz lub ukryjesz produkt, dodasz synonim albo przekierowanie dokładnej frazy.

Te akcje zmieniają szkic: kliknij Zapisz szkic, aby je zachować, i Opublikuj, aby zastosować w sklepie. Lista Reguły szkicu pozwala je usunąć i edytować termin kampanii. Reguły i synonimy dodawane osobno w zakładkach Reguły i Słownik działają w wybranym terminie w obu wersjach testu.

Przypięcie działa przy sortowaniu według trafności i tylko dla produktów pasujących do frazy oraz filtrów. Przy braku wyników propozycje są rekomendacjami: użyj trafnego synonimu, aby produkt zaczął pasować. Niepełny import lub ograniczenie do pierwszych 20 000 produktów jest oznaczone. Działanie w szablonie sprawdź także w sklepie.

Podgląd szkicu przed publikacją

W trzecim kroku kreatora albo w zakładce Wygląd kliknij Testuj szkic na stronie sklepu. Podgląd używa bieżących ustawień edytora i zaimportowanego katalogu, nawet gdy zmiany nie są zapisane. Pobiera wygląd publicznej strony bez jej skryptów, więc nie potwierdza jeszcze działania integracji w sklepie. Wybierz gotową frazę, sprawdź literówkę i przełącz pełny ekran lub podpowiedzi pod polem.

Podgląd działa 15 minut. Po zmianie ustawień kliknij Zaktualizuj podgląd szkicu. Jeśli import trwa, wyniki obejmują dotychczas zaimportowane produkty. Testy nie dopisują statystyk i nie dodają produktów do koszyka; publikacja jest osobnym przyciskiem.

Test po publikacji

Na Starcie pojawi się checklista Sprawdź wyszukiwarkę w sklepie. Indeks i publikację potwierdza serwer. Otwórz sklep, wpisz podane frazy z katalogu, sprawdź wyszukiwanie na prawdziwym telefonie i porównaj wygląd. Każdy test potwierdź osobnym przyciskiem; samo otwarcie linku nie zalicza testu.

Jeżeli pojawi się fraza bez wyników, dodaj jej trafny synonim. Potem kliknij Zakończ sprawdzanie. Potwierdzenia zostają po ponownym wejściu, a checklista znika po zakończeniu. Nowa publikacja lub ponowna instalacja wymaga nowych testów. „Odśwież checklistę” zachowuje niezapisane ustawienia.

  1. Wpisz fragment nazwy produktu — podpowiedzi albo fullscreen powinny pokazać Twoje realne produkty.
  2. Wpisz frazę z literówką — korekta nadal trafia.
  3. W trybie pełnoekranym: kliknij mikrofon i powiedz nazwę produktu (Chrome).
  4. Zaznacz filtr producenta — wyniki zawężają się, liczniki się zgadzają.
  5. Przejdź przez „Zobacz wszystkie wyniki” na natywną stronę wyników sklepu.
  6. Po kilkunastu wyszukiwaniach odczytaj raport fraz i dodaj pierwszy synonim z propozycji.

Najczęstsze pytania