Baza wiedzyInstrukcja

Jak działa Trafjo Autocomplete na Shoperze

Aplikacja sama dostaje domenę sklepu i sama dokłada skrypt do koszyka. W ramce panelu ustawiasz podpowiedzi, oglądasz zużycie i widzisz plan. Poniżej są te same elementy, które widzi sprzedawca.

Instalacja, krok po kroku

  1. 01

    Instalujesz aplikację w App Store

    W panelu Shopera wchodzisz do App Store i instalujesz Trafjo Autocomplete. Od tej chwili sklep ma własną instalację i własny klucz. Klucza nigdzie nie kopiujesz i nie wklejasz.

  2. 02

    Panel zarządzania

    Po instalacji zostajesz przekierowany do panelu zarządzania. Sprawdź w nim, czy w polu „Adres Twojego sklepu” jest dodana domena twojego sklepu. Powinna się dodać automatycznie podczas instalacji. Jeżeli jej nie ma, dopisz ją ręcznie — wystarczy nam link do strony głównej twojego sklepu.

  3. 03

    Sprawdź działanie skryptu w koszyku swojego sklepu

    Skrypt powinien pojawić się w polach: email, ulica z numerem oraz miasto.

  4. 04

    Dostosuj ustawienia w panelu

    W panelu jest kilka ustawień, które warto dostosować do twojego sklepu.

Tip. Po odinstalowaniu aplikacji podpowiedzi gasną od razu. Koszyk zostaje zwykłym formularzem. Ponowna instalacja włącza ten sam sklep z powrotem.

Adres sklepu

Webhook wpisuje adres z instalacji. Na liście widać jedną domenę, a w tle zapisany jest też wariant z www. Pole poniżej służy do kolejnych adresów: własna domena albo wersja językowa na innym hoście. Dopisanie nie kasuje adresu z webhooka.

Tak wygląda pole w panelu. Adres „sklep.pl” stoi tu tak, jak po webhooku.

Adres Twojego sklepu

Podaj domenę, na której ma działać wtyczka.

Usunięcie pyta o potwierdzenie i zdejmuje oba warianty, z www i bez. Limit to 10 wpisów technicznych, więc kilka domen z wariantem www wypełnia listę wcześniej, niż widać dziesięć wierszy.

Tip. Możesz wkleić cały adres ze https:// i ze ścieżką. Zostaje sama domena. Pusta lista gasi podpowiedzi, a kupujący wpisuje adres ręcznie. Po dopisaniu odśwież koszyk; nowa domena może zacząć działać do około pół minuty.

Skrypt w koszyku

Moduł storefront wstawia jedną linijkę, taką samą w każdym sklepie. Skrypt pyta Trafjo, który sklep otworzył koszyk, i dostaje klucz oraz ustawienia z panelu. Gdy domeny nie ma na liście, usługa jest wyłączona albo skończył się opłacony okres, podpowiedzi się nie uruchamiają. Formularz zamówienia działa dalej.

<script type="module" src="https://www.trafjo.pl/sdk/shoper-checkout.v2.js"></script>

Tip. Drugiej kopii nie doklejaj ręcznie. Dwa takie same skrypty potrafią podnieść listę podpowiedzi dwa razy. Zmiana przełącznika wchodzi w sklepie po odświeżeniu koszyka. Otwarta karta trzyma poprzednie ustawienia.

Tak wygląda karta w miejscu licznika sesji, dopóki nie wiemy, czy podpowiedzi wstały.

Nie wiemy z góry, czy skrypt wstał w Twoim szablonie koszyka, bo dowiadujemy się o tym dopiero wtedy, gdy ktoś ten koszyk otworzy. Dlatego prosimy o sprawdzenie i o jedno kliknięcie. „Nie działa” trafia prosto do nas, razem z opisem, i nie zależy od tego, czy masz wykupiony pakiet.

Tip. Karta gaśnie sama, gdy skrypt odezwie się z Twojego koszyka — nie musisz nic klikać. „Sprawdzę później” schowa ją od razu, na przykład w sklepie, który dopiero startuje i nie ma jeszcze zamówień.

Ustawienia w ramce

Przełączniki poniżej są tymi samymi komponentami co w panelu sklepu. Działają tylko na tej stronie. Podgląd listy po prawej reaguje od razu. W prawdziwym koszyku ta sama zmiana czeka na odświeżenie strony.

Podgląd planu. Na Starterze trzy przełączniki są zablokowane.

System Autocomplete

Włącza usługę Autocomplete w sklepie.

Główny włącznik tego sklepu. Domyślnie jest włączony. Gdy go zdejmiesz, loader w ogóle nie uruchamia podpowiedzi, a pozostałe ustawienia w panelu się rozmywają.

Tip. Wyłączenie zostawia koszyk w spokoju: kupujący wpisuje adres tak jak przed instalacją. Włączenie z powrotem nie wymaga ponownego wklejania skryptu.

Priorytet podpowiedzi

Dopasowuje kolejność podpowiedzi do przybliżonej lokalizacji.

Domyślnie włączone. Lista podnosi wyżej miejscowości z okolicy miasta odczytanego z adresu IP. Nic z listy nie znika. Działa na każdym planie.

Tip. To nie jest pytanie przeglądarki o GPS. Wyłączenie zostawia pełną listę Polski, tylko bez promowania okolicy kupującego.

Logo na liście podpowiedzi

Wyświetla logo Trafjo na liście podpowiedzi.

Domyślnie nad listą widać znak Trafjo. Wyłączenie chowa znak. Podpowiedzi, klawisze i napis „Sugestie:” zostają.

Tip. Na Starterze suwak jest wyszarzony i logo zostaje. Od Standard można je schować. Wróć przełącznikiem planu u góry, żeby zobaczyć blokadę.

Napisy przy skrótach klawiszowych

Wyświetla opisy przy klawiszach Esc, strzałkach i Enter.

Domyślnie przy Esc, strzałkach i Enter widać słowa: Wyjdź, Wybierz, Zatwierdź. Wyłączenie zostawia same klawisze. Schowanie jest od planu Standard.

Tip. Na telefonie pasek i tak pokazuje „Sugestie:”, bo tam nie ma klawiszy. Na Starterze napisów nie da się schować.

Ciemny motyw podpowiedzi

Wyświetla listę podpowiedzi w ciemnym motywie.

Włączenie podmienia kolory paska, wierszy i klawiszy. W podglądzie obok widać to od razu.

Tip. Domyślnie lista jest jasna. Na Starterze zostaje jasna. Ciemne kolory włączysz od Standard. Układ wierszy się nie zmienia.

Plakietki przy numerze domu

Wyświetla numer i lokal w osobnych plakietkach („numer 7”). Wyłączone — numer stoi w adresie, tak jak wejdzie do pola („Kwiatowa 7/1”).

Domyślnie numer stoi wprost w adresie, razem z lokalem, jako jeden napis: numer z bazy jest mocny, a spoza spisu — przygaszony. Włączenie wraca do plakietek „numer 7” i „lokal 1”. Ustawienie jest na każdym planie.

Tip. Do pola adresu i tak wchodzi „Kwiatowa 7/1” — przełącznik zmienia tylko to, jak numer wygląda na liście.

Centrowanie mapy punktu odbioru

Automatycznie centruje mapę na adresie podanym w koszyku.

Domyślnie włączone. Mapa punktu odbioru, na przykład InPost, staje na adresie wpisanym w koszyku. Wyłączenie zostawia własny widok mapy operatora. Podpowiedzi adresu działają dalej. Ustawienie jest na każdym planie.

Tip. Podgląd w panelu nie ma mapy operatora. Efekt widać w koszyku, przy wyborze punktu odbioru, po odświeżeniu strony.

Podgląd listy

Podgląd listy podpowiedzi z aktualnymi ustawieniami. Zmiany w sklepie widoczne są po odświeżeniu koszyka. Zapytania z tego formularza nie wliczają się do planu. Prosimy jednak korzystać z podglądu z rozwagą.

W okresie próbnym, zanim sklep ma przypisany pakiet, logo, napisy i ciemną listę da się ustawić. Gdy pakietem zostanie Starter, te trzy wracają do wyglądu Startera. Po przejściu na Standard albo wyżej wraca wcześniejszy wybór.

Sesje i zapytania

Plan liczy sesje. Jedna sesja to jedno wypełnienie adresu w koszyku. Litery wpisywane po drodze to zapytania: widać je na wykresie, a do limitu planu się nie doliczają. Zwykłe zamówienie zamyka się w jednej sesji, choć podpowiedzi po drodze było kilka albo kilkanaście.

Przykładowe liczby, 164 sesje w tym miesiącu. Przełącz plan u góry ustawień, żeby zobaczyć inny limit. Na Starterze (200) pasek wchodzi w ostrzeżenie.

Zużycie

Liczymy…

Sesje i zapytania

Dane prezentowane według wybranego okresu. Bieżące dane mogą być opóźnione o kilka minut.

Liczymy…

Okres liczy się od dnia zakupu, nie od pierwszego dnia miesiąca: kto kupił 20., ma licznik od 20. do 19. następnego miesiąca, według czasu Warszawy. Dzień zerowania licznika karta pisze wprost. Pasek jest zielony, od około 80% bursztynowy, po wyczerpaniu limitu czerwony. Bez pakietu i na Enterprise zamiast liczby stoi znak nieskończoności.

Tip. Licznik okresu bywa spóźniony o kilka minut. Na wykresie jest o tym osobna informacja. Rozliczenie i tak idzie po sesjach, nie po wysokości słupka zapytań.

Po przekroczeniu limitu masz jeszcze 10% rezerwy, a rozpoczęte wypełnianie adresu kończy się normalnie. Nowe podpowiedzi wracają w dniu zerowania licznika albo po przejściu na wyższy plan w App Store. Gdy skończy się opłacony okres, podpowiedzi są wstrzymane, a koszyk dalej przyjmuje adres ręcznie. Po opłaceniu wracają same, w ciągu godziny.

Tip. Sesja trwa przez czas uzupełniania formularza, około 10 minut aktywności. Wyjątkowo długie wpisywanie, grubo ponad zwykły adres, może otworzyć następną sesję. Krótkie poprawki liter tego nie robią.

Co jest w którym planie

Autocomplete, priorytet podpowiedzi i centrowanie mapy są na każdym planie. Różnią się limit sesji oraz trzy ustawienia wyglądu. Ceny na kartach są netto. Roczny to 10 stawek miesięcznych. Zakup i zmiana planu odbywają się w App Store Shopera. Podświetlenie „Obecny plan” na tej stronie podąża za przełącznikiem u góry ustawień.

UstawienieStarterStandardProEnterprise
Sesje / miesiąc2001 0003 000bez limitu
Autocomplete w koszykutaktaktaktak
Priorytet podpowiedzitaktaktaktak
Centrowanie mapy punktutaktaktaktak
Schowanie logonietaktaktak
Schowanie napisów przy klawiszachnietaktaktak
Ciemna listanietaktaktak

Starter

Na pierwsze koszyki

19zł / miesiąc netto

200 sesji / miesiącJedna sesja to jedno wypełnienie adresu w koszyku. Zapytania w trakcie pisania nie doliczają się osobno.

  • Autocomplete adresu w formularzu zamówienia
  • W zamian: miejsce na tablicy zaufanych sklepów

Standard

Dla rosnących sklepów

49zł / miesiąc netto

1000 sesji / miesiącJedna sesja to jedno wypełnienie adresu w koszyku. Zapytania w trakcie pisania nie doliczają się osobno.

  • Pełne White-Label, bez logo w koszyku
  • Pomoc we wdrożeniu skryptu

PRO

Pełna skala checkoutu

129zł / miesiąc netto

3000 sesji / miesiącJedna sesja to jedno wypełnienie adresu w koszyku. Zapytania w trakcie pisania nie doliczają się osobno.

  • Pełne White-Label, bez logo w koszyku
  • Priorytetowy support
  • Gwarancja SLA (uptime 99,9%)

Potrzebujesz więcej niż 3 000 sesji miesięcznie? Napisz w sprawie pakietu Enterprise.

Skontaktuj się

Tip. Pro dokłada priorytetowy support i gwarancję dostępności. Enterprise, powyżej 3 000 sesji, ustala się mailem na kontakt@trafjo.pl. W ramce jest do tego pasek pod kartami.