Импорт целевых событий из CallTouch

Help Center

Импорт целевых событий из CallTouch в Target Ads

Инструкция по интеграции событий из коллтрекинга в нашу систему для анализа post-view звонков.

Из системы CallTouch в систему TargetAds можно импортировать целевые события, по которым будет рассчитана атрибуция, включая кроссплатформенную postview атрибуцию с глубиной до 90 дней. В настоящее время метчинг данных осуществляется по идентификаторам Google Analytics или Яндекс Метрики. Чтобы интеграция заработала, необходимо передавать эти идентификаторы в CallTouch, а на вашем сайте должен быть установлен JavaScript-код системы TargetAds, который автоматически собирает данные.

Важно! Интеграция находится на стадии тестирования, и для активации расчета атрибуции на вашем проекте требуется обратиться к вашему менеджеру.

Настройка отправки событий проходит в три этапа:

Создать целевое событие в системе TargetAds
Сгенерировать ссылку для отправки из системы CallTouch и настроить webhook
Выбираем метрики для отправки.

Создание целевого события в TargetAds.
Создание ссылки для отправки из CallTouch и настройка webhook.
Выбор данных для отправки.

Шаг 1. Создание целевого события
Более подробную документацию по созданию целевых событий можно найти по ссылке: https://targetads.io/help/create_event.

Главное: для каждой цели, которую вы планируете импортировать из CallTouch, необходимо создать отдельное целевое событие.

Например, если вы хотите отслеживать две цели — все звонки и звонки длительностью более 1 минуты, необходимо создать две цели и указать следующие данные:

Название события обязательно должно быть на латинице.
После успешного создания целей, потребуется настроить callback URL.

Шаг 2. Создание webhook в CallTouch
Полную инструкцию по настройке webhook в CallTouch можно найти по ссылке.

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

Входящий звонок:
Это событие фиксирует все входящие звонки.
Для его настройки заполните следующие поля:

Название вебхука: TargetADS: Все звонки (можете выбрать любое удобное вам название).
Адрес обработчика: https://eye.targetads.io/calltraking/calltouch/collect?pid=<id проекта>&event_name=call
В параметр pid вставьте ID вашего проекта в системе TargetADS (узнать его можно у менеджера или в настройках, в разделе "Счетчик").
В параметр event_name вставьте значение, указанное при создании целевых событий на первом шаге (в нашем примере — "call").
Метод передачи данных: POST.
Модель атрибуции: выберите модель по вашему усмотрению.
Метрики для отправки вебхуков: выберите "Лиды > Все звонки".
Фильтр по тегам и фильтр по трафику: по умолчанию оставьте без изменений. Однако вы можете настроить фильтры для отправки только тех целевых действий или звонков, которые вам необходимы.
События для отправки вебхуков: в нашем примере мы выбираем "Завершение звонка", чтобы отправлять данные только по завершенным звонкам.
В зависимости от ваших задач можно выбрать другой тип событий, НО ТОЛЬКО ОДНО, иначе целевые действия будут задваиваться в системе TargetADS.

Целевой звонок:
Это событие фиксирует только целевые звонки, например, звонки, длительность которых превышает определенное время.
Для его настройки заполните следующие поля:

Название вебхука: TargetADS: Целевые звонки (название можно выбрать любое).
Адрес обработчика: https://eye.targetads.io/calltraking/calltouch/collect?pid=<id проекта>&event_name=target_call
В параметр pid вставьте ID вашего проекта.
В параметр event_name вставьте значение, которое указано для данного события (в нашем случае — "target_call").
Метод передачи данных: POST.
Модель атрибуции: по вашему усмотрению.
Метрики для отправки вебхуков: выберите "Лиды > Целевые звонки".
Фильтр по тегам и фильтр по трафику: по умолчанию оставляем без изменений, но при необходимости можно настроить фильтрацию.
События для отправки вебхуков: как и в случае с первым событием, выбираем "Завершение звонка", чтобы отправлять данные только по завершенным целевым звонкам.

Опять же, важно выбрать только одно событие, чтобы избежать дублирования данных.
После настройки передаваемой информации сохраните изменения. Теперь вебхук готов к работе.

Шаг 7. Выбор данных для отправки.
Выбор данных для интеграции производится на отдельной вкладке:

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

Google Client ID, Yandex Client ID
Дата и время звонка в формате Unix Time Stamp

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

Тип обращения;leadtype;Показывает, по какому типу обращения был отправлен webhook. Возможные значения: call — вебхук отправлен по звонку, request — вебхук отправлен по заявке;Звонки, Заявки, Чаты;Отсутствуют ID звонка;id;Уникальный идентификатор звонка в Calltouch;Звонки;Отсутствуют ID заявки в Calltouch;requestId;Уникальный идентификатор заявки в Calltouch;Заявки;Отсутствуют Внешний ID заявки;requestNumber;Уникальный идентификатор заявки, который был присвоен ей извне в параметре requestNumber API-метода создания заявок;Заявки;Отсутствуют Название формы;subject;Произвольное название формы на сайте, с которой отправляется заявка в Calltouch;Заявки;Отсутствуют Номер клиента;callerphone;Телефонный номер клиента, с которого он выполняет звонок или оставляет заявку. Формат: 7XXXXXXXXXX;Звонки, Заявки;Отсутствуют Email клиента;email;Почта клиента, оставившего заявку. Формат: user@server.com;Заявки, Чаты;Отсутствуют Длительность разговора;duration;Длительность телефонного разговора в секундах;Звонки;Значение недоступно на момент начала звонка Дата и время звонка в формате Unix Time Stamp;timestamp;Дата и время начала звонка в формате Unix Time Stamp в секундах;Звонки;Отсутствуют Статус звонка;status;Статус звонка. Возможные значения: successful — удачный звонок, unsuccessful — неудачный звонок;Звонки;Значение недоступно на момент начала звонка Уникальный звонок или нет;unique;Уникальный звонок - это первый звонок клиента с одного номера в рамках проекта и заданной глубины уникальности. Возможные значения: true — уникальный звонок, false — повторный звонок;Звонки;Отсутствуют Целевой звонок или нет;targetcall;Звонок, который укладывается в рамки целевого звонка, заданных в системных настройках ЛК (по умолчанию от 30 сек). Возможные значения: target — целевой, non-target — нецелевой;Звонки;Значение недоступно на момент начала звонка Уникально-целевой звонок или нет;uniqtargetcall;Первый звонок от клиента, укладывающийся в рамки целевого звонка. Возможные значения: uniqtarget — уникально-целевой звонок, non-uniqtarget — не уникально-целевой звонок;Звонки;Значение недоступно на момент начала звонка Обратный звонок или нет;callback;Звонок, сделанный через виджет обратного звонка Calltouch или с формы сайта, подключенной к обратному звонку. Возможные значения: callback — обратный, non-callback — прямой звонок;Звонки;Отсутствуют Рейтинг;rating;Рейтинг, присвоенный звонку или заявке. Возможные значения: 0 — рейтинг не присвоен, 1-5 — присвоен рейтинг от 1 до 5;Звонки, Заявки;Значение недоступно на момент начала звонка Источник;source;Источник трафика перехода на сайт, или название источника в статическом пуле;Звонки, Заявки, Чаты;Отсутствуют Канал;medium;Канал трафика перехода на сайт, или название канала в статическом пуле. Если значение отсутствует, передается <не указано>;Звонки, Заявки, Чаты;Отсутствуют Метка utm_source;utm_source;Значение utm-метки utm_source. Если utm-метки отсутствовали, передается <не указано>. Если utm_source отсутствовала, передается <не заполнено>;Звонки, Заявки, Чаты;Отсутствуют Метка utm_campaign;utm_campaign;Значение utm-метки utm_campaign. Если метки отсутствовали, передается <не указано>, если utm_campaign отсутствовала или была пуста, передается <не заполнено>;Звонки, Заявки, Чаты;Отсутствуют Google Client ID;gcid;Идентификатор Google Client ID. Присутствует при интеграции с Google Analytics. Если не настроено или не удалось определить ID, параметр не передается;Звонки, Заявки, Чаты;Отсутствуют Yandex Client ID;yaClientId;Идентификатор Yandex Client ID. Присутствует при интеграции с Яндекс.Метрикой. Если не настроено или не удалось определить ID, параметр не передается;Звонки, Заявки, Чаты;Отсутствуют

Мы в настоящее время принимаем только указанные выше поля. Если вы выберете поля, которых нет в этом списке, интеграция может работать некорректно 🛠️. Однако, при необходимости мы можем добавить дополнительные метрики — просто свяжитесь с вашим менеджером, и мы расширим список доступных данных.
Эти метрики можно выгружать через наше API, а также строить кастомные отчеты. Например, можно анализировать длительность звонка в зависимости от того, видел ли человек определенный креатив, и выяснять, с каких рекламных кампаний звонки приходят более качественные и конверсионные.
После того как выбрали нужные данные для отправки, нажмите "Сохранить" и переведите ползунок активации. После этого webhook станет активным.

Поскольку тестирование функционала ещё продолжается, а атрибуция запускается вручную, пожалуйста, сообщите своему менеджеру о необходимости активации атрибуции и проверки результатов.
👌

Получение мобильных событий из AppsFlyer

Инструкция по интеграции событий из мобильного приложения в нашу систему.

Загрузка оффлайн событий через API