Продукты Решения Тарифы Партнерам Блог
Получить консультацию
Связаться
Выгрузка данных из CoMagic при помощи myBI Connect
17 апреля 2019

Выгрузка данных из CoMagic при помощи myBI Connect

В этой статье мы расскажем про выгрузку данных с помощью myBI Connect из сервиса сквозной аналитики CoMagic (UIS). Пройдем по всем шагам настройки и покажем структуру данных, которую вы сможете самостоятельно использовать.

Также доступна видеоинструкция по данной теме:

Сервис myBI Connect предназначен для автоматической выгрузки данных из различных онлайн-источников в облачное хранилище и ежедневного их обновления. При этом данные в хранилище представлены в удобном виде для последующей самостоятельной работы с ними. Это позволяет пользователю взять данные под свой полный контроль, собрать единую модель данных из различных источников подобно конструктору, а после построить отчетность по своим правилам и законам. Для новых пользователей нашего сервиса доступен бесплатный триал на 2 недели работы.

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

На данный момент существует несколько способов получения данных с помощью myBI Connect:

  • базовая выгрузка,
  • выгрузка пользовательских отчетов,
  • использование вебхуков.

Сейчас мы рассмотрим базовую выгрузку, а в следующих материалах расскажем про особенности остальных вариантов и работу с этими данными.

Итак, в первую очередь необходимо получить ключ для доступа по API к сервису CoMagic (в сервисе используется Data API).

Это делается на уровне пользователя в меню администратора.

Здесь вы можете: выбрать тип доступа и активировать использование ключа (1), выбрать время жизни ключа (рекомендуем выбирать постоянный) (2), сгенерировать ключ (3).

Изображение № 7

Сгенерированный ключ скопируйте.

Далее необходимо открыть доступ к ключу, который по умолчанию закрыт. Для этого нужно прописать IP-адрес хоста, с которого делается запрос на получение данных (адреса наших серверов, на которых обрабатываются данные: 40.115.109.79 и 23.100.57.136). Для этого зайдите в меню администратора,

затем перейдите в раздел «Правила и настройки безопасности» (1) на вкладку «API» (2) и нажмите на кнопку «+ Добавить» (3). После чего вводим IP (4), описание (5) и сохраняем (6).

Также есть возможность открыть доступ всем, написав «0.0.0.0/0» на место IP (7).

Стоит отметить, что возможность выполнять запросы к API осуществляется с тарифа Optimum или на тарифе Start, при условии что вы подключите дополнительный пакет (500 рублей).

Вторым шагом будет настройка выгрузки уже в самом сервисе myBI Connect.

Для этого в разделе «Источники данных» нажимаем на кнопку «Добавить новый +», далее во вкладке «Другое» выбираем «CoMagic» и нажимаем «Подключить».

 

Затем задаем любое узнаваемое название и вставляем ключ, который вы скопировали ранее.

Теперь остается только выполнить загрузку данных за выбранный период. Для этого в разделе источников данных выбираем действие «Загрузить»,

а затем указываем период исторической загрузки (на триале период ограничен одним месяцем).

Необходимо также сказать о том, что в CoMagic установлены лимиты на обращение к API. Изначально доступно 3000 баллов в день, которые расходуются за каждый успешный запрос. Если вы превысите это значение, то с очередной выгрузкой в сервисе myBI Connect вы увидите ошибку,

описание которой можно посмотреть в журнале событий (напротив источника в столбце действий выбираем «Журнал событий»).

Чтобы исправить данную ситуацию, нужно в меню аккаунта сервиса CoMagic перейти в раздел «Тариф и опции» и увеличить показатель «Баллов Data API в день» за дополнительную плату.

Затем следует запустить загрузку данных за тот период, в котором вы получили эту ошибку (на изображении, где описана ошибка, это будет период с 22 по 24 марта).

Взглянуть на выгружаемую модель данных вы можете в настройках источника.

Здесь представлен список таблиц

и наглядно изображена сама структура базы данных.

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

Рассмотрим сначала таблицы измерений. Как правило, они содержат набор описательных атрибутов, характеризующих объект.

Не сливайте рекламный бюджет впустую
Получить консультацию

СМ Параметры кампаний (comagic_campaigns)

Здесь собрана некоторая информация, касающаяся рекламной кампании, к которой относится звонок.

В таблице, кроме идентификаторов, содержатся сведения:

  • причина окончания звонка,
  • направление звонка,
  • источник звонка,
  • потерянный звонок,
  • номер контакта,
  • виртуальный номер,
  • устройство пользователя,
  • канал,
  • источник перехода.

СМ Параметры звонков (comagic_calls)

Данная таблица описывает качественные характеристики звонка:

  • название кампании,
  • описание кампании,
  • тип кампании,
  • платформа интегрированной кампании,
  • статус,
  • расходы,
  • коэффициент расходов,
  • оператор расчета расходов.

СМ Параметры кампаний (comagic_campaigns)

Здесь собрана некоторая информация, касающаяся рекламной кампании, к которой относится звонок.

В таблице, кроме идентификаторов, содержатся сведения:

  • причина окончания звонка,
  • направление звонка,
  • источник звонка,
  • потерянный звонок,
  • номер контакта,
  • виртуальный номер,
  • устройство пользователя,
  • канал,
  • источник перехода.

СМ Атрибуты звонков (comagic_calls_attributes)

Таблица дает информацию о том, какой системный параметр (атрибут) присвоен обращению:

  • название атрибута.

СМ Теги звонков (comagic_calls_tags)

Здесь вы узнаете, какой тег был поставлен звонку:

  • название тега,
  • тип тега.

Общие таблицы измерений:

SHD Параметры дат (general_dates)

Здесь вы узнаете, когда был совершен звонок:

  • дата,
  • год,
  • квартал,
  • номер месяца,
  • месяц,
  • номер недели,
  • номер дня недели,
  • день недели,
  • день месяца.

SHD Параметры местоположений (general_locations)

Таблица дает сведения о географическом расположении клиента:

  • страна,
  • регион,
  • город,
  • широта,
  • долгота.

SHD Параметры посетителей (general_clientids)

  • идентификатор посетителя сайта,
  • телефон,
  • e-mail.

SHD Параметры сайтов (general_sites)

Здесь отражаются сайты, созданные в сервисе CoMagic

  • доменное имя,
  • описание.

SHD Параметры трафика (general_traffic)

Сюда передаются UTM-метки сессий пользователей, перешедших на ваш сайт:

  • название группы,
  • источник,
  • канал,
  • кампания,
  • объявление,
  • ключевое слово,
  • страница входа.

СМ Звонки (comagic_calls_facts)

Таблица фактов состоит из ссылок на таблицы измерений и статистики по звонкам:

  • длительность ожидания,
  • полная длительность ожидания (учитывает все промежутки, когда абонент не разговаривал с сотрудником),
  • длительность разговора (считается от момента первого разговора абонента с сотрудником до начала постобработки),
  • чистая длительность разговора,
  • общая длительность звонка (учитывает только те промежутки, когда абонент разговаривал с сотрудником),
  • длительность постобработки.

Как вы можете видеть из списка таблиц, в базовой выгрузке реализовано получение сведений по звонкам. Кому-то этого может оказаться недостаточно. Для таких случаев существует возможность использования выгрузки пользовательских отчетов, о которой мы расскажем в следующей публикации.

Все выгружаемые данные помещаются в облачную базу данных Azure и обновляются раз в сутки (начиная с часа ночи по Москве). И после этих шагов вы будете иметь к ней доступ, который можно использовать в Power BI, Qlik или в других инструментах, имеющих возможность подключения к БД.

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

  • получение только новых сведений без необходимости полной выгрузки исторических данных;
  • данные могут использоваться многократно (без постоянного извлечения их из источников);
  • быстрая загрузка данных в отчеты по защищенным каналам при работе с Power BI без необходимости использования шлюзов, за счет использования Azure;
  • возможность работы в Power BI как через DirectQuery, так и через импорт данных;
  • представления, создаваемые сервисом, имеют русские названия, что облегчает работу с ними в Power BI;
  • аналитическая структура базы данных позволяет формировать единую модель данных для множества источников за счет общих таблиц измерений.
Не пропускайте новости
Получать новости
Спасибо за подписку!

Мы уже отправили вам первое письмо с подборкой лучших материалов

Полезные кейсы, статьи и исследования от экспертов UIS
Подписаться
Вы успешно подписаны на новости!
Спасибо за обращение
Понятно