зміст

про інтеграції

Інтеграція з Google Analytics призначена для передачі з Calltouch в Google Analytics подій про дзвінки та заявках з сайту. Події можуть відправлятися як в режимі реального часу (відразу після завершення дзвінка), так і в відкладеному режимі (з затримкою в 4 години після завершення дзвінка). Якщо з якої-небудь причини подія в будь-якому з режимів (в реальному часі або з затримкою) не вдалося передати в UA, наприклад, сервер GA не відповідає, події формуються в чергу на стороні Calltouch і при першій нагоді вони все обов'язково будуть відправлені в UA . Таким чином, в GA будуть гарантовано відправлені події по всьому зафіксованим в статистиці Calltouch дзвінків.

Перед створенням в Google Analytics події про заявках з форм Вашого сайту, вони заздалегідь повинні бути підключені до відстеження за допомогою API Calltouch .

Для роботи інтеграції на сайті повинен бути встановлений скрипт Calltouch, який в коді сайту повинен знаходиться нижче стандартного скрипта Google Analytics. До скриптів, між ними і після, може перебувати довільний код HTML. Необов'язково мати у своєму розпорядженні скрипти один за одним, однак, обов'язково зберегти їх черговість:

• Спочатку стандартний скрипт Google Analytics
• Потім скрипт Calltouch

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

Налаштування інтеграції в особистому кабінеті Calltouch

Для цього необхідно перейти в розділ "Інтеграції => Передача даних в зовнішні системи => Google Analytics" особистого кабінету Calltouch:

Щоб налаштувати інтеграцію з Google Analytics в особистому кабінеті Calltouch досить виконати 4 кроки:

1. Вказати ідентифікатор лічильника UA
2. Вибрати в який момент після завершення дзвінка відправляти подія в UA
3. Вибрати за яким дзвінків будуть відправлятися події в UA
4. Вибрати передавати чи в GA теги дзвінків

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

Вказівка ​​ідентифікатора лічильника UA

Вкажіть ідентифікатор лічильника Google Analytics, в який будуть відправлятися події по дзвінках і заявками, зафіксованими в Calltouch.

Вибір в який момент після завершення дзвінка відправляти подія в UA

Calltouch може відправляти події в GA відразу після завершення дзвінка і / або із затримкою в 4 години після завершення дзвінка. За ці способи відправки в особистому кабінеті Calltouch відповідають 2 опції:

• Включити / відключити передачу подій в Google Analytics в режимі реального часу - подія по дзвінку буде відправлено в GA відразу ж після завершення дзвінка. Ім'я створюваної категорії подій в GA - CallTouch.
• Включити / відключити передачу подій в Google Analytics з затримкою в 4 години - подія по дзвінку буде відправлено через 4 години після завершення дзвінка. Ім'я створюваної категорії подій в GA - CallTouch_delay.

Ви можете вибрати як один з методів, так і обидва відразу. В останньому випадку за дзвінком будуть відправлятися два окремих події - одне після завершення дзвінка та інший через 4 години. Відправка саме окремих подій з затримкою, а не оновлення вже відправлених раніше відразу після завершення дзвінка, пов'язане з тим, що Google не дозволяє оновлювати будь-яким чином вже отримані дані.

Calltouch не передає GA джерел дзвінків, тому що в GA джерело трафіку у події визначається самостійно на основі даних сесії відвідувача з лічильника GA і ідентифікатора cid (Google Client ID), який Calltouch передає в подію, і за яким і в GA відбувається склеювання сесії користувача GA з подією, переданим з Calltouch. Тому відправка подій з затримкою о 4 годині може привести до великої похибки в статистиці UA, тому що джерело трафіку події не завжди зможе бути коректно визначено в UA через тривалого часу (4 години) через початку сесії відвідувача, яка була зафіксована в UA. Ми настійно рекомендуємо використовувати Вам одночасно 2 режиму відправки подій - і в режимі реального часу відразу після завершення дзвінка і в відкладеному режимі з затримкою в 4 години. А для чого в такому разі взагалі потрібна відправка події з задежкой о 4 годині, див. Далі.

Для чого може бути корисна відправка події в GA через 4 години після завершення дзвінка?

Це необхідно, якщо після завершення розмови дзвінку присвоюються якісь із тегів, які на момент відправки події в GA після завершення дзвінка, ще не були проставлені дзвінку. Дзвінки можуть бути розмічені тегами різними способами як в процесі розмови:

так і після завершення розмови:

Саме для передачі чотирьох типів тегів вище, які можуть бути присвоєні дзвінку тільки після його завершення, і може бути використана можливість відправки подій в GA із затримкою в 4 години. В результаті, типи тегів вище, проставлені дзвінку протягом 4 годин після його завершення, будуть автоматично передані в GA подією з 4 годинною затримкою.

Вибір за яким дзвінків будуть відправлятися події в UA

По одному дзвінку в GA може бути відправлено кілька подій. Які саме події відправляти по одному дзвінку необхідно вибрати в налаштуваннях інтеграції:

Події об'єднуються в категорію, яка автоматично створюється в GA при першій передачі події після настройки інтеграції. Ім'я категорії і подій всередині неї залежить від того в який момент передаються події:

• Ім'я категорії CallTouch - події передаються відразу після завершення дзвінка
• Ім'я категорії CallTouch_delay - події передаються із затримкою в 4 години після завершення дзвінка. Всі події всередині цієї категорії будуть так само мати приставку _delay в кінці імені, див. Таблицю далі.

Крім того, по кожній події, крім CallStatic і noSession (див. Таблицю далі), в Google Analytics так само передається cid (унікальний ідентифікатор клієнта Google Client ID).

Події за яким дзвінків можуть бути відправлені в UA?

Всі дзвінки, зв'язалися з сесією * Call Call_delay Всі дзвінки, за якими вдалося визначити джерело. Цільові дзвінки, зв'язалися з сесією * ValCall ValCall_delay Дзвінки, за якими вдалося визначити джерело і тривалість яких укладається в певний часовий проміжок, який Ви можете вказати самі. За замовчуванням дзвінок вважається цільовим, якщо його тривалість становить від 20 секунд до 300 секунд. Ви можете змінити кордони цільового дзвінка на будь-які бажані в розділі Налаштування => Статистика . Унікальні дзвінки, зв'язалися з сесією * UniqCall UniqCall_delay Дзвінки, за якими вдалося визначити джерело і які є першими дзвінками в Вашу компанію з будь-якого номера клієнта. Наприклад, якщо клієнт зателефонував кілька разів з одного і того ж номера, то це всього один унікальний дзвінок. Унікально-цільові дзвінки, зв'язалися з сесією * UVCall UVCall_delay Дзвінки, за якими вдалося визначити джерело і є унікальними, при цьому укладаються в заданий часовий проміжок цільового дзвінка. Дзвінки на статичні номери CallStatic CallStatic_delay

Дзвінки на виділені статичні номера. При цьому назви джерел, за якими закріплені статичні номера в особистому кабінеті Calltouch, будуть передані в якості ярликів подій. Якщо в назві джерела, за яким закріплений статичний номер, використовується кирилиця, то вона автоматично перетворюється в трансліт.

Якщо ви включили опцію передачі тегів в UA , То крім назви джерела, за яким закріплений статичний номер, в ярлику події через символ | без пробілів будуть перераховані теги дзвінків (якщо вони є у дзвінка). Наприклад, так буде виглядати значення ярлика події, переданому по дзвінку на статичний номер, закріплений за джерелом "Візитка", і з присвоєним тегом "Цільовий":

Vizitka | Celevoj

Дзвінки без сесій * noSession noSession_delay

• Дзвінки, по яким не вдалося визначити джерело (без пов'язаної сесії користувача сайту).
• Дзвінки, за якими вдалося визначити джерело, але чия сесія відвідувача не містила cid (ідентифікатор клієнта Google Client ID).

* Мається на увазі, наявність зв'язки з сесією Analytics (тобто наявність Google Client ID).

Перед відправкою в Analytics події за дзвінком робиться перевірка на наявність Google Client ID в сесії Calltouch, пов'язаної з цим дзвінком:

• Якщо Google Client ID є, то подія передається як дзвінок, пов'язаний з сесією.
• Якщо Google Client ID немає, то подія буде або noSession або CallStatic, в залежності від того, на який номер надійшов даний дзвінок - з динамічного пулу або з статичного.

Події за зворотним дзвінків

Події за зворотним дзвінків передаються як події за звичайними дзвінків + в якості ярлика передається тег, який автоматично присвоюється зворотному дзвінку в статистиці Calltouch:

Тому, щоб відрізнити в GA звичайний дзвінок від зворотного, необхідно включити передачу тегів в UA .

Події за заявками з підключених до відстеження форм сайту

Події за заявками з відслідковуються форм сайту передаються за замовчуванням автоматично за умови підключених форм за допомогою API Calltouch і корректно налаштованою інтеграції Calltouch і Google Analytics. Передане подія в Google Analytics за заявками:

• Request - події передаються відразу після отримання заявки
• Request_delay - події передаються із затримкою в 4 години після отримання заявки.

Додаткові події з вашого сайту

Вам доступна також передача додаткових подій з вашого сайту, а саме події по показу кнопки зворотного дзвінка, показу форми зворотного дзвінка і отримання заявки на зворотний дзвінок.

Всі події також об'єднані в категорію Calltouch, проте дані події відправляються в Google Analytics відразу, в момент настання. Налаштування з блоку «Спосіб передачі даних» ніяк на них не впливають.

Показ кнопки зворотного дзвінка Callback_button_show Передається кожен показ кнопки при оновленні сторінки. Показ форми зворотного дзвінка Callback_form_show Передається кожен показ форми при оновленні сторінки. Отримання заявки на зворотний дзвінок Callback_form_sent Передається кожна заявка після натискання кнопки відправки. Кожна подія прив'язане до відповідного типу віджета, але в Аналітікс будуть відображатися сумарні значення за кожним типом події, якщо віджетів кілька.

Важливо! Події за заявками можуть бути передані в одну дату, а фактично дзвінок може бути здійснений в іншу. Наприклад, така ситуація може статися при замовленні дзвінка в неробочий час.
Також, дані щодо кількості показів кнопки / форми і кількість відправлених заявок в календарну дату ніколи не будуть збігатися зі звітом по віджетів. Так відбувається тому, що події відправляються в режимі реального часу, а звіт по віджетів будується за датою сесії, до якої прив'яжуться дзвінки.

Передача в GA тегів дзвінків

Дзвінки в Calltouch можуть бути розмічені тегами різними способами як в процесі розмови, так і після завершення розмови. Теги передаються в GA як ярликів подій. При передачі тега, в назву якого використовується кирилиця, вона автоматично перетворюється в трансліт. Якщо один дзвінок відзначений одночасно декількома тегами, вони будуть передані в якості ярликів подій, розділеними символом | Без пропусків.

Передача в GA тегів, проставлених дзвінку в процесі розмови.

Це можуть бути такі типи тегів:

Для передачі в GA даних типів тегів необхідно включити опцію Передавати теги:

Передача в GA тегів, проставлених дзвінку після завершення розмови.

Це можуть бути такі типи тегів:

Для передачі в GA даних типів тегів необхідно включити опцію Передавати теги, зображену на попередньому скріншоті, а так само крім неї використовувати відкладений режим відправки подій в GA (з затримкою в 4 години після завершення розмови), докладніше про це читайте в раніше .

Теги, проставлені дзвінку через понад 4 години після його завершення, не зможуть бути передані в UA, тому що події вже не зможуть бути пов'язані з сесіями GA через тривалого часу.

Інтеграція з OWOX BI

Компанія OWOX BI спеціалізується на впровадженні Google Analytics 360 в eCommerce-проекти і розробки унікальних онлайн-сервісів на основі Google BigQuery. Якщо Ви користуєтеся цим сервісом, включите інтеграцію з OWOX BI, після чого події в обраному режимі відправки і за обраними типами дзвінків будуть так само передаватися з Calltouch в сервіс OWOX BI:

Ознайомитися з інструкцією по налаштуванню OWOX BI можна посиланням:

https://support.owox.com/hc/ru/articles/216907048

Після включення передачі подій в OWOX BI, за допомогою протоколу Measurement Protocol в даний сервіс, Calltouch буде передавати такі змінні і їх значення:

• tid => Лічильник Google Analytics
• cid => Google Client ID
• t => Подія в Google Analytics
• ec => Категорія подій CallTouch
• ea => Подія по дзвінку або заявки
• el => Ярлик події (теги дзвінків)
• ev => Значення події
• tel => Номер що дзвонив

Налаштування цілей щодо подій Calltouch в Google Analytics

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

1. Перейти в розділ "Адміністратор => Подання => Цілі":

2. У вікні, клікнути на кнопку "+ Мета":

3. Далі в блоці "Опис мети" необхідно вказати довільну назву цілі, наприклад, "Унікальний дзвінок з Calltouch" і вибрати тип "Подія":

4. У блоці "Докладні відомості про мету" необхідно вказати значення:

• Поле "Категорія" - вказується обов'язкове значення "CallTouch", якщо мета створюється для подій, що відправляються відразу після завершення дзвінка, або значення "CallTouch_delay", якщо мета створюється для подій, що відправляються із затримкою в 4 години.
  Буква T в значення Call T ouch вказується у верхньому регістрі. Це пов'язано з настройками передачі подій на стороні нашого сервера, які були налаштовані в минулому, коли наш бренд повинен був відображатися як CallTouch.
• Поле "Дія" - вказується передане подія з таблиці подій . У нашому прикладі ми створюємо мета "Унікальний дзвінок з Calltouch", тому вказуємо відповідне значення з таблиці подій UniqCall.
• Поле "Ярлик" - як ярлик в Google Analytics передаються теги дзвінків, тому в ярлику створюваної мети Ви можете вказати назву тега (латиницею), який повинен був привласнений дзвінку в Calltouch, щоб мета була досягнута. Зверніть увагу, що теги можуть присвоюватися дзвінку і після його завершення, в цьому випадку необхідно використовувати категорію "CallTouch_delay" і відповідні значення подій з таблиці вище . Детальніше див. У розділі Передача в GA тегів дзвінків . В даному прикладі в якості значення ярлика ми вкажемо регулярний вираз / Vizitka / - мета виконається, якщо дзвінок буде містити тег Візитка:

5. Після того, як Ви збережете налаштовану мета, вона успішно відобразитися в списках цілей.

Надалі мета може використовуватися для побудови різних звітів Google Analytics.