Google Analytics

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

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

Создайте счетчик на странице https://analytics.google.com/

Перейдите во вкладку “Код отслеживания”

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

Скопируйте идентификатор отслеживания

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

Формирование запросов

Перед тем как начать формировать запросы

Рекомендуется к изучению https://developers.google.com/analytics/devguides/collection/protocol/v1/devguide

В этой справке приведены принципы формирования разных запросов. Ознакомившись с ними, вы гораздо быстрей сможете отойти от использования шаблонов запросов и дополнять их своими параметрами.

Запросы типа События (t:events)

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

Увидеть события можно в разделе Поведение->События->Лучшие события

В данном примере вы можете увидеть сколько было переходов в те блоки, откуда настроили передачу данных.

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

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

Передача событий из Salebot

Чтобы передать событие в Google Analytics при переходе в этап необходимо отправить POST-json запрос из целевого блока, или из блока “Не состояние” переход куда осуществляется по таймеру из целевого блока.

URL запроса: https://store.salebot.pro/function/google_analytics

Чтобы составить запрос, воспользуйтесь документацией ниже. В ней содержатся все возможные параметры с подробным описанием:

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

Пример запроса (обязательные параметры жирным)

{ "v":"1", "tid":"UA-111111111-1", "t":"event", "cid":"#{_ga}", "user_agent": "#{messenger}", "ec":"Salebot", "ea":"Вход в бот", "el":"${tag}", "ev":"50" }

Пояснение к параметрам из примера

  • ev - ценность события. Передается в целых числах, запишется в той валюте, которая указана в настройках представления.

  • user_agent - название браузера, от лица которого произойдет событие. Переменная #{messenger} позволит получить в отчет по браузерам это

Запросы типа Виртуальные страницы (t:pageview)

Передачей данных о просмотре страницы вы имитируете посещение пользователем веб-страницы. Увидеть стандартный отчет по страницам можно в разделе “Поведение->Контент сайта”

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

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

Плюс данного подхода - наглядное представление движения по воронке не выходя из аналитикса.

Минус - по сути вы передает всего один параметр - посещение какого-то блока. Доп данные, такие как Ярлык или ценность, как в запросах Events тут не передать.

URL запроса: https://store.salebot.pro/function/google_analytics

Чтобы составить запрос, воспользуйтесь документацией ниже. В ней содержатся все возможные параметры с подробным описанием:

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

Пример запроса (обязательные параметры жирным):

{ "v":"1", "tid":"#{UA}", "t":"pageview", "cid":"#{_ga}", "user_agent": "#{messenger}" "dp":"/start", "dt":"Вход в бот22" } Электронная торговля

Для отправки транзакции в простую электронную торговлю необходимо сначала её активировать в Представлении.

POST-json запрос URL запроса: https://store.salebot.pro/function/google_analytics

Чтобы составить запрос, воспользуйтесь документацией ниже. В ней содержатся все возможные параметры с подробным описанием:

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

//Транзакция

{ "v":"1", "tid":"#{UA}", "t":"transaction", "user_agent": "#{messenger}" "cid":"#{_ga}", "ti":"#{order_id}", "tr":"#{price}", “in”:”{product_name}” }

Расширенная электронная торговля

Позволяет отправлять данные о товарах (услугах)

  • Просмотр

  • Подробнее о товаре (просмотр карточки товара)

  • Добавление в корзину

  • Удаление из корзины

  • Оформление покупки

  • Покупка

  • Возврат

POST-json запрос URL запроса: https://store.salebot.pro/function/google_analytics

Чтобы составить запрос, воспользуйтесь документацией ниже. В ней содержатся все возможные параметры с подробным описанием: https://developers.google.com/analytics/devguides/collection/protocol/v1/parameters?hl=ru#enhanced-ecomm //Пример запроса о транзакции

{ "v":"1", "tid":"#{UA}", "t":"pageview", "pa":"purchase", "cid":"#{_ga}", "user_agent": "#{messenger}", "dp":"/paid", "dt":"Оплата", "ti":"#{order_id}", "tr":"#{price}", "tcc":"#{promocode}" }

Значение tr отобразится в Google Analtyics в виде дохода. Добавить товар в расширенную электронную торговлю Массив ниже - не является самостоятельным Это дополнение к запросу расширенной э.т.

{ "pr1id":"id_товара", "pr1nm":"название товара", "pr1ca":"категория товара", "pr1pr":"цена товара", "pr1qt":"количество товара" "pr2id":"id_товара", "pr2nm":"название товара", "pr3ca":"категория товара", "pr3pr":"цена товара", "pr3qt":"количество товара" }

Доп.возможности решения

Сохранение отформатированного или сгенерированного client_id

Если переменная #{_ga} будет пустая, то сервер сгенерирует google client id и отправит запрос в ваш счётчик. Этот client id никак не будет связан с посещениями вашего сайта, но позволит увидеть общую конверсию по этапам бота. В переменную #{custom_answer} сервер отправляет отправленный в счетчик google client id. В случае, если вы понимаете, что #{_ga} у вас часто будет пустой - можете сохранить cid в переменную _ga и дальше использовать это значение. Это повысит качество собираемых данных.

Если переменная #{_ga} не пустая, то в исходном виде она содержит в себе лишние символы. GA1.2.1746499686.1600361046 Для формирования запроса достаточно 1746499686.1600361046 Если вы планируете использовать google client id за пределами бота (в AmoCRM например) то лучше записывайте в сделку сразу отформатированное значение, которое вернется в custom_answer при первом же запросе.

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

Если вам необходимо в ручную задать источник трафика для вашего события - можно дополнить любой из типов запроса следующими параметрами.

Массив ниже - не является самостоятельным, используется только в сочетании с запросами, описанными выше

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

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

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

Видеоурок