View on GitHub

PQYandexMetrica

Неофициальный, открытый коннектор для выгрузки данных из Reporting API Яндекс.Метрики в Power BI и Excel, скрипт на языке Power Query

Оглавление

Быстрый старт использования PQYandexMetrica для Power BI (pbix)

  1. Скачиваем последнюю версию PBIX файла по ссылке
  2. Открываем файл. Переходим в настройки Power BI => Конфиденциальность => Уровни Конфиденциальности => Всегда игнорировать параметры уровней конфиденциальности => Privacy => Privacy Levels => Always Ignore Privacy Level settings
  3. Переходим по ссылке, жмем кнопку “разрешить”, копируем предоставленный токен, он понадобится нам дальше
  4. Возвращаемся в Power BI, жмем на кнопку “Изменить запросы” “Edit Queries”
  5. В окне с запросами слева выбираем функцию PQYM, заполняем все поля необходиыми настройками, жмем кнопку “Вызвать”
  6. Должно появиться окно с выбором настроек доступа. Оставляем настройки по умолчанию - анонимный доступ и жмем на кнопку подключение
  7. Если все настройки произведены правильно, то новый запрос должен отобразить полученную из Яндекс.Метрики таблицу с данными.

Видео из курса Максим Уварова Power BI для интернет-маркетинга

Термины Яндекс.Метрики. Базовая настройка PQYandexMetrica

Группировка (dimension) — это атрибут визита или хита, по которому можно сгруппировать данные.

В запросах к API группировки задаются в параметре dimensions. Если необходимо указать несколько группировок, перечислите их через запятую.

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

Метрика (metric) — числовая величина, которая рассчитывается на основе атрибута хита или визита.

В запросах к API метрики задаются в параметре metrics. Если необходимо указать несколько метрик, перечислите их через запятую.

Неполный список группировок и метрик есть в справке Яндекс.Метрики.

Расширенный список доступных измерений и метрик полученных по api в Excel Online или Google Spreadsheets.

API поддерживает три типа группировок и метрик:

В одном запросе нельзя использовать разные префиксы, а также указывать больше одного множества (см. раздел Множества и отношения).

Даты для получения отчетов можно задавать:

PQYandexMetrica поддерживает использование фильтров. Правила работы с фильтрами в api приведены в справке Яндекс.Метрики

Получение статистики по достижениям целей

В API Яндекс.Метрики есть следующие метрики, относящиеся к целям:

В перечисленных метриках <goal_id> нужно заменить на id запрашиваемой цели. Этот id можно найти на странице настройка счетчика, на вкладке цели (см скриншот)

Вот справка на параметризацию запросов в метрике.

Задание модели атрибуции в выгрузке

Атрибуцию в соответствующих группировках (например, в группировке ym:s:<attribution>TrafficSource) можно задавать при помощи слов:

Вот справка на параметризацию запросов в метрике.

Выгрузка данных по расходам Яндекс.Директ из api Яндекс.Метрики

Если вы хотите выгружать из метрики данные по рекламным сущностям - у них стоит приставка ym:ad: (например, по расходам в Яндекс.Директ ym:ad:<currency>AdCost), то вам потребуется заполнить поле direct_ids (это числовой id вашего рекламного кабинет в Яндекс.Директ). Получить список id рекламных кабинетов, доступных для конкретного счетчика, вы сможете используя функцию GetDirectIDs.

Копирование запросов между PBIX и XLSX файлами

Запросы в Power Query можно копировать между PBIX и XLSX файлами. Для этого надо открыть Power Query, в правой панели выбрать интересующие запросы (несколько запросов можно выбрать зажав клавишу ctrl). После того как запрос скопирован в буфер обмена вы можете его вставить в Power Query в Excel или Power BI.

Отзыв токена Яндекс.Метрики

В случае, если есть подозрение, что ваш токен попал в чужие руки, вы всегда можете отозвать старый токен по ссылке: https://passport.yandex.ru/profile/access

Видео мастер-класса Максима Уварова на вебмастерской конференции

Примеры отчетов

В примерах ниже приведены конфигурации действующих отчетов проекта с активным токеном. Не забудьте изменить токен и id счетчика, если захотите получить подобный отчет для своего проекта.

Обозначение параметров по порядку:

= PQYM (ids , metrics, dimensions, date1, date2, token, filters, direct_ids) 

Все параметры передаются как Text. При перечислении ids, metrics, dimensions, filters, direct_ids - если внутри параметра используется несколько сущностей (например, несколько группировок), то они передаются через запятую, без пробелов.

Отчет 1

С фильтром по переходам из Поисковых Систем (последний значимый источник), со статистикой по количеству визитов, средней длительностью визита и абсолютным числом отказов за период с 1 января 2019 года по вчера.

= PQYM("21781912", 
    "ym:s:visits,ym:s:avgVisitDuration,ym:s:bounces", 
    "ym:s:date,ym:s:lastsignTrafficSource", 
    "2019-01-01", 
    "yesterday", 
    "AQAAAAAQy8J1AAPquhq4JeyqQE6ygfUNoMnGr8E", 
    "ym:s:lastsignTrafficSourceName=='Переходы из поисковых систем'", 
    null)

Отчет 2

Отчет по адресам страниц, со статистикой по количеству просмотров и пользователей, посетивших страницу за последние 365 дней (по вчера).

= PQYM("21781912", 
    "ym:pv:pageviews,ym:pv:users", 
    "ym:pv:URLPath", 
    "365daysAgo", 
    "1daysAgo", 
    "AQAAAAAQy8J1AAPquhq4JeyqQE6ygfUNoMnGr8E", 
    null, 
    null)

Отказ от ответственности (disclaimer)

Программа создавалась для собственного пользования и распространяется по доброте душевной в состоянии как есть (под лицензией GPLv3 http://s.40-02.ru/1DHW9dz). Автор не несет ответственности за ущерб, который можно получить при использовании данной програмы. Если у вас появилось желание сказать спасибо за данную программу, можете написать автору на pqyandexmetrika@40-02.com.

Полезные ссылки

  1. Скачать надстройку Power Query для Excel 2010 и 2013
  2. PQGoogleAnalytics, проект на гитхабе
  3. Справка по api Яндекс.Метрики
  4. Правила работы с фильтрами в api
  5. Неполный список измерений и метрик в api в справке метрики
  6. Расширенный список доступных измерений и метрик полученных по api в Excel Online или Google Spreadsheets
  7. Статья в marketing-wiki об использовании коннектора

update