Instalacja w Shoperze
Aplikacja TallyHost z Shoper App Store dodaje snippet do sklepu i wysyła opłacone zamówienia z serwera. Instalacja nie wymaga wklejania kodu.
Instalacja aplikacji
- Otwórz aplikację TallyHost w Shoper App Store.
- Kliknij „Zainstaluj” i potwierdź uprawnienia, o które prosi aplikacja.
- W panelu TallyHost otwórz stronę sklepu, krok „Instalacja”, zakładkę Shoper, i kliknij „Utwórz klucz parowania”. Klucz działa 24 godziny i tylko raz.
- W panelu Shopera otwórz aplikację TallyHost (lista zainstalowanych aplikacji), wklej klucz i kliknij „Dalej”. Jeśli baner zgód sklepu działa w IAB TCF, zaznacz to w tym samym formularzu. Aplikacja pokaże nazwę strony i organizacji w TallyHost — jeśli się zgadzają, kliknij „Połącz sklep”.
- Po połączeniu i aktywacji własnej domeny strony otwórz dowolną stronę sklepu w nowej karcie. Kod TallyHost pojawi się w sklepie w ciągu kilku minut, a panel pokaże pierwsze zdarzenie, gdy tylko do nas dotrze.
Co robi aplikacja
- Snippet. Aplikacja dodaje snippet TallyHost do stron sklepu. Snippet wysyła zdarzenia z przeglądarki, także zakup ze strony podziękowania.
- Zakupy z serwera. Gdy zamówienie zostanie opłacone, Shoper powiadamia aplikację (powiadomienie
order.paid), a aplikacja wysyła zakup z serwera, podpisany kluczem sklepu. - Sprawdzanie zamówień. Co 10 minut aplikacja sprawdza ostatnie opłacone zamówienia. Dzięki temu nie zgubimy zakupu, gdy powiadomienie od Shopera nie dotrze.
Zakup z przeglądarki i z serwera mają ten sam identyfikator, więc dostawca nie policzy zakupu dwa razy. Zamówień opłaconych przed połączeniem aplikacji ze stroną nie wysyłamy.
Własna domena i blokery reklam
Część blokerów reklam (uBlock Origin, AdGuard) blokuje skrypty po adresie dostawcy. Dlatego aplikacja ładuje snippet tylko z aktywnej własnej domeny strony (np. rk4vqz.twojsklep.pl, „Ustawienia strony” → „Własna domena”; zobacz Szybki start, krok 2), a blokery nie odróżnią go od sklepu.
Dopóki domena nie jest aktywna, aplikacja nie dodaje snippetu do sklepu, a panel pokazuje, na co czeka (rekordy DNS, certyfikat). Zakupy z serwera aplikacja wysyła od razu po połączeniu. Kilka minut po aktywacji domeny snippet pojawi się w sklepie sam, bez zmian w panelu Shopera.
Sam skrypt startowy aplikacji Shoper nadal pochodzi z adresu TallyHost. Dla pełnej odporności wklej też kod z panelu („Ustawienia strony” → „Instalacja”, sekcja „Kod dla Shopera”) do nagłówka strony sklepu:
- w starszych szablonach: „Dodatki i integracje” → „Integracje własne” → „Nagłówek i stopka strony”, pole nagłówka strony (
<head>; wklej kod na końcu); - w szablonie Storefront: „Wygląd i treści” → „Wygląd sklepu” → „Edycja szablonu graficznego”, a w nim miejsce na kod w sekcji
<head>(szczegóły w pomocy Shopera).
Snippet uruchomi się na stronie tylko raz, nawet gdy ładują go jednocześnie aplikacja i wklejony kod.
Zdarzenia ze sklepu (dataLayer)
Wyświetlenia produktów, dodania do koszyka, kolejne kroki zamówienia i zakup snippet odczytuje z warstwy danych (dataLayer), którą wypełnia wbudowana integracja Shopera z Google Analytics 4 albo Google Tag Manager. Sprawdziliśmy jej kod w szablonach Storefront i RWD (listopad 2026). Obie wersje wysyłają zdarzenia w formacie GA4, które snippet odczytuje bez dodatkowych ustawień, także przez gtag. Wyszukiwanie w sklepie (view_search_results) snippet wysyła jako search, bez pola z wpisaną frazą. Adres i tytuł strony wyników przechodzą zwykłe czyszczenie (parametry zapytania spoza listy dozwolonych usuwamy).
- Bez włączonej integracji GA4 lub GTM Shopera w warstwie danych nie ma zdarzeń e-commerce. Snippet wysyła wtedy tylko wyświetlenia stron, a zakup z serwera nie dostaje zgody klienta (zobacz wyżej).
- Warstwy
shopLayer, którą Shoper wypełnia dla własnych statystyk, snippet nie czyta. - Dane klienta, które Shoper dodaje do warstwy danych przed zakupem (e-mail, telefon, adres), snippet pomija.
- Snippet aplikacji czyta warstwę o domyślnej nazwie Shopera,
dataLayer.
Baner cookies i tryb TCF
Sklep musi mieć baner cookies, który obsługuje Google Consent Mode v2 albo IAB TCF 2.2. Jeśli twój baner działa na IAB TCF, zaznacz to przy łączeniu sklepu w aplikacji TallyHost w panelu Shopera. Ustawienie zmienisz później na tej samej stronie aplikacji. Przeczytaj też ostrzeżenia na stronie Baner cookies (CMP) i zgody.
Inne aplikacje wysyłające zakupy
Jeśli sklep ma aplikację albo integrację z Pixelem Meta, Pixelem TikToka lub tagiem Google Analytics, wyłącz w niej zdarzenie zakupu i wysyłkę z serwera. Inaczej dostawca policzy zakupy dwa razy. Panel pokaże ten punkt w kroku 5 konfiguracji. Szczegóły: Meta Pixel, Google Tag Manager i inne wtyczki.
Zamówienie testowe
- Złóż w sklepie zamówienie testowe, na przykład z płatnością przelewem.
- Oznacz zamówienie jako opłacone w panelu Shopera.
- W zakładce „Zdarzenia” w TallyHost sprawdź, czy przyszedł zakup z serwera sklepu.
Powiadomienia o połączeniu
Gdy ktoś połączy sklep ze stroną albo go od niej odłączy, właściciele i administratorzy organizacji dostają e-mail z adresem sklepu, nazwą strony i czasem zmiany. Jeśli nikt z zespołu nie łączył sklepu, odłącz go od razu (niżej) i zmień hasło do TallyHost.
Odłączenie sklepu w panelu
W „Ustawieniach strony” → „Instalacja” kliknij „Odłącz sklep” przy kluczu „Aplikacja Shoper” (właściciel albo administrator organizacji). Unieważniamy wtedy klucz podpisu sklepu i przestajemy przyjmować jego zakupy z serwera. Aplikacja zostaje w sklepie: żeby połączyć go ponownie, utwórz nowy klucz parowania i wklej go w aplikacji TallyHost w panelu Shopera.
Odinstalowanie
Po odinstalowaniu aplikacji usuwamy jej dostęp do sklepu i klucz podpisu sklepu, a połączenie ze stroną w panelu zostaje cofnięte.
Jeśli coś nie działa, skontaktuj się z nami.