Salebot.pro
Search…
⌃K

Google Analytics

Как добавить аналитику в своего чат-бота

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

Интеграция с Google Analytics работает только для версии Universal Analytics.
Новые счетчики по умолчанию создаются в версии GA4. Он работает на 2 версии протокола, наши запросы будут проигнорированы.
Создавать аналитику надо выключив переключатель на скрине ниже:

Как создать и установить счетчик на минилендинг

Создайте счетчик на странице https://analytics.google.com/
Перейдите во вкладку “Код отслеживания”
Скопируйте код и установите в HEAD минилендинга
Для упрощения дальнейшей работы, рекомендуется добавлять счетчики на минилендинг с помощью Google Tag Manager. Но это не обязательно. Взять его можно в настройках ресурса google analytics
Скопируйте идентификатор отслеживания и перейдите на salebot в нужный проект, откройте там Настройки. Сохраните идентификатор в переменные проекта под названием google_tracking_id

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

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

Как передать данных в GA из Salebot

При вызове функций для передачи данных в 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}"}'
Документация по параметрам:

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

Используются в Google Analytics для фиксации наступления определенных событий В GA можно настраивать цели, которые фиксируются при наступлении определенных событий. (т.е. не все события передаваемые события должны быть обязательно целью)
Увидеть события можно в разделе Поведение -> События -> Лучшие события
В данном примере вы можете увидеть сколько было переходов в те блоки, откуда настроили передачу данных.

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

На самые значимые этапы воронки можно настроить цели и использовать их для отслеживания конверсии между этапами. Цели настраиваются в раздел “Представление” -> Цели

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

Чтобы передать событие в Google Analytics при переходе в этап, в поле Калькулятор, необходимо вызвать функцию ga_event() с необходимыми параметрами.
ga_event('категория', 'действие события', 'ярлык', 'ценность события', '{"название параметра": "значение", "название параметра2": "значение3"}', 'признак теста')
где:
  1. 1.
    категория события - обязательный параметр
  2. 2.
    действие события - обязательный параметр
  3. 3.
    ярлык события
  4. 4.
    ценность события. Передается в целых числах, запишется в той валюте, которая указана в настройках представления
  5. 5.
    словарь с дополнительными параметрами пример: '{"ti":"#{order_id}", "tr":"25", "tcc":"#{promocode}"}'
  6. 6.
    признак теста - необязательный параметр. Может быть передано любое значение, достаточно передать значение 1. Позволяет протестировать корректность построения запроса без передачи данных на сервер аналитики
Внимание! Не забывайте убирать признак теста после проверки.
Примеры вызова функции:
ga_event('продажа', 'просмотр списка') ga_event('Salebot', 'Вход в бот', '#{tag}', '100', '{"ti":"#{order_id}", "tr":"#{price}", "tcc":"#{promocode}"}') ga_event('Salebot', 'Вход в бот', '#{tag}', '100') ga_event('Salebot', 'Вход в бот', "", '20')
Пример тестового вызова функции:
ga_event('Salebot', 'Вход в бот', '', '', '', 1)
В результате тестового вызова будет получен ответ вида:
{'hitParsingResult': [{'valid': True, 'parserMessage': [], 'hit': '/debug/collect?ec=Salebot1&ea=Вход в бот1&ev=20&t=event&v=1&tid=UA-213816105-1&cid=860822573.9377922815'}], 'parserMessage': [{'messageType': 'INFO', 'description': 'Found 1 hit in the request.'}]}, где
'valid': True - признак успешно выполненного запроса, параметры переданы верно.

Как использовать запросы типа Просмотр страниц (t:pageview)

Передачей данных о просмотре страницы вы имитируете посещение пользователем веб-страницы. Увидеть стандартный отчет по страницам можно в разделе “Поведение -> Контент сайта”
Если настроить цель на посещение ряда страниц, можно получить визуальную воронку движения по ветке бота, не выходя из Google Analytics.
Пример настройки:
Плюс данного подхода — наглядное представление движения по воронке не выходя из аналитикса.
Минус - по сути вы передает всего один параметр - посещение какого-то блока. Доп данные, такие как Ярлык или ценность, как в запросах Events тут не передать.
Чтобы передать данные о “посещении страницы” в Google Analytics при переходе в блок необходимо, в поле Калькулятор, вызвать функцию ga_pageview() с необходимыми параметрами.
ga_pageview('путь URL страницы', 'заголовок', '{"название параметра": "значение", "название параметра2": "значение3"}', 'признак теста')
где:
  1. 1.
    путь URL страницы - Часть URL страницы, определяющая путь.
  2. 2.
    заголовок - Заголовок страницы/документа
  3. 3.
    Словарь с дополнительными параметрами вида '{"название параметра": "значение", "название параметр2": "значение2"}'
  4. 4.
    признак теста - необязательный параметр. Может быть передано любое значение, достаточно передать значение 1. Позволяет протестировать корректность построения запроса без передачи данных на сервер аналитики
Внимание! Не забывайте убирать признак теста после проверки.
Примеры вызова функции:
ga_pageview('/start, 'Точка входа') ga_pageview('/pay', 'Покупка', '{"cd1": "High Scores"}')
Для передачи дополнительных параметров, воспользуйтесь документацией ниже. В ней содержатся все возможные параметры с подробным описанием:

Как работать с расширенной электронной торговлей

Параметры расширенной электронной торговли нужно отправлять в существующих обращениях (pageview, event)
Для этого предусмотрено две функции: ga_transaction_pageview и ga_transaction_event.

Функция ga_transaction_pageview

Обязательные параметры выделены жирным:
ga_transaction_pageview('идентификатор транзакции', 'общий доход', 'путь URL страницы', 'заголовок', 'список товаров', 'словарь дополнительных параметров', 'признак теста')
Пояснение к параметрам из примера
  1. 1.
    Уникальный идентификатор транзакции
  2. 2.
    Общий доход, связанный с транзакцией
  3. 3.
    Часть URL страницы, определяющая путь.
  4. 4.
    Заголовок страницы/документа
  5. 5.
    Массив товаров '[["id", "name", "цена", "количество"], ["id", "name", "цена", "количество"]]'
  6. 6.
    Словарь с дополнительными параметрами вида '{"название параметра": "значение", "название параметр2": "значение2"}'
  7. 7.
    признак теста - необязательный параметр. Может быть передано любое значение, достаточно передать значение 1. Позволяет протестировать корректность построения запроса без передачи данных на сервер аналитики
Внимание! Не забывайте убирать признак теста после проверки.
Примеры вызова функции:
ga_transaction_pageview('#{order_id}', '2200', '/send', 'Получил', '[["222", "Курс1", "1200", "1"], ["223", "ДопКурс", "1000", "1"]]')
ga_transaction_pageview('123', '100', '/pay', 'Оплатил', '', '{"cd": "High Scores", "cs":"#{utm_source}", "cm":"#{utm_medium}", "cn":"#{utm_campaign}"}' )
Массив товаров имеет следующий вид - массива массивов:
'[["id_товара", "название товара", "цена товара", "количество товара"], ["id_товара", "название товара", "цена товара", "количество товара"]]'
Каждый товар должен иметь 4 параметра, общий массив в одинарных кавычках, параметры внутри в двойных.

Функция ga_transaction_event

Обязательные параметры выделены жирным:
ga_transaction_event ('идентификатор транзакции', 'доход от транзакции', 'категория события', 'действие события', 'метка', 'ценность события', 'массив товаров', 'другие параметры')
Пояснение к параметрам из примера:
  1. 1.
    Уникальный идентификатор транзакции
  2. 2.
    Общий доход, связанный с транзакцией
  3. 3.
    категория события - обязательный
  4. 4.
    действие события - обязательный
  5. 5.
    метка события
  6. 6.
    ценность события. Передается в целых числах, запишется в той валюте, которая указана в настройках представления
  7. 7.
    Массив товаров '[["id", "name", "цена", "количество"], ["id", "name", "цена", "количество"]]'
  8. 8.
    Словарь с дополнительными параметрами вида '{"название параметра": "значение", "название параметр2": "значение2"}'
  9. 9.
    признак теста - необязательный параметр. Может быть передано любое значение, достаточно передать значение 1. Позволяет протестировать корректность построения запроса без передачи данных на сервер аналитики
Внимание! Не забывайте убирать признак теста после проверки.
Примеры вызова функции:
ga_transaction_event('1244', '121.2', '1категория', 'действие', 'ярлык', '10', '[["11", "Товар1", "1.2", "1"], ["22", "Товар2", "120", "1"]]')
ga_transaction_event('1244', '1.2', '1категория', 'действие', '', '', '[["11", "Товар1", "1.20", "1"]]')
ga_transaction_event('1244', '121.2', '1категория', 'действие', 'ярлык', '10', '[["11", "Товар1", "1.2", "1"], ["22", "Товар2", "120", "1"]]', '{"ta": "Google Store", "cs":"#{utm_source}", "cm":"#{utm_medium}", "cn":"#{utm_campaign}"}' )
Массив товаров имеет следующий вид массива массивов:
'[["id_товара", "название товара", "цена товара", "количество товара"], ["id_товара", "название товара", "цена товара", "количество товара"]]'
Каждый товар должен иметь 4 параметра, общий массив в одинарных кавычках, параметры внутри в двойных.

Видеоурок