Про фрагмент gtag.js та ідентифікатори ресурсів
Фрагменти gtag.js для ресурсів Universal Analytics і Google Analytics 4 приблизно однакові. Обидва фрагменти мають однакову структуру:
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>
Рядок 1. Якщо ви запровадили ресурс Universal Analytics за допомогою фрагмента gtag.js, цей рядок коду вже має бути на вашому сайті. Замість параметра <Ідентифікатор ресурсу А> код міститиме числовий ідентифікатор із префіксом "UA-". Якщо ж ви запроваджували gtag.js для Google Ads або іншого продукту Google Marketing Platform, замість префікса "UA-" може стояти відповідно "AW-" або "DC-".
Ідентифікатор ресурсу (у ресурсах Google Analytics 4 – ідентифікатор тегу) у параметрі <Ідентифікатор ресурсу A> "керує" фрагментом gtag.js. Це важливо з кількох причин.
- Якщо цей рядок уже є на сайті, його не потрібно додавати ще раз. Залишається лише додати рядок "config" з ідентифікатором тегу.
- Ідентифікатор ресурсу в цьому рядку "керує" фрагментом gtag.js. Тож якщо на сторінці вже вказано ідентифікатор ресурсу Universal Analytics ("UA-XXXXXXXX"), ви зможете скористатися підключеними тегами сайту. Вони дають змогу надсилати дані відстеження в ресурс Google Analytics 4 без необхідності додавати новий код на сторінку.
Рядок 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 активує відстеження основних даних.
- Команда "config" використовує ідентифікатор ресурсу Universal Analytics, щоб надсилати в нього звернення типу "перегляд сторінки".
- Якщо в директиві "config" для ресурсу Google Analytics 4 вказано ідентифікатор тегу, у цьому ресурсі автоматично реєструються події page_view, коли директива завантажується на сторінці.
Ідентифікатори ресурсів
Ідентифікатори ресурсів Universal Analytics мають формат "UA-XXXXXXXX". Їх ще називають ідентифікаторами відстеження. У цій статті ми використовуватимемо назву "Ідентифікатор ресурсу Universal Analytics".
У потоках веб-даних ресурсів Google Analytics 4 використовуються ідентифікатори тегів, які мають формат "G-XXXXXXXX".
Подекуди в документації та прикладах коду можна побачити параметр TAG_ID – він відповідає обом типам ідентифікаторів.
Збирання основних даних
Для ресурсів Google Analytics 4 збираються такі основні дані:
- події page_view
- автоматично реєстровані події
- події розширеної статистики (якщо їх увімкнено в інтерфейсі)
Якщо для вашого наявного ресурсу Universal Analytics використовується gtag.js, увімкнути збирання основних даних для ресурсу Google Analytics 4 можна двома способами, описаними нижче.
- Варіант 1. Додати ще одну директиву "config" із релевантним ідентифікатором тегу.
- Варіант 2. Увімкнути підключені теги сайту (якщо ваш код gtag.js підтримує таку можливість).
Хоч який варіант ви виберете, це не вплине на ресурс Universal Analytics – він отримуватиме дані так само, як і раніше.
Варіант 1. Додати ще одне правило "config"
Якщо на сторінці вже є код gtag.js, можна просто додати ще одне правило "config" з ідентифікатором потоку даних, який відповідає вашому ресурсу Google Analytics 4. У прикладі нижче ми додали рядок 8 з ідентифікатором потоку даних ресурсу Google Analytics 4. Тепер події page_view реєструватимуться саме в цьому ресурсі. А ще ми тим самим увімкнули для нього збирання даних про автоматично реєстровані події та розширену статистику (якщо ви її активували).1: <script async src="https://www.googletagmanager.com/gtag/js?id=<Ідентифікатор ресурсу А>"></script>
2: <script>
3: window.dataLayer = window.dataLayer || [];
4: function gtag(){dataLayer.push(arguments);}
5: gtag('js', new Date());
6:
7: gtag('config', '<Ідентифікатор ресурсу А>');
8: gtag('config', 'G-XXXXXXXX');
9: </script>
Варіант 2. Увімкнути підключені теги сайту
Підключений тег сайту можна використовувати, якщо виконано дві умови.
- Фрагмент gtag.js на сторінці, де ви хочете відстежувати взаємодію з користувачами, "підконтрольний" ресурсу Universal Analytics, тобто ідентифікатор у відповідному рядку фрагмента gtag.js починається з "UA-":
<script async src="https://www.googletagmanager.com/gtag/js?id=<Ідентифікатор ресурсу A>"></script>
(Підключені теги сайту також працюватимуть, якщо фрагмент gtag.js підконтрольний ресурсу Google Analytics 4, але таке буває, лише коли ресурс Google Analytics 4 вже запроваджено.)
- Ви маєте доступ із правами адміністратора до ресурсу Universal Analytics, ідентифікатор якого вказано у фрагменті.
Налаштування конфігурації gtag.js
Налаштовуючи основний фрагмент gtag.js, можна керувати параметрами збирання даних: приховуванням IP-адрес, налаштуваннями файлів cookie, Google Signals тощо. Для цього використовуються правила "config" і "set".
Налаштування конфігурації через gtag.js підтримують обидва типи ресурсів – і Universal Analytics ("UA-XXXXXXXX"), і Google Analytics 4 (G-XXXXXXXX), але для них використовуються дещо різні параметри.
- У ресурсах Google Analytics 4 IP-адреси за умовчанням приховуються, і цю функцію не можна вимкнути. Це означає, що в стандартних подіях ресурсів Google Analytics 4 ("G-XXXXXXXX") IP-адреси маскуються автоматично.
- Якщо до всіх ресурсів потрібно застосувати певні загальні налаштування, скористайтеся командою "set". Вона дає змогу змінити всі ресурси з ідентифікаторами потоку даних та/або ресурсів (зокрема й додані через підключені теги сайту).
- Зверніть особливу увагу на функції вимкнення персоналізації реклами, які найчастіше запроваджуються через рядок "config".
- Якщо використовуються підключені теги сайту, усі налаштування в коді gtag.js, задані через параметр "config", застосовуються лише до ресурсу, зв’язаного з ідентифікатором потоку даних у відповідному рядку, і не надсилаються автоматично в підключений ресурс Google Analytics 4. Щоб застосувати конфігурацію до підключеного ресурсу Google Analytics 4:
- створіть окрему директиву "config" і вкажіть у ній ідентифікатор потоку даних відповідного ресурсу Google Analytics 4
АБО - змініть налаштування за допомогою директиви "set" – тоді конфігурація діятиме для всіх ресурсів.
- створіть окрему директиву "config" і вкажіть у ній ідентифікатор потоку даних відповідного ресурсу Google Analytics 4
Приклади конфігурацій
Увімкнення збирання основних даних і налаштування User-ID
gtag('config', 'GA_MEASUREMENT_ID', {
'user_id': 'USER_ID'
});
Налаштування файлів cookie
gtag('config', 'GA_MEASUREMENT_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', 'MEASUREMENT_ID', {
'user_id': 'USER_ID',
'send_page_view': false
});
Події
Перегляньте посібник із перенесення подій.
Спеціальні параметри та показники
За допомогою спеціальних параметрів і показників можна передавати розширені дані та імпортувати локальну інформацію, наприклад із систем керування взаємодією з клієнтами (CRM).
Якщо використовуються підключені теги сайту чи ресурс Google Analytics 4 ("G-XXXXXXXX"), то спеціальні параметри й показники, запроваджені через тег Google (gtag.js), автоматично трансформуються в параметри Google Analytics 4.
Докладніше про спеціальні параметри й показники.