DataGo

Интеграция с DataGo предназначена для передачи из Calltouch в DataGo данных по событиям звонков, заявок и сделок. 

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Вы можете выбрать как один из методов, так и оба сразу. В последнем случае по звонку будут отправляться два отдельных события - одно после завершения звонка и другое через 4 часа. Отправка событий с задержкой в 4 часа будет именно в виде отдельных событий. Это связано с тем, что DataGo не позволяет обновлять каким-либо образом уже полученные данные. 

По каким звонкам будут отправляться события

По одному звонку в DataGo может быть отправлено несколько событий. Какие именно события отправлять необходимо выбрать в настройках интеграции:

Подробнее про типы звонков (целевые, уникальные, уникально-целевые) можно прочитать в статье Типы звонков.

Перед отправкой в DataGo события по звонку делается проверка на наличие ID посетителя DataGo в сессии Calltouch, связанной с этим звонков:

• Если ID посетителя DataGo есть, то событие передаётся как звонок, связанный с сессией.
• Если ID посетителя DataGo нет, то возможны два варианта передачи событий:
  • Без сессии - для звонков из динамического пула.
  • На статические номера - для звонков на номера статического пула и обратных звонков, заказанных через виджеты VK, FB, TikTok и тд.

Описание критериев разделения событий:

• Связанные с сессией
  Это звонки, имеющие привязку к сессии, в рамках которой удалось получить ID посетителя DataGo.
• Без сессии
  Это звонки на номера динамических пулов, не имеющие привязку к сессии, в рамках которой удалось получить ID посетителя DataGo.
  
• На статические номера
  Это звонки на номера статических пулов, звонки импортированные по API, обратные звонки заказанные через виджеты VK, FB, TikTok и тд.

Какие данные будут в передаваемых событиях

Категория события передается в DataGo в параметре ec. События передаются с категорией Calltouch_1234 (где 1234 это id сайта в Calltouch). Для событий которые передаются с задержкой в 4 часа к категории добавляется постфикс _delay (например Calltouch_1234_delay).

Действие по событию передается в DataGo в параметре ea. Таблица передаваемых действий по событиям по звонкам:

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

В запросах к DataGo по событиям звонков и заявок передается следующий набор параметров: 

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

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

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

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

Вы можете выбрать как один из методов, так и оба сразу. В последнем случае по звонку будут отправляться два отдельных события - одно после поступления заявки и другое через 4 часа. Отправки событий с задержкой в 4 часа будет именно в виде отдельных событий. Это связано с тем, что DataGo не позволяет обновлять каким-либо образом уже полученные данные. 

По каким заявкам будут отправляться события

По одной заявке в DataGo может быть отправлено несколько событий. Какие именно события отправлять необходимо выбрать в настройках интеграции:

Подробнее про типы заявок (целевые, уникальные, уникально-целевые) можно прочитать в статье Типы заявок

Перед отправкой в DataGo события по заявке делается проверка на наличие ID посетителя DataGo в сессии Calltouch, связанной с этой заявкой:

• Если ID посетителя DataGo есть, то событие передаётся как заявка, связанная с сессией.
• Если ID посетителя DataGo нет, то событие передается как заявка без сессии

Описание критериев разделения событий:

• Связанные с сессией
  Это заявки, имеющие привязку к сессии, в рамках которой удалось получить ID посетителя DataGo.
• Без сессии
  Это заявки без сессий, или с сессией, в рамках которой не удалось получить ID посетителя DataGo.

Какие данные будут в передаваемых событиях

Категория события передается в DataGo в параметре ec. События передаются с категорией Calltouch_1234 (где 1234 это id сайта в Calltouch). Для событий которые передаются с задержкой в 4 часа к категории добавляется постфикс _delay (например Calltouch_1234_delay).

Действие по событию передается в DataGo в параметре ea. Таблица передаваемых действий по событиям по заявкам:

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

Подробное описание передаваемых параметров в запросах к DataGo по событиям звонков и заявок указан выше.

Передача данных по сделкам

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

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

• Все сделки
  События по всем сделкам будут передаваться в DataGo сразу после регистрации сделки в Calltouch.
• Сделки в выбранных статусах
  События по сделкам будут передаваться в DataGo только если у сделки появился выбранный статус, после появления этого статуса у сделки. Искомый статус может быть передан в сделке изначально при ее регистрации, тогда событие по сделке отправиться в DataGo после регистрации сделки. Или искомый статус может появиться в сделке после ее обновления, тогда событие по сделке отправится в DataGo после обновления сделки в Calltouch.

По каким сделкам будут отправляться события

Какие именно события отправлять необходимо выбрать в настройках интеграции:

Перед отправкой в DataGo события по сделке делается проверка на наличие ID посетителя DataGo в сессии Calltouch, связанной с этой сделкой:

• Если ID посетителя DataGo есть, то событие передаётся как сделка, связанная с сессией.
• Если ID посетителя DataGo нет, то событие передается как сделка без сессии

Описание критериев разделения событий:

• Связанные с сессией
  Это сделки, имеющие привязку к сессии, в рамках которой удалось получить ID посетителя DataGo.
• Без сессии
  Это сделки без сессий, или с сессией, в рамках которой не удалось получить ID посетителя DataGo.

Какие данные будут в передаваемых событиях

Категория события передается в DataGo в параметре ec. События передаются с категорией Calltouch_1234 (где 1234 это id сайта в Calltouch). Для событий которые передаются с задержкой в 4 часа к категории добавляется постфикс _delay (например Calltouch_1234_delay).

Действие по событию передается в DataGo в параметре ea. Таблица передаваемых действий по событиям по сделкам:

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

В запросах к DataGo по событиям сделок передается следующий набор параметров: