Про фрагмент gtag.js
Якщо зараз ви застосовуєте для поточного ресурсу Universal Analytics код analytics.js, то для нового ресурсу Google Analytics 4 потрібно буде додати фрагмент gtag.js. Він має таку структуру:
01: <script async src="https://www.googletagmanager.com/gtag/js?id=<Ідентифікатор ресурсу А>"></script>
02: <script>
03: window.dataLayer = window.dataLayer || [];
04: function gtag(){dataLayer.push(arguments);}
05: gtag('js', new Date());
06:
07: gtag('config', '<Ідентифікатор ресурсу А>');
08:
09: gtag('config', '<Ідентифікатор ресурсу Б>');
10:
11: gtag('event', 'sign_up', { 'method': 'email' });
12:
13: gtag('event', 'view_video', { 'send_to': '<Ідентифікатор ресурсу Б>' });
14:
15: </script>
Рядок 7. Директива "config" у gtag забезпечує передавання даних у ресурс, пов’язаний з <Ідентифікатором ресурсу A>. Наприклад, якщо вказати в цій директиві ідентифікатор тегу, то події page_view реєструватимуться у відповідному ресурсі Google Analytics 4.
У різних продуктах Google для відстеження використовуються різні ідентифікатори ресурсів: для Universal Analytics – "UA-XXXXXXXX", для Google Analytics 4 – "G-XXXXXXXX", для Google Ads – "AW-XXXXXXXX", для Floodlight – "DC-XXXXXXXX.
Рядок 11. Директива "event" у gtag надсилає подію. Якщо у фрагменті кілька директив "config" для різних ресурсів, то подія надсилається в усі ці ресурси.
У цьому прикладі параметр "sign_up" – назва події, а останній параметр – об’єкт, який містить набір параметрів події. "method" тут виступає параметром зі значенням "email".
Рядок 13. Тут маємо подію з параметром "send_to". Це спеціальний параметр, який "спрямовує" зв’язану подію в конкретний ресурс. Завдяки цьому подія реєструється лише в ресурсі, указаному в параметрі <Ідентифікатор ресурсу Б>.
Директива "config" у gtag забезпечує надсилання основних даних про ресурс Google Analytics 4, зокрема й автоматичну реєстрацію подій page_view під час його завантаження на сторінці.
Звернення типу "перегляд сторінки" та події page_view можна змінювати й блокувати за допомогою певних параметрів.
Ідентифікатори ресурсів
Ідентифікатори ресурсів Universal Analytics мають формат "UA-XXXXXXXX". Їх ще називають ідентифікаторами відстеження. У цій статті ми використовуватимемо назву "Ідентифікатор ресурсу Universal Analytics".
У потоках веб-даних для ресурсів Google Analytics 4 використовується ідентифікатор тегу у форматі "G-XXXXXXXX".
Подекуди в документації та прикладах коду можна побачити параметр TAG_ID – він відповідає обом типам ідентифікаторів.
Збирання основних даних
Для ресурсів Google Analytics 4 збираються такі основні дані:
- події page_view
- автоматично реєстровані події;
- події розширеного відстеження (якщо їх увімкнено в інтерфейсі).
Щоб увімкнути збирання основних даних для ресурсу Google Analytics 4, додайте в розділ <head> кожної сторінки фрагмент gtag.js (тег Google).
Порівняння фрагментів gtag.js і analytics.js
Фрагмент gtag.js для ресурсів Google Analytics 4 виконує приблизно ті ж завдання, що й код analytics.js для ресурсів Universal Analytics.
Головна відмінність між цими двома фрагментами полягає в тому, що код analytics.js включає окремий виклик типу "надіслати перегляд сторінки", а gtag.js – ні: у ньому перегляд сторінки є подією, яка реєструється автоматично та передається за допомогою директиви "config".
Ресурс Universal Analytics (analytics.js)
<script>
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
})(window,document,'script','https://www.google-analytics.com/analytics.js','ga');
ga('create', 'TAG_ID', 'auto');
ga('send', 'pageview');
</script>
Ресурс Google Analytics 4 (gtag.js)
<script async src="https://www.googletagmanager.com/gtag/js?id=TAG_ID"></script>
<script>
window.dataLayer = window.dataLayer || [];
function gtag(){dataLayer.push(arguments);}
gtag('js', new Date());
gtag('config', 'TAG_ID');
</script>
Налаштування конфігурації gtag.js
Налаштовуючи основний фрагмент gtag.js, можна керувати параметрами збирання даних (маскуванням IP-адрес, налаштуваннями файлів cookie, Google Signals тощо) так само, як і в analytics.js. Але в gtag.js для цього використовуються директиви "config" і "set" (на відміну від директив "set", "create" і "require" в analytics.js).
Ресурси Google Analytics 4 (G-XXXXXXXX) підтримують налаштування конфігурації через gtag.js, але для цього використовуються дещо інші параметри, ніж у ресурсах Universal Analytics. Зверніть увагу на рекомендації нижче.
- У ресурсах Google Analytics 4 IP-адреси за умовчанням маскуються, і цю функцію не можна вимкнути. Це означає, що в стандартних подіях ресурсів Google Analytics 4 ("G-XXXXXXXX") IP-адреси маскуються автоматично.
- Якщо до всіх ресурсів потрібно застосувати певні загальні налаштування, скористайтеся командою "set" у gtag.js. Тоді буде змінено всі ресурси з ідентифікаторами тегів і/або ресурсів, указаними у фрагменті коду.
- Особливу увагу зверніть на функції реклами та її персоналізації, які в analytics.js найчастіше запроваджуються через рядок "set".
Якщо у вашому коді analytics.js застосовуються директиви "set", "create" і "require", перевірте, які з них автоматично запроваджуються в ресурсі Google Analytics 4, а для яких потрібно додати в код ресурсу параметри-відповідники.
Нижче наведено зразки коду конфігурацій в analytics.js (для ресурсу Universal Analytics) і gtag.js (для ресурсу Google Analytics 4).
Увімкнення збирання основних даних і налаштування User-ID
analytics.js
ga('create', 'TAG_ID', 'auto', {
userId: USER_ID
});
ga('send', 'pageview');
gtag.js
gtag('config', 'TAG_ID', {
'user_id': 'USER_ID'
});
Налаштування файлів cookie
analytics.js
ga('create', 'TAG_ID', {
'cookieName': 'gaCookie',
'cookieDomain': 'blog.example.co.uk',
'cookieExpires': 60 * 60 * 24 * 28 // Час (у секундах)
});
gtag.js
gtag('config', 'TAG_ID', {
'cookie_prefix': 'MyCookie',
'cookie_domain': 'blog.example.com',
'cookie_expires': 28 * 24 * 60 * 60 // 28 днів (у секундах)
});
Блокування події page_view
Якщо не потрібно реєструвати події page_view під час виконання коду "config" (наприклад, коли завантажується iframe), можна заблокувати цю подію в налаштуваннях "config". Уявімо таку ситуацію: на сайті реєструється подія page_view, а потім користувач входить в обліковий запис. Під час такої взаємодії директива "config" призначає користувачу ідентифікатор. Після цього реєструється ще одна подія page_view, а нам цього не потрібно. Ось як цього можна уникнути:
gtag('config', 'TAG_ID', {
'user_id': 'USER_ID',
'send_page_view': false
});
Назви тегів
Назви тегів (також відомі як "засоби відстеження") дають змогу надсилати дані в різні ресурси Universal Analytics у коді analytics.js. Ці засоби визначають, у який ресурс передати дані. Для всіх звернень після першого ("create") більше не потрібно вказувати ідентифікатор ресурсу Universal Analytics – достатньо лише назви засобу відстеження.
У gtag.js не можна використовувати засоби відстеження ні для ресурсів Google Analytics 4, ні для Universal Analytics. Щоб передавати дані про всі звернення в кілька ресурсів одночасно (у ресурсах Google Analytics 4 – у різні потоки даних), укажіть відповідні ідентифікатори ресурсів або тегів у рядку "config".
Події
Перегляньте посібник із перенесення подій.Спеціальні параметри та показники
За допомогою спеціальних параметрів і показників можна передавати зі сторінок розширені дані відстеження й імпортувати локальну інформацію, наприклад із систем керування взаємодією з клієнтами (CRM). У ресурсах Universal Analytics ("UA-XXXXXXXX") спеціальні параметри та показники потрібно створювати в інтерфейсі користувача та призначати їм ідентифікатори. Лише після цього їх можна буде запровадити або імпортувати. Вони можуть стосуватися чотирьох областей: звернення, сеанс, користувач, товар.
У ресурсах Google Analytics 4 ("G-XXXXXXXX") спеціальні параметри та показники запроваджуються інакше. Спеціальні параметри та показники з ресурсів Universal Analytics, запроваджені за допомогою analytics.js, потрібно додавати як параметри в ресурси Google Analytics 4.
У ресурсі Universal Analytics спеціальний параметр можна застосувати за допомогою тегу analytics.js:
ga('send', 'event', 'category_value', 'action_name', {'dimension5': 'custom data'
});
АБО
ga('set', 'dimension5', 'custom data');
Ці спеціальні параметри можна транслювати в ресурс Google Analytics 4 за допомогою коду gtag.js:
gtag('event', 'action_name', {'eventCategory': 'category_value',
'dimension5': 'custom data'
});
АБО
gtag('set', {'dimension5': 'custom data'});
Тут є два нюанси.
- Щоб параметри відображались у звітах, їх потрібно зареєструвати в інтерфейсі користувача. Цей процес аналогічний реєстрації спеціальних параметрів у Universal Analytics, і для нього діють певні обмеження. Якщо ви просто переглядаєте експортовані дані чи використовуєте параметр лише для активації аудиторії, його можна не реєструвати.
- Область спеціальних параметрів – завжди на рівні події (відповідно до області звернення). Те саме стосується спеціальних параметрів, які автоматично трансформуються в параметри (для ресурсів "UA-XXXXXXXX" у коді gtag.js) незалежно від своєї вихідної області.
Ті самі рекомендації та правила зіставлення діють і для спеціальних показників. Єдина відмінність: під час реєстрації, потрібної для відображення у звітах, показники зараховуються як числові, а не як текстові параметри, тому для них діють відповідні обмеження за кількістю.
Загалом усі спеціальні параметри та показники ресурсів Universal Analytics незалежно від області дії транслюються в ресурс Google Analytics 4 за описаною нижче схемою.
- Спеціальний параметр на рівні звернення: параметр (усього щонайбільше 25 параметрів на подію під час збирання даних; щонайбільше 50 спеціальних параметрів, щонайбільше 50 спеціальних показників).
Зверніть увагу, що автоматично реєстровані події та параметри можуть уже передавати певні дані, для яких раніше використовувалися б спеціальні параметри на рівні звернення. - Спеціальний параметр на рівні користувача: властивість користувача (максимум 25 зареєстрованих для звітів в інтерфейсі). Це обмеження не поширюється на автоматично реєстровані параметри користувачів.
- Спеціальний параметр на рівні сеансу: без аналогів у ресурсі Google Analytics 4. Натомість використовуйте спеціальні параметри або властивості користувачів.
Практичні поради щодо роботи з властивостями користувачів
Властивості користувачів охоплюють усі платформи й типи потоків даних, тому їх слід використовувати, лише якщо дані потрібно застосовувати на рівні користувача. Властивості користувачів не можна використовувати для даних на рівні сеансу та пристрою (наприклад, для розміру екрана).
Приклад ресурсу Google Analytics 4
gtag('set', 'user_properties', {
favorite_composer: 'Малер',
favorite_instrument: 'контрабас',
season_ticketholder: 'true'
});