[UA→GA4] Як тег gtag.js для UA відображається в Google Analytics 4

Цей посібник призначений для власників веб-сайтів, які використовують бібліотеку gtag.js і хочуть зрозуміти, як тег gtag.js для Universal Analytics (UA) корелюється з Google Analytics 4. Передбачається, що ви вже створили ресурс Google Analytics 4. Якщо ви просто хочете додати на сайт базовий код відстеження, прочитайте цю статтю.

Зміст

• Про фрагмент gtag.js
• Збирання основних даних
• Налаштування конфігурації gtag.js
• Події
• Спеціальні параметри та показники

Про фрагмент 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. Це важливо з кількох причин.

1. Якщо цей рядок уже є на сайті, його не потрібно додавати ще раз. Залишається лише додати рядок "config" з ідентифікатором тегу.
2. Ідентифікатор ресурсу в цьому рядку "керує" фрагментом 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 і контейнер GTM, тег gtag.js потрібно розмістити над контейнером GTM, щоб підключені теги сайтів працювали.

Налаштування конфігурації 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" – тоді конфігурація діятиме для всіх ресурсів.

Приклади конфігурацій

Увімкнення збирання основних даних і налаштування 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.

Докладніше про спеціальні параметри й показники.