# Google Analytics
* [Какую версию аналитики использовать](#which-version-of-the-analytics-to-use)
* [Как создать и установить свойство на мини-лендинге ](#how-to-create-and-set-a-property-on-a-mini-landing)
* [Как передать Google Client ID(\_ga) с мини-лендинга через переменные](#how-to-share-google-client-id-_ga-from-the-mini-landing-with-variables)
* [Как передать данные GA из Salebot](#how-to-transfer-ga-data-from-salebot)
* [Как настроить цели событий ](#how-to-configure-event-goals)
* [Как передавать события ](#how-to-transfer-events)
* [Как использовать запросы типа Page View (t:pageview)](#how-to-use-requests-of-the-page-view-type-t-pageview)
* [Как использовать E-commerce](#how-to-use-e-commerce)
* [Видеоурок](#video-tutorial)
## Какую версию аналитики использовать
{% hint style="warning" %}
Интеграция с Google Analytics работает только для версии Universal Analytics.
{% endhint %}
По умолчанию в версии GA4 создаются новые свойства. Наши запросы будут игнорироваться.
Нужно создать аналитику с включенным переключателем (как показано на скриншоте ниже)
## Как создать и установить свойство на мини-лендинге
Создайте свойство на
Перейдите в Tracking info -> Tracking code
Скопируйте код и вставьте его в head мини-лендинга
Для удобства дальнейшей работы рекомендуется добавлять свойства к мини-лендингам через Google Tag Manager, но это не обязательно.
Далее нужно найти Tracking id в настройках свойства
Скопируйте Tracking id, затем откройте настройки проекта в Salebot и сохраните id в Project Constants под именем **google\_tracking\_id**:
## Как передать Google Client ID(\_ga) с мини-лендинга через переменные
Чтобы передать client id, нужно отметить 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** — это client id для аналитики. Если пользователь пришел в бота с мини-лендинга, как показано выше, то id автоматически сохраняется в переменные проекта, в переменную **\_ga**
Если в карточке клиента нет этой переменной, то она автоматически генерируется как случайная последовательность цифр, но в этом случае рекомендуется передавать источник трафика в дополнительных настройках (показано ниже — Как переопределить источник)
## Как переопределить источник
Если нужно вручную задать источник трафика для вашего события, то можно добавить к нему любой тип запроса со следующими параметрами. Словарь ниже не является самостоятельным — он используется только при вызове функций, указанных в поле Дополнительные параметры.
`'{ "cs":"#{utm_source}", "cm":"#{utm_medium}", "cn":"#{utm_campaign}", "ck":"#{utm_term}", "cc":"#{utm_content}"}'`
Документация по параметрам:
{% embed url="" %}
## Как использовать запросы типа 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** — метка события, значение передается как целое число и записывается в валюте, заданной в настройках привлечения \
**словарь с дополнительными параметрами**; например: '{"ti":"#{order\_id}", "tr":"25", "tcc":"#{promocode}"}'
#### Пример вызова функции:
ga\_event('sale', 'list viewing’) \
ga\_event('Salebot', 'Enter bot', '#{tag}', '100', '{"ti":"#{order\_id}", "tr":"#{price}", "tcc":"#{promocode}"}') \
ga\_event('Salebot', '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"}')
Для передачи дополнительных параметров обратитесь к документации по ссылке ниже. Там можно найти все возможные параметры с подробными описаниями:
{% embed url="" %}
## Как использовать E-commerce
Настройка E-commerce во вкладке All Web Site Data
{% hint style="warning" %}
Параметры E-commerce нужно передавать как существующие запросы (pageview, event)
{% endhint %}
Для этого есть две функции: **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** — уникальный 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** — уникальный 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 параметра, весь массив — в одинарных кавычках (‘), параметры внутри — в двойных кавычках (“)
###
## Видеоурок
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.mavibot.ai/doc/ru/integrations/other/analytics/google.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.