Google Analytics

Как добавить интеграцию Google Analytics на свой сайт

Отслеживание действий с помощью интеграции Google Analytics доступно только через конструктор сайтов Salebot.

Регистрация аккаунта и создание потока данных

Структуру сервиса Google Analytics 4 составляют три элемента:

1) Аккаунт - это ресурсы, принадлежащие одной компании.

2) Ресурс - это интернет-проект, у которого может быть несколько витрин. Например, Ozon — ресурс, у которого четыре витрины: маркетплейс, сайт для продавцов и два приложения для Android и iOS.

3) Поток данных - это данные для ресурса с одной из витрин — например, с сайта.

На каждую витрину устанавливается код отслеживания. Другие его названия — счётчик, тег. Он формирует поток данных — отслеживает все действия пользователей на сайте и передаёт их в сервис. Благодаря этому, например, можно видеть в отчётах, сколько человек посетили сайт в прошлом месяце или оформили заказ в боте.

Новые счетчики по умолчанию создаются в версии GA4. Он работает на 2 версии протокола.

Создайте аккаунт на странице:

Укажите название аккаунта:

Далее создаем Ресурс: для начала укажите своё название для Ресурса

Заполните необходимую информацию о компании:

Для создания аккаунта необходимо выставить галочки в чекбоксы о том, что принимаете "Условия обработки данных" и "защиты данных" и нажать кнопку "Принимаю".

На этом создание РЕСУРСА закончено.

Настраиваем сбор данных.

Для этого переходим в панели Администратор (по умолчанию после создания Ресурса вы попадаете в эту панель) откройте раздел Потоки данных и выберите источник Веб (для сбора данных с сайта)

Далее указываем ссылку на сайт для сбора данных. Можно использовать ссылку на минилендинг с доменом конструктора Salebot:

(пример https://salebot.site/md/<название_в_ссылке>)

ИЛИ установить на минилендинг(сайт) свой домен (пример ниже):

После клика по кнопке Создать откроется вкладка "Сведения о веб-потоке":

На изображении:

1 - Идентификатор потока данных (ga4_measurement_id). Данный идентификатор указывается в общих настройках минилендинга во вкладке Аналитика для сбора данных.

Пример:

2 - Секретный ключ API. Переходим в эту вкладку, чтоб получить ga4_api_secret:

Нажмите кнопку Создать. Будет сгенерирован Секретный ключ API, который в дальнейшем потребуется для настройки передачи данных в бота. Скорируйте данный ключ.

Добавляем в переменные проекта две переменные:

ga4_measurement_id - Идентификатор потока данных (пример G-LYXWRKECY4) ga4_api_secret - Секретный ключ API (пример ZSZ2IDt2Sd8JMAUW9WnJGA)

На этом основные настройки на стороне Google.Аналитики выполнены.

Для просмотра информации/отчётов по данному ресурсу или аккаунту перейдите на любую из вкладок меню в левой части экрана:

Как перейти в панель АДМИНИСТРАТОР в Google.Аналитике из отчётов:

В нижней панели слева ВНИЗУ есть значок шестеренки. Нажмите на нее, чтобы зайти в настройки ресурса как Администратор:

Установить счётчик на минилендинг

Установить счётчик на минилендинг можно одним из удобных способов.

Добавить счётчик на минилендинг можно установив тег Google в настройках CSS и JS минилендинга в поле HTML-код HEAD.

Другой способ, в настройках минилендинга в разделе Аналитика заполнить поля Идентификатора потока данных и Названия события конверсии.

Заполнение данных этих полей равносильно добавлению тега Goggle в настройках CSS и JS минилендинга в поле HTML-код HEAD.

Как создать счетчик (Поток данных) на странице https://analytics.google.com/ описано выше.

Ниже выберите один из способов установки счётчика на минилединг для добавления счётчика на минилендинг:

Подключение счётчика в настройках Аналитики минилендинга

Заполнение полей в разделе Аналитика равносильно добавлению тега Goggle в настройках CSS и JS минилендинга в поле HTML-код HEAD.

Откройте минилендинг для редактирования:

Перейдите по кнопке Настройки в раздел Аналитика:

В настройках минилендинга (раздел Аналитика) указываем Идентификатор потока данных и название события-конверсии:

Как получить данные Идентификатор потока данных и название события-конверсии

В настройках Потока данных Google Аналитики скопируйте "Идентификатор потока данных" . Его необходимо будет указать в настройках минилендинга.

Можно скопировать идентификатор в ранее созданном потоке данных или создать новый, как описано в разделе "Регистрация аккаунта

Чтобы клики по кнопкам мессенджера вызывал событие конверсии, нужно создать "Событие-конверсия" в разделе Конверсии.

Чтобы создать его перейдите в раздел Конверсии -> События-конверсии -> Создать событие-конверсию --> Напишите название для данного события.

Имя события-конверсии может быть любым, его нужно передать в настройки минилединга. Например, click

Событие-конверсия будет срабатывать по нажатию на любую кнопку минилендинга.

Если вы хотите разделить конверсии для разных мессенджеров, в настройках минилендинга название события-конверсии должно заканчиваться на нижнее подчеркивание “_”

Если ввести в поле “Название события конверсии” “click_button_”, для каждого мессенджера будет исходить разная конверсия. click_button_vk - для ВКонтакте click_button_telegram - для Телеграм click_button_viber - для Вайбера click_button_whatsapp - для Ватсапа click_button_ok - для Одноклассников click_button_instagram - для Инстаграма

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

Событие-конверсия после создания может обновляться до 24-х часов. Для проверки, вы можете создать событие-конверсию и проверить её в разделе “Отчет в реальном времени” внизу странице в графе “Конверсии”.

Если все установлено правильно, там появятся имена и количество конверсий.

Как передать Google Client ID(_ga) с минилендинга в переменные

Чтобы передать идентификатор посетителя, в настройках минилендинга установите галочку Google Client ID(_ga). После запуска бота в диалоге с клиентом с данного минилендинга появится переменная _ga.

Шаг 1. Зайдите в редактирование минилендинга. Верхняя строка поля конструктора минилендингов --> кнопка Настройки:

Шаг 2. Откройте раздел Аналитика и поставьте галочку в чекбоксе Google Client ID(_ga):

Шаг 3. При запуске бота с минилендинга переменная _ga появится в информации о клиенте в правой части диалога:

Как передать события в GA из Salebot

Чтобы передать событие в Google Analytics при переходе в этап, в поле Калькулятор, необходимо вызвать функцию ga4_event() с необходимыми параметрами.

ga4_event('event_name', 'params', 'debug', 'measurement_id', 'api_secret')

event_name (Обязательно) - Название события.

params - Параметры события (Необязательно). Пример '{"key": "value", "another_key": "another_value"}'

debug - Признак теста(Необязательно). Может быть передано любое значение, достаточно передать значение 1. Позволяет протестировать корректность построения запроса без передачи данных на сервер аналитики.

Если несколько счетчиков, то можно передать measurement_id в паре с api_secret

measurement_id (Необязательно) - Идентификатор потока данных (пример G-LYXWRKECY4).

api_secret - Секретный ключ API (пример , ''ZSZ2IDt2Sd8JMAUW9WnJGA)

Важно!!

measurement_id и api_secret в параметрах функции приоритетнее тех, что указаны в настройках проекта.

Примеры запросов:

result = ga4_event('login', '{"method":"Telegram"}')

result = ga4_event('purchase', '{"currency": "USD", "transaction_id": "T_1234", "value":"12.21"}')

/* Ниже пример функции, если в проекте используются несколько счётчиков аналитики (потоков данных*/

result = ga4_event('login', '{"method":"Telegram"}', '', 'G-LYXWRKECY4', 'ZSZ2IDt2Sd8JMAUW9WnJGA')

Все возможные события с параметрами описаны здесь:

Тестирование запросов

Если передать последний параметр, то будет отправлен тестовый запрос, который возвращает больше информации. Если запрос без ошибок, то в ответ придет:

{'validationMessages': []} если в запросе есть ошибка, то в ответе будет ее описание, например: {'validationMessages': [{'fieldPath': 'events', 'description': 'Event at index: [0] has no name.', 'validationCode': 'NAME_INVALID'}]}

Примеры тестирования запросов:

result = ga4_event('login', '{"method":"Telegram"}', '1')

result = ga4_event('purchase', '{"transaction_id": "T_1234", "value":"12.21"}', '1')

Как передать параметр UTM в GA4

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

Видеоурок (УСТАРЕВШАЯ ВЕРСИЯ для Universal Analytics)

Last updated