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

Google Analytics 4

Читать 24

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

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

Передача данных осуществляется посредством Measurement Protocol. Подробнее в статье: Справочное руководство по Measurement Protocol.

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

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

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


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

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

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

advice_ver2.pngПереданную в Google Analytics 4 информацию по событиям можно посмотреть в отчетах, в которых доступен вывод метрик по событиям, или по конверсиям, настроенным по этим событиям.

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

Указание идентификатора потока данных из Google Analytics 4

Для получения идентификатора потока в GA4:

1) Перейдите в раздел Администратор - Потоки данных.


2) Выберите поток данных, скрипт от которого установлен на Вашем сайте, подключенном к отслеживанию в Calltouch.

3) В открывшемся окне скопируйте тест из блока Идентификатор потока данных.


4) Укажите этот идентификатор в настройках интеграции в Calltouch.

Указание секретного ключа API из Google Analytics 4

Для получения секретного ключа API в GA4:

1) Вернитесь на страницу настроек потока данных в GA4, выберите пункт Секретный ключ API для Measurement Protocol.

2) Если API ключи ранее не использовались, примите условия использования и нажмите на кнопку Создать.

3) Введите название ключа, например Calltouch, и нажмите на кнопку Создать.

4) Созданный ключ появится в списке, скопируйте его значение.

5) Укажите этот API ключ в настройках интеграции в Calltouch.

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

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


Про модели атрибуции можно подробнее прочитать в статье: Модель атрибуции

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

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

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

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

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

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

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

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

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

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

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

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

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

Название события передается в GA4 в параметре events[].name. Таблица передаваемых названий событий:

Тип заявок Название события Название события, при отправке с задержкой 4 часа
Все звонки, Связанные с сессий call call_delay
Целевые звонки, Связанные с сессий val_call val_call_delay
Уникальные звонки, Связанные с сессий uniq_call uniq_call_delay
Уникально-целевые звонки, Связанные с сессий uv_call uv_call_delay
Все звонки, Без сессии call_nosession call_nosession_delay
Целевые звонки, Без сессии val_call_nosession val_call_nosession_delay
Уникальные звонки, Без сессии uniq_callnosession uniq_call_nosession_delay
Уникально-целевые звонки, Без сессии uv_call_nosession uv_call_nosession_delay
Все звонки, На статические номера call_static call_static_delay
Целевые звонки, На статические номера val_call_static val_call_static_delay
Уникальные звонки, На статические номера uniq_call_static uniq_call_static_delay
Уникально-целевые звонки, На статические номера uv_call_static uv_call_static_delay

advice_ver2.pngЕсли у звонка нет CID, то мы передаем в GA4 источники звонка в том виде, как они указаны у нас в системе.

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

Параметр Пример содержимого  Описание
client_id 12345.12345 Client ID GA4, полученный в рамках сессии звонка/заявки на сайте из куки GA4. 
timestamp_micros 1627192577008000 Время наступления события, в формате timestamp, в микросекундах.
events[n].name call Название события. Содержимое зависит от выбранного для передачи события и его типа, варианты указаны в таблице выше.
events[n].params.session_id 123456 User-ID GA4, полученный в рамках сессии звонка/заявки на сайте. 
events[n].params.tags тег1|тег2 Все теги звонка/заявки, через |
events[n].params.is_unique true Критерий уникальности звонка/заявки, передаем true или false
events[n].params.is_target false Критерий целевого звонка/заявки, передаем true или false
events[n].params.is_unique_target true Критерий уникально-целевого звонка/заявки, передаем true или false
events[n].params.domain calltouch.ru Домен сайта, из сессии звонка/заявки (если звонок/заявка не привязан к сессии - то параметр не отправляется).
events[n].params.source google Источник.
events[n].params.medium cpc Канал.
events[n].params.campaign msk_retargeting Кампания.
events[n].params.content na_poiske Объявление.
events[n].params.keyword бренд Ключевое слово.
events[n].params.campaign_source google Источник (если звонок/заявка имеет CID - то параметр не отправляется).
events[n].params.campaign_medium cpc Канал (если звонок/заявка имеет CID - то параметр не отправляется).
events[n].params.campaign_name msk_retargeting Кампания (если звонок/заявка имеет CID - то параметр не отправляется).
events[n].params.campaign_content na_poiske Объявление (если звонок/заявка имеет CID - то параметр не отправляется).
events[n].params.campaign_term бренд Ключевое слово (если звонок/заявка имеет CID - то параметр не отправляется).
events[n].params.page_location https://calltouch.ru/index.html URL перехода из сессии звонка/заявки (если звонок/заявка не привязан к сессии - то параметр не отправляется).
events[n].params.page_referrer https://www.google.ru/ Referer перехода из сессии звонка/заявки (если звонок/заявка не привязан к сессии - то параметр не отправляется).

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

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

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

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

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

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

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


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

Перед отправкой в Google Analytics 4 события по заявке делается проверка на наличие CID (Client ID GA4) в сессии Calltouch, связанной с этой заявкой:

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

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

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

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

Название события передается в GA4 в параметре events[].name. Таблица передаваемых названий событий:

Тип заявок Название события Название события, при отправке заявок с задержкой в 4 часа
Все заявки, Связанные с сессий request request_delay
Целевые заявки, Связанные с сессий val_request val_request_delay
Уникальные заявки, Связанные с сессий uniq_request uniq_request_delay
Уникально-целевые заявки, Связанные с сессий uv_request uv_request_delay
Все заявки, Без сессии request_nosession request_nosession_delay
Целевые заявки, Без сессии val_request_nosession val_request_nosession_delay
Уникальные заявки, Без сессии uniq_request_nosession uniq_request_nosession_delay
Уникально-целевые заявки, Без сессии uv_request_nosession uv_request_nosession_delay

advice_ver2.pngЕсли у заявки нет CID, то мы передаем в GA4 источники заявки в том виде, как они указаны у нас в системе.

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

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

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

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

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

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

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


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

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

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

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

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

Название события передается в GA4 в параметре events[].name. Таблица передаваемых названий событий:

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

advice_ver2.png Если у сделки нет CID, то мы передаем в GA4 источники сделки в том виде, как они указаны у нас в системе.

Отображение данных в отчетах Google Analytics 4

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

advice_ver2.pngGA4 может принять события, которые произошли в прошлом, но только если от момента наступления события до его отправки прошло менее 72 часов. Если вы загружаете данные по звонкам, заявкам или сделкам в Calltouch задним числом, с датой-временем более чем на 3 суток отличной от текущей - то такие события на стороне GA4 могут не обработаться и не отобразиться в статистике.

После передачи событий в GA4 и их обработки на стороне GA4 - названия событий появятся в списке событий в разделе Администратор - События


В данном разделе вы можете отметить интересующие Вас события как конверсионные.

advice_ver2.pngПо оффлайн событиям, которые были переданы через Mesurement Protocol, нельзя настроить специальные определения специальных параметров или специальных показателей, тем самым создав новые события или конверсии на основе существующих с условиями по их параметрам. Это ограничение на стороне GA4.

Расмотрим основные отчеты в которых можно посмотреть данные по событиям и конверсиям, и логику их построения.

В GA4 есть отчеты, в которых данные по событиям выводятся согласно данным, полученным после обработки CID (Client ID GA4) из переданного события. Например, это отчет Источники трафика, в нем можно посмотреть статистику по событиям и конверсиям в интересующем разрезе по трафику:


В GA4 есть отчеты, в которых данные по событиям выводятся согласно данным, полученным после обработки User-ID (ID пользователя GA4) из переданного события. Например, это отчет Привлечение трафика, в нем можно посмотреть статистику по событиям и конверсиям в интересующем разрезе по трафику:

В GA4 есть отдельные отчеты по событиям и конверсиям, в них вы можете посмотреть детальные данные по переданным событиям, в интересующих Вас срезах:

Также, все данные по событиям и конверсиям доступны в кастомных отчетах, созданных из раздела Исследования.

advice_ver2.pngКак описано выше, GA4 в разных отчетах оперирует разными данными, построенными на основании разных параметров и с разной логикой. Поэтому показатели событий и конверсий в разных отчетах могут отличаться. Подробнее про логику работы отчетов GA4 вы можете прочитать в документации GA4: Справка

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

advice_ver2.pngТакже, отчеты которые Вы смотрите в Calltouch, строятся по своей логике, отличной от GA4. Данные в разных отчетах в Calltouch и GA4 могут отличаться, и это нормально.