Fragment kodu gtag.js i identyfikatory usług
Fragmenty kodu gtag.js usług Universal Analytics i Google Analytics 4 są zasadniczo takie same. Oba fragmenty kodu mają taką strukturę:
01: <script async src="https://www.googletagmanager.com/gtag/js?id=<Identyfikator usługi A>"></script>
02: <script>
03: window.dataLayer = window.dataLayer || [];
04: function gtag(){dataLayer.push(arguments);}
05: gtag('js', new Date());
06:
07: gtag('config', '<Identyfikator usługi A>');
08:
09: gtag('config', '<Identyfikator usługi B>');
10:
11: gtag('event', 'sign_up', { 'method': 'email' });
12:
13: gtag('event', 'view_video', { 'send_to': '<Identyfikator usługi B>' });
14:
15: </script>
Wiersz 1: jeśli usługa Universal Analytics została zaimplementowana za pomocą tagu gtag.js, pewnie masz już w swojej witrynie ten wiersz kodu. Zamiast ciągu „<Identyfikator usługi A>” zobaczysz prefiks „UA-” z pewną liczbą cyfr. Jeśli tag gtag.js został zaimplementowany na potrzeby Google Ads lub innej usługi Google Marketing Platform, też możesz mieć ten wiersz kodu w witrynie, ale ciąg „<Identyfikator usługi A>” będzie się wtedy zaczynać prefiksem „AW-” lub „DC-”.
Identyfikator usługi (lub identyfikator tagu w przypadku usług Google Analytics 4), podany tu jako ciąg „<Identyfikator usługi A>”, „steruje” tym fragmentem kodu gtag.js. To jest ważne, ponieważ:
- Jeśli ten wiersz już występuje, nie trzeba go wstawiać ponownie. Aby określić identyfikator tagu, wystarczy dodać wiersz „config”.
- Identyfikator usługi w tym wierszu „steruje” fragmentem kodu gtag.js. Jeśli identyfikator usługi Universal Analytics („UA-XXXXXXXX”) steruje tagiem, możesz używać połączonych tagów witryny do wysyłania danych pomiarowych do usługi Google Analytics 4 bez umieszczania nowego kodu na stronie.
Wiersz 7: instrukcja „config” tagu gtag włącza zbieranie danych przez usługę powiązaną z identyfikatorem „<Identyfikator usługi A>”. Na przykład w przypadku usługi Google Analytics 4 dodanie tej instrukcji z identyfikatorem tagu spowoduje wysyłanie do tej usługi zdarzeń „page_view”.
Identyfikator usługi może reprezentować pomiar różnych usług Google, m.in. usługi Universal Analytics („UA-XXXXXXXX”), usługi Google Analytics 4 („G-XXXXXXXX”), Google Ads („AW-XXXXXXXX”) lub Floodlight („DC-XXXXXXXX”).
Wiersz 11: instrukcja „event” tagu gtag spowoduje wysyłanie zdarzenia. W przypadku fragmentów kodu, w których występuje wiele instrukcji „config” związanych z wieloma usługami, zdarzenie będzie wysyłane do wszystkich usług.
W tym przykładzie parametr „sign_up” to nazwa zdarzenia. Ostatni parametr to obiekt zawierający zbiór parametrów zdarzenia. W tym przypadku „method” to parametr o wartości „email”.
Wiersz 13: widoczne tu zdarzenie ma parametr „send_to”. Jest to specjalny parametr, który wysyła powiązane zdarzenie do konkretnej usługi. Oznacza to, że to zdarzenie będzie wysyłane tylko do usługi wskazanej przez ciąg „<Identyfikator usługi B>”.
Polecenie config w tagu gtag umożliwia pomiar podstawowy.
- W przypadku usługi Universal Analytics dyrektywa „config” z identyfikatorem usługi Universal Analytics wysyła działanie „pageview”.
- W przypadku usługi Google Analytics 4 instrukcja „config” z identyfikatorem tagu umożliwia rejestrowanie zdarzeń „page_view” (jako zdarzeń zbieranych automatycznie) podczas wczytywania strony.
Identyfikatory usług
Identyfikator usługi Universal Analytics ma format „UA-XXXXXXXX”. Czasami nazywa się go identyfikatorem śledzenia. W tym przewodniku nazywamy go identyfikatorem usługi UA.
Strumienie danych z sieci w usługach Google Analytics 4 korzystają z identyfikatora tagu w formacie „G-XXXXXXXX”.
W niektórych przykładach kodu i w dokumentacji oba rodzaje identyfikatorów mogą występować pod nazwą „IDENTYFIKATOR_TAGU”.
Podstawowe zbieranie danych
Włączenie podstawowego zbierania danych na potrzeby usługi Google Analytics 4 umożliwia gromadzenie takich danych:
- zdarzeń „page_view”,
- zdarzeń zbieranych automatycznie,
- zdarzeń objętych pomiarem zaawansowanym (jeśli są włączone w interfejsie).
Jeśli Twoja obecna usługa Universal Analytics używa implementacji tagu gtag.js, podstawowe zbieranie danych na potrzeby usługi Google Analytics 4 możesz włączyć tak:
- Opcja 1: dodaj nową instrukcję „config” z odpowiednim identyfikatorem tagu
LUB - Opcja 2: włącz połączone tagi witryny (jeśli obecna implementacja tagu gtag.js się do tego kwalifikuje).
Niezależnie od wybranej opcji Twoja dotychczasowa usługa Universal Analytics pozostanie niezmieniona i nadal będzie zbierać dane.
Opcja 1. Dodaj nową instrukcję „config”
Jeśli na stronie jest już kod gtag.js, wystarczy umieścić w nim dodatkową instrukcję „config” z odpowiednim identyfikatorem pomiaru usługi Google Analytics 4. W podanym niżej przykładzie do tagu gtag.js dodano wiersz 8. Zawiera on odwołanie do identyfikatora pomiaru usługi Google Analytics 4 i powoduje wysyłanie do niej zdarzeń „page_view”. Włącza też w niej zdarzenia zbierane automatycznie i zdarzenia objęte pomiarem zaawansowanym (jeśli masz aktywny pomiar zaawansowany).1: <script async src="https://www.googletagmanager.com/gtag/js?id=<Identyfikator usługi A>"></script>
2: <script>
3: window.dataLayer = window.dataLayer || [];
4: function gtag(){dataLayer.push(arguments);}
5: gtag('js', new Date());
6:
7: gtag('config', '<Identyfikator usługi A>');
8: gtag('config', 'G-XXXXXXXX');
9: </script>
Opcja 2. Włącz połączone tagi witryny
Połączonych tagów witryny możesz używać, jeśli:
- obecny fragment kodu gtag.js na stronie, na której chcesz mierzyć interakcje użytkowników, jest sterowany przez usługę Universal Analytics (tzn. identyfikator podany w tym wierszu fragmentu kodu gtag.js zaczyna się od „UA-”):
<script async src="https://www.googletagmanager.com/gtag/js?id=<Identyfikator usługi A>"></script>
(Połączone tagi witryny działają też wtedy, gdy dotychczasowym fragmentem kodu gtag.js steruje usługa Google Analytics 4. Taka sytuacja występuje jednak tylko wtedy, gdy usługa Google Analytics 4 została już zaimplementowana).
- ORAZ masz dostęp administracyjny do usługi Universal Analytics wskazanej poprzez identyfikator podany we fragmencie kodu.
Ustawienia konfiguracji tagu gtag.js
Podstawowy fragment kodu gtag.js możesz konfigurować, by kontrolować ustawienia zbierania danych, np. anonimizację adresów IP, dostosowywanie plików cookie i Google Signals. Służą do tego instrukcje „config” i „set” w tagu gtag.js.
Usługi Universal Analytics („UA-XXXXXXXX”) i Google Analytics 4 („G-XXXXXXXX”) obsługują wprowadzanie tych ustawień konfiguracji w tagu gtag.js. Występuje jednak kilka różnic między tymi ustawieniami w przypadku usług Universal Analytics i Google Analytics 4.
- Anonimizacja adresów IP ma standardowo wartość „true” (prawda) i nie można jej konfigurować w usłudze Google Analytics 4. W efekcie adres IP jest automatycznie maskowany przy rejestrowaniu standardowego zdarzenia przez usługę Google Analytics 4 („G-XXXXXXXX”).
- Jeśli ustawienia globalne muszą być stosowane do wszystkich skonfigurowanych usług, użyj polecenia „set”. Dzięki temu zastosujesz ustawienia globalne do wszystkich identyfikatorów pomiaru lub identyfikatorów usług, w tym do zaimplementowanych za pomocą połączonych tagów witryny.
- Zwróć szczególną uwagę na funkcje wyłączania personalizacji reklam, które są najczęściej implementowane za pomocą wiersza „config”.
- Jeśli korzystasz z połączonych tagów witryny: wszelkie ustawienia wprowadzone w kodzie gtag.js za pomocą instrukcji „config” mają zastosowanie tylko do usługi powiązanej z identyfikatorem pomiaru podanym w tym wierszu kodu. Ustawienia te nie będą automatycznie wysyłane do połączonej usługi Google Analytics 4. Jeśli chcesz zastosować konfigurację do połączonej usługi Google Analytics 4:
- Utwórz osobną instrukcję „config” i zastosuj ją do odpowiedniej usługi Google Analytics 4 poprzez podanie jej identyfikatora pomiaru.
LUB - Skonfiguruj ustawienie za pomocą instrukcji „set”, dzięki czemu konfiguracja zostanie zastosowana do wszystkich skonfigurowanych usług.
- Utwórz osobną instrukcję „config” i zastosuj ją do odpowiedniej usługi Google Analytics 4 poprzez podanie jej identyfikatora pomiaru.
Przykłady konfiguracji
Włączanie podstawowego zbierania danych; konfigurowanie identyfikatora User ID
gtag('config', 'IDENTYFIKATOR_POMIARU_GA', {
'user_id': 'IDENTYFIKATOR_UŻYTKOWNIKA'
});
Konfigurowanie ustawień plików cookie
gtag('config', 'IDENTYFIKATOR_POMIARU_GA', {
'cookie_prefix': 'MójPlikCookie',
'cookie_domain': 'blog.example.com',
'cookie_expires': 28 * 24 * 60 * 60 // 28 dni podane w sekundach
});
Blokowanie zdarzenia „page_view”
Jeśli nie chcesz, by zdarzenie „page_view” było wysyłane podczas wczytywania kodu konfiguracji (np. gdy wczytujesz element iframe), możesz dostosować ustawienie konfiguracji, by zablokować zdarzenie „page_view”. Przeanalizujmy scenariusz, w którym wysyłane jest zdarzenie „page_view”, a następnie użytkownik loguje się w witrynie. W przypadku interakcji polegającej na zalogowaniu się używasz instrukcji „config”, by określić identyfikator użytkownika, ale nie chcesz wysyłać kolejnego zdarzenia „page_view”. W podanym niżej kodzie widać, jak zapobiec wysyłaniu zdarzenia „page_view”.
gtag('config', 'IDENTYFIKATOR_POMIARU', {
'user_id': 'IDENTYFIKATOR_UŻYTKOWNIKA',
'send_page_view': false
});
Zdarzenia
Zobacz artykuł Informacje o tym przewodniku po migracji zdarzeń.
Wymiary i dane niestandardowe
Wymiary i dane niestandardowe mogą służyć do poszerzania zakresu dostępnych informacji oraz do importowania danych offline, np. z systemów CRM.
W przypadku korzystania z tagu Google (gtag.js) wymiary i dane niestandardowe są automatycznie przekształcane w parametry, jeśli używasz połączonych tagów witryny lub usługi Google Analytics 4 (np. „G-XXXXXXXX”).
Dowiedz się więcej o wymiarach i danych niestandardowych.