Power BI

Интеграция с Power BI предназначена для экспорта и анализа “сырых” данных по звонкам и заявкам из Calltouch без привлечения технических специалистов. Это позволит в автоматизированном режиме считать любые производные показатели: стоимость звонка, стоимость заявки, % успешности звонка, % успешности заявки, средняя продолжительность звонка и т.п..
Интеграция так же позволяет экспортировать в Power BI теги по звонкам и заявкам.

Для интеграции Calltouch и Power BI Вы можете воспользоваться специальным коннектором, позволяющем буквально в 1 клик выгрузить все сырые данные по звонкам и заявкам через API. Процесс настройки коннектора подробно описан далее.

Автор инструкции: Александр Морин, Ведущий специалист по Power BI в Arrow Media

1. Включение коннектора в Power BI Desktop

Первое, что нужно сделать – включить использование самописных коннекторов в Power BI Desktop.
Выбираем «Файл -> Параметры и настройки –> Параметры»:

В разделе «Безопасность» нужно разрешить загрузку любого расширения без проверок и предупреждений:

2. Перенос mez-файл в папку

В качестве коннектора выступает файл-архив calltouch.mez

Нам необходимо поместить его в папку «C:\Users\USERNAME\Documents\Power BI Desktop\Custom Connectors», где USERNAME – имя вашего компьютера. Найти папку легко, а если её нет – создайте такую папку:

3. Запуск коннектора

В панели управления Power BI Desktop нажимаю на кнопку «Получить данные». В поиске ввожу calltouch и вижу в списке коннекторов Calltouch Connector. Выбираю его и нажимаю кнопку «Подключить».

Появляется окно, где нужно указать свои параметры:

4. Настройка API Calltouch

Для получения всех необходимых параметров, зайдите в личный кабинет Calltouch:  Интеграции / 
Отправка данных во внешние системы / API и Webhooks.

Включаете передачу данных по API, если нужно обновляете токен и убеждаетесь, что ваш ID активен:

Для коннектора вам понадобятся ID и Токен. Для удобства в Calltouch справа от ID и Токена сделана кнопка копирования.

5. Указание параметров и получение данных

• «Report type» поддерживает 3 значения – calls, requests и orders (звонки, заявки и сделки).
• «Calltouch ID» – как раз из поля ID.
• «Attribution model» поддерживает 2 модели – «last non-direct» и «last click» (последний непрямой и последний клик) и работает только для звонков.
• «Count by date» позволяет привязаться либо к дате звонка/заявки/сделки, либо к дате сессии. В зависимости от выбора один и тот же звонок может привязываться к разным датам, поэтому при сверке обращайте внимание на этот параметр. Если в интерфейсе вы смотрите по дате сессии, а в коннекторе выбрали дату звонка, данные могут расходиться.
• Дата начала и дата окончания вводится либо в формате 2020-04-30 (день всегда задаётся двухзначный), либо в динамическом формате: today, yesterday или 69daysAgo. Вместо 69 может быть любое число. Как правило, дату начала я указываю в формате yyyy-mm-dd, а дату окончания – today или yesterday. Это позволяет всегда иметь последние данные в отчёте, начиная с фиксированной даты до вчерашнего/сегодняшнего дня.

Заполняем параметры и нажимаем ОК. Теперь Power BI требует от нас ввести токен в качестве доступа. Копируем Токен из Calltouch и вставляем в наше поле «Ключ учётной записи»:

После ввода токена, получаем список звонков, каждый звонок пока находится в формате строки:

Жмём на преобразование данных и получаем табличку со строками. 

Чтобы увидеть сами данные, нужно развернуть строки, нажав на стрелки в правом верхнем углу таблицы:

Чтобы увидеть полный список доступных столбцов, нажимаем «Загрузить еще» и отключаем исходное имя столбца как префикс, чтобы не получать слово «data» в названии каждого столбца:

Далее оставляем галочки только на нужных столбцах и нажимаем ОК.

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

6. Разбор функции Calltouch.Data()

Если вы посмотрите код Power Query, то увидите, что извлечение данных происходит с помощью функции Calltouch.Data():

Если вместо вызова функции с параметрами вы напишите «Calltouch.Data» без скобок, то увидите небольшое описание с примерами и возможность вызвать функцию с выбором необходимых параметров:

7. Использование Personal Gateway

Для поддержки онлайн-обновления отчёта в Power BI Service, вам понадобится установить шлюз Power BI Gateway Personal Mode. Если вы уже установили его, при открытии окна шлюза на вкладке «Соединители» вы увидите в списке коннекторов наш коннектор к Calltouch. На всякий случай можно сверить корректно ли указана папка для расположения пользовательских коннекторов (соединителей):

Шлюз необходим чтобы Power BI Service видел нашу функцию «Calltouch.Data()» и мог использовать её. Как вы помните, сама функция лежит на вашем компьютере в специальной папке. Поэтому для её использования необходим персональный шлюз, как например для работы с локальными файлами. Чтобы заставить набор данных Calltouch обновляться автоматически, вам понадобится держать включенным персональный шлюз. Само окно шлюза можно закрыть. Но, если выключить компьютер, данные обновляться не будут.

8. Настройка автоматического обновления отчёта

Чтобы всё работало корректно, после выгрузки отчёта в Power BI Service, нам нужно указать учётные данные для обращения к Calltouch. Переходим в наборы данных Power BI Service:

Выбираем «Подключение шлюза -> Персональный шлюз», нажимаем «Применить».
Далее выбираем «Учётные данные источников данных -> Изменить учётные данные»:

Во всплывающем окне нужно еще раз ввести Токен и нажать «войти»:

После этого можно будет обновлять данный отчёт в Power BI Service по требованию:

А также станет доступной настройка расписания обновлений:

• Инструкции по другим коннекторам Power BI от Александра Морина: https://www.youtube.com/playlist?list=PL3du-Tm1nAm4YeyOW6ICgc8mhPtStEv6l
• Плейлист для новичков по Power Query от Александра Морина: https://www.youtube.com/playlist?list=PL3du-Tm1nAm6SSQOCpryquOx-6aasPARM
• Бесплатный краткий курс Power BI от Microsoft.
• Справка по API Calltouch для выгрузки звонков и интерактивный редактор запросов api.calltouch.ru.