Słownik

Jak warstwa danych przekazuje zdarzenia do tagów analitycznych

Taras Shynkarenko
Taras Shynkarenko
•Zaktualizowano: •9 min czytania
Jak warstwa danych przekazuje zdarzenia do tagów analitycznychJak warstwa danych przekazuje zdarzenia do tagów analitycznych

W skrócie

9 min czytania

Warstwa 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 stanuKolejka zdarzeń
PrzykładW3C Customer Experience Digital Data Layer 1.0Menedżer tagów Google, Adobe Client Data Layer
Nazwa globalnadigitalDatadataLayer, adobeDataLayer
StrukturaJeden zagnieżdżony obiekt z elementami page, product, cart, transaction, event i userZwykła tablica, a każde push() dopisuje komunikat
Jak czytają ją tagiOdczytują właściwości w chwili uruchomienia taguPrzetwarzają komunikaty po kolei i reagują na zdarzenia
Problem z czasemTag uruchomiony przed wypełnieniem obiektu nic nie odczytaKomunikaty 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.

Schemat uporządkowanej kolejki na tablicy, pokazujący przetwarzanie komunikatów pojedynczo, w kolejności ich nadejścia.

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:

  1. Zadeklaruj tablicę raz, nad fragmentem kodu kontenera. Kod instalacyjny Google to window.dataLayer = window.dataLayer || [];, umieszczony przed załadowaniem Menedżera tagów.
  2. 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 w dataLayer.push({'color': 'red', 'conversionValue': 50, 'event': 'customize'}).
  3. 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”.
  4. 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”.
  5. 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.

Programista rozwiązuje problem z kodem na laptopie, co pasuje do sekcji o szukaniu przyczyn awarii warstwy danych.

Wysyłanie danych e-commerce bez czyszczenia i z czyszczeniem
Bez ecommerce: null
  • 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ł
Najpierw ecommerce: null
  • Czyszczenie nadpisuje stary obiekt ecommerce
  • Dane zakupu scalają się z niczym
  • GA4 widzi tylko transaction_id T_12345 i jego własne produkty
Ta sama zasada scalania, która przenosi tekst pageType, przenosi też nieaktualne produkty z koszyka do zdarzenia zakupu, chyba że model zostanie najpierw wyczyszczony.

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.

Flowsery
Flowsery

Rozpocznij 14-dniowy okres próbny

Panel w czasie rzeczywistym

Śledzenie celów

Śledzenie bez cookie

BłądCo się dziejeRozwiązanie
dataLayer = [{...}] po załadowaniu kontenera„nadpisze wszystkie istniejące wartości”, a Menedżer tagów przestaje widzieć wywołaniaZadeklaruj 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 eventWartości się aktualizują, ale nie uruchamia się żadna regułaPodaj 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-commerceNieaktualne produkty i wartości scalają się z następnym zdarzeniemNajpierw 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

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 parametruGrupowanie treści w GA4 za pomocą jednego parametru
Słownik

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).

•8 min czytania
Jak parametry zdarzeń w GA4 przenoszą szczegóły każdego zdarzeniaJak parametry zdarzeń w GA4 przenoszą szczegóły każdego zdarzenia
Słownik

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.

•8 min czytania
Co zawiera plan śledzenia i czego nie jest w stanie wychwycićCo zawiera plan śledzenia i czego nie jest w stanie wychwycić
Słownik

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.

•8 min czytania
Jak konwencja nazewnictwa zdarzeń przetrwa pierwszą zmianę nazwyJak konwencja nazewnictwa zdarzeń przetrwa pierwszą zmianę nazwy
Słownik

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.

•9 min czytania
Co zmieniło się w kluczowych zdarzeniach i konwersjach w GA4Co zmieniło się w kluczowych zdarzeniach i konwersjach w GA4
Słownik

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.

•7 min czytania
Dlaczego współczynnik odrzuceń w GA4 to odwrócony współczynnik zaangażowaniaDlaczego współczynnik odrzuceń w GA4 to odwrócony współczynnik zaangażowania
Słownik

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ć.

•8 min czytania

Powiązane artykuły