Spis treści
Co to jest data layer?
Data layer, po polsku warstwa danych, to tablica JavaScript window.dataLayer, przez którą strona przekazuje informacje do Google Tag Managera i tagu Google. Trafiają do niej zdarzenia, np. zakup albo logowanie, i wartości, np. kwota zamówienia.
Tagi czytają dane z warstwy danych, zamiast wyciągać je z treści strony, a w GTM można na ich podstawie ustawiać reguły uruchamiania tagów. Google zaleca zadeklarować warstwę danych przed kodem kontenera GTM:
<script>
window.dataLayer = window.dataLayer || [];
</script>
<!-- tu dopiero kod kontenera Google Tag Manager --> Jak działa dataLayer.push?
Dane dopisuje się metodą push. Ten przykład z dokumentacji Google wysyła zdarzenie i dwie zmienne naraz:
dataLayer.push({
'event': 'customize',
'color': 'red',
'conversionValue': 50
}); Po co warstwa danych, skoro GTM może czytać stronę?
GTM potrafi odczytać tekst czy kliknięty element, ale takie dane psują się przy każdej zmianie wyglądu. Wystarczy, że programista zmieni klasę przycisku albo przeniesie cenę w inne miejsce. Warstwa danych przekazuje te same informacje wprost, niezależnie od wyglądu strony.
Szczególnie ważne jest to w sklepach. Żeby GA4 i Google Ads widziały wartość zamówienia, produkty i identyfikator transakcji, sklep musi te dane przekazać, a warstwa danych jest do tego najpewniejszą drogą.
Najczęstsze błędy
Google wymienia kilka pułapek. Najpoważniejsza to nadpisanie całej warstwy danych zamiast dopisania do niej:
// Źle: nadpisuje całą warstwę danych
dataLayer = [{'item': 'value'}];
// Dobrze: dopisuje do istniejącej
window.dataLayer = window.dataLayer || [];
dataLayer.push({'item': 'value'}); - Wielkość liter. dataLayer.push działa, datalayer.push już nie.
- Niespójne nazwy zmiennych. visitorType na jednej stronie i visitor_type na drugiej to dla GTM dwie różne zmienne.
- Kilka warstw danych na jednej stronie. Google zaleca jedną, bo kilka może sprawić, że tagi się nie uruchomią, a dane zginą.
- Ponowna inicjalizacja po załadowaniu GTM. Dane trafiają wtedy do tablicy, której GTM już nie obserwuje.
Jak sprawdzić, co trafia do data layer?
- 1Włącz tryb podglądu w Google Tag Manager i przejdź ścieżkę, którą chcesz sprawdzić, np. do zakupu testowego.
- 2W panelu podglądu otwórz zdarzenie i zakładkę z warstwą danych. Zobaczysz dokładnie, jakie wartości strona wysłała.
- 3Szybki podgląd daje też konsola przeglądarki: wpisz dataLayer i sprawdź zawartość tablicy.
Komentarz Sebastiana – konsultanta SEO i AI
Sebastian Baryś · freelancer SEO i Google Ads
Gdy przejmuję konto Google Ads sklepu, jedną z pierwszych rzeczy, które sprawdzam, jest to, czy wartość zamówienia trafia do warstwy danych. Zdarza się, że konwersje się liczą, ale z wartością 0 albo zawsze tą samą kwotą, a wtedy strategie ustalania stawek oparte na ROAS uczą się na złych danych.
Odradzam wyciąganie danych z wyglądu strony, np. odczytywanie ceny z tekstu na stronie podziękowania. Działa do pierwszej zmiany szablonu. Warstwa danych jest umową między stroną a tagami i przeżywa zmiany wyglądu.
Powiązane pojęcia
Jak Data layer (warstwa danych) łączy się z innymi pojęciami ze słownika:
- data layer przekazuje dane do Google Tag Manager i tagu Google Google Tag Manager Tag Google
- dataLayer.push wysyła zdarzenia i zmienne Zdarzenie (GA4)
FAQ – najczęstsze pytania
Co to jest data layer?
Data layer, po polsku warstwa danych, to tablica JavaScript window.dataLayer, przez którą strona przekazuje informacje do Google Tag Managera i tagu Google. Tagi czytają z niej np. nazwę zdarzenia, wartość zamówienia czy typ użytkownika, zamiast wyciągać te dane z wyglądu strony.
Jak dodać zdarzenie do data layer?
Metodą dataLayer.push, np. dataLayer.push({'event': 'login'}). W Google Tag Manager tworzy się potem regułę, która uruchamia tag, gdy w warstwie danych pojawi się to zdarzenie. Kolejne wartości dopisuje się w tym samym obiekcie albo w osobnych wywołaniach push.
Gdzie umieścić data layer?
Google zaleca zadeklarować warstwę danych przed kodem kontenera Google Tag Manager, poleceniem window.dataLayer = window.dataLayer || [];. Dzięki temu dane są dostępne od momentu, w którym GTM zaczyna działać.
Czy wielkość liter w dataLayer ma znaczenie?
Tak. Google zwraca uwagę, że nazwy są wrażliwe na wielkość liter: dataLayer.push działa, a datalayer.push już nie. To samo dotyczy nazw zmiennych, więc visitorType i visitor_type to dla GTM dwie różne zmienne.
Czy data layer jest potrzebny w sklepie internetowym?
W praktyce tak. Żeby GA4 i Google Ads widziały wartość zamówienia, produkty i identyfikator transakcji, sklep musi te dane przekazać, a najpewniej robi się to przez warstwę danych. Wiele platform sklepowych i wtyczek wysyła takie dane automatycznie.
Źródła
Chcesz mieć pewność, że wartość konwersji liczy się poprawnie?
Przy kampaniach Google Ads sprawdzam warstwę danych, tagi i konwersje, żeby strategie stawek uczyły się na prawdziwych przychodach, a nie na przypadkowych liczbach.
Sebastian Baryś
Odpowiadam osobiście, bez pośredników