Google Analytics 4

Читать 24

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

Интеграция с Google Analytics 4 предназначена для передачи из Calltouch в Google Analytics 4 данных по событиям звонков, заявок и сделок. Отправляемые события содержат CID (Client ID GA4) и GA4 session_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. Выберите, надо ли передавать события по сделкам. Если надо - то какие именно.

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

Переданную в 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

Если у звонка нет 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 GA4 session_id, полученный в рамках сессии звонка/заявки на сайте. 
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
Если у заявки нет 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
Если у сделки нет CID, то мы передаем в GA4 источники сделки в том виде, как они указаны у нас в системе.

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

параметр пример содержимого описание
client_id 12345.12345 Client ID GA4, полученный в рамках сессии звонка/заявки на сайте из куки GA4. 
timestamp_micros 1627192577008000 Время наступления события, в формате timestamp, в микросекундах.
events[n].name deal Название события. Содержимое зависит от выбранного для передачи события и его типа, варианты указаны в таблице выше.
events[n].params.session_id 123456 GA4 session_id, полученный в рамках сессии сделки на сайте. 
events[n].params.tags тег1|тег2 Все теги сделки, через |
events[n].params.domain calltouch.ru Домен сайта, из сессии сделки (если сделка не привязана к сессии - то параметр не отправляется).
events[n].params.funnel Продажи Воронка сделки.
events[n].params.status Оплачено Статус сделки.
events[n].params.currency RUB Валюта сделки. RUB или USD.
events[n].params.value 1000 Выручка сделки.
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 перехода на сайт. (если сделка имеет CID - то параметр не отправляется).
events[n].params.page_referrer https://www.google.ru/ Referer перехода из сессии сделки (если сделка имеет CID - то параметр не отправляется).

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

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

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

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


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

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

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

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


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

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


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

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

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

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


Не нашли решение проблемы?
Заполните форму, и мы вам поможем.