Warstwa danych (dataLayer) to obiekt JavaScript przechowujący ustrukturyzowane informacje o stronie i zachowaniu użytkownika, z którego korzysta Google Tag Manager do uruchamiania tagów i przekazywania wartości do narzędzi analitycznych. To pośrednik między kodem strony a GTM — zamiast „grzebać” w treści HTML, GTM odczytuje dane z jednego, ustandaryzowanego źródła.
Jak działa warstwa danych
Warstwa danych to zwykła tablica JavaScript o nazwie dataLayer. Deweloper umieszcza w niej informacje, a strona aktualizuje ją w trakcie interakcji użytkownika. GTM nasłuchuje zmian i na ich podstawie odpala odpowiednie tagi oraz wypełnia zmienne.
Przykład zdarzenia w dataLayer
Po dodaniu produktu do koszyka strona może wysłać do warstwy danych:
event: 'add_to_cart'— nazwa zdarzenia, która uruchamia regułę w GTM.value: 199.00— wartość transakcji, gotowa do przekazania do GA4.currency: 'PLN'— waluta.item_id: 'SKU-123'— identyfikator produktu.
GTM odczytuje te wartości jako zmienne warstwy danych i przekazuje je dalej, np. do zdarzenia w GA4 lub tagu konwersji Google Ads.
Po co stosować warstwę danych
| Bez warstwy danych | Z warstwą danych |
|---|---|
| GTM „zgaduje” dane, scrapując tekst ze strony. | Dane dostarczane są w jasnym, stałym formacie. |
| Zmiana wyglądu strony psuje pomiary. | Layout można zmieniać bez wpływu na tracking. |
| Trudne przekazywanie wartości transakcji. | Wartość, waluta i produkty dostępne natychmiast. |
Dobre praktyki
- Ustal stały, udokumentowany schemat nazw zdarzeń i kluczy (tzw. data layer spec).
- Inicjalizuj
dataLayerprzed kodem kontenera GTM, aby nie zgubić pierwszych wartości. - Używaj metody
dataLayer.push()do dodawania zdarzeń dynamicznych. - Nie umieszczaj w warstwie danych informacji wrażliwych ani danych osobowych w postaci jawnej.
- Te same dane wykorzystuj później w tagowaniu server-side, by ujednolicić pomiary.
Solidnie zaprojektowana warstwa danych to fundament wiarygodnej analityki — wdrażamy ją w ramach wdrożenia GA4.
Najczęściej zadawane pytania
Czy warstwa danych jest obowiązkowa w GTM?
Nie jest formalnie wymagana, ale w praktyce niezbędna przy poważnych wdrożeniach. Bez niej trudno przekazywać wartości transakcji, parametry produktów czy dane logowania w stabilny sposób.
Kto powinien przygotować warstwę danych?
Schemat projektuje analityk lub specjalista pomiarowy, a implementację w kodzie strony wykonuje deweloper. Współpraca obu stron gwarantuje, że dane będą kompletne i poprawne.
Czy dane z warstwy danych są widoczne dla użytkownika?
Tak, obiekt dataLayer jest dostępny w przeglądarce, więc nie należy umieszczać w nim danych wrażliwych ani niezaszyfrowanych danych osobowych.
