# 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', '#{tag}', '100') \
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/uk/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.