DataGo
Об интеграции
Интеграция с DataGo предназначена для передачи из Calltouch в DataGo данных по событиям звонков, заявок и сделок. Отправляемые события содержат ID посетителя DataGo или Google Analytics (если он был получен нами в рамках сессии с сайта, к которой привязано событие), необходимый для склеивания сессионных данных.
Таким образом, интересующие Вас события из Calltouch со всеми необходимыми данными Вы можете передавать в DataGo, и далее через DataGo в ClickHouse.
Настройка интеграции в личном кабинете Calltouch
Для настройки необходимо перейти в раздел личного кабинета Calltouch: Интеграции / Отправка данных во внешние системы / DataGo.
Чтобы настроить интеграцию с DataGo в личном кабинете Calltouch нажмите кнопку "Добавить счетчик" и выполните несколько шагов:
- Укажите ID клиента из DataGo
- Укажите модель атрибуции
- Укажите используемый идентификатор сессии.
- Укажите в каком виде передавать контакты.
- Выберите, надо ли передавать события по звонкам. Если надо - то какие именно.
- Выберите, надо ли передавать события по заявкам. Если надо - то какие именно.
- Выберите, надо ли передавать события по сделкам. Если надо - то какие именно.
Затем сохраните изменения и интеграция автоматически начнет работать.
Рассмотрим все шаги настройки интеграции детальнее.
Указание ID клиента из DataGo
Укажите идентификатор клиента из DataGo. Получить его можно у Вашего менеджера в DataGo.
Указание модели атрибуции
Выберите, согласно какой модели атрибуции данные по событиям будут передаваться в DataGo. По умолчанию - последний непрямой.
Про модели атрибуции можно подробнее прочитать тут.
Указание используемого идентификатора сессии
Данные по событиям в DataGo можно передавать с привязкой к идентификатору посетителя DataGo, либо с привязкой к идентификатору посетителя Google Analytics. Выберите подходящий вариант в зависимости от того какой именно идентификатор посетителя Вы используете в DataGo.
Указание в каком виде передавать контакты
В данных по событиям, передаваемых в DataGo, происходит отправка телефона и почты из звонка, заявки или сделки. Выберите в каком виде будут передаваться контакты - в открытом виде, или в скрытом (захешированном).
Передача данных по звонкам
На странице настройки интеграции можно выбрать:
В какой момент необходимо отправлять события по звонкам
- Передача событий по звонкам сразу после завершения звонка.
В большинстве случаев достаточно передачи событий по звонкам сразу после завершения звонка.
- Передача событий по звонкам с задержкой в 4 часа.
После завершения разговора звонку могут присваиваться какие-либо теги, которые на момент завершения звонка еще не были проставлены. Про разные виды тегов можно подробнее прочитать тут.
Режим отправки событий с задержкой в 4 часа позволяет отправить события со всеми тегами которые были проставлены в течении 4‑х часов после завершения звонка.
Если дополнительные теги после завершения звонка у вас не появляются или они не нужны вам в DataGo – то выбирайте передачу событий сразу после завершения звонка.
По каким звонкам будут отправляться события
По одному звонку в DataGo может быть отправлено несколько событий. Какие именно события отправлять необходимо выбрать в настройках интеграции:
Подробнее про типы звонков (целевые, уникальные, уникально-целевые) можно прочитать в статье Типы звонков.
Перед отправкой в DataGo события по звонку делается проверка на наличие ID посетителя, выбранного в настройках, связанного с этим звонком:
- Если необходимый ID посетителя есть, то событие передаётся как звонок, связанный с сессией.
- Если необходимого ID посетителя нет, то возможны два варианта передачи событий:
- Без сессии - для звонков из динамического пула.
- На статические номера - для звонков на номера статического пула и обратных звонков, заказанных через виджеты VK, FB, TikTok и тд.
Описание критериев разделения событий:
- Связанные с сессией
Это звонки, имеющие привязку к сессии, в рамках которой удалось получить ID посетителя. - Без сессии
Это звонки на номера динамических пулов, не имеющие привязку к сессии, в рамках которой удалось получить ID посетителя.
- На статические номера
Это звонки на номера статических пулов, звонки импортированные по API, обратные звонки заказанные через виджеты VK, FB, TikTok и тд.
Какие данные будут в передаваемых событиях
Категория события передается в DataGo в параметре ec. События передаются с категорией Calltouch_1234 (где 1234 это id сайта в Calltouch). Для событий которые передаются с задержкой в 4 часа к категории добавляется постфикс _delay (например Calltouch_1234_delay).
Действие по событию передается в DataGo в параметре ea. Таблица передаваемых действий по событиям по звонкам:
Тип звонков | Действие по событию | Действие по событию, при отправке с задержкой в 4 часа |
Все звонки, Связанные с сессий | Call | Call_delay |
Целевые звонки, Связанные с сессий | ValCall | ValCall_delay |
Уникальные звонки, Связанные с сессий | UniqCall | UniqCall_delay |
Уникально-целевые звонки, Связанные с сессий | UVCall | UVCall_delay |
Все звонки, Без сессии | CallNoSession | CallNoSession_delay |
Целевые звонки, Без сессии | ValCallNoSession | ValCallNoSession_delay |
Уникальные звонки, Без сессии | UniqCallNoSession | UniqCallNoSession_delay |
Уникально-целевые звонки, Без сессии | UVCallNoSession | UVCallNoSession_delay |
Все звонки, На статические номера | CallStatic | CallStatic_delay |
Целевые звонки, На статические номера | ValCallStatic | ValCallStatic_delay |
Уникальные звонки, На статические номера | UniqCallStatic | UniqCallStatic_delay |
Уникально-целевые звонки, На статические номера | UVCallStatic | UVCallStatic_delay |
В запросах к DataGo по событиям звонков и заявок передается следующий набор параметров:
Параметр | Пример содержимого | Описание |
uip | 213.87.133.54 | IP адрес из сессии звонка/заявки (если звонок/заявка не привязан к сессии - то параметр не отправляется). |
ua | Mozilla/5.0 ... | User agent из сессии звонка/заявки (если звонок/заявка не привязан к сессии - то параметр не отправляется). |
tid | id-1-calltouch | Идентификатор клиента, указанный в настройках интеграции в ЛК. |
tel | 79000000000 | Номер телефона из звонка/заявки, в формате 7XXXXXXXXXX. Передается для звонков/заявок, где указан номер. |
t | event | Тип хита. Всегда передается event. |
qt | 8000 | Разница между временем совершения события (начало звонка, приход заявки) и его отправкой, в миллисекундах. |
ev | 123 | Значение события. Для звонков передается длительность разговора. Для заявок передается 0. |
test@mail.ru | Почта из заявки. Передается для заявок, где указана почта. | |
el | тег1|тег2|тег3 |
Ярлык события. Передаются все теги звонка/заявки, разделенные символом | |
ec | Calltouch_1234 | Категория события. Передается в виде Calltouch_1234 (где 1234 это id сайта в Calltouch). Для событий которые передаются с задержкой в 4 часа к категории добавляется постфикс _delay (например Calltouch_1234_delay). |
ea | Call | Действие по событию. Содержимое зависит от выбранного для передачи события и его типа, варианты указаны в таблице выше. |
ds | calltouch | Источник данных. Всегда передается calltouch. |
dr | https://www.google.ru/ | Referer перехода из сессии звонка/заявки (если звонок/заявка не привязан к сессии - то параметр не отправляется). |
dh | calltouch.ru | Домен сайта, из сессии звонка/заявки (если звонок/заявка не привязан к сессии - то параметр не отправляется). |
cs | Источник (если звонок/заявка имеет ID посетителя - то параметр не отправляется). | |
cn | msk_retargeting | Кампания (если звонок/заявка имеет ID посетителя- то параметр не отправляется). |
cm | cpc | Канал (если звонок/заявка имеет ID посетителя DataGo - то параметр не отправляется). |
ck | бренд | Ключевое слово (если звонок/заявка имеет ID посетителя - то параметр не отправляется). |
cid | 6e34fb04-aa8c-4c76-9c41-4e1ecdb6c12d |
ID посетителя, полученный в рамках сессии звонка/заявки на сайте из куки DataGo. Если datago_id нет то:
|
cc | na_poiske | Объявление (если звонок/заявка имеет ID посетителя - то параметр не отправляется). |
Передача данных по заявкам
На странице настройки интеграции можно выбрать:
В какой момент необходимо отправлять события по заявкам
- Передача событий по заявкам сразу после поступления заявки
В большинстве случаев достаточно передачи событий по заявкам сразу после поступления заявки.
- Передача событий по заявкам с задержкой в 4 часа
После поступления заявки ей могут присваиваться какие-либо теги, которые на момент регистрации заявки еще не были проставлены. Про разные виды тегов можно подробнее прочитать тут.
Режим отправки событий с задержкой в 4 часа позволяет отправить события со всеми тегами которые были проставлены в течении 4‑х часов после поступления заявки.
Если дополнительные теги после поступления заявки у вас не появляются или они не нужны вам в DataGo – то выбирайте передачу событий сразу после поступления заявки.
По каким заявкам будут отправляться события
По одной заявке в DataGo может быть отправлено несколько событий. Какие именно события отправлять необходимо выбрать в настройках интеграции:
Подробнее про типы заявок (целевые, уникальные, уникально-целевые) можно прочитать в статье Типы заявок
Перед отправкой в DataGo события по заявке делается проверка на наличие выбранного в настройках ID посетителя в сессии Calltouch, связанной с этой заявкой:
- Если ID посетителя есть, то событие передаётся как заявка, связанная с сессией.
- Если ID посетителя нет, то событие передается как заявка без сессии
Описание критериев разделения событий:
- Связанные с сессией
Это заявки, имеющие привязку к сессии, в рамках которой удалось получить ID посетителя. - Без сессии
Это заявки без сессий, или с сессией, в рамках которой не удалось получить ID посетителя.
Какие данные будут в передаваемых событиях
Категория события передается в DataGo в параметре ec. События передаются с категорией Calltouch_1234 (где 1234 это id сайта в Calltouch). Для событий которые передаются с задержкой в 4 часа к категории добавляется постфикс _delay (например Calltouch_1234_delay).
Действие по событию передается в DataGo в параметре ea. Таблица передаваемых действий по событиям по заявкам:
Тип звонков/заявок | Действие по событию | Действие по событию, при отправке с задержкой в 4 часа |
Все заявки, Связанные с сессией | Request | Request_delay |
Целевые заявки, Связанные с сессией | ValRequest | ValRequest_delay |
Уникальные заявки, Связанные с сессией | UniqRequest | UniqRequest_delay |
Уникально-целевые заявки, Связанные с сессией | UVRequest | UVRequest_delay |
Все заявки, Без сессии | RequestNoSession | RequestNoSession_delay |
Целевые заявки, Без сессии | ValRequestNoSession | ValRequestNoSession_delay |
Уникальные заявки, Без сессии | UniqRequestNoSession | UniqRequestNoSession_delay |
Уникально-целевые заявки, Без сессии | UVRequestNoSession | UVRequestNoSession_delay |
Подробное описание передаваемых параметров в запросах к DataGo по событиям звонков и заявок указан выше.
Передача данных по сделкам
На странице настройки интеграции можно выбрать:
В какой момент необходимо отправлять события по сделкам
- Все сделки
События по всем сделкам будут передаваться в DataGo сразу после регистрации сделки в Calltouch. - Сделки в выбранных статусах
События по сделкам будут передаваться в DataGo только если у сделки появился выбранный статус, после появления этого статуса у сделки. Искомый статус может быть передан в сделке изначально при ее регистрации, тогда событие по сделке отправиться в DataGo после регистрации сделки. Или искомый статус может появиться в сделке после ее обновления, тогда событие по сделке отправится в DataGo после обновления сделки в Calltouch.
По каким сделкам будут отправляться события
Какие именно события отправлять необходимо выбрать в настройках интеграции:
Перед отправкой в DataGo события по сделке делается проверка на наличие выбранного в настройках интеграции ID посетителя в сессии Calltouch, связанной с этой сделкой:
- Если ID посетителя есть, то событие передаётся как сделка, связанная с сессией.
- Если ID посетителя нет, то событие передается как сделка без сессии
Описание критериев разделения событий:
- Связанные с сессией
Это сделки, имеющие привязку к сессии, в рамках которой удалось получить ID посетителя. - Без сессии
Это сделки без сессий, или с сессией, в рамках которой не удалось получить ID посетителя.
Какие данные будут в передаваемых событиях
Категория события передается в DataGo в параметре ec. События передаются с категорией Calltouch_1234 (где 1234 это id сайта в Calltouch). Для событий которые передаются с задержкой в 4 часа к категории добавляется постфикс _delay (например Calltouch_1234_delay).
Действие по событию передается в DataGo в параметре ea. Таблица передаваемых действий по событиям по сделкам:
Тип сделок | Действие по событию |
Все сделки, Связанные с сессией | Deal |
Все сделки, Без сессии | DealNoSession |
В запросах к DataGo по событиям сделок передается следующий набор параметров:
Параметр | Пример содержимого | Описание |
tid | id-1-calltouch | Идентификатор клиента, указанный в настройках интеграции в ЛК. |
cid | 6e34fb04-aa8c-4c76-9c41-4e1ecdb6c12d |
ID посетителя DataGo, полученный в рамках сессии звонка/заявки на сайте из куки DataGo. Если datago_id нет то шлем deal12345, где 12345 это id сделки. |
t | event | Тип хита. Всегда передается event. |
ec | Calltouch_303 | Категория события. Передается в виде Calltouch_1234 (где 1234 это id сайта в Calltouch). Для событий которые передаются с задержкой в 4 часа к категории добавляется постфикс _delay (например Calltouch_1234_delay). |
ea | Deal | Действие по событию. Содержимое зависит от выбранного для передачи события и его типа, варианты указаны в таблице выше. |
el | Воронка|Статус |
Ярлык события. Передаем воронку и статус сделки, разделенные | . Если воронки нет то передается notSet вместо нее. Если статуса нет то передается notSet вместо него. |
ev | 12345 | Значение события. Передается выручка из сделки. |
ds | calltouch | Источник данных. Всегда передается calltouch. |
qt | 8000 | Шлем разницу между временем совершения события (дата-время создания сделки при отправке всех сделок, или дата-время обновления сделки при отправке сделок только в выбранных статусах) и его отправкой в миллисекундах. |
dh | calltouch.ru | Домен сайта, из сессии сделки (если сделка не привязана к сессии - то параметр не отправляется). |
uip | 213.87.133.54 | IP адрес из сессии сделки(если сделка не привязана к сессии - то параметр не отправляется). |
ua | Mozilla/5.0 ... | User agent из сессии сделки (если сделка не привязана к сессии - то параметр не отправляется). |
dr | https://www.google.ru/ | Referer перехода из сессии сделки (если сделка не привязана к сессии - то параметр не отправляется). |
cs | Источник (если сделка имеет ID посетителя - то параметр не отправляется). | |
cm | cpc | Канал (если сделка имеет ID посетителя - то параметр не отправляется). |
cn | msk_retargeting | Кампания (если сделка имеет ID посетителя - то параметр не отправляется). |
cc | na_poiske | Объявление (если сделка имеет ID посетителя - то параметр не отправляется). |
ck | бренд | Ключевое слово (если сделка имеет ID посетителя - то параметр не отправляется). |
tel | 79000000000 | Номер телефона из сделки, в формате 7XXXXXXXXXX. Передается для сделок, сматченных с лидами где указан номер. |
test@mail.ru | Почта из сделки. Передается для сделок, сматченных с лидами где указана почта. |
и мы поможем вам
- A/B тестирование (раздел «Подключение»)
- Email-трекинг (раздел «Подключение»)
- Отслеживание офлайн конверсии (раздел «Подключение»)
- Подключение к отслеживанию дополнительных доменов (раздел «Подключение»)
- Подмена номеров на AMP-страницах Google (раздел «Подключение»)