Какую версию аналитики использовать

Интеграция с Google Analytics работает только для версии Universal Analytics.

Новые свойства по умолчанию создаются в версии GA4. Наши запросы будут игнорироваться.

Вам нужно создать аналитику с включенным переключателем (как показано на скриншоте ниже)

Как создать и настроить свойство на мини-лендинге

Создайте свойство на https://analytics.google.com/

Перейдите в раздел Tracking info -> Tracking code

Скопируйте код и вставьте его в head мини-лендинга

Для упрощения дальнейшей работы рекомендуется добавлять свойства на мини-лендинги с помощью Google Tag Manager, но это необязательно.

Далее вам нужно найти Tracking id в настройках свойства

Скопируйте Tracking id, затем откройте настройки проекта в Mavibot и сохраните id в константах проекта под именем google_tracking_id:

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

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

Как передать данные GA из Mavibot

При вызове функции для передачи данных в Google Analytics некоторые параметры передаются автоматически. Информация ниже приведена для общего понимания работы функции.

Для функций ga_pageview и ga_transaction_pageview передается параметр “t”: “pageview”

Для функций ga_event и ga_transaction_event передается параметр “t”: “event”

Для функций ga_transaction_pageview и ga_transaction_event дополнительно передается параметр “pa” со значением “purchase”.

Также при вызове всех функций автоматически передается параметр cid — это идентификатор клиента для аналитики. Если пользователь пришел в бот с мини-лендинга, как показано выше, то идентификатор автоматически сохраняется в переменные проекта, в переменную _ga

Если в карточке клиента нет этой переменной, то она генерируется автоматически как случайная строка чисел, но в этом случае рекомендуется передавать источник трафика в расширенных настройках (показано ниже — Как переопределить источник)

Как переопределить источник

Если вам нужно вручную установить источник трафика для вашего события, вы можете добавить к нему запрос любого типа со следующими параметрами. Приведенный ниже словарь не является самостоятельным — он используется только при вызове функций, упомянутых в поле «Дополнительные параметры».

'{ "cs":"#{utm_source}", "cm":"#{utm_medium}", "cn":"#{utm_campaign}", "ck":"#{utm_term}", "cc":"#{utm_content}"}'

Документация по параметрам:

https://developers.google.com/analytics/devguides/collection/protocol/v1/parameters?hl=en#trafficsources

Как использовать запросы типа Events (t:events)

Они используются в Google Analytics для определенных событий. Вы можете настроить цели в GA, которые фиксируются при наступлении определенных событий (т.е. не все передаваемые события обязательно должны быть целью).

События можно найти в разделе Behaviour -> Events -> Top Events

Как настроить цели событий

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

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

Чтобы передать событие в GA, при переходе на другой этап необходимо вызвать функцию ga_event() с нужными параметрами в поле калькулятора.

ga_event (‘category’, ‘event action’, ‘label’, ‘event value’, ‘{“parameter name”: “value”, “parameter name 2”: “value 2”}’)

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

category - категория события (обязательный параметр)
event action - обязательный параметр
label - метка события
event value - значение события передается целыми числами и записывается в той же валюте, которая установлена в настройках привлечения
словарь с дополнительными параметрами; пример: '{"ti":"#{order_id}", "tr":"25", "tcc":"#{promocode}"}'

Пример вызова функции:

ga_event('sale', 'list viewing’)
ga_event('Mavibot', 'Enter bot', '#{tag}', '100', '{"ti":"#{order_id}", "tr":"#{price}", "tcc":"#{promocode}"}')
ga_event('Mavibot', 'Enter bot', '#{tag}', '100')
ga_event('Mavibot', 'Enter bot', "", '20')

Как использовать запросы типа Page View (t:pageview)

Передавая данные о просмотрах страниц, вы имитируете посещение страницы пользователем. Чтобы увидеть стандартный отчет по страницам, перейдите в раздел Behaviour -> Site Content

Если настроить цель на посещение страниц, вы можете получить виртуальный рабочий процесс прохождения ветки бота, не выходя из Google Analytics.

Пример настройки:

Преимущество этого метода — визуальное представление движения по рабочему процессу без необходимости покидать Analytics.

Недостаток, однако, заключается в том, что вы по сути передаете только один параметр — посещение блока. Дополнительные данные, такие как Label или Value, как в запросах Event, таким образом передать нельзя.

Чтобы передать данные о просмотре страницы в GA при переходе на блок, необходимо вызвать функцию ga_pageview() с нужными параметрами в поле калькулятора.

ga_pageview(‘URL page path’, ‘title’, ‘{“parameter name”: “value”, “parameter name 2”: “value 3”}’)

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

URL page path - часть URL, содержащая путь
title - заголовок страницы/документа
словарь с дополнительными параметрами следующей структуры: ‘{“parameter name”: “value”, “parameter name 2”: “value 2”}’

Пример вызова функции:

ga_pageview('/start, 'Entry point')
ga_pageview('/pay', ‘Sale’, '{"cd1": "High Scores"}')

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

https://developers.google.com/analytics/devguides/collection/protocol/v1/parameters?hl=en#content

Как использовать E-commerce

Настройка E-commerce находится на вкладке All Web Site Data

Параметры E-commerce необходимо отправлять в составе существующих запросов (pageview, event)

Для этого есть две функции: ga_transaction_pageview и ga_transaction_event. Подробнее о них ниже.

Функция ga_transaction_pageview

Обязательные параметры выделены жирным шрифтом:

ga_transaction_pageview('transaction id', 'total income’, 'URL page path', ‘title’, 'list of products’, 'dictionary of additional parameters’)

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

transaction id - уникальный идентификатор транзакции
total income - общий доход, связанный с транзакцией
URL page path - часть URL, содержащая путь
title - заголовок страницы/документа
list of products - массив продуктов следующей структуры: '[["id", "name", "price", "amount"], ["id", "name", "price", "amount"]]'
словарь с дополнительными параметрами следующей структуры: ‘{“parameter name”: “value”, “parameter name 2”: “value 2”}’

Пример вызова функции:

ga_transaction_pageview('#{order_id}', '2200', '/send', ‘Received’, '[["222", "Rate1", "1200", "1"], ["223", "AdditionalRate", "1000", "1"]]')

ga_transaction_pageview('123', '100', '/pay', 'Payed', '', '{"cd": "High Scores", "cs":"#{utm_source}", "cm":"#{utm_medium}", "cn":"#{utm_campaign}"}' )

Массив продуктов выглядит следующим образом: массив массивов:

'[["product_id", "product name", "product price", "amount of products"], ["product_id", "product name", "product price", "amount of products"]]'

Каждый продукт должен иметь 4 параметра, весь массив в одинарных кавычках (‘), параметры внутри — в двойных кавычках (“)

Функция ga_transaction_event

Обязательные параметры выделены жирным шрифтом:

ga_transaction_event('transaction id', 'transaction income’, 'event category', ‘event action’, 'event tag', 'event importance', 'list of products’, 'additional parameters’)

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

transaction id - уникальный идентификатор транзакции
total income - общий доход, связанный с транзакцией
event category, event action, event tag - обязательные параметры
event importance - передается целыми числами и записывается в той же валюте, которая установлена в настройках просмотра
list of products - массив продуктов следующей структуры: '[["id", "name", "price", "amount"], ["id", "name", "price", "amount"]]'
словарь с дополнительными параметрами следующей структуры: ‘{“parameter name”: “value”, “parameter name 2”: “value 2”}’

Пример вызова функции:

ga_transaction_event('1244', '121.2', 'category1', 'action', 'tag', '10', '[["11", "Product1", "1.2", "1"], ["22", "Product2", "120", "1"]]')

ga_transaction_event('1244', '1.2', 'category1', 'action', '', '', '[["11", "Product1", "1.20", "1"]]')

ga_transaction_event('1244', '121.2', 'category1', 'action', 'tag', '10', '[["11", "Product1", "1.2", "1"], ["22", "Product2", "120", "1"]]', '{"ta": "Google Store", "cs":"#{utm_source}", "cm":"#{utm_medium}", "cn":"#{utm_campaign}"}' )

Массив продуктов выглядит следующим образом: массив массивов:

'[["product_id", "product name", "product price", "amount of products"], ["product_id", "product name", "product price", "amount of products"]]'

Каждый продукт должен иметь 4 параметра, весь массив в одинарных кавычках (‘), параметры внутри — в двойных кавычках (“)

Видеоурок