Всичко за фрагмента gtag.js
Ако използвате analytics.js за текущата си собственост в Universal Analytics, трябва да добавите фрагмента gtag.js за новата си собственост в Google Анализ 4. Фрагментът gtag.js е със следната структура:
01: <script async src="https://www.googletagmanager.com/gtag/js?id=<Some Property ID A>"></script>
02: <script>
03: window.dataLayer = window.dataLayer || [];
04: function gtag(){dataLayer.push(arguments);}
05: gtag('js', new Date());
06:
07: gtag('config', '<Some Property ID A>');
08:
09: gtag('config', '<Some Property ID B>');
10:
11: gtag('event', 'sign_up', { 'method': 'email' });
12:
13: gtag('event', 'view_video', { 'send_to': '<Some Property ID B>' });
14:
15: </script>
Ред 7: Командата „config“ на gtag активира събирането на данни за собствеността, свързана със <Some Property ID A>. Например добавянето на тази директива с идентификатор на маркер за собственост в Google Анализ 4 ще изпраща събития page_view към нея.
ID на собствеността може да представлява различни продукти на Google, включително собственост в UA („UA-XXXXXXXX“), собственост в Google Анализ 4 („G-XXXXXXXX“), собственост в Google Ads („AW-XXXXXXXX“) или собственост във Floodlight („DC-XXXXXXXX“).
Ред 11: Командата „event“ на gtag ще изпрати събитие. Във фрагменти, в които за няколко собствености са налице няколко команди „config“, събитието ще бъде изпратено до всички собствености.
В този пример параметърът sign_up е името на събитието. Последният параметър е обект, който съдържа набор от параметри на събитието. В този случай method е параметър със стойност email.
Ред 13: Събитието тук има параметър „send_to“. Това е специален параметър, който „маршрутизира“ свързаното събитие към конкретна собственост. С други думи, това събитие ще бъде изпратено само до собствеността, посочена от <Some Property ID B>.
Основното събиране на данни за собственост в Google Анализ 4 се активира чрез командата „config“ на gtag и дава възможност за събирането на събития „page_view“ (като автоматично събирани събития), когато се зареждат на страница.
Посещението с показване на страница или събитието „page_view“ може да се променят или блокират чрез конкретни параметри.
Идентификатори на собствености
Идентификаторите на собственостите в Universal Analytics са с формат „UA-XXXXXXXX“. Те понякога се наричат идентификатори за проследяване. В това ръководство ще ги наричаме идентификатори на собственостите в UA.
Потоците от данни от мрежата за собствености в Google Анализ 4 използват ID на маркера във формат „G-XXXXXXXX“.
В някои примерни кодове и документация може да ги видите като „TAG_ID“.
Основно събиране на данни
Активирането на основното събиране на данни за собственост в Google Анализ 4 дава възможност за събиране на следното:
- събития „page_view“;
- автоматично събирани събития;
- събития с подобрено измерване (ако е активирано в ПИ).
За да активирате основното събиране на данни за собствеността си в Google Анализ 4, добавете фрагмента gtag.js (маркера на Google) към секцията <head> на всяка страница.
Сравнение между фрагмента gtag.js и фрагмента analytics.js
Фрагментът gtag.js за собственост в Google Анализ 4 служи подобно на фрагмента analytics.js за собственост в Universal Analytics.
Най-голямата разлика между тези два фрагмента е, че кодът analytics.js включва отделно извикване „изпращане на показване на страница“, а кодът gtag.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 Анализ 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 адресите, персонализиране на „бисквитките“ и сигнали от Google, подобно на analytics.js. Можете да направите това чрез командите „config“ или „set“ в gtag.js (или чрез командите „set“, „create“ и „require“ в analytics.js.)
Собственостите в Google Анализ 4 („G-XXXXXXXX“) поддържат внедряване на подобни конфигурационни настройки чрез gtag.js. Има разлики между тези настройки за собственостите в Universal Analytics и в Google Анализ 4. Обърнете внимание на следните съображения:
- Маскирането на IP адресите е стандартизирано на „true“ и не може да се конфигурира в собственост в Google Анализ 4. Поради това IP адресът автоматично се маскира със стандартното събитие за собственост в Google Анализ 4 („G-XXXXXXXX“).
- Когато трябва да се приложат глобални настройки към всички конфигурирани собствености, трябва да се използва командата „set“ в gtag.js, за да се приложи към всички идентификатори на маркери и/или на собствености.
- Обърнете особено внимание на функциите за рекламиране и персонализиране на рекламите в analytics.js, които най-често се внедряват с ред „set“.
Ако използвате команди „set“, „create“ и „require“ в текущото си внедряване на analytics.js, прегледайте кои от тях се задават автоматично в собственост в Google Анализ 4 и кои трябва да бъдат посочени в кода на собствеността в Google Анализ 4 (съпоставяне на параметрите).
Някои примерни конфигурации с техните примерни кодове в analytics.js (за собствеността в UA) и gtag.js (за собствеността в Google Анализ 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'
});
Конфигуриране на настройките за „бисквитките“
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“ (ако например се зарежда вградена рамка), можете да коригирате настройката за конфигуриране да блокира събитието „page_view“. Обмислете вариант, при който е изпратено събитие „page_view“, последвано от влизане на потребителя в профила си в сайта. За взаимодействието при влизане в профила използвате команда „config“, за да зададете идентификатор на потребителя, но не бихте искали да изпращате друго събитие „page_view“. Следният код илюстрира как да предотвратите изпращането на събитието page_view.
gtag('config', 'TAG_ID', {
'user_id': 'USER_ID',
'send_page_view': false
});
Имена на маркерите
Имената на маркерите (известни като „инструменти за проследяване“) се използват, ако искате да изпращате данни до различни собствености в Universal Analytics в analytics.js. В analytics.js инструментите за проследяване определят на коя собственост искате да изпратите данните. Посещенията след първоначалното посещение „create“ вече не е необходимо да посочват идентификатора на собствеността в Universal Analytics, а само името на инструмента за проследяване.
В gtag.js инструментите за проследяване не са налице нито за собствености в Google Анализ 4, нито за собствености в Universal Analytics. Ако искате да изпратите всички посещения към няколко собствености (различни потоци от данни в собственост в Google Анализ 4), трябва да посочите всички идентификатори на маркери или на собственостите в реда „config“.
Събития
Вижте ръководството относно мигрирането на събития.Персонализирани величини и показатели
Персонализираните величини и показатели се използват за разширяване на информацията, която се измерва на уебсайта, и за импортиране на офлайн данни от системи за управление на връзките с клиенти. В собственост в Universal Analytics („UA-XXXXXXXX“) персонализираните величини и показатели трябва да се създават в ПИ, да им се присвоява идентификатор и след това могат да бъдат внедрени или импортирани. Те могат да бъдат създадени с четири различни обхвата: посещение, сесия, потребител, продукт.
В собственост в Google Анализ 4 („G-XXXXXXXX“) персонализираните величини и показатели за използване се внедряват по различен начин. Измерванията на персонализирани величини и показатели в собственост в Universal Analytics, внедрена чрез analytics.js, трябва да бъдат внедрени повторно като параметри в собствеността в Google Анализ 4.
Персонализирана величина за собственост в Universal Analytics може да бъде внедрена чрез analytics.js по следния начин:
ga('send', 'event', 'category_value', 'action_name', {'dimension5': 'custom data'
});
ИЛИ
ga('set', 'dimension5', 'custom data');
Тези персонализирани величини могат да бъдат прехвърлени към собственост в Google Анализ 4 чрез gtag.js по следния начин:
gtag('event', 'action_name', {'eventCategory': 'category_value',
'dimension5': 'custom data'
});
ИЛИ
gtag('set', {'dimension5': 'custom data'});
Има две предупреждения:
- Параметрите трябва да бъдат регистрирани в потребителския интерфейс, за да се показват в отчетите. Този процес е сравним с регистрирането на персонализирани величини в Universal Analytics (прилагат се ограничения). Не е необходимо да ги регистрирате, ако разглеждате само експортирани данни или използвате параметъра за активиране на аудитории.
- Обхватът на персонализираните параметри винаги е на ниво събитие, сравним с обхвата на ниво посещения. Това важи и за персонализираните величини, които автоматично се превръщат в параметри (за внедряване на gtag.js „UA-XXXXXXXX“), независимо от първоначалната настройка на обхвата им.
Същото съпоставяне и съображения важат и за персонализираните показатели, с изключение на това, че се отчитат като числени параметри вместо като текстови параметри, когато са регистрирани за отчитане.
Концептуално погледнато персонализираните величини и показатели с различен обхват в собственост в Universal Analytics съответстват на собственост в Google Анализ 4, както следва:
- Персонализирана величина с обхват на ниво посещение: parameter (макс. 25 записани параметъра за събитие по време на събирането на данни; макс. 50 персонализирани величини/50 персонализирани показателя)
Моля, имайте предвид, че автоматично събираните събития и параметри може вече да обхващат някои случаи на употреба, за които по-рано е щяла да бъде използвана персонализирана величина с обхват на ниво посещение - Персонализирана величина с обхват на ниво потребител: user-properties (макс. 25, регистрирани за отчитане чрез потребителския интерфейс). Автоматично събираните величини за потребителите не се включват в това ограничение.
- Персонализирана величина с обхват на ниво сесия: няма еквивалент в собствеността в Google Анализ 4; погледнете вместо това персонализираните параметри или характеристиките на потребителя.
Най-добри практики за характеристики на потребителя
Характеристиките на потребителя се придържат към потребител в различни платформи (напр. във всички типове потоци от данни) и следователно се използват само ако данните трябва да се прилагат на ниво потребител. Характеристиките на потребителя не бива да се използват за данни на ниво сесия или за данни на ниво устройство (например размер на екрана).
Пример за собственост в Google Анализ 4
gtag('set', 'user_properties', {
favorite_composer: 'Mahler',
favorite_instrument: 'double bass',
season_ticketholder: 'true'
});