W skrócie
9 min czytaniaWarstwa danych to obiekt JavaScript, w którym strona zapisuje zdarzenia i wartości do odczytu przez tagi analityczne. Menedżer tagów Google i gtag.js współdzielą jedną tablicę, window.dataLayer, i przetwarzają wysłane komunikaty w kolejności ich nadejścia, uruchamiając tagi na podstawie klucza "event". Wysłane wartości scalają się w abstrakcyjny model danych, więc zagnieżdżone obiekty i tablice przechodzą między kolejnymi wywołaniami. Dlatego przykłady e-commerce GA4 od Google wysyłają ecommerce: null przed każdym zdarzeniem e-commerce. Starsza specyfikacja społeczności W3C przyjmuje inne podejście: jeden obiekt stanu o nazwie digitalData.
Czym jest warstwa danych?
W analityce internetowej warstwa danych to obiekt JavaScript na stronie, w którym witryna zapisuje zdarzenia i ich wartości, aby tagi analityczne i marketingowe odczytywały czyste, nazwane dane, zamiast wyciągać je z HTML. Dokumentacja Menedżera tagów Google ujmuje to krótko: „Warstwa danych to obiekt używany przez Menedżera tagów Google i gtag.js do przekazywania informacji do tagów”.
Sens warstwy polega na rozdzieleniu odpowiedzialności. Kod aplikacji wie, że właśnie zakończono zakup i ile był wart. Tagi wiedzą, dokąd wysłać tę informację. Warstwa danych znajduje się między nimi, a Google wprost podaje cel takiego projektu: tagi „są zaprojektowane tak, by korzystać z informacji dodawanych do warstwy danych w uporządkowany i przewidywalny sposób, zamiast analizować zmienne, informacje o transakcjach, kategorie stron i inne sygnały rozproszone po stronie”. Gdy po przeprojektowaniu cena trafi do innego <div>, tagi czytające warstwę danych nadal działają, a tagi wyciągające dane ze strony przestają.
Jakie są dwa rodzaje warstwy danych?
Warstwy danych mają dwie postacie: obiekt stanu opisujący stronę oraz kolejkę zdarzeń zapisującą po kolei, co się wydarzyło. Postać decyduje o tym, jak tag je odczytuje.
| Obiekt stanu | Kolejka zdarzeń | |
|---|---|---|
| Przykład | W3C Customer Experience Digital Data Layer 1.0 | Menedżer tagów Google, Adobe Client Data Layer |
| Nazwa globalna | digitalData | dataLayer, adobeDataLayer |
| Struktura | Jeden zagnieżdżony obiekt z elementami page, product, cart, transaction, event i user | Zwykła tablica, a każde push() dopisuje komunikat |
| Jak czytają ją tagi | Odczytują właściwości w chwili uruchomienia tagu | Przetwarzają komunikaty po kolei i reagują na zdarzenia |
| Problem z czasem | Tag uruchomiony przed wypełnieniem obiektu nic nie odczyta | Komunikaty wysłane przed załadowaniem biblioteki tagów czekają w kolejce |
Model obiektu stanu jest starszy. Customer Experience Digital Data Layer 1.0, końcowy raport grupy społecznościowej z 10 grudnia 2013 roku, stwierdza, że obiekt główny „MUSI nazywać się digitalData, a wszystkie właściwości danych w tej specyfikacji MUSZĄ należeć do hierarchii obiektu digitalData”. Sekcja o statusie dodaje: „Nie jest to standard W3C ani nie znajduje się na ścieżce standardów W3C”. Zdarzenia znajdują się w tablicy wewnątrz obiektu, digitalData.event[n], którą specyfikacja definiuje jako „listę zmierzonych zdarzeń”.
Model kolejki wygrał w praktyce z powodu kolejności ładowania. Dokumentacja Adobe wyjaśnia tę zaletę: strony i skrypty „mogą zacząć rejestrować dane, wywoływać zdarzenia i rejestrować wywołania zwrotne, dodając je do tablicy, jeszcze zanim załaduje się sam skrypt warstwy danych”. Zwykła tablica przyjmuje dane, zanim na stronie pojawi się jakikolwiek kod dostawcy.

Jak dataLayer.push staje się zdarzeniem analitycznym?
Wywołanie dataLayer.push() staje się zdarzeniem analitycznym, gdy Menedżer tagów przetworzy komunikat, dopasuje jego klucz event do reguły i uruchomi tag odczytujący wysłane wartości. Sekwencja ma pięć kroków:
- Zadeklaruj tablicę raz, nad fragmentem kodu kontenera. Kod instalacyjny Google to
window.dataLayer = window.dataLayer || [];, umieszczony przed załadowaniem Menedżera tagów. - Wyślij komunikat z nazwą zdarzenia. Składnia Google to
dataLayer.push({'event': 'event_name'}), a jedno wywołanie może zawierać wartości obok zdarzenia, jak wdataLayer.push({'color': 'red', 'conversionValue': 50, 'event': 'customize'}). - Menedżer tagów umieszcza komunikat w kolejce i go przetwarza. Google podaje, że „Menedżer tagów przetwarza komunikaty według zasady pierwszy na wejściu, pierwszy na wyjściu: każdy komunikat jest przetwarzany pojedynczo, w kolejności otrzymania”.
- Reguła zdarzenia niestandardowego dopasowuje nazwę zdarzenia. „Jeśli komunikat jest zdarzeniem, wszystkie tagi ze spełnionymi warunkami reguł zostaną uruchomione, zanim Menedżer tagów przejdzie do następnego komunikatu”.
- Zmienna warstwy danych przekazuje wartość do tagu, a tag wysyła ją dalej, na przykład jako parametr zdarzenia GA4.
Krok 4 wyjaśnia zasadę, która często sprawia kłopoty. Wywołanie bez klucza event aktualizuje wartości, ale niczego nie uruchamia. Google ostrzega, że dane wysłane z kodu strony „nie muszą być dostępne dla następnego zdarzenia”, a jako rozwiązanie zaleca „dodanie nazwy zdarzenia do komunikatu przy wysyłaniu go do warstwy danych, a następnie nasłuchiwanie tej nazwy za pomocą reguły zdarzenia niestandardowego”.
Fragment kodu gtag.js korzysta z tej samej kolejki. Własny fragment Google definiuje funkcję gtag jako jednowierszową nakładkę:
window.dataLayer = window.dataLayer || [];
function gtag() {
dataLayer.push(arguments);
}
gtag('js', new Date());
gtag('config', 'TAG_ID');Witryna korzystająca z gtag.js i Menedżera tagów ma więc jedną tablicę, do której trafiają komunikaty z obu narzędzi. Google wyraźnie zaznacza: „Na stronie obsługiwany jest tylko jeden obiekt dataLayer”.
Dlaczego wartości warstwy danych przechodzą między kolejnymi wywołaniami?
Wartości przechodzą dalej, bo każde wywołanie jest scalane z bieżącym „abstrakcyjnym modelem danych”, a nie zastępuje go. Otwartoźródłowa biblioteka Google data-layer-helper, która dokumentuje ten model, mówi, że „przechowuje on najnowszą wartość wszystkich kluczy ustawionych przez komunikat warstwy danych”. Wartości skalarne są nadpisywane. Zwykłe obiekty i tablice scalają się rekurencyjnie: klucze nowego obiektu są kopiowane do starego, a indeksy nowej tablicy zapisywane są na indeksach starej, przy czym indeksy, których nowa tablica nie ustawia, pozostają bez zmian.
Ta zasada jest nieszkodliwa dla tekstu pageType, ale niebezpieczna w e-commerce. Wyślij widok koszyka z dwoma produktami, a potem zakup z jednym, a model może nadal zawierać drugi produkt z wcześniejszego wywołania. Przewodnik Google po e-commerce GA4 w Menedżerze tagów zapobiega temu, czyszcząc dane we wszystkich 14 przykładach zdarzeń. Oto skrócony przykład zakupu:
dataLayer.push({ ecommerce: null }); // Clear the previous ecommerce object.
dataLayer.push({
event: "purchase",
ecommerce: { transaction_id: "T_12345", value: 72.05, currency: "USD", items: [ ... ] }
});Null działa, bo w tabeli scalania null należy do kategorii „wszystko inne”, więc całkowicie nadpisuje stary obiekt. Następne wywołanie scala się już z niczym. Jeśli raporty przychodów pokazują produkty, których nikt nie kupił, zanim zaczniesz sprawdzać cokolwiek innego, poszukaj brakującego czyszczenia. Stronę GA4 tej konfiguracji omawia artykuł o wyborze narzędzi do śledzenia e-commerce bez nadmiernego śledzenia.

- Widok koszyka wysyła dwa produkty
- Zakup dodaje jeden produkt
- Scalanie zachowuje wcześniejszy produkt w modelu
- Zdarzenie zakupu w GA4 raportuje produkt, którego nikt nie kupił
- Czyszczenie nadpisuje stary obiekt ecommerce
- Dane zakupu scalają się z niczym
- GA4 widzi tylko transaction_id T_12345 i jego własne produkty
Co psuje warstwę danych?
Sześć błędów odpowiada za większość warstw danych, które wyglądają poprawnie, a gubią zdarzenia. Każdy pochodzi z listy rozwiązywania problemów Google lub wynika z powyższych zasad scalania.
Panel w czasie rzeczywistym
Śledzenie celów
Śledzenie bez cookie
| Błąd | Co się dzieje | Rozwiązanie |
|---|---|---|
dataLayer = [{...}] po załadowaniu kontenera | „nadpisze wszystkie istniejące wartości”, a Menedżer tagów przestaje widzieć wywołania | Zadeklaruj raz zabezpieczonym fragmentem Google, a potem wywołuj tylko push() |
datalayer.push(...) zapisane małymi literami | „W nazwie obiektu dataLayer rozróżniana jest wielkość liter”, więc dane nigdzie nie trafiają | Wszędzie stosuj tę samą wielkość liter |
visitorType na jednej stronie, visitor_type na innej | „tagi nie będą mogły uruchamiać się konsekwentnie we wszystkich zamierzonych miejscach” | Jedna konwencja nazewnictwa dla całej witryny |
Wartości wysłane bez klucza event | Wartości się aktualizują, ale nie uruchamia się żadna reguła | Podaj nazwę zdarzenia w tym samym wywołaniu |
| Oczekiwanie, że wartości przetrwają nawigację | Każda zmienna „będzie istnieć tylko tak długo, jak odwiedzający pozostaje na bieżącej stronie” | Wysyłaj wartości dotyczące strony przy każdym jej załadowaniu |
| Brak czyszczenia danych e-commerce | Nieaktualne produkty i wartości scalają się z następnym zdarzeniem | Najpierw wyślij { ecommerce: null } |
Wiersz o nazewnictwie to miejsce, w którym warstwa danych spotyka się z resztą instrumentacji. Warstwa danych jest tak spójna jak jej specyfikacja, a tym zajmuje się plan śledzenia. Same nazwy podlegają zasadom opisanym w artykule o tym, jak konwencja nazewnictwa zdarzeń przetrwa pierwszą zmianę nazwy.
Co powinno zawierać wywołanie warstwy danych?
Wywołanie warstwy danych powinno zawierać nazwę zdarzenia i wartości potrzebne w raporcie, a nic, co identyfikuje osobę. Wszystko, co wyślesz, może odczytać każdy tag w kontenerze, także tag dodany później przez kogoś innego. Zawartość pól formularzy, adresy e-mail i imiona nie powinny trafiać do kolejki. Zamiast nich wysyłaj identyfikator formularza i wynik, jak opisuje to w odniesieniu do formularzy praktyczny przewodnik po śledzeniu bez cookies.
Przydatny jest ten sam test co przy każdym zdarzeniu: każda wysłana wartość powinna odpowiadać na pytanie zadawane przez raport. Jeśli nikt nie potrafi wskazać raportu, usuń klucz. Praktykę leżącą u podstaw, czyli zapisywanie działań jako nazwanych zdarzeń z właściwościami, omawia artykuł o tym, jak śledzenie zdarzeń rejestruje to, co użytkownicy faktycznie zrobili.
Czy każde narzędzie analityczne potrzebuje warstwy danych?
Żadne narzędzie analityczne nie wymaga jej bezwzględnie. Warstwa istnieje po to, by menedżer tagów mógł kierować jeden zestaw wartości do wielu dostawców. Narzędzie przyjmujące zdarzenia przez bezpośrednie wywołanie funkcji pomija kolejkę i zasady scalania. Tak działa Flowsery: śledzenie celów rejestruje zdarzenia jednym wywołaniem, takim jak window.flowsery("signup"), „bez skomplikowanej konfiguracji i menedżerów tagów”. Zdarzenia pojawiają się w kanale na żywo, dzięki czemu możesz „od razu debugować i weryfikować śledzenie”, do zdarzeń można dołączać wartości przychodu, by mierzyć wpływ każdego działania, a śledzenie odbywa się bez cookies i danych osobowych. Konfigurację pokazuje strona funkcji śledzenia celów i zdarzeń. Witryny, które już mają warstwę danych dla innych dostawców, mogą ją zachować i wywoływać window.flowsery() z tego samego kodu, który wysyła zdarzenie.
Najczęściej zadawane pytania
Czy warstwa danych to to samo co Menedżer tagów Google?
Nie. Warstwa danych to tablica na twojej stronie, a Menedżer tagów to jeden z odczytujących ją konsumentów. Fragment kodu gtag.js od Google używa tej samej tablicy dataLayer bez Menedżera tagów, a warstwa danych Adobe ma własną tablicę o nazwie adobeDataLayer.
Gdzie na stronie umieścić kod warstwy danych?
Zadeklaruj ją jak najwyżej na stronie, nad fragmentem kodu Menedżera tagów lub gtag.js. Google podaje, że wartości, które „muszą być dostępne dla Menedżera tagów podczas ładowania strony”, również należy wysłać nad kodem kontenera. Wywołania umieszczone niżej nadal trafią do kolejki, ale dotrą po pierwszych zdarzeniach kontenera.
Czy mogę zmienić nazwę zmiennej dataLayer?
Tak. Menedżer tagów przyjmuje nazwę jako parametr we fragmencie kodu kontenera, a gtag.js jako parametr zapytania l, na przykład l=myNewName. Każda deklaracja i każde wywołanie muszą wtedy używać nowej nazwy, bo dane wysłane pod starą nazwę nigdzie nie trafią.
Dlaczego zdarzenie zakupu w GA4 zawiera produkty z wcześniejszego zdarzenia?
Wcześniejsze wywołanie scaliło się z modelem danych, a wywołanie zakupu go nie wyczyściło. Tablice i zwykłe obiekty scalają się rekurencyjnie, więc pozostałe produkty przetrwały. Wysyłaj { ecommerce: null } bezpośrednio przed każdym zdarzeniem e-commerce, tak jak w przykładach Google.
Czy wartości warstwy danych przetrwają przeładowanie strony?
Nie. Google podaje, że każda zmienna warstwy danych istnieje „tylko tak długo, jak odwiedzający pozostaje na bieżącej stronie”. Wartości ważne na każdej stronie, takie jak typ odwiedzającego czy kategoria strony, trzeba wysyłać ponownie przy każdym załadowaniu.
Czym różni się dataLayer.push od gtag?
gtag() to nakładka wywołująca dataLayer.push(arguments), więc obie metody zapisują do tej samej kolejki. Różnią się formatem komunikatu i metodami niestandardowymi: według Google funkcje wysyłane w celu użycia set, get i reset „muszą korzystać bezpośrednio z .push”, bo gtag traktuje funkcję jako „nieprawidłowe polecenie” i ją ignoruje.
Dlaczego dataLayer.push nie uruchomiło tagu?
Wywołanie uruchamia tag tylko wtedy, gdy zawiera klucz event, na który nasłuchuje reguła zdarzenia niestandardowego. Wartości wysłane bez niego aktualizują warstwę danych, ale Menedżer tagów nie ma czego dopasować, więc nie uruchamia się żadna reguła ani tag. Dodaj nazwę zdarzenia do tego samego wywołania, bo inaczej wartości poczekają na późniejszy komunikat, który ją przyniesie.
Czy w nowym projekcie użyć digitalData czy dataLayer?
Wybierz model kolejki zdarzeń, z którego korzystają dataLayer i adobeDataLayer. Przyjmuje dane, zanim załaduje się jakikolwiek skrypt dostawcy, a to właśnie problem z kolejnością ładowania, na który natrafia model obiektu stanu: tag czytający digitalData przed wypełnieniem obiektu nic nie odczyta. digitalData pochodzi też z raportu grupy społecznościowej z 2013 roku, który wprost stwierdza, że nie jest standardem W3C.
Czy wysyłanie adresów e-mail do warstwy danych jest bezpieczne?
Nie. Wszystko, co trafia do warstwy danych, może odczytać każdy tag w kontenerze, także tag dodany później przez kogoś innego. Wysyłaj identyfikator formularza i wynik, a nigdy faktyczną zawartość pól, imię ani adres e-mail.
Czy adobeDataLayer to to samo co dataLayer od Google?
Obie to zwykłe tablice przetwarzające komunikaty po kolei, ale są to osobne zmienne globalne. Menedżer tagów Google i gtag.js współdzielą window.dataLayer, a warstwa danych Adobe używa własnej tablicy window.adobeDataLayer. Dokumentacja Adobe opisuje tę samą zaletę związaną z kolejnością ładowania: strony i skrypty mogą rejestrować dane i wywoływać zdarzenia, dodając je do tablicy, zanim załaduje się sam skrypt warstwy danych.
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


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 parametry zdarzeń w GA4 przenoszą szczegóły każdego zdarzenia
Google ogranicza parametry zdarzeń w GA4 do 25 na zdarzenie. Poznaj limity nazw i wartości, nazwy zastrzeżone i powód, dla którego własne parametry nie trafiają do raportów.
Co zawiera plan śledzenia i czego nie jest w stanie wychwycić
Plan śledzenia opisuje każde zdarzenie, wyzwalacz, właściwość i właściciela, zanim trafi do kodu. Zobacz kolumny, wypełniony przykład i lukę, której nie widzą narzędzia walidacyjne.


Jak konwencja nazewnictwa zdarzeń przetrwa pierwszą zmianę nazwy
Konwencja nazw zdarzeń musi uwzględniać zastrzeżone nazwy GA4, limit 40 znaków i wielkość liter, bo zmiana nazwy po starcie nie obejmuje historii.


Co zmieniło się w kluczowych zdarzeniach i konwersjach w GA4
Google podzieliło jedno słowo na dwa: kluczowe zdarzenia i konwersje w GA4 to teraz różne obiekty w Analytics i Ads. Co oznaczają i gdzie je znajdziesz.


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ć.
Powiązane artykuły


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.


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.

