Szybki start
Konfiguracja strony w panelu TallyHost ma 5 kroków: sklep, instalacja, baner cookies, destynacje i sprawdzenie. Zajmie ci to zwykle kilkanaście minut, a postęp zapisujemy po każdym kroku.
Jak działa TallyHost
Snippet w przeglądarce i (na WooCommerce i Shoperze) wtyczka albo aplikacja na serwerze sklepu wysyłają do TallyHost zdarzenia e-commerce: wyświetlenie produktu, dodanie do koszyka, rozpoczęcie zamówienia, wybór płatności i zakup. TallyHost wysyła je dalej do Meta Conversions API, TikTok Events API i Google Analytics 4. Robimy to tylko wtedy, gdy klient sklepu wyraził zgodę w banerze cookies.
Konfigurację możesz przerwać w dowolnym momencie. Strona zostaje na liście „w konfiguracji”, a po powrocie zaczniesz od kroku, na którym skończyłeś.
Krok 1. Sklep
Podaj trzy rzeczy:
- Adres sklepu — ten, który widzą klienci. Adres musi zaczynać się od
https://. - Platforma — WooCommerce, Shoper albo inna platforma. Od niej zależy instrukcja instalacji w kroku 2.
- Nazwa strony — służy do rozróżniania sklepów w panelu. Widzisz ją tylko ty i twój zespół.
Krok 2. Instalacja
Najpierw własna domena — ten krok jest obowiązkowy. Snippet TallyHost ładuje się tylko z subdomeny twojego sklepu (np. rk4vqz.twojsklep.pl), a nie z adresu TallyHost: blokery reklam (uBlock Origin, AdGuard, Brave) nie odróżnią jej od sklepu, więc zdarzenia z przeglądarki dotrą, a zakup z serwera zachowa zgodę klienta.
- Dodaj subdomenę w panelu. Panel sam proponuje losową nazwę w domenie sklepu (np.
rk4vqz.twojsklep.pl): możesz ją zmienić albo kliknąć „Losuj inną”. Losowa nazwa jest bezpieczniejsza niż popularnesstczygtm, które listy blokerów znają z innych usług. Unikajads,analytics,sgtmitrack— listy blokerów blokują je niezależnie od sklepu. - U operatora DNS domeny sklepu (home.pl, OVH, nazwa.pl, Cloudflare i inni) dodaj rekordy A, AAAA i TXT z tabeli w panelu. Instrukcje dla tych operatorów są pod tabelą. Nie używaj CNAME.
- Poczekaj na aktywację. Sprawdzamy DNS sami, a potem wystawiamy certyfikat; panel pokazuje stan sprawdzenia i certyfikatu. Zwykle trwa to kilka minut, czasem do kilku godzin, gdy zmiany DNS rozchodzą się wolniej.
Kod instalacyjny panel pokaże, gdy domena będzie aktywna. Wtyczkę WooCommerce i aplikację Shoper możesz połączyć wcześniej: zakupy z serwera sklepu działają bez domeny, a snippet zacznie działać po aktywacji (na WooCommerce sparuj wtedy wtyczkę ponownie).
Panel pokaże instrukcję dla twojej platformy:
- WooCommerce: instalujesz wtyczkę TallyHost i wklejasz klucz parowania. Szczegóły: Instalacja w WooCommerce.
- Shoper: instalujesz aplikację TallyHost z Shoper App Store. Szczegóły: Instalacja w Shoperze.
- Inna platforma: wklejasz kod instalacyjny w sekcji
<head>sklepu. Szczegóły: Inna platforma i integracja dla programistów.
Po instalacji otwórz dowolną stronę sklepu w nowej karcie. Panel sprawdza co 3 sekundy, czy przyszło pierwsze zdarzenie. Jeśli instalację zrobi ktoś inny, kliknij „Sprawdzę później” i przejdź dalej.
Krok 3. Baner cookies (CMP)
Ten krok jest obowiązkowy. TallyHost czyta zgody klienta z banera cookies sklepu (CMP). Baner musi obsługiwać Google Consent Mode v2 albo IAB TCF 2.2. Panel sprawdza baner na zdarzeniach, które już przyszły ze sklepu.
Bez banera nie przejdziesz dalej: bez sygnału zgody nie możemy wysłać zdarzeń do Meta, TikToka i GA4. Jeśli twój baner działa na IAB TCF, przeczytaj ostrzeżenia na stronie Baner cookies (CMP) i zgody.
Krok 4. Destynacje
Destynacja to konto dostawcy, do którego wysyłamy zdarzenia: Meta (Facebook i Instagram), TikTok albo Google Analytics 4. Połącz co najmniej jedną. Przed zapisaniem destynacji panel wysyła do dostawcy zdarzenie testowe i pokazuje jego odpowiedź.
Nowa destynacja działa przez 48 godzin w trybie testowym: zdarzenia idą do dostawcy z kodem testowym, więc widzisz je w narzędziach testowych dostawcy. Po 48 godzinach tryb testowy kończy się sam i zdarzenia idą bez kodu. Kolejne destynacje dodasz później w zakładce „Destynacje”.
Krok 5. Sprawdzenie i start
Złóż w sklepie zamówienie testowe i przejdź całą ścieżkę zakupu. Lista punktów odświeża się sama:
- Instalacja — zdarzenia przychodzą z adresu sklepu.
- Baner cookies — wykryty sygnał zgody z Google Consent Mode v2 albo z IAB TCF.
- Zdarzenia e-commerce — przyszły wyświetlenie produktu, dodanie do koszyka, rozpoczęcie zamówienia i zakup. Wybór płatności liczymy, jeśli sklep go wysyła, ale nie jest wymagany.
- Odmowa zgody działa — otwórz sklep w oknie prywatnym, kliknij w banerze „Odrzuć wszystkie” i wejdź na produkt. Zdarzenie powinno mieć w debuggerze status „brak zgody”.
- Zakup z serwera sklepu — oznacz zamówienie testowe jako opłacone. Na WooCommerce i Shoperze ten punkt jest wymagany, na innej platformie zalecany.
- Inne wtyczki wysyłające zakupy — wyłącz zdarzenie zakupu w innych wtyczkach i integracjach. Szczegóły: Meta Pixel, Google Tag Manager i inne wtyczki.
- Automatyczne zaawansowane dopasowanie w Meta — wyłącz je w Events Managerze, jeśli Pixel Meta zostaje w sklepie.
- Destynacje w trybie testowym — panel pokazuje, kiedy kończy się tryb testowy.
- Własna domena (obowiązkowa) — aktywna subdomena sklepu, z której ładuje się snippet i która zbiera zdarzenia przeglądarki. Ustawiasz ją na początku kroku 2.
Przycisk „Zakończ konfigurację” będzie aktywny, gdy wszystkie punkty poza zalecanymi będą gotowe. Jeśli nie chcesz czekać 48 godzin, przełączysz destynację na produkcję wcześniej przyciskiem „Przełącz na produkcję teraz”.
Debugger: zakładka „Zdarzenia”
W zakładce „Zdarzenia” widzisz każde zdarzenie, które przyjęliśmy, i wynik wysyłki do każdej destynacji, razem z odpowiedzią dostawcy. Zdarzenia przechowujemy 14 dni.
Najczęstsze statusy wysyłki:
- „wysłane” — dostawca przyjął zdarzenie.
- „brak zgody” — klient nie wyraził zgody, więc zdarzenie nie trafiło do dostawcy. Powód obok statusu mówi, której zgody zabrakło.
- „pominięte” — dostawca nie przyjmuje tego zdarzenia albo zdarzeniu brakuje danych. Powód jest obok statusu.
- „błąd, ponowienie” — wyślemy zdarzenie ponownie.
- „porzucone” — dostawca odrzucił zdarzenie i nie będziemy go ponawiać.
- „destynacja wstrzymana” — destynacja jest wstrzymana, na przykład po wygaśnięciu tokenu dostawcy.
Gdzie szukać pomocy
- Instalacja w WooCommerce
- Instalacja w Shoperze
- Inna platforma i integracja dla programistów
- Baner cookies (CMP) i zgody
- Meta Pixel, Google Tag Manager i inne wtyczki
Jeśli nie znajdziesz odpowiedzi, skontaktuj się z nami. Podaj nazwę strony w panelu i, jeśli chodzi o konkretne zdarzenie, jego czas i nazwę z debuggera.