// Integracje / Google Tag Manager

Visitant przez Google Tag Managera

Masz już Google Tag Managera? To dodasz Visitant bez dotykania kodu strony: jeden tag Niestandardowy HTML, jedna reguła, publikacja. Jedna rzecz musi się zgadzać: tag ma się odpalać na każdej stronie, a nie dopiero po zgodzie - skrypt żadnej nie potrzebuje.

Czego potrzebujesz

• Kontener GTM już zainstalowany na stronie i prawo do publikacji w tym kontenerze.
• Darmowe konto Visitant z dodaną domeną, np. twojastrona.pl.
• Około 10 minut razem ze sprawdzeniem w Podglądzie.

Instalacja w 5 krokach

1. 01 Utwórz tag Niestandardowy HTML

   W obszarze roboczym GTM kliknij Tagi - Nowy. Kliknij pole Konfiguracja tagu i wybierz Niestandardowy kod HTML (w angielskim interfejsie Custom HTML). Nazwij tag Visitant, żeby łatwo go później znaleźć.

   Opcję Obsługa document.write zostaw wyłączoną. Nasz skrypt jej nie używa.

2. 02 Wklej linijkę Visitant

   Wklej poniższą linijkę w pole HTML i zamień twojastrona.pl na swoją domenę. GTM sam wstawia skrypt do strony, więc atrybut defer nic tu nie robi - skrypt i tak ładuje się asynchronicznie i nie ma to znaczenia.

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

3. 03 Ustaw regułę All Pages - i żadnej zgody

   Kliknij pole Reguły i wybierz wbudowaną regułę All Pages (typ Wyświetlenie strony). Nie podpinaj tagu pod zdarzenie udzielenia zgody ani regułę banera cookies: Visitant nie zapisuje cookies ani adresów IP, więc nie potrzebuje zgody, a uzależnienie go od niej wyrzuci z liczb każdego, kto zignoruje baner - z naszego doświadczenia to duża część wizyt. Jeśli używasz trybu uzyskiwania zgody GTM, otwórz w tagu Ustawienia zaawansowane - Ustawienia zgody i zaznacz Nie jest wymagana dodatkowa zgoda (dokładne nazwy mogą się różnić w Twojej wersji).

   Wbudowane sprawdzanie zgody dotyczy tagów Google. Tag Niestandardowy HTML odpala się, gdy odpala się jego reguła, więc to reguła decyduje.

4. 04 Sprawdź w Podglądzie

   Kliknij Zapisz, a potem Podgląd w prawym górnym rogu. W nowej karcie otworzy się Tag Assistant; wpisz adres swojej strony i kliknij Połącz. Strona otworzy się z podpiętym debuggerem. Wróć do karty Tag Assistant, kliknij Dalej i spójrz na listę Uruchomione tagi przy zdarzeniu Container Loaded - powinien tam być Visitant. Gdy karta Podglądu jest otwarta, panel pokazuje już 1 osobę teraz.

5. 05 Opublikuj kontener

   Kliknij Prześlij w prawym górnym rogu. Zostaw zaznaczone Opublikuj i utwórz wersję, nadaj wersji nazwę, np. Dodanie Visitant, i kliknij Opublikuj. Dopóki nie opublikujesz, tag istnieje tylko w obszarze roboczym i prawdziwi odwiedzający nie są liczeni.

   Uczciwa uwaga o wadze: przewodnik Google na web.dev podaje, że sama biblioteka GTM waży około 33 KB po kompresji, a typowy kontener około 50 KB. Skrypt Visitant ma mniej niż 2 KB po kompresji. Jeśli GTM istnieje tylko po to, żeby załadować Visitant, zwykła instalacja jedną linijką jest lżejsza.

Czy działa? Sprawdź w 60 sekund

Zrób te sprawdzenia na opublikowanej stronie, nie w Podglądzie - wtedy wiesz, że wersja poszła na żywo.

• Otwórz stronę w oknie prywatnym: licznik osób teraz na górze panelu Visitant pokazuje 1.
• Otwórz narzędzia deweloperskie (F12), zakładka Sieć, filtr v.js: jedno żądanie ze statusem 200, a po nim żądanie do /api/e ze statusem 202.
• Odrzuć albo zamknij baner cookies (jeśli go masz) i otwórz kolejną podstronę: odsłona i tak pojawia się w tabeli Strony. Jeśli nie, tag jest uzależniony od zgody - wróć do kroku 3.
• Wejdź na stronę z wyniku wyszukiwania Google: tabela Źródła pokazuje Google.
• W GTM zakładka Wersje pokazuje Twoją nową wersję jako Opublikowana.

Częste problemy

Tag odpala się w Podglądzie, ale panel na żywej stronie jest pusty	Kontener nie został opublikowany albo strona ładuje starszą kopię gtm.js z cache. Opublikuj, a potem przeładuj stronę z wyłączonym cache w narzędziach deweloperskich.
Wizyty pojawiają się dopiero, gdy ktoś zaakceptuje cookies	Tag jest podpięty pod regułę zgody albo ma ustawione Wymagana dodatkowa zgoda. Zmień regułę na All Pages, a ustawienie zgody na Nie jest wymagana dodatkowa zgoda. Skrypt nie potrzebuje zgody.
Dwie odsłony na każdą stronę	Masz Visitant dwa razy: raz przez GTM i raz w kodzie strony (albo w drugim tagu). Zostaw jeden. Wyszukaj v.js w źródle strony, żeby znaleźć ten bezpośredni.
Licznik działa na pierwszej stronie aplikacji SPA, ale nie po klikaniu dalej	Visitant sam śledzi zmiany tras przez history.pushState, więc dodatkowa reguła Zmiana historii nie jest potrzebna - a dodana podwoiłaby liczby. Usuń z tagu każdą drugą regułę.
GTM ostrzega, że kontener zbliża się do limitu rozmiaru	Tagi Niestandardowy HTML wliczają się do limitu, ale nasz to jedna linijka. Limit wyczerpują inne tagi; Visitant dodaje mniej niż 100 znaków.

Pytania