DataGo

Читать 22

Об интеграции

Интеграция с DataGo предназначена для передачи из Calltouch в DataGo данных по событиям звонков, заявок и сделок. Отправляемые события содержат ID посетителя DataGo или Google Analytics (если он был получен нами в рамках сессии с сайта, к которой привязано событие), необходимый для склеивания сессионных данных. 

Таким образом,  интересующие Вас события из Calltouch со всеми необходимыми данными Вы можете передавать в DataGo, и далее через DataGo в ClickHouse.

После отправки событий из Calltouch они обрабатываются на стороне DataGo, и отображаются в ClickHouse с задержкой. Задержка от момента отправки данных из Calltouch до момента их появления в ClickHouse составляет около 20 минут.

Настройка интеграции в личном кабинете Calltouch

Для настройки необходимо перейти в раздел личного кабинета Calltouch:  Интеграции /  Отправка данных во внешние системы / DataGo.

Чтобы настроить интеграцию с DataGo в личном кабинете Calltouch нажмите кнопку "Добавить счетчик" и выполните несколько шагов:

  1. Укажите ID клиента из DataGo
  2. Укажите модель атрибуции
  3. Укажите используемый идентификатор сессии.
  4. Укажите в каком виде передавать контакты.
  5. Выберите, надо ли передавать события по звонкам. Если надо - то какие именно.
  6. Выберите, надо ли передавать события по заявкам. Если надо - то какие именно.
  7. Выберите, надо ли передавать события по сделкам. Если надо - то какие именно.

Затем сохраните изменения и интеграция автоматически начнет работать.

Переданную в DataGo информацию можно посмотреть в базе данных ClickHouse, в которую настроен стриминг данных из DataGo.

Рассмотрим все шаги настройки интеграции детальнее.

Указание ID клиента из DataGo

Укажите идентификатор клиента из DataGo. Получить его можно у Вашего менеджера в DataGo.


Указание модели атрибуции

Выберите, согласно какой модели атрибуции данные по событиям будут передаваться в DataGo. По умолчанию - последний непрямой.


Про модели атрибуции можно подробнее прочитать тут.

Указание используемого идентификатора сессии

Данные по событиям в DataGo можно передавать с привязкой к идентификатору посетителя DataGo, либо с привязкой к идентификатору посетителя Google Analytics. Выберите подходящий вариант в зависимости от того какой именно идентификатор посетителя Вы используете в DataGo.

DataGo - указание идентификатора посетителя

Указание в каком виде передавать контакты

В данных по событиям, передаваемых в DataGo, происходит отправка телефона и почты из звонка, заявки или сделки. Выберите в каком виде будут передаваться контакты - в открытом виде, или в скрытом (захешированном).

DataGo настройка передачи контактов

Передача данных по звонкам

На странице настройки интеграции можно выбрать:

В какой момент необходимо отправлять события по звонкам


  • Передача событий по звонкам сразу после завершения звонка.
    В большинстве случаев достаточно передачи событий по звонкам сразу после завершения звонка. 
  • Передача событий по звонкам с задержкой в 4 часа.
    После завершения разговора звонку могут присваиваться какие-либо теги, которые на момент завершения звонка еще не были проставлены. Про разные виды тегов можно подробнее прочитать тут.
    Режим отправки событий с задержкой в 4 часа позволяет отправить события со всеми тегами которые были проставлены в течении 4‑х часов после завершения звонка. 
    Если дополнительные теги после завершения звонка у вас не появляются или они не нужны вам в DataGo – то выбирайте передачу событий сразу после завершения звонка.
Вы можете выбрать как один из методов, так и оба сразу. В последнем случае по звонку будут отправляться два отдельных события - одно после завершения звонка и другое через 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

Если у звонка нет выбранного в настройках интеграции ID посетителя, то мы передаем в DataGo источники звонка в том виде как они указаны у нас в системе, а в качестве cid в событии будет передан id звонка в Calltouch.

В запросах к 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.
email 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 google Источник (если звонок/заявка имеет ID посетителя - то параметр не отправляется).
cn msk_retargeting Кампания (если звонок/заявка имеет ID посетителя- то параметр не отправляется).
cm cpc  Канал (если звонок/заявка имеет ID посетителя DataGo - то параметр не отправляется).
ck бренд Ключевое слово (если звонок/заявка имеет ID посетителя - то параметр не отправляется).
cid 6e34fb04-aa8c-4c76-9c41-4e1ecdb6c12d

ID посетителя, полученный в рамках сессии звонка/заявки на сайте из куки DataGo. Если datago_id нет то:

  • для звонков передается call12345, где 12345 это id звонка.
  • для заявок передается request12345, где 12345 это id заявки.
cc na_poiske Объявление (если звонок/заявка имеет ID посетителя - то параметр не отправляется).

Передача данных по заявкам

На странице настройки интеграции можно выбрать: 

В какой момент необходимо отправлять события по заявкам


  • Передача событий по заявкам сразу после поступления заявки
    В большинстве случаев достаточно передачи событий по заявкам сразу после поступления заявки. 
  • Передача событий по заявкам с задержкой в 4 часа
    После поступления заявки ей могут присваиваться какие-либо теги, которые на момент регистрации заявки еще не были проставлены. Про разные виды тегов можно подробнее прочитать тут
    Режим отправки событий с задержкой в 4 часа позволяет отправить события со всеми тегами которые были проставлены в течении 4‑х часов после поступления заявки.
    Если дополнительные теги после поступления заявки у вас не появляются или они не нужны вам в DataGo – то выбирайте передачу событий сразу после поступления заявки.
Вы можете выбрать как один из методов, так и оба сразу. В последнем случае по звонку будут отправляться два отдельных события - одно после поступления заявки и другое через 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


Если у заявки нет выбранного в настройках интеграции ID посетителя, то мы передаем в DataGo источники заявки в том виде как они указаны у нас в системе, а в качестве cid в событии будет передан id заявки в Calltouch.

Подробное описание передаваемых параметров в запросах к 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


Если у сделки нет ID посетителя, выбранного в настройках интеграции, то мы передаем в DataGo источники сделки в том виде как они указаны у нас в системе, а в качестве cid в событии будет передан id сделки в Calltouch.

В запросах к 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 google Источник (если сделка имеет ID посетителя - то параметр не отправляется).
cm cpc  Канал (если сделка имеет ID посетителя - то параметр не отправляется).
cn msk_retargeting Кампания (если сделка имеет ID посетителя - то параметр не отправляется).
cc na_poiske Объявление (если сделка имеет ID посетителя - то параметр не отправляется).
ck бренд Ключевое слово (если сделка имеет ID посетителя - то параметр не отправляется).
tel 79000000000 Номер телефона из сделки, в формате 7XXXXXXXXXX. Передается для сделок, сматченных с лидами где указан номер.
email test@mail.ru Почта из сделки. Передается для сделок, сматченных с лидами где указана почта.