Wszystkie strony pomocy

Instalacja w WooCommerce

Wtyczka TallyHost dodaje snippet do sklepu i wysyła opłacone zamówienia z serwera sklepu, podpisane kluczem wtyczki. Do połączenia wtyczki z panelem wystarczy jednorazowy klucz parowania.

Wymagania

  • WordPress z WooCommerce i PHP w wersji 7.4 lub nowszej.
  • Konto administratora WordPressa albo konto z uprawnieniem do zarządzania WooCommerce.
  • Strona w panelu TallyHost z platformą WooCommerce (krok 1 konfiguracji, zobacz Szybki start).

Instalacja i parowanie

  1. Pobierz plik ZIP wtyczki TallyHost (dostaniesz go od nas, dopóki wtyczki nie ma w katalogu WordPressa). W panelu WordPressa otwórz „Wtyczki” → „Dodaj nową” → „Wyślij wtyczkę na serwer” i wybierz ten plik.
  2. Zainstaluj wtyczkę i kliknij „Włącz”.
  3. Otwórz WooCommerce → TallyHost.
  4. Skopiuj klucz parowania z panelu TallyHost. Znajdziesz go w kroku 2 konfiguracji albo w „Ustawienia strony” → „Instalacja”. Klucz zaczyna się od thpair_.
  5. Wklej klucz parowania w polu „Klucz parowania” i kliknij „Połącz”.
  6. Otwórz dowolną stronę sklepu w nowej karcie. Panel pokaże pierwsze zdarzenie, gdy tylko do nas dotrze. Snippet działa tylko z aktywną własną domeną strony (niżej); sparuj wtyczkę po jej aktywacji, a sparowaną wcześniej — ponownie.

Klucz parowania jest ważny 24 godziny i działa tylko raz. Jeśli wygasł albo został już użyty, wygeneruj nowy w „Ustawienia strony” → „Instalacja”.

Co robi wtyczka po sparowaniu

  • Klucz podpisu. Wtyczka generuje własny klucz podpisu Ed25519. Klucz prywatny zostaje w sklepie. Do TallyHost trafia tylko klucz publiczny, którym sprawdzamy, że zamówienie naprawdę przyszło z twojego sklepu.
  • Snippet. Wtyczka dodaje snippet TallyHost na początku sekcji <head> każdej strony sklepu.
  • Zdarzenia e-commerce. Jeśli sklep nie ma jeszcze warstwy danych e-commerce (dataLayer), wtyczka ją dodaje: wyświetlenie produktu, dodanie do koszyka, rozpoczęcie zamówienia i zakup.
  • Zakupy z serwera. Gdy zamówienie zostanie opłacone albo przejdzie w stan „W trakcie realizacji” lub „Zrealizowane”, wtyczka wysyła zakup z serwera sklepu, podpisany kluczem wtyczki. Zakup z przeglądarki i z serwera mają ten sam identyfikator, więc dostawca nie policzy go dwa razy.
  • Zwroty. Zwrot w WooCommerce wtyczka wysyła jako osobne zdarzenie. Dziś zwroty trafiają tylko do Google Analytics 4.

Wysyłka z serwera nigdy nie blokuje składania zamówienia: wtyczka wysyła zakup w tle i ponawia go, gdy TallyHost jest chwilowo niedostępny. Zamówień złożonych przed włączeniem wtyczki nie wysyłamy.

Własna domena i blokery reklam

Część blokerów reklam (uBlock Origin, AdGuard) blokuje skrypty po adresie dostawcy, a bez snippetu zakup z serwera traci zgodę klienta. Dlatego wtyczka wstawia snippet tylko z aktywnej własnej domeny strony (np. rk4vqz.twojsklep.pl, „Ustawienia strony” → „Własna domena”; zobacz Szybki start, krok 2). Gdy domena jest aktywna, parowanie ustawia ją we wtyczce samo: snippet ładuje się z tej domeny i do niej wysyła zdarzenia przeglądarki.

Bez domeny w polu „Host snippetu” (albo z adresem TallyHost, np. https://t.tallyhost.io) wtyczka nie wstawia snippetu i mówi to w WooCommerce → TallyHost oraz na kokpicie i liście wtyczek. Zakupy i zwroty z serwera sklepu wysyła dalej. Dotyczy to także sklepów sparowanych wcześniej, które ładowały snippet z t.tallyhost.io.

Jeśli domena stała się aktywna po sparowaniu, sparuj wtyczkę ponownie albo wpisz adres domeny (np. https://rk4vqz.twojsklep.pl) w polu „Host snippetu” w WooCommerce → TallyHost. W polu „Host zbierający” zostaw https://t.tallyhost.io — na ten adres serwer sklepu wysyła zakupy, więc nie zależą one od stanu domeny. Jeśli domenę wpisano kiedyś w „Host zbierający”, przenieś ją do „Host snippetu”, a w „Host zbierający” wpisz https://t.tallyhost.io.

Oba pola i zmiany z parowania zapisuje tylko administrator witryny. Gdy paruje kierownik sklepu, wtyczka połączy się z panelem, ale hosty zostaną bez zmian (komunikat to powie).

Inne wtyczki wysyłające konwersje

Podczas parowania wtyczka zgłasza do panelu aktywne wtyczki, które same wysyłają konwersje do Meta, TikToka albo GA4, na przykład:

  • „Facebook for WooCommerce”
  • „Meta Pixel for WordPress”
  • „PixelYourSite”
  • wtyczki TikToka, na przykład „TikTok for WooCommerce”

Panel pokaże je w kroku 5 konfiguracji. W każdej z nich wyłącz zdarzenie zakupu albo wysyłkę przez Pixel i Conversions API (Events API w przypadku TikToka). Inaczej dostawca policzy zakupy dwa razy. Szczegóły: Meta Pixel, Google Tag Manager i inne wtyczki.

Ustawienia opcjonalne

Ustawienia znajdziesz w WooCommerce → TallyHost.

  • IAB TCF — zaznacz, jeśli baner cookies sklepu działa na IAB TCF. Wtyczka doda wtedy do snippetu atrybut data-cmp="tcf". Przeczytaj wcześniej ostrzeżenia na stronie Baner cookies (CMP) i zgody.
  • Zdarzenia własne — zaznacz, jeśli sklep wysyła do dataLayer własne zdarzenia (np. zapis do newslettera) i ich nazwy są na liście w panelu (Ustawienia strony → Zdarzenia własne). Wtyczka doda atrybut data-custom-events. Szczegóły: Inna platforma i integracja dla programistów.
  • Meta Pixel ID — tylko jeśli sklep nie ładuje Pixela Meta w inny sposób, na przykład przez Google Tag Manager. Snippet załaduje wtedy Pixel dopiero po zgodzie klienta.
  • Identyfikator GA4 — identyfikator usługi GA4 (zaczyna się od G-). Dzięki niemu zakup z serwera trafia do tej samej sesji GA4 co wizyta klienta.
  • GA4 przy zablokowanym tagu — zaznacz razem z opcją „Uzupełniaj GA4, gdy tag Google jest zablokowany” w destynacji GA4 w panelu. Wymaga identyfikatora GA4. Szczegóły i cookie _sst_ga do polityki cookies: Meta Pixel, Google Tag Manager i inne wtyczki.
  • Wartość zakupu — domyślnie suma produktów po rabatach, bez wysyłki i podatku (tak zaleca Google). Możesz wybrać wartość całego zamówienia, z wysyłką i podatkiem.
  • dataLayer e-commerce — „Automatycznie” dodaje warstwę danych tylko wtedy, gdy nie dodaje jej inna wtyczka z pełną warstwą (GTM4WP, Google Analytics for WooCommerce, Conversios, GTM for WooCommerce (Tag Pilot)). Obok Pixel Managera, Site Kitu, PixelYourSite i Google for WooCommerce wtyczka TallyHost dodaje własną warstwę, bo te wtyczki nie dają wszystkich zdarzeń przy każdej wizycie. To samo zdarzenie z tej samej strony w ciągu 5 sekund snippet zwykle wysyła raz. Dodanie do koszyka nasza wtyczka zgłasza jednak na następnej stronie, więc obok wtyczek, które zgłaszają je przy kliknięciu (Pixel Manager, Site Kit, PixelYourSite), może przyjść dwa razy. Jeśli druga wtyczka zawsze daje pełną warstwę, wybierz „Nigdy”.

Wtyczki z dataLayer, które odczytujemy

Snippet odczytuje zdarzenia e-commerce tych wtyczek (sprawdzone w ich kodzie, listopad 2026):

  • GTM4WP (Google Tag Manager for WordPress). Gdy w GTM4WP ustawisz inną nazwę warstwy danych niż dataLayer, wtyczka TallyHost przekaże ją snippetowi sama.
  • Google Analytics for WooCommerce (oficjalna wtyczka WooCommerce).
  • Site Kit by Google (dodanie do koszyka i zakup).
  • PixelYourSite (moduł Google Tag Manager).
  • Pixel Manager for WooCommerce — zdarzenia pojawiają się dopiero po zgodzie klienta, którą sprawdza sama wtyczka, więc wtyczka TallyHost dodaje obok własną warstwę danych. Gdy w wersji Pro włączysz wysyłkę GA4 z serwera (Measurement Protocol), Pixel Manager nie wysyła zakupu GA4 w przeglądarce, więc snippet go nie zobaczy; zakup z serwera i tak wysyła wtyczka TallyHost.
  • Conversios i GTM for WooCommerce (Tag Pilot).

Google for WooCommerce (Google Listings & Ads) wysyła zdarzenia tylko do Google Ads. Snippet je pomija, bo to kopie dla reklam Google. Gdy w sklepie działają naraz dwie wtyczki z tej listy (np. Site Kit i GTM4WP), to samo dodanie do koszyka (ten sam produkt, wariant i ilość w ciągu 5 sekund) zwykle wysyłamy raz. Gdy wtyczki opisują wariant różnym tekstem, dodanie produktu z wariantami może przyjść dwa razy.

Ponowne parowanie

Nowy klucz parowania zastępuje klucz podpisu wtyczki. Sparuj wtyczkę ponownie, gdy przenosisz sklep na inny serwer, odtwarzasz go z kopii zapasowej bez ustawień wtyczki albo podejrzewasz wyciek klucza. Poprzedni klucz przestaje wtedy działać.

Gdy coś nie działa

  • Panel nie widzi pierwszego zdarzenia. Sprawdź, czy wtyczka jest włączona i czy cache strony albo wtyczka optymalizująca nie usuwa skryptu z sekcji <head>. Wyczyść cache i otwórz sklep ponownie.
  • Klucz parowania nie działa. Klucz jest ważny 24 godziny i tylko raz. Wygeneruj nowy.
  • Zakup z serwera nie przychodzi. Sprawdź, czy zamówienie testowe jest opłacone albo ma stan „W trakcie realizacji”. Wtyczka zapisuje błędy wysyłki w notatkach zamówienia i w dzienniku WooCommerce → Status → Logi (źródło tallyhost).
  • Komunikat o innej wtyczce wysyłającej konwersje. Wyłącz w niej wysyłkę zakupów i zwrotów, jak opisano wyżej.

Jeśli problem zostaje, skontaktuj się z nami.