Отправка данных во внешние системы

DataGo

Читать 21

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

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

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

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

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

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


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

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

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

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

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

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

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


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

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


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

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

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

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

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

advice_ver2.pngВы можете выбрать как один из методов, так и оба сразу. В последнем случае по звонку будут отправляться два отдельных события - одно после завершения звонка и другое через 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. Таблица передаваемых действий по событиям по звонкам:

Тип звонков Действие по событию Действие по событию, при отправке с задержкой в 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

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

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

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

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

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

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



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

advice_ver2.pngВы можете выбрать как один из методов, так и оба сразу. В последнем случае по звонку будут отправляться два отдельных события - одно после поступления заявки и другое через 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. Таблица передаваемых действий по событиям по заявкам:

Тип звонков/заявок Действие по событию Действие по событию, при отправке с задержкой в 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

advice_ver2.pngЕсли у заявки нет 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. Таблица передаваемых действий по событиям по сделкам:

Тип сделок Действие по событию
Все сделки, Связанные с сессией Deal
Все сделки, Без сессии DealNoSession

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