О фрагменте gtag.js и идентификаторах ресурса
Фрагмент gtag.js в целом одинаков для ресурсов Universal Analytics и ресурсов Google Аналитики 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 Рекламы или другого продукта Google Платформы для маркетинга, у вас на сайте также может быть этот код, но идентификатор ресурса будет начинаться с "AW-" или "DC-".
Идентификатор ресурса (для ресурсов Google Аналитики 4 – идентификатор тега), обозначенный как <Идентификатор ресурса А>, управляет этим фрагментом gtag.js. Это важно по следующим причинам:
- Если эта строка уже есть в коде, не нужно добавлять ее повторно. Чтобы задать идентификатор тега, просто добавьте строку config.
- Идентификатор ресурса в этой строке управляет фрагментом gtag.js. Если тегом управляет идентификатор ресурса Universal Analytics (UA-XXXXXXXX), вы сможете использовать подключенные теги сайта, чтобы передавать данные в ресурс Google Аналитики 4, не добавляя на страницу новый код.
Строка 7. Директива config тега gtag.js включает сбор данных для ресурса, связанного с <Идентификатором ресурса А>. Например, для ресурса Google Аналитики 4 добавление такой директивы с идентификатором тега запустит передачу событий page_view в этот ресурс.
Идентификатор ресурса может обозначать отслеживание для разных продуктов Google, включая ресурс Universal Analytics (UA-XXXXXXXX), ресурс Google Аналитики 4 (G-XXXXXXXX), Google Рекламу (AW-XXXXXXXX) и Floodlight (DC-XXXXXXXX).
Строка 11. Директива event тега gtag.js передает событие. Если во фрагменте присутствуют директивы config для нескольких ресурсов, событие передается во все эти ресурсы.
В примере выше параметр sign_up – это название события. Последний параметр – это объект, содержащий набор параметров события. В нашем примере method – параметр со значением email.
Строка 13. Здесь send_to – параметр события. Это специальный параметр, который направляет связанное с ним событие в определенный ресурс. В нашем примере это событие будет передано только в ресурс, обозначенный как <Идентификатор ресурса Б>.
Команда config включает базовый сбор данных.
- Для ресурса Universal Analytics директива config с идентификатором этого ресурса передает обращение pageview.
- Для ресурса Google Аналитики 4 директива config с идентификатором потока данных этого ресурса включает сбор событий page_view (как автоматически регистрируемых), когда загружается на странице.
Идентификаторы ресурсов
Идентификатор ресурса Universal Analytics имеет формат "UA-XXXXXXXX". Его иногда называют идентификатором отслеживания, но в этой статье мы используем термин "идентификатор ресурса Universal Analytics".
В потоках данных сайта для ресурса Google Аналитики 4 используется идентификатор потока данных формата "G-XXXXXXXX".
В некоторых примерах кода и документации они иногда могут называться "TAG_ID".
Базовый сбор данных
Включив базовый сбор данных для ресурса Google Аналитики 4, вы сможете регистрировать следующее:
- события page_view;
- автоматически регистрируемые события;
- события улучшенной статистики (если они включены в интерфейсе).
Если для вашего ресурса Universal Analytics используется gtag.js, вы можете включить базовый сбор данных для ресурса Google Аналитики 4 несколькими способами:
- Способ 1. Добавьте новую директиву config с нужным идентификатором тега.
- Способ 2. Активируйте подключенные теги сайта, если это доступно для вашей реализации фрагмента gtag.js.
Независимо от выбранного способа существующий ресурс Universal Analytics не изменится и сбор данных в нем продолжится.
Способ 1. Добавление новой директивы config
Если на странице уже есть код gtag.js, просто добавьте новую директиву config с соответствующим идентификатором показателя для ресурса Google Аналитики 4. В примере ниже в код добавлена строка 8 с идентификатором показателя для ресурса Google Аналитики 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, то есть идентификатор в приведенной ниже строке начинается с "UA-".
<script async src="https://www.googletagmanager.com/gtag/js?id=<Идентификатор ресурса А>"></script>
Подключенные теги сайта можно использовать и в том случае, если существующий фрагмент gtag.js управляется ресурсом Google Аналитики 4, однако это возможно, только когда у вас уже есть ресурс такого типа.
- У вас есть доступ с правами администратора к ресурсу Universal Analytics, идентификатор которого указан во фрагменте.
Настройки конфигурации gtag.js
Вы можете настроить базовый фрагмент gtag.js, чтобы управлять настройками сбора данных, например анонимизацией IP-адресов, персонализацией файлов cookie и сигналами Google. Для этого используются директивы config и set.
И ресурсы Universal Analytics (UA-XXXXXXXX), и ресурсы Google Аналитика 4 (G-XXXXXXXX) поддерживают реализацию настроек конфигурации в gtag.js, однако есть некоторые различия, которые следует учитывать.
- В ресурсах Google Аналитики 4 для анонимизации IP-адресов задано значение "true", которое нельзя изменить, поэтому в стандартных событиях для таких ресурсов (G-XXXXXXXX) IP-адреса анонимизируются автоматически.
- Если ко всем сконфигурированным ресурсам нужно применить общие настройки, используйте команду set, с помощью которой можно охватить все идентификаторы потоков данных и ресурсов, включая те, которые реализованы через подключенные теги сайта.
- Обратите особое внимание на отключение функций персонализации рекламы, которое обычно реализуется в строке config.
- Если вы используете подключенные теги сайта, то любые изменения, внесенные в код gtag.js с помощью директивы config, применяются только к ресурсу, связанному с идентификатором потока данных, который задан в этой строке кода, и не передаются автоматически в связанный ресурс Google Аналитики 4. Если вы хотите, чтобы конфигурация применялась к такому ресурсу, выполните одно из указанных ниже действий:
- Создайте отдельную директиву config и примените ее к нужному ресурсу Google Аналитики 4, указав его идентификатор потока данных.
- Задайте настройки с помощью директивы set. В этом случае конфигурация будет применена ко всем связанным ресурсам.
- Создайте отдельную директиву config и примените ее к нужному ресурсу Google Аналитики 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
Если вы не хотите, чтобы при загрузке кода config передавалось событие page_view (например, когда загружается окно iframe), вы можете заблокировать это событие. Допустим, событие page_view передается, когда пользователь выполняет вход на сайте. Вы задаете для взаимодействия типа "Вход" идентификатор пользователя с помощью директивы config, но не хотите передавать ещё одно событие page_view. В коде ниже показано, как его заблокировать.
gtag('config', 'MEASUREMENT_ID', {
'user_id': 'USER_ID',
'send_page_view': false
});
События
Ознакомьтесь с руководством по переносу событий.
Специальные параметры и показатели
Специальные параметры и показатели можно использовать, чтобы получать больше информации и импортировать офлайн-данные, например из CRM-систем.
При реализации тега Google gtag.js специальные параметры и показатели автоматически преобразуются в параметры, если используются подключенные теги сайта или ресурс Google Аналитики 4 (G-XXXXXXXX).
Подробнее о специальных параметрах и показателях…