# Google Analytics
{% hint style="info" %}
Отслеживание действий с помощью интеграции Google Analytics доступно только через конструктор сайтов Salebot.
{% endhint %}
## Регистрация аккаунта и создание потока данных
Структуру сервиса Google Analytics 4 составляют три элемента:
1\) **Аккаунт -** это ресурсы, принадлежащие одной компании.
2\) **Ресурс** - это интернет-проект, у которого может быть несколько витрин. Например, Ozon — ресурс, у которого четыре витрины: маркетплейс, сайт для продавцов и два приложения для Android и iOS.
3\) **Поток данных -** это данные для ресурса с одной из витрин — например, с сайта.
На каждую витрину устанавливается код отслеживания. Другие его названия — счётчик, тег. Он формирует поток данных — отслеживает все действия пользователей на сайте и передаёт их в сервис. Благодаря этому, например, можно видеть в отчётах, сколько человек посетили сайт в прошлом месяце или оформили заказ в боте.
Новые счетчики по умолчанию создаются в версии GA4. Он работает на 2 версии протокола.
Создайте аккаунт на [странице](https://analytics.google.com):
Укажите название аккаунта:
Далее создаем Ресурс: для начала укажите своё название для Ресурса
Заполните необходимую информацию о компании:
Для создания аккаунта необходимо выставить галочки в чекбоксы о том, что принимаете "Условия обработки данных" и "защиты данных" и нажать кнопку "Принимаю".
На этом создание РЕСУРСА закончено.
**Настраиваем сбор данных.**
Для этого переходим **в панели Администратор** (по умолчанию после создания Ресурса вы попадаете в эту панель) откройте раздел **Потоки данных** и выберите источник **Веб** (для сбора данных с сайта)
Далее **указываем ссылку на сайт для сбора данных**. Можно использовать ссылку на минилендинг с доменом конструктора Salebot:
(пример <название\_в*\_*ссылке>)
ИЛИ установить на минилендинг(сайт) свой домен (пример ниже):
После клика **по кнопке Создать** откроется вкладка "Сведения о веб-потоке":
На изображении:
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.
Другой способ, в настройках минилендинга в разделе Аналитика заполнить поля Идентификатора потока данных и Названия события конверсии.
{% hint style="warning" %}
Заполнение данных этих полей равносильно добавлению тега Goggle в настройках CSS и JS минилендинга в поле HTML-код HEAD.
{% endhint %}
Как создать счетчик (Поток данных) на странице описано выше.
Ниже выберите один из способов установки счётчика на минилединг для добавления счётчика на минилендинг:
{% tabs %}
{% tab title="Настройки минилендинга - > Аналитика" %}
### Подключение счётчика в настройках Аналитики минилендинга
{% hint style="warning" %}
Заполнение полей в разделе Аналитика равносильно добавлению тега Goggle в настройках CSS и JS минилендинга в поле HTML-код HEAD.
{% endhint %}
Откройте минилендинг для редактирования:
Перейдите по кнопке Настройки в раздел Аналитика:
В настройках минилендинга (раздел Аналитика) указываем Идентификатор потока данных и название события-конверсии:
#### Как получить данные Идентификатор потока данных и название события-конверсии
В настройках Потока данных Google Аналитики скопируйте "Идентификатор потока данных" . Его необходимо будет указать в настройках минилендинга.
{% hint style="info" %}
Можно скопировать идентификатор в ранее созданном потоке данных или создать новый, как описано в разделе ["Регистрация аккаунта](#registraciya-akkaunta-i-sozdanie-potoka-dannykh)
{% endhint %}
Чтобы клики по кнопкам мессенджера вызывал событие конверсии, нужно создать "Событие-конверсия" в разделе Конверсии.
Чтобы создать его перейдите в раздел Конверсии -> События-конверсии -> Создать событие-конверсию --> Напишите название для данного события.
Имя события-конверсии может быть любым, его нужно передать в настройки минилединга. Например, click
Событие-конверсия будет срабатывать по нажатию на любую кнопку минилендинга.
{% hint style="success" %}
Если вы хотите разделить конверсии для разных мессенджеров, в настройках минилендинга название события-конверсии должно заканчиваться на нижнее подчеркивание “\_”
{% endhint %}
Если ввести в поле “Название события конверсии” “click\_button\_”, для каждого мессенджера будет исходить разная конверсия.\
click\_button\_vk - для ВКонтакте\
click\_button\_telegram - для Телеграм\
click\_button\_viber - для Вайбера\
click\_button\_whatsapp - для Ватсапа\
click\_button\_ok - для Одноклассников\
click\_button\_instagram - для Инстаграма
{% hint style="success" %}
Само названия события-конверсии может быть любой, главное, чтобы в конце было нижнее подчеркивание. В отчетах аналитики к нему будет добавлено имя мессенджера.
{% endhint %}
{% hint style="danger" %}
Событие-конверсия после создания может обновляться до 24-х часов. Для проверки, вы можете создать событие-конверсию и проверить её в разделе “Отчет в реальном времени” внизу странице в графе “Конверсии”.
Если все установлено правильно, там появятся имена и количество конверсий.
{% endhint %}
{% endtab %}
{% tab title="Настройки минилендинга - > тег Goggle(CSS и JS)" %}
### Подключение счётчика в настройках минилендига с помощью тега Goggle
У вас должен быть создан Поток данных(счётчик), как было [описано в статье выше](https://docs.salebot.pro/integracii/analitika/integraciya-chatbota-s-google-analitics#registraciya-akkaunta-i-sozdanie-potoka-dannykh).
Заходим в настройки потока данных Google Аналитики:
Переходим на вкладку "Просмотр инструкции тега":
Открываем вкладку "Установить вручную", чтобы получить код тега для установки в минилендинг. Копируем код тега:
Переходим в настройки минилендинга и в разделе "CSS и JS" в поле "HTML-код HEAD" устанавливаем скопированный тег Google:
После этого нажимаем кнопку Сохранить, чтобы внесенные изменения применились.
{% endtab %}
{% endtabs %}
## Как передать Google Client ID(\_ga) с минилендинга в переменные
Чтобы передать идентификатор посетителя, в настройках минилендинга установите галочку Google Client ID(\_ga). После запуска бота в диалоге с клиентом с данного минилендинга появится переменная **\_ga**.
**Шаг 1.** Зайдите в редактирование минилендинга. Верхняя строка поля конструктора минилендингов --> кнопка Настройки:
**Шаг 2.** Откройте раздел Аналитика и поставьте галочку в чекбоксе Google Client ID(\_ga):
**Шаг 3.** При запуске бота с минилендинга переменная **`_ga`** появится в информации о клиенте в правой части диалога:
## **Как передать события в GA из Salebot**
{% tabs %}
{% tab title="Google Analytics 4" %}
Чтобы передать событие в 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')`
**Все возможные события с параметрами** описаны здесь:
{% embed url="" %}
### Тестирование запросов
Если передать последний параметр, то будет отправлен тестовый запрос, который возвращает больше информации. Если запрос без ошибок, то в ответ придет:
{'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')`
{% endtab %}
{% tab title="Universal Analytics(УСТАРЕВШАЯ ВЕРСИЯ)" %}
## **Как передать события в GA из Salebot**
Чтобы передать событие в Google Analytics при переходе в этап, в поле Калькулятор, необходимо вызвать функцию **ga\_event()** с необходимыми параметрами.
**ga\_event('категория', 'действие события'**, 'ярлык', 'ценность события', '{"название параметра": "значение", "название параметра2": "значение3"}', 'признак теста')
**где:**
1. категория события - обязательный параметр
2. действие события - обязательный параметр
3. ярлык события
4. ценность события. Передается в целых числах, запишется в той валюте, которая указана в настройках представления
5. словарь с дополнительными параметрами пример: '{"ti":"#{order\_id}", "tr":"25", "tcc":"#{promocode}"}'
6. признак теста - необязательный параметр. Может быть передано любое значение, достаточно передать значение 1. Позволяет протестировать корректность построения запроса без передачи данных на сервер аналитики
{% hint style="warning" %} **Внимание!** Не забывайте убирать признак теста после проверки.
{% endhint %}
**Примеры вызова функции:**
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 - признак успешно выполненного запроса, параметры переданы верно.
При вызове функций для передачи данных в 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**
Также при вызове всех функций автоматически передается параметр **cid** — это идентификатор пользователя для аналитики. Если пользователь пришел в бот с минилендинга и в минилендинг настроен, как указано выше, то этот идентификатор автоматически сохранится в переменные клиента, в переменную **\_ga**
если у клиента не окажется данной переменной, то она генерируется автоматически из рандомного набора цифр, но при таком условии рекомендуется передать в дополнительных параметрах источник трафика описание ниже (Переопределение источника).
### **Как переопределить источник (для** Universal Analytics)
Если вам необходимо вручную задать источник трафика для вашего события - можно дополнить любой из типов запроса следующими параметрами.
Словарь ниже - не является самостоятельным, используется только при вызовах функций описанных ниже в поле Дополнительные параметры
`'{ "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=ru#trafficsources**](https://developers.google.com/analytics/devguides/collection/protocol/v1/parameters?hl=ru#trafficsources)
### **Как использовать запросы типа События (t:events) (для** Universal Analytics)
Используются в Google Analytics для фиксации наступления определенных событий В GA можно настраивать цели, которые фиксируются при наступлении определенных событий. (т.е. не все события передаваемые события должны быть обязательно целью)
Увидеть события можно в разделе Поведение -> События -> Лучшие события
В данном примере вы можете увидеть сколько было переходов в те блоки, откуда настроили передачу данных.
## **Как настроить цель на событие (для** Universal Analytics)
На самые значимые этапы воронки можно настроить цели и использовать их для отслеживания конверсии между этапами. Цели настраиваются в раздел “Представление” -> Цели
## **Как использовать запросы типа Просмотр страниц (t:pageview) (для** Universal Analytics)
Передачей данных о просмотре страницы вы имитируете посещение пользователем веб-страницы. Увидеть стандартный отчет по страницам можно в разделе “Поведение -> Контент сайта”
Если настроить цель на посещение ряда страниц, можно получить визуальную воронку движения по ветке бота, не выходя из Google Analytics.
Пример настройки:
Плюс данного подхода — наглядное представление движения по воронке не выходя из аналитикса.
Минус - по сути вы передает всего один параметр - посещение какого-то блока. Доп данные, такие как Ярлык или ценность, как в запросах Events тут не передать.
Чтобы передать данные о “посещении страницы” в Google Analytics при переходе в блок необходимо, в поле Калькулятор, вызвать функцию **ga\_pageview()** с необходимыми параметрами.
**ga\_pageview('путь URL страницы', 'заголовок'**, '{"название параметра": "значение", "название параметра2": "значение3"}', 'признак теста')
**где:**
1. **путь URL страницы -** Часть URL страницы, определяющая путь.
2. **заголовок -** Заголовок страницы/документа
3. Словарь с дополнительными параметрами вида '{"название параметра": "значение", "название параметр2": "значение2"}'
4. **признак теста** - необязательный параметр. Может быть передано любое значение, достаточно передать значение 1. Позволяет протестировать корректность построения запроса без передачи данных на сервер аналитики
{% hint style="warning" %} **Внимание!** Не забывайте убирать признак теста после проверки.
{% endhint %}
**Примеры вызова функции:**
ga\_pageview('/start, 'Точка входа')\
ga\_pageview('/pay', 'Покупка', '{"cd1": "High Scores"}')
Для передачи дополнительных параметров, воспользуйтесь документацией ниже. В ней содержатся все возможные параметры с подробным описанием:
## **Как работать с расширенной электронной торговлей (для** Universal Analytics)
{% hint style="warning" %}
Параметры расширенной электронной торговли нужно отправлять в существующих обращениях (pageview, event)
{% endhint %}
Для этого предусмотрено две функции: **ga\_transaction\_pageview** и **ga\_transaction\_event**.
### **Функция ga\_transaction\_pageview (для** Universal Analytics)
Обязательные параметры выделены жирным:
**ga\_transaction\_pageview('идентификатор транзакции', 'общий доход', 'путь URL страницы', 'заголовок',** 'список товаров', 'словарь дополнительных параметров', 'признак теста'**)**
**Пояснение к параметрам из примера**
1. Уникальный идентификатор транзакции
2. Общий доход, связанный с транзакцией
3. Часть URL страницы, определяющая путь.
4. Заголовок страницы/документа
5. Массив товаров '\[\["id", "name", "цена", "количес**т**во"], \["id", "name", "цена", "количество"]]'
6. Словарь с дополнительными параметрами вида '{"название параметра": "значение", "название параметр2": "значение2"}'
7. признак теста - необязательный параметр. Может быть передано любое значение, достаточно передать значение 1. Позволяет протестировать корректность построения запроса без передачи данных на сервер аналитики
{% hint style="warning" %} **Внимание!** Не забывайте убирать признак теста после проверки.
{% endhint %}
Примеры вызова функции:
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 (для** Universal Analytics)
Обязательные параметры выделены жирным:
**ga\_transaction\_event ('идентификатор транзакции', 'доход от транзакции', 'категория события', 'действие события', 'метка'**, 'ценность события', 'массив товаров', 'другие параметры'**)**
Пояснение к параметрам из примера:
1. Уникальный идентификатор транзакции
2. Общий доход, связанный с транзакцией
3. категория события - обязательный
4. действие события - обязательный
5. метка события
6. ценность события. Передается в целых числах, запишется в той валюте, которая указана в настройках представления
7. Массив товаров '\[\["id", "name", "цена", "количество"], \["id", "name", "цена", "количество"]]'
8. Словарь с дополнительными параметрами вида '{"название параметра": "значение", "название параметр2": "значение2"}'
9. признак теста - необязательный параметр. Может быть передано любое значение, достаточно передать значение 1. Позволяет протестировать корректность построения запроса без передачи данных на сервер аналитики
{% hint style="warning" %} **Внимание!** Не забывайте убирать признак теста после проверки.
{% endhint %}
**Примеры вызова функции:**
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\_товара", "название товара", "цена товара", "количество товара"]]'
{% hint style="info" %}
Каждый товар должен иметь 4 параметра, общий массив в одинарных кавычках, параметры внутри в двойных.
{% endhint %}
{% endtab %}
{% endtabs %}
### Как передать параметр UTM в GA4
В документации Google нет описания передачи данного параметра. Когда будет добавлено, в функции можно будет передать UTM. \
Поиск в интернете подтверждает, что на данный момент нет возможности передать UTM:
