Яку версію аналітики використовувати

Інтеграція з Google Analytics працює лише для версії Universal Analytics.

Нові властивості за замовчуванням створюються у версії GA4. Наші запити будуть ігноруватися.

Вам потрібно створити аналітику з увімкненим перемикачем (як показано на скріншоті нижче)

Як створити та налаштувати властивість на міні-лендінгу

Створіть властивість на https://analytics.google.com/

Перейдіть до Tracking info -> Tracking code

Скопіюйте код і вставте його в head міні-лендінгу

Для полегшення подальшої роботи рекомендується додавати властивості до міні-лендінгів за допомогою Google Tag Manager, але це не обов'язково.

Далі потрібно знайти Tracking id у налаштуваннях властивості

Скопіюйте Tracking id, потім відкрийте налаштування проекту в Mavibot і збережіть id у константах проекту під назвою google_tracking_id:

Як передати Google Client ID(_ga) з міні-лендінгу за допомогою змінних

Щоб передати ідентифікатор клієнта, потрібно позначити Google Client ID(_ga) у налаштуваннях міні-лендінгу. Після запуску бота з'явиться змінна _ga.

Як передати дані GA з Mavibot

Під час виклику функції для передачі даних до 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}"}'

Документація щодо параметрів:

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

Як використовувати запити типу 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('Mavibot', 'Enter bot', '#{tag}', '100', '{"ti":"#{order_id}", "tr":"#{price}", "tcc":"#{promocode}"}')
ga_event('Mavibot', 'Enter bot', '#{tag}', '100')
ga_event('Mavibot', 'Enter bot', "", '20')

Як використовувати запити типу Page View (t:pageview)

Передаючи дані про перегляди сторінок, ви імітуєте відвідування сторінки веб-користувачем. Щоб побачити стандартний звіт сторінок, перейдіть до Behaviour -> Site Content

Якщо ви налаштуєте ціль для відвідування сторінок, ви зможете отримати віртуальний робочий процес проходження гілки бота, не виходячи з Google Analytics.

Приклад налаштування:

Перевагою цього методу є візуальне представлення руху робочого процесу без необхідності залишати Analytics.

Недоліком, однак, є те, що ви, по суті, передаєте лише один параметр - відвідування блоку. Додаткові дані, такі як Label або Value, як у запитах подій, не можуть бути передані таким чином.

Щоб передати дані про перегляд сторінки в 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"}')

Для передачі додаткових параметрів зверніться до документації за посиланням нижче. Там ви знайдете всі можливі параметри з детальними описами:

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

Як використовувати E-commerce

Налаштування E-commerce у вкладці All Web Site Data

Параметри E-commerce потрібно надсилати як існуючі запити (pageview, event)

Для цього є дві функції: 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 - унікальний ідентифікатор транзакції
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 - унікальний ідентифікатор транзакції
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 параметри, весь масив в одинарних лапках (‘), параметри всередині - у подвійних лапках (“)

Відеоурок