[GA4] Руководство по внедрению тега gtag.js

Это расширенное руководство предназначено для владельцев сайтов, которые используют библиотеку gtag.js и хотят понять, как gtag.js для ресурса Universal Analytics сопоставляется с gtag.js для ресурса "Google Аналитика 4". Подразумевается, что издатель уже создал ресурс "Google Аналитика 4". Если вы просто хотите добавить на сайт базовый код отслеживания, ознакомьтесь с этой статьей.
Содержание

О фрагменте 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. Это важно по следующим причинам:

  1. Если эта строка уже есть в коде, не нужно добавлять ее повторно. Просто добавьте строку config, чтобы задать идентификатор потока данных для ресурса "Google Аналитика 4".
  2. Идентификатор ресурса в этой строке управляет фрагментом 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 тега gtag.js включает базовый сбор данных.

  • Для ресурса Universal Analytics директива config с идентификатором этого ресурса передает обращение pageview.
  • Для ресурса "Google Аналитика 4" директива config с идентификатором потока данных этого ресурса включает сбор событий page_view (как автоматически регистрируемых), когда загружается на странице.

Идентификаторы ресурсов

Идентификатор ресурса Universal Analytics имеет формат "UA-XXXXXXXX". Его иногда называют идентификатором отслеживания, но в этой статье мы используем термин "идентификатор ресурса Universal Analytics".

В веб-потоках для ресурса "Google Аналитика 4" используется идентификатор потока данных формата "G-XXXXXXXX".

В некоторых примерах кода и документации они иногда могут называться "GA_Measurement_ID".

Базовый сбор данных

Включив базовый сбор данных для ресурса "Google Аналитика 4", вы сможете регистрировать следующее:

Если для вашего ресурса Universal Analytics используется gtag.js, вы можете включить базовый сбор данных для ресурса "Google Аналитика 4" несколькими способами:

  • Способ 1. Добавьте новую директиву config с соответствующим идентификатором потока данных для ресурса "Google Аналитика 4".
  • Способ 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, однако есть некоторые различия, которые следует учитывать.

  • Если ко всем сконфигурированным ресурсам нужно применить общие настройки, используйте команду set, с помощью которой можно охватить все идентификаторы потоков данных и ресурсов, включая те, которые реализованы через подключенные теги сайта.
  • Обратите особое внимание на отключение функций персонализации рекламы, которое обычно реализуется в строке config.
  • Если вы используете подключенные теги сайта, то любые изменения, внесенные в код gtag.js с помощью директивы config, применяются только к ресурсу, связанному с идентификатором потока данных, который задан в этой строке кода, и не передаются автоматически в связанный ресурс "Google Аналитика 4". Если вы хотите, чтобы конфигурация применялась к такому ресурсу, выполните одно из указанных ниже действий:
    • Создайте отдельную директиву config и примените ее к нужному ресурсу "Google Аналитика 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

Если вы не хотите, чтобы при загрузке кода config передавалось событие page_view (например, когда загружается окно iframe), вы можете заблокировать это событие. Допустим, событие page_view передается, когда пользователь выполняет вход на сайте. Вы задаете для взаимодействия типа "Вход" идентификатор пользователя с помощью директивы config, но не хотите передавать ещё одно событие page_view. В коде ниже показано, как его заблокировать.

gtag('config', 'MEASUREMENT_ID', {

'user_id': 'USER_ID',

'send_page_view': false

});

События

Если ресурс Universal Analytics реализован с помощью тега gtag.js ("UA-XXXXXXXX"), события представляют собой разные типы обращений, в которых используются параметры "Категория события", "Действие" и "Ярлык" и показатель "Ценность события". Данные о них добавляются в отчеты. Ограничений по количеству значений событий, параметров и показателей нет.

В ресурсах "Google Аналитика 4" каждое обращение считается событием, т. е. различий между типами обращений больше нет.

Категории событий в ресурсе "Google Аналитика 4"

Существует четыре категории событий для ресурсов "Google Аналитика 4": автоматически регистрируемые события, улучшенная статистика, рекомендуемые и специальные события.

  1. Информация об автоматически регистрируемых событиях собирается автоматически в рамках базового сбора данных.
  2. Улучшенная статистика позволяет включать и отключать события для ресурса "Google Аналитика 4" в интерфейсе администрирования. Для отслеживания таких событий не требуется добавлять или изменять код в приложении или на сайте.
    • Учтите, что если события реализованы как отдельные и при этом также отслеживаются с помощью улучшенной статистики, то данные о них будут регистрироваться дважды.Если вы передаете событие и в ресурс Universal Analytics, и в ресурс "Google Аналитика 4", добавьте в событие параметр send_to, указав нужный идентификатор ресурса Universal Analytics. В этом случае событие будет передаваться только в ресурс Universal Analytics, но не в ресурс "Google Аналитика 4".
    • Техническое примечание. Улучшенная статистика не основана на идентификаторах или классах HTML, в отличие от настройки через Google Менеджер тегов, когда идентификаторы и классы HTML используются как триггеры или переменные событий, например кликов по ссылкам и скачиваний.

  1. Рекомендуемые события реализуются вручную, но их названия и параметры заданы Google. Используя такие события, вы сможете работать с существующими и будущими функциями отчетов, недоступными для специальных событий (таких, которым вы сами даете названия). Предусмотрены следующие рекомендуемые события:
  1. Специальные события (те события, которые вы сами называете и реализуете).

Рекомендации по реализации событий

  1. Когда это возможно, используйте автоматически регистрируемые события и улучшенную статистику, а не реализуйте события самостоятельно.
  2. Если нужное событие не входит в регистрируемые автоматически и в улучшенную статистику, поищите его в рекомендуемых.
  3. Реализуйте специальное событие, только если вы не нашли нужное событие как указано выше.

Составьте список событий, которые используются в вашем ресурсе Universal Analytics, и посмотрите, входят ли они в число автоматически регистрируемых событий и событий улучшенной статистики для ресурса "Google Аналитика 4". Если да, в первую очередь настройте эти события, потому что для их переноса не требуется вручную изменять код.

События, реализуемые вручную (рекомендуемые и специальные)

Ресурсы "Google Аналитика 4" и Universal Analytics имеют разную структуру данных событий.

  • Для ресурса Universal Analytics у событий есть поля "Категория события", "Действие события", "Ярлык события" и "Ценность события". Также можно добавить специальные параметры.
  • Для ресурса "Google Аналитика 4" реализованное вручную событие содержит название, автоматически регистрируемые параметры и настраиваемые вручную параметры. Настраиваемые вручную параметры заменяют собой поля событий из ресурса Universal Analytics. С помощью этих параметров также можно задавать дополнительную информацию о событии.

Если ваш ресурс Universal Analytics реализован с помощью фрагмента gtag.js ("UA-XXXXXXXX") и команда send_to не задана, события автоматически переносятся в ресурс "Google Аналитика 4", если в конфигурации указан идентификатор потока данных ("G-XXXXXXXX") или если используется подключенный тег сайта.

Перенос осуществляется следующим образом:

  • Действие события становится названием события в ресурсе "Google Аналитика 4".
  • Категория, ярлык и ценность события становятся параметрами в ресурсе "Google Аналитика 4". Ограничения параметров описаны ниже.

Например, рассмотрим следующее событие для ресурса Universal Analytics, реализованное с помощью фрагмента gtag.js:

1: gtag('event', <action>, {

2: 'event_category': <category>,

3: 'event_label': <label>,

4: 'value': <value>

5: });

Оно будет перенесено в ресурс "Google Аналитика 4" как общее событие:

1: gtag('event', <event_name>, {

2: <parameter_1>: <parameter_1_value>,

3: <parameter_2>: <parameter_2_value>,

4: <parameter_3>: <parameter_3_value>,

5: ...

6: });

Т. е. действие (<action>) из ресурса Universal Analytics сопоставляется с названием события (<event_name>) в ресурсе "Google Аналитика 4", а event_category, event_label, value и их значения сопоставляются с параметрами и их значениями.

О названиях событий, добавляемых вручную

Если вы указываете название события, которое не совпадает с названием автоматически регистрируемого события или события улучшенной статистики, это событие считается регистрируемым вручную.

Можно задать не более 500 уникальных названий событий. Старайтесь по возможности использовать рекомендованные названия, чтобы вам были доступны все отчеты в ресурсах "Google Аналитика 4" и функции, которые могут быть добавлены впоследствии.

Параметры события

Параметры можно использовать, если вы хотите передавать с событием информацию, которая не регистрируется автоматически. Все параметры, которые вы собираете, доступны для создания аудиторий и в инструменте BigQuery.

Свойства параметров

Параметр может содержать неограниченное количество уникальных значений. Однако когда вы создаете ресурс "Google Аналитика 4" в дополнение к ресурсу Universal Analytics, необходимо учитывать определенные ограничения и особенности параметров.

  • Для одного события можно задать до 25 специальных параметров. Каждое значение параметра может содержать до 100 символов.
  • Для одного ресурса можно зарегистрировать не более 50 специальных текстовых и 50 числовых параметров.

Пример

Вы регистрируете клики по ссылкам "Скачать" на своем сайте с видео. В ресурсе Universal Analytics может быть следующая структура тегов:

  • event_category: "Видео"
  • action: "Скачивание"
  • event_label: "История игрушек"

Если ресурс Universal Analytics был реализован с помощью gtag.js, это событие будет перенесено в ресурс "Google Аналитика 4" с применением следующей логики:

  • "Скачивание" – название события.
  • "event_category" – специальный параметр.
  • "event_label" – специальный параметр.

В целом структура событий будет выглядеть так:

  • event_category: [resourceType]
  • action: [interactionType]
  • event_label: [resourceName]
При реализации с помощью gtag.js action становится названием события. Если у вас задано 10 типов взаимодействия, они будут преобразованы в 10 разных названий событий.

Перенос параметров из ресурса Universal Analytics в ресурс "Google Аналитика 4" следует такой же схеме: в каждое новое событие action будут добавлены параметры event_category и event_label.

Если ваша структура события похожа на приведенную выше, сделайте следующее:

  1. Начните собирать данные. Проверьте данные событий в BigQuery.
  2. Проверьте, какие из существующих событий можно найти среди автоматически регистрируемых и в улучшенной статистике. Добавьте команду send_to, чтобы передавать эти события только в ресурс Universal Analytics, но не в ресурс "Google Аналитика 4".
  3. По возможности реализуйте рекомендуемые события.

Специальные параметры и показатели

Специальные параметры и показатели можно использовать, чтобы получать больше информации и импортировать офлайн-данные, например из CRM-систем.

При реализации глобального тега gtag.js специальные параметры и показатели автоматически преобразуются в параметры, если используются подключенные теги сайта или ресурс "Google Аналитика 4" (G-XXXXXXXX).

Подробнее о специальных параметрах и показателях

 

Эта информация оказалась полезной?
Как можно улучшить эту статью?