// Integracje / Shopify

Visitant w Shopify

Jedna linijka w pliku motywu i każda strona produktu, kolekcji i koszyka jest policzona - bez cookies i bez banera zgód. Pięć minut, bez instalowania aplikacji (w Shopify App Store nie ma aplikacji Visitant i nie jest potrzebna).

Czego potrzebujesz

• Sklep Shopify, w którym jesteś właścicielem albo pracownikiem z uprawnieniem do Motywów.
• Darmowe konto Visitant z dodaną domeną sklepu (panel pokaże Ci ten sam kod już z Twoją domeną).
• Domena sklepu, np. twojastrona.pl - bez https:// i bez www.

Instalacja w 5 krokach

1. 01 Otwórz edytor kodu motywu

   W panelu Shopify wejdź w Sklep online - Motywy. Przy aktualnym motywie kliknij przycisk ... (trzy kropki) i wybierz Edytuj kod. Dokładne nazwy mogą się różnić w Twojej wersji panelu.

   Shopify zaleca najpierw zduplikować motyw (... - Duplikuj), żeby mieć kopię zapasową. Zmiana jednej linijki jest bezpieczna, ale kopia nic nie kosztuje.

2. 02 Otwórz plik layout/theme.liquid

   Na liście plików po lewej otwórz folder Layout i kliknij theme.liquid. To szkielet każdej strony sklepu, więc skrypt wklejony tutaj działa na stronie głównej, kolekcjach, produktach, wyszukiwarce, blogu i stronie koszyka.

3. 03 Wklej linijkę Visitant przed </head>

   Wyszukiwarką edytora (Ctrl+F) znajdź </head> i wklej poniższą linijkę tuż nad nim. Zamień twojastrona.pl na domenę swojego sklepu.

   <script defer data-domain="twojastrona.pl" src="https://annuora.com/v.js"></script>Kopiuj

   Skrypt ma mniej niż 2 KB po kompresji i ładuje się z atrybutem defer, więc nie opóźnia zdjęć produktów ani JavaScriptu motywu.

4. 04 Zapisz i otwórz sklep

   Kliknij Zapisz w prawym górnym rogu. Potem otwórz sklep w zwykłej karcie przeglądarki (nie w podglądzie motywu) i przejdź przez dwie, trzy strony: główną, kolekcję, produkt.

   Shopify na krótko cache'uje strony sklepu. Jeśli po minucie nic nie widać, otwórz stronę produktu, na której dziś jeszcze nie byłeś.

5. 05 Dodaj cele, które mają sens bez checkoutu

   Kod motywu nie działa na krokach checkoutu, na stronie podziękowania ani na stronie statusu zamówienia - Shopify wyłączył starą ścieżkę checkout.liquid (dla stron podziękowania i statusu zamówienia wygaszoną 28 sierpnia 2025, dla pozostałych kroków checkoutu już niewspieraną), a checkout da się dziś rozszerzać tylko przez rozszerzenia i piksele Shopify, które działają w piaskownicy, gdzie nasz skrypt strony nie ma wstępu. Dotyczy to także Shopify Plus. Visitant widzi więc wszystko do strony /cart włącznie, ale nie zamówienia, ich wartość ani przychód. W panelu wejdź w Ustawienia - Cele i dodaj Wizyta /cart jako konwersję; jeśli chcesz krok bliżej sprzedaży, dodaj data-v-event="Begin checkout" do przycisku checkoutu w sections/main-cart-footer.liquid (albo tam, gdzie trzyma go Twój motyw).

   Mówimy o tym wprost, bo to ograniczenie ma każde narzędzie bez cookies, które siedzi w motywie. Lejki w Visitant kończą się w Shopify na koszyku.

Czy działa? Sprawdź w 60 sekund

Otwórz panel Visitant w jednej karcie, a sklep w drugiej. Wszystko poniżej powinno się wydarzyć w ciągu minuty od zapisania motywu.

• Licznik osób teraz na górze panelu pokazuje 1 (Ciebie) kilka sekund po otwarciu strony produktu.
• Ramka instalacyjna z kodem znika z panelu, a na wykresie pojawia się pierwszy słupek.
• Wejdź na stronę produktu z wyniku Google albo wpisz adres sklepu ręcznie: tabela Źródła pokaże odpowiednio Google albo Direct.
• Wejdź na /cart: pojawia się w tabeli Strony. Otwórz checkout: nic nowego się nie pojawia - to ograniczenie z kroku 5, nie błąd.
• Podejrzyj źródło strony (Ctrl+U) i wyszukaj v.js: linijka siedzi w <head>, dokładnie raz.

Częste problemy

W panelu nic się nie pojawia	Sprawdź domenę w tagu: musi być identyczna z domeną dodaną w Visitant, bez www. Literówka w tym miejscu to naszym zdaniem przyczyna numer jeden. Upewnij się też, że edytujesz motyw aktualnie opublikowany, a nie roboczą kopię.
Licznik działa na stronie głównej, ale nie na produktach	Niektóre motywy używają osobnego pliku układu dla części szablonów (np. layout/password.liquid albo własnego układu ustawionego w JSON-ie szablonu). Otwórz szablon w edytorze kodu, sprawdź, którego układu używa, i wklej linijkę także tam.
Brakuje zamówień i przychodu	W Shopify to normalne: kod motywu nie działa na stronach checkoutu, więc żaden skrypt z poziomu motywu nie widzi zakupów. Jako cel ustaw Wizyta /cart albo zdarzenie Begin checkout (krok 5).
Linijka zniknęła po aktualizacji motywu	Aktualizacje z Theme Store podmieniają pliki motywu. Po aktualizacji dodaj linijkę do theme.liquid ponownie albo wpisz to do swojej listy kontrolnej.

Pytania