 |
Roistat — российская платформа бизнес-аналитики с широкими возможностями для анализа данных и большим количеством сопутствующих инструментов. В этой статье мы рассмотрим функционал mybi connect для получения данных этого источника.
API Roistat позволяет выгружать статистику и решать множество других задач.
Возможность подключения новых источников отключена из-за нестабильной работы API сервиса Roistat
Для того, чтобы получать данные с помощью API, в первую очередь, необходимо получить ключ для доступа. Для этого в кабинете Roistat откройте страницу “API”:
Необходимо скопировать секретный API ключ в буфер обмена.
Вторым шагом будет настройка выгрузки уже в самом сервисе mybi connect.
Для того, чтобы добавить новый источник данных, в интерфейсе mybi connect необходимо в левом боковом меню сервиса выбрать пункт “Источники данных” и нажать на кнопку “Добавить новый+”, после чего перейти в раздел “СЧЕТЧИКИ ПОСЕЩАЕМОСТИ САЙТА” и выбрать источник Roistat, нажав на кнопку “Подключить”:
В открывшейся форме необходимо заполнить поля настройки источника:
Поле “Название источника” может быть любым и необходимо для того, чтобы вы могли однозначно идентифицировать этот источник среди других. В поле “ключ доступа” необходимо вставить скопированный ранее в Roistat ключ. Если авторизационные данные верны, в следующей форме выберите проект, по которому необходимо выгружать данные.
После ввода всех необходимых данных необходимо завершить настройку источника, нажав на кнопку “Продолжить”.
Базовая выгрузка
После завершения подключения в таблице “Источники” появится новый источник данных с указанным в ходе настройки названием. Если вы используете Триал, то автоматически запустится выгрузка данных за 2 последних дня и вы можете сразу перейти к просмотру данных в БД. Далее для запуска исторической загрузки данных за нужный период выберите в колонке “Действия” в строке добавленного источника пункт меню “Загрузить”:
Обратите внимание, что период доступной исторической загрузки зависит от выбранных вами параметров тарифа, а для триального периода составляет 1 месяц.
По завершению загрузки в базе данных появятся сведения по посещениям сайта в специально спроектированном нами виде, наиболее удобном для дальнейшего анализа:
Более детально ознакомиться со структурой выгрузки вы можете здесь.
По умолчанию не выгружаются сведения по событиям. Если вам эти данные необходимы, или наоборот, в каких-то данных вы не нуждаетесь, вы можете воспользоваться функционалом по выбору необходимых таблиц и в настройках источника выбрать только те, в которые будут загружаться данные в процессе базовой выгрузки:
Это позволит вам как ограничить набор данных, так и в какой-то мере сэкономить количество расходуемых на выгрузку строк.
Кроме возможности выбора таблиц, в базовой выгрузке также существует функционал фильтрации, позволяющий ограничить данные, загружаемые в те или иные таблицы. Вот пример использования фильтра:
Этот фильтр позволяет не выгружать отмененные заказы.
На этом настройка источника Roistat закончена. В дальнейшем статистика по рекламе будет автоматически загружаться в базу данных, доступ к которой вы можете найти в разделе “Хранилище данных“.
Пользовательская выгрузка
Пользовательская выгрузка позволяет организовать загрузку произвольного набора полей с последующим автоматическим обновлением по текущий период. Кроме того, только при помощи пользовательской выгрузки можно получить полную статистику, так как в базовую выгрузку выгружаются только качественные визиты. Необходимым условием создания выгрузки является наличие настроенного источника. Для ее создания необходимо перейти в раздел “Планировщик заданий“, нажать на кнопку “Добавить новое+” и выбрать из списка «Выгрузка отчетов из Roistat». Далее на экране будет отображена форма с параметрами выгрузки:
В первой строке указываем произвольное название задания (длиной не более 64-х символов), затем выбираем необходимый источник данных (подключенный аккаунт Roistat).
Ниже необходимо выбрать набор показателей и параметров. Под показателями понимаются численные величины, под параметрами какие-либо описательные характеристики.
Также можно использовать фильтр, чтобы выгрузить не все данные, а только по нужным вам условиям. Весь список параметров и показателей, а также правила фильтрации вы можете посмотреть в документации Roistat.
По умолчанию загружаемые данные сохраняются в таблицу roistat_reports в формате JSON.
Если воспользоваться опцией “Зафиксировать структуру”, то в этом случае данные отчета будут выгружаться в отдельную таблицу в развернутом виде. Дополнительно в поле “Описание таблиц” можно добавить специальное правило, описывающие каким образом полученные сведения должны обрабатываться mybi connect. Это даст возможность пользователю сохранять данные в удобном виде и в указанных таблицах. Для завершения настройки пользовательской выгрузки необходимо нажать на кнопку “Продолжить”.
Добавив отчет в список заданий, его можно запустить для загрузки данных. Это можно сделать, отобразив меню “Выбрать” в колонке “Действия” напротив созданного отчета и выбрав пункт меню “Выполнить”:
После указания периода загрузки данные будут загружены в хранилище.
Удаление устаревших данных
Учитывая объем накапливаемых данных, а также наличие зависимости максимального объема хранимых данных от параметров тарифного плана, в некоторых случаях можно воспользоваться дополнительным заданием “Удаление устаревших данных“. Это задание позволяет удалять данные из хранилища, длительность хранения которых превышает количество дней, указанных при настройки задания. Для того, чтобы создать задание для удаления устаревших данных, необходимо перейти в раздел “Планировщик заданий“, нажать на кнопку “Добавить новое+”, выбрать из списка “Удаление устаревших данных”, далее будет отображена форма с параметрами задания:
Мы будем рады вашим вопросам и рациональным комментариям относительно функционала сервиса в чате нашего телеграм-канала @mybi connect