Typy zmiennych definiowanych przez użytkownika dla stron internetowych

W Menedżerze tagów Google możesz tworzyć niestandardowe zmienne definiowane przez użytkownika dla stron internetowych, które są dopasowane do konkretnych wymagań, jakich nie spełniają zmienne wbudowane.

Aby utworzyć nową zmienną definiowaną przez użytkownika:

1. W menu po lewej stronie kliknij Zmienne.
2. W sekcji Zmienne zdefiniowane przez użytkownika kliknij Nowa.
3. Kliknij Konfiguracja zmiennej i wybierz odpowiedni typ zmiennej.
4. Wybierz opcje konfiguracyjne dla wybranego typu zmiennej.
5. Nadaj nazwę zmiennej. Zastosuj opisową konwencję nazewnictwa wskazującą funkcję zmiennej, np. „Zmienna warstwy danych – nazwa produktu”.
6. Kliknij Zapisz.

Menedżer tagów obsługuje takie typy zmiennych definiowanych przez użytkownika dla stron internetowych:

• Nawigacja
  • Strona odsyłająca HTTP
  • Adres URL
• Zmienne strony
  • Własny plik cookie
  • Niestandardowy kod JavaScript
  • Warstwa danych
• Elementy strony
  • Zmienna zdarzenia automatycznego
  • Element DOM
  • Widoczność elementu
• Narzędzia
  • Stała
  • Zdarzenie niestandardowe
  • Nazwa środowiska
  • Ustawienia Google Analytics
  • Tag Google – ustawienia konfiguracji
  • Tag Google – ustawienia zdarzenia
  • Tabela przeglądowa
  • Liczba losowa
  • Tabela wyrażeń regularnych
• Dane przekazywane przez użytkowników
• Dane kontenera
  • Identyfikator kontenera
  • Numer wersji kontenera
  • Tryb debugowania

Nawigacja

Strona odsyłająca HTTP

Wartość jest ustawiona na stronę odsyłającą HTTP, czyli adres URL poprzedniej strony odwiedzonej przez danego użytkownika. Jeśli np. przejdzie on na jedną z Twoich stron produktów ze strony głównej, stroną odsyłającą będzie strona główna. Menedżer tagów Google tworzy wystąpienie tego typu zmiennej automatycznie, ale możesz utworzyć dodatkowe wystąpienia, jeśli chcesz wyeksponować różne części adresu URL strony odsyłającej.

Adres URL

Ten typ zmiennej umożliwia analizowanie i eksponowanie składników adresu URL. Możesz utworzyć dodatkowe wystąpienia, aby wyeksponować inne części adresu URL. Masz do wyboru takie komponenty adresu URL: Pełny adres URL, Protokół, Nazwa hosta, Port, Ścieżka, Rozszerzenie nazwy pliku, Zapytanie i Fragment. Zestaw możliwych wartości zmiennych tego typu odpowiada adresowi URL strony, na której obecnie znajduje się użytkownik (pobieranemu z własności document.location). Dostosuj Źródło adresu URL, tak aby Menedżer tagów używał innej zmiennej jako źródła wartości adresu URL.

Zmienne strony

Własny plik cookie

Przyjmuje wartość własnego pliku cookie z nazwą domeny, z której obecnie korzysta użytkownik. Jeśli w tej samej domenie wdrożono więcej niż jeden plik cookie o tej samej nazwie, pobrana zostanie pierwsza wartość. Jest to identyczne z wywołaniem makra document.cookie z poziomu strony i wybraniem pierwszego wyniku.

Niestandardowy kod JavaScript

Wartość jest równa wynikowi funkcji JavaScript. JavaScript musi mieć formę anonimowej funkcji, która zwraca wartość. Możesz np. utworzyć niestandardową zmienną JavaScriptu w celu konwertowania wszystkich wystąpień wstępnie zdefiniowanej zmiennej {{url}} na małe litery:

function () {
  return {{url}}.toLowerCase();
}

Warstwa danych

Wartość jest ustawiana, gdy dane zostaną przekazane do warstwy danych za pomocą wywołania dataLayer.push():
dataLayer.push({"Nazwa warstwy danych": "wartość"}).

Możesz określić, jak Menedżer tagów ma interpretować kropki („.”) w nazwie klucza:

• Wersja 1: zezwalaj na kropki w nazwach kluczy. Na przykład w wywołaniu dataLayer.push("a.b.c": "wartość") nazwa klucza zostanie zinterpretowana jako „a.b.c”" (tzn. {"a.b.c": "wartość"}).
• Wersja 2: interpretuj kropki jako wartości zagnieżdżone. Na przykład w wywołaniu dataLayer.push({"a.b.c": "wartość"}) zostaną rozpoznane 3 poziomy zagnieżdżenia: {a: {b: {c: "wartość"}}}.

Zmienna JavaScript

Wartość jest ustawiona na określoną przez Ciebie globalną zmienną JavaScriptu. Jeśli wymaganej wartości nie ustawiono w warstwie danych (patrz zmienna Warstwa danych) i nie jest ona widoczna w elemencie DOM (patrz zmienna Element DOM), można pobrać wartość ze zmiennej JavaScriptu. Użyj tego typu zmiennej, jeśli wartość można znaleźć w kodzie źródłowym strony w postaci globalnej zmiennej JavaScript.

Elementy strony

Zmienna zdarzenia automatycznego

Przechwytuje informacje o elemencie, który spowodował wystąpienie zdarzenia (np. kliknięcia, przesłane formularze, wyświetlenie elementu itd.).

• Element: zwraca obiekt elementu. Może być traktowana jako obiekt w niestandardowym kodzie JavaScriptu, np. {{Element}}.title, lub w selektorach arkuszy CSS, np. {{Element}} pasuje do selektora arkusza CSS div.foo.
• Typ elementu: zwraca wartość element.tagName, np. „A”, „BUTTON”, „IMG”.
• Atrybut elementu: po określeniu atrybutu elementu ta opcja zwraca wartość tego atrybutu.
• Klasy elementu: zwraca listę klas znalezionych w atrybucie class elementu.
• Identyfikator elementu: zwraca wartość atrybutu id.
• Miejsce docelowe elementu: zwraca wartość atrybutu target, np. „_blank”.
• Tekst elementu: zwraca zawartość tekstową elementu.
• Adres URL elementu: zwraca adres URL elementu pobrany z atrybutu href lub action.
• Fragment nowego adresu URL w historii: zwraca fragment nowego adresu URL z historii przeglądarki, np. „#summary”.
• Fragment starego adresu URL w historii: zwraca fragment starego adresu URL z historii przeglądarki, np. „#intro”.
• Nowy stan historii: bieżący obiekt stanu historii, kontrolowany przez wywołania witryny kierowane do metody pushState.
• Stary stan historii: wcześniejszy obiekt stanu historii, kontrolowany przez wywołania witryny kierowane do metody pushState.
• Źródło zmiany w historii: zwraca zdarzenie, które spowodowało zmianę w historii, np. „pushState”, „replaceState” itp.

Element DOM

Wartość jest ustawiona na tekst elementu DOM lub wartość określonego atrybutu elementu DOM. Jeśli wymaganej wartości nie ustawiono w warstwie danych (patrz zmienna Warstwa danych), można ją pobrać z elementu DOM. Użyj tego typu zmiennej, jeśli wartość można znaleźć w elemencie DOM.

Jeśli ustawiono opcjonalną nazwę atrybutu, wartość zmiennej będzie zwracać wartość określoną w tym atrybucie (np. data-food="babeczki"). W przeciwnym razie wartością zmiennej będzie tekst elementu DOM.

Widoczność elementu

Wartość jest ustawiana na podstawie stanu widoczności określonego elementu DOM. W przeciwieństwie do reguły typu Widoczność elementu pojedyncza zmienna tego typu może informować o widoczności tylko jednego elementu. Zdecyduj, czy chcesz wybrać element oparty na identyfikatorze elementu, czy na selektorze arkusza CSS. Jeśli do określonego selektora CSS pasuje wiele elementów, użyty zostanie pierwszy pasujący element.

Dla tej zmiennej możesz wybrać typ wartości wyjściowej:

• Prawda/fałsz: wartość logiczna wskazująca, czy wybrany element jest widoczny, gdy występuje odwołanie do zmiennej.
• Procent: wartość procentowa (0–100) wskazująca, jaka część wybranego elementu jest widoczna na ekranie, gdy występuje odwołanie do zmiennej.

Jeśli jako typ wartości wyjściowej wybierzesz Prawda/fałsz, możesz również określić Minimalny widoczny odsetek, by wskazać, jaka część wybranego elementu musi być widoczna na ekranie, by zmienna przyjęła wartość „prawda”.

Narzędzia

Stała

Przyjmowaną wartość stanowi podany przez Ciebie ciąg. Zmiennych typu ciąg stały używa się zwykle, gdy wiele tagów korzysta z tego samego numeru konta. Zobacz też: Ustawienia Google Analytics.

Zdarzenie niestandardowe

Przyjmowaną wartością jest nazwa zdarzenia niestandardowego, które zostało przekazane do warstwy danych.

Nazwa środowiska

Zwraca nazwę środowiska wyświetlanego w trybie podglądu.

Ustawienia Google Analytics

Zmienna ustawień Google Analytics jest używana w tagach Universal Analytics w kontenerach internetowych i mobilnych (Firebase) do centralnego konfigurowania i udostępniania ustawień Google Analytics wykorzystywanych w wielu tagach. Gdy utworzysz tag Google Analytics za pomocą Universal Analytics, Menedżer tagów poprosi Cię o wybranie lub utworzenie zmiennej ustawień Google Analytics. Więcej informacji

Tag Google – ustawienia konfiguracji

Ta zmienna umożliwia ustawienie parametrów na poziomie konfiguracji po wczytaniu tagu Google.

Załóżmy np., że publikujesz witrynę w kilku językach i chcesz podzielić odbiorców na segmenty według języka, którym się posługują. Zamiast modyfikować ręcznie każdy tag, możesz utworzyć zmienną konfiguracji z parametrem language i używać jej w tagach Google.

Dowiedz się, jak ponownie użyć ustawień konfiguracji

Tag Google – ustawienia zdarzenia

Ta zmienna umożliwia ustawienie parametrów na poziomie zdarzenia, aby wysyłać dodatkowe dane za pomocą zdarzenia GA4.

Załóżmy na przykład, że prowadzisz sklep internetowy, w którym masz wyprzedaż. Chcesz śledzić, ile osób używa podanego przez Ciebie kodu zniżkowego. Zamiast ręcznie dodawać parametr discount do każdego tagu, możesz stosować go wielokrotnie za pomocą zmiennej Tag Google – ustawienia zdarzenia.

Dowiedz się, jak ponownie użyć ustawień konfiguracji

Tabela przeglądowa

Wartość jest ustawiana zgodnie z instrukcjami podanymi w tabeli przeglądowej. Tabela przeglądowa zawiera dwie kolumny (pusta tabela ilustruje sposób późniejszego użycia danych):

Kiedy [wybierz zmienną] równa się	Ustaw [tę zmienną] na

Tabela przeglądowa pozwala utworzyć zmienną, której wartość będzie zależna od wartości innej zmiennej. Jest to przydatne, gdy Twoją stronę skonfigurowano tak, że odpowiednia wartość (np. identyfikator konwersji) może zostać zmapowana na adres URL, element DOM lub inny składnik strony. Ten przykład pokazuje utworzenie zmiennej o nazwie Identyfikator konwersji. Jeśli adres URL zawiera ciąg „/dziekujemy/zakup1.html”, wartość jest ustawiana na „12345”. Jeśli adres URL zawiera ciąg „dziekujemy/zakup2.html”, wartość jest ustawiana na „34567”.

Kiedy {{url}} zawiera	Ustaw {{Identyfikator konwersji}} na
dziekujemy/zakup1.html	12345
dziekujemy/zakup2.html	34567
dziekujemy/zakup3.html	56789

Liczba losowa

Ustawieniem tej wartości jest liczba losowa od 0 do 2147483647.

Tabela wyrażeń regularnych

Zmienna tabeli wyrażeń regularnych działa podobnie jak zmienna tabeli przeglądowej. Różnica polega na tym, że może ona obsługiwać wzory wyrażeń regularnych dla elementów, które chcesz dopasować.

Dla konfiguracji tabeli wyrażeń regularnych:

Wzór	Wartość wyjściowa
.*/strona[1-3]\.html.*	foo
.*/strona[4-6]\.html.*	bar
.*/strona[7-9]\.html.*	baz

Wartość wyjściowa zmiennej będzie następująca:

Dopasowany wynik	Wartość
http://example.com/strona1.html	foo
http://www.example.com/strona1.html	foo
http://example.com/strona2.html#detail	foo
http://example.com/strona5.html	bar
http://example.com/strona5.html?status=new	bar
http://example.com/strona6.html	bar
https://example.com/strona9.html	baz

Wyszukiwanie w tabeli wyrażeń regularnych przeprowadzane jest od góry do dołu listy. Po znalezieniu dopasowania zwracana jest wartość wyjściowa.

Wybierz Ustaw wartość domyślną, by ustawić wartość wyjściową, gdy dopasowanie nie zostanie znalezione.

Wzory muszą być domyślnie dopasowane do całego ciągu wejściowego, a wielkość liter w nich nie jest rozróżniana. Ten sposób działania można zmienić w Ustawieniach zaawansowanych:

• Ignoruj wielkość liter: wzory będą dopasowane do dopasowań niezależnie od wielkości liter, bez potrzeby dodawania różnych opcji do wyrażenia regularnego.

• Tylko pełne dopasowania: jeśli ta opcja jest włączona, wzory muszą odpowiadać całej wartości wejściowej. Jest to równoznaczne z domyślnymi kotwicami początkowymi (^) i końcowymi ($) wokół wzoru. Jeśli ta opcja jest wyłączona, wzory będą dopasowywane, gdy zostaną znalezione w wartości wejściowej.

• Włącz grupy przechwytywania i funkcję zastępowania: jeśli ta opcja jest włączona, możesz użyć składni zastępczej wykorzystującej znak dolara, aby uwzględnić w wartości wyjściowej fragmenty wartości wejściowej (np. z grup przechwytywania w dopasowanym wzorze). Jeśli dopasowane wyrażenie regularne to np. /(wiadomosci)/strona(2)\.html, możesz użyć $1, aby odwołać się do pierwszej grupy przechwytywania („wiadomosci”), i $2, aby odwołać się do drugiej grupy przechwytywania („2”).

Korzystanie z ustawienia „Włącz grupy przechwytywania i funkcję zastępowania” z wyłączonym ustawieniem „Tylko pełne dopasowania” może powodować nieoczekiwane zachowanie (np. zwrot całej wartości wejściowej z zamienioną dopasowaną częścią).

Dane przekazywane przez użytkowników

Zbiera informacje z formularza, np. adres e-mail, numer telefonu, imię i nazwisko oraz adres pocztowy. Określ informacje do przechwytywania za pomocą jednego z tych trybów:

• Konfiguracja automatyczna: automatycznie wykrywa pola formularzy w witrynie i nowych wpisach.
• Konfiguracja ręczna: umożliwia mapowanie obecnych zmiennych Menedżera tagów na odpowiednie pola danych przekazywanych przez użytkowników, np. adres e-mail, numer telefonu, imię i nazwisko oraz adres pocztowy.
• Kod: umożliwia określenie zmiennej warstwy danych lub zmiennej niestandardowego kodu JavaScriptu, która zwraca obiekt z uporządkowanymi danymi przekazywanymi przez użytkowników.

Dane kontenera

Identyfikator kontenera

Zwraca identyfikator kontenera Menedżera tagów, np. „GTM-101010”.

Numer wersji kontenera

Gdy kontener znajduje się w trybie podglądu, zmienna wersji kontenera zwraca numer wersji podglądu kontenera. W innym przypadku zmienna podaje numer opublikowanej wersji kontenera.

Tryb debugowania

Zmienna przyjmuje wartość prawda, jeśli kontener jest w trybie podglądu i debugowania. W przeciwnym razie ustawiana jest wartość fałsz.