W skrócie
8 min czytaniagtag() to funkcja JavaScript stojąca za tagiem Google (gtag.js). Każde wywołanie dodaje polecenie do dataLayer, a biblioteka gtag.js, ładowana asynchronicznie z googletagmanager.com, odczytuje tę kolejkę i wysyła dane do Google Analytics, Google Ads i innych produktów Google. Główne polecenia to config, event, set, get i consent. Domyślne ustawienia zgody muszą zostać wykonane przed wywołaniem config lub event, a osobom, które nie czują się pewnie w JavaScripcie, Google poleca Google Tag Manager.
Czym jest gtag?
Funkcja gtag() to API JavaScript tagu Google. Każde jej wywołanie dodaje polecenie, takie jak config, event, set lub consent, do kolejki o nazwie dataLayer, którą biblioteka gtag.js odczytuje, aby wysyłać dane do produktów Google. Dokumentacja Google ujmuje to w jednym zdaniu: "The Google tag (gtag.js) API uses the gtag() function to send data to Google products like Google Analytics and Google Ads." Jeśli kod źródłowy witryny ładuje gtag/js?id=, witryna uruchamia tag Google bezpośrednio we własnym kodzie, a nie przez kontener Tag Managera.
Trzy nazwy łatwo tu pomylić. gtag.js to plik biblioteki. gtag() to funkcja wywoływana przez twój kod. Tag Google to nazwa produktu, której Google używa dla całości i którą opisuje jako "a single tag you can add to your website to use Google measurement and advertising products like Google Ads, Google Analytics, Campaign Manager, Display & Video 360, and Search Ads 360."
Jak gtag.js ładuje się na stronie?
gtag.js ładuje się przez dwuczęściowy fragment kodu, który według Google należy umieścić "immediately after the opening <head> HTML tag on every page you want to measure." Pierwsza część pobiera bibliotekę, a druga definiuje funkcję gtag() i ustawia w kolejce pierwsze polecenia.
<!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=TAG_ID"></script>
<script>
window.dataLayer = window.dataLayer || [];
function gtag() {
dataLayer.push(arguments);
}
gtag('js', new Date());
gtag('config', 'TAG_ID');
</script>Kolejność ma mniejsze znaczenie, niż się wydaje. Biblioteka ładuje się z atrybutem async, więc skrypt wbudowany wykonuje się pierwszy. Ponieważ gtag() robi tylko dataLayer.push(arguments), każde polecenie wywołane przed załadowaniem biblioteki czeka w tablicy dataLayer, a gtag.js przetwarza kolejkę po załadowaniu. Dlatego możesz wywołać gtag('event', ...) w dowolnym miejscu strony, nie sprawdzając, czy biblioteka jest gotowa.
Wartość id w adresie skryptu to identyfikator tagu Google. Google podaje jako przykłady "GT-XXXXXXXXX, G-XXXXXXXXX, and AW-XXXXXXXXX" i zaznacza, że "the IDs can be used interchangeably when adding the Google tag to your website." Jeden tag Google może mieć kilka identyfikatorów i wysyłać dane do kilku miejsc docelowych, takich jak usługa Google Analytics i konto Google Ads.
Do czego służą polecenia gtag()?
Polecenia gtag() to pięć czasowników przekazywanych jako pierwszy argument: config, event, set, get i consent. Tabela zawiera składnię i sformułowania z dokumentacji API Google.
| Polecenie | Składnia | Co robi według Google |
|---|---|---|
| config | gtag('config', '<TARGET_ID>', {...}) | "Lets you add additional configuration information to targets." |
| event | gtag('event', '<event_name>', {...}) | "Use the event command to send event data." |
| set | gtag('set', {...}) | "Lets you define parameters that will be associated with every subsequent event on the page." |
| get | gtag('get', '<target>', '<field_name>', callback) | "Lets you get various values from gtag.js including values set with the set command." |
| consent | gtag('consent', 'default' or 'update', {...}) | "Use the consent command to configure consent." |
config robi więcej, niż sugeruje opis. Google podaje, że "The config command is needed to send data to Google advertisement products," a w przypadku Google Analytics domyślne wywołanie config wysyła też zdarzenie page_view. Aby temu zapobiec, Google opisuje send_page_view: false, co jest potrzebne, gdy sam wysyłasz odsłony, na przykład w aplikacji jednostronicowej.
Polecenia set warto używać oszczędnie. Google dodaje: "We recommend using config or event commands wherever possible." Wartości ustawione na poziomie zdarzenia nadpisują wartości z config, a wartości z config nadpisują to, co ustawiono globalnie przez set.
consent ma dwa tryby. 'default' ustawia stan początkowy, zanim odwiedzający odpowie na baner, a 'update' zmienia go po odpowiedzi. Cztery parametry trybu zgody v2 to ad_storage, analytics_storage, ad_user_data i ad_personalization; przewodnik po Google Consent Mode v2 omawia, co wniosły dwa nowsze sygnały.

W jakiej kolejności powinny działać polecenia gtag?
Polecenia gtag wykonują się w kolejności dodania, a trzy z nich działają tylko wtedy, gdy znajdą się przed pierwszym wywołaniem config lub event.
- Flaga rezygnacji.
window['ga-disable-MEASUREMENT_ID'] = true"must be set before any calls togtag()are made, and it must be set on each page for which you want to turn off Analytics." - Domyślne ustawienia zgody. Google zaleca ustawienie wartości domyślnej każdego typu zgody "on every page of your site before any commands that send measurement data (such as
configorevent)." Jeśli narzędzie do zgód ładuje się asynchronicznie, dodajwait_for_updatez wartością w milisekundach. - Ustawienia globalne. Wywołania
set, takie jakallow_google_signals: false, umieść przedconfig, aby uwzględniało je już pierwsze żądanie. - config. Jedno wywołanie na identyfikator tagu.
- event. Wszystko pozostałe.
Domyślne ustawienie zgody umieszczone po config przychodzi za późno dla pierwszej odsłony, a to jeden z mniej widocznych sposobów, w jakie witryna wysyła dane, które miała wstrzymać.
Jak gtag ma się do tagu Google i Google Tag Manager?
gtag.js i Google Tag Manager to dwa sposoby wdrożenia tego samego tagu Google: przy gtag.js piszesz polecenia w kodzie strony, a w Tag Managerze konfigurujesz je w interfejsie internetowym, a skrypt kontenera, gtm.js, ładuje je za ciebie. Przewodnik Google po gtag.js mówi, że "if you're unfamiliar with JavaScript, we recommend using Google Tag Manager instead of gtag.js."
| gtag.js na stronie | Google Tag Manager | |
|---|---|---|
| Ładowany skrypt | gtag/js?id=G-... | gtm.js?id=GTM-... |
| Gdzie są polecenia | W kodzie witryny | W tagach i regułach kontenera GTM |
| Kto zmienia śledzenie | Programiści, przez wdrożenie | Każdy z dostępem do kontenera, przez publikację |
| Używany identyfikator | Identyfikator tagu Google (G-, AW-, GT-) | Identyfikator kontenera (GTM-), który następnie ładuje tag Google |
Oba rozwiązania współdzielą dataLayer, więc witryna może korzystać z obu. Ryzykiem jest podwójne liczenie. Google ostrzega na przykład, że jeśli konfigurujesz tagi przez Tag Managera, nie należy dodatkowo włączać automatycznego śledzenia historii w Google Analytics, "as this can lead to double-counting page views." Ta sama logika dotyczy fragmentu gtag wpisanego na stałe i tagu Google w GTM, gdy oba wskazują ten sam identyfikator pomiaru: każdy wysyła własne page_view. Przewodnik o wpływie Google Tag Manager na prywatność omawia drugą stronę tego wyboru, czyli to, ile kodu kontener pozwala innym dodawać do twoich stron.

Panel w czasie rzeczywistym
Śledzenie celów
Śledzenie bez cookie
Dlaczego blokery reklam zatrzymują gtag?
Blokery reklam zatrzymują gtag, blokując żądanie biblioteki z www.googletagmanager.com lub dane wysyłane do punktów zbierania Google. Gdy żądanie skryptu się nie powiedzie, gtag() nadal istnieje, bo zdefiniował ją wbudowany fragment, ale nikt nie odczytuje kolejki dataLayer, więc żadne dane nie opuszczają strony. Przewodnik o blokerach reklam i dokładności analityki wyjaśnia, jak ta luka wygląda w raportach. Google tag gateway for advertisers serwuje tag z twojej własnej domeny, choć dokumentacja tej bramy nie wspomina o blokerach reklam.
Jak sprawdzić, co wysyła gtag?
To, co wysyła gtag, sprawdzisz, obserwując żądania sieciowe i narzędzia debugowania Google, a nie czytając fragment kodu. Przewodniki Google korzystają z dwóch: Tag Assistant, który pokazuje polecenia i wygenerowane przez nie żądania, oraz DebugView w Google Analytics, który po włączeniu trybu debugowania pokazuje przychodzące zdarzenia. W przeglądarce przefiltruj panel Network pod kątem żądań zbierających dane i sprawdź, czy każda odsłona lub każde zdarzenie pojawia się raz, z oczekiwanymi parametrami. Lista kontrolna weryfikacji analityki opisuje te same testy dla dowolnego narzędzia śledzącego.
Jak skrypt Flowsery wypada na tle gtag?
Skrypt śledzący Flowsery to jeden tag script z identyfikatorem witryny, więc przed rozpoczęciem przepływu danych nie trzeba konfigurować kolejki poleceń. Wklej <script defer data-fl-website-id="flid_******" src="https://cdn.flowsery.com/main.js"></script> do sekcji head, a odsłony będą śledzone automatycznie. Cele niestandardowe korzystają z atrybutu data-fs-goal na elemencie lub z wywołania takiego jak window.flowsery('signup'), a dokumentacja Flowsery pokazuje małą kolejkę window.flowsery.q, która przechowuje wywołania wykonane przed załadowaniem skryptu, czyli ten sam wzorzec, którego gtag używa z dataLayer. Skrypt ma też opcję bez plików cookie, która używa codziennie zmienianego hasha odwiedzającego i nie przechowuje danych osobowych. Lekki skrypt waży mniej niż 10 KB i ładuje się asynchronicznie. Jeśli twój zespół zarządza już tagami w Google Tag Manager, dokumentacja Flowsery zawiera konfigurację tagu Custom HTML dla GTM, więc oba rozwiązania mogą działać obok siebie podczas migracji.
Najczęściej zadawane pytania
Czy gtag to to samo co Google Tag Manager?
Nie. gtag.js to biblioteka stojąca za tagiem Google, a gtag() wywołujesz we własnym kodzie strony. Google Tag Manager to osobny kontener ładowany przez gtm.js, w którym tagi konfiguruje się w interfejsie internetowym. Oba mogą wdrażać ten sam tag Google.
Czy można wywołać gtag() przed załadowaniem gtag.js?
Tak. Wbudowany fragment definiuje gtag() jako funkcję dodającą argumenty do tablicy dataLayer. Wywołania wykonane przed załadowaniem biblioteki czekają w tej kolejce, a gtag.js przetwarza je po kolei po załadowaniu.
Czy jeden fragment gtag może wysyłać dane do Google Analytics i Google Ads?
Tak. Jeden tag Google może łączyć się z kilkoma miejscami docelowymi, takimi jak usługa Google Analytics i konto Google Ads. Pojedynczy tag może mieć kilka identyfikatorów, a Google zaznacza, że przy dodawaniu tagu do witryny można ich używać zamiennie.
Dlaczego gtag wysyła page_view bez wywołania event?
Domyślne wywołanie config dla identyfikatora Google Analytics samo wysyła zdarzenie page_view. Ustaw send_page_view: false, jeśli chcesz wysyłać odsłony ręcznie. W witrynach z pomiarem zaawansowanym odsłony oparte na historii nadal się uruchamiają, chyba że wyłączysz też tę opcję w strumieniu danych.
Gdzie umieścić fragment gtag?
Według Google należy go umieścić zaraz po otwierającym tagu <head> na każdej stronie, którą chcesz mierzyć. Flaga rezygnacji trafia do skryptu przed fragmentem, bo Google wymaga jej ustawienia przed pierwszym wywołaniem gtag(). Domyślne ustawienia zgody umieszcza się wewnątrz fragmentu, przed wywołaniem config, bo według Google muszą zostać wykonane przed poleceniami wysyłającymi dane pomiarowe.
Czy gtag działa, gdy skrypt jest zablokowany?
Żadne dane nie są wysyłane. Wbudowana część fragmentu nadal definiuje gtag() i wypełnia dataLayer, ale bez biblioteki gtag.js nikt nie przetwarza tej kolejki. Dlatego zablokowani odwiedzający po prostu nie pojawiają się w Google Analytics, zamiast być widoczni jako błędy.
Czym różnią się gtag.js, gtag() i tag Google?
gtag.js to plik biblioteki ładowany z googletagmanager.com. gtag() to funkcja wywoływana przez twój kod, która dodaje polecenia do dataLayer. Tag Google to nazwa, której Google używa dla całości: jednego tagu obejmującego produkty takie jak Google Ads i Google Analytics.
Jakich formatów identyfikatora tagu można użyć we fragmencie gtag?
Google podaje jako przykłady GT-XXXXXXXXX, G-XXXXXXXXX i AW-XXXXXXXXX i zaznacza, że przy dodawaniu tagu Google do witryny można ich używać zamiennie. Identyfikator trafia do parametru id w adresie skryptu oraz do wywołania config. Jeden tag Google może mieć kilka identyfikatorów.
Kiedy używać gtag('set')?
Używaj set dla parametrów, które mają być dołączane do każdego kolejnego zdarzenia na stronie. Google zaleca w miarę możliwości config lub event. Wartości zdarzenia nadpisują wartości z config, a te nadpisują ustawienia globalne. Jeśli korzystasz z set, umieść je przed config, aby wartości uwzględniało już pierwsze żądanie.
Jak wyłączyć Google Analytics flagą rezygnacji gtag?
Ustaw na stronie window['ga-disable-MEASUREMENT_ID'] = true. Google podaje, że flagę trzeba ustawić przed pierwszym wywołaniem gtag() i na każdej stronie, na której chcesz wyłączyć Analytics.
Czy ten artykuł był pomocny?
Chętnie poznamy opinię!
Częściej widoczni w Google
Jedno kliknięcie ustawia Flowsery jako preferowane źródło, dzięki czemu nasze artykuły pojawiają się wyżej w Najważniejszych artykułach, trybie AI i Przeglądach od AI.
Jeszcze jedno...
Flowsery
Analityka witryny skupiona na przychodach
Każdy odwiedzający, źródło i konwersja w czasie rzeczywistym. Prosto, skutecznie i bez plików cookie.
Panel w czasie rzeczywistym
Śledzenie celów
Śledzenie bez cookie
Powiązane hasła ze słownika


Jak ustawiać właściwości użytkownika w GA4 i raportować o nich
Ustaw właściwości użytkownika w GA4 przez gtag lub Tag Manager, zarejestruj je jako wymiary niestandardowe o zakresie użytkownika i zmieść się w limicie 25.


Grupowanie treści w GA4 za pomocą jednego parametru
Skonfiguruj grupowanie treści w GA4 parametrem content_group w gtag lub Tag Managerze, odczytaj wymiar Content group i pozbądź się wierszy (not set).


Jak działa opt-out z Google Analytics i co blokuje każda metoda
Opt-out z Google Analytics to dodatek do przeglądarki, flaga ga-disable w window lub odmowa zgody. Co każda metoda blokuje, kto nią steruje i gdzie się kończy.


Dlaczego współczynnik odrzuceń w GA4 to odwrócony współczynnik zaangażowania
Współczynnik odrzuceń w GA4 to odsetek sesji bez zaangażowania. Sprawdź, jak definiuje go Google, czym różni się od Universal Analytics i gdzie go dodać.


Co liczy raport stron docelowych w GA4 i gdzie pojawiają się puste wiersze
Raport stron docelowych w GA4 pokazuje pierwszą stronę każdej sesji. Gdzie go znaleźć, jakie ma domyślne wskaźniki, skąd (not set) i jak dodać źródło.


Jak GA4 rejestruje to, co odwiedzający wpisują w wyszukiwarkę witryny
Skonfiguruj wyszukiwanie w witrynie w GA4 przez pomiar zaawansowany, dodaj własne parametry zapytań, znajdź wymiar Search term i śledź wyszukiwania bez adresu URL.
Powiązane artykuły


Jak połączyć Search Console z GA4 i opublikować raporty
Jak połączyć Search Console z GA4 w sekcji Administracja, jakie role są potrzebne, jak opublikować dwa raporty w Library i czego te dane nie połączą.


Jak budować wskaźniki obliczane w GA4 przy limicie pięciu miejsc
Google ogranicza wskaźniki obliczane w GA4 do 5 na standardową usługę. Poznaj składnię wzorów, jednostki, miejsca użycia i to, czego wzór nie może zawierać.


Jak dodawać adnotacje Google Analytics w GA4 i prowadzić rejestr zmian
Adnotacje Google Analytics w GA4 przypinają datowaną notatkę do wykresów liniowych. Kto może je dodawać, limity 60 i 150 znaków, pułap 1 000 i rejestr zmian.

