Yandex Metrica

Renta позволяет выгружать агрегированные отчёты Yandex Metrica в хранилище данных: статистику сессий и просмотров страниц, построенную из выбранных вами измерений, метрик и целей, включая источники трафика, UTM-метки, атрибуты устройств и географии, доход e-commerce и конверсии по целям.

Аутентификация

Renta использует OAuth для аутентификации в Яндексе. Вы будете перенаправлены на страницу Яндекса, чтобы предоставить Renta ограниченный доступ к счётчикам Yandex Metrica.

Создание пайплайна

После подключения источника создайте пайплайн, чтобы выгружать данные Yandex Metrica в хранилище.

Настройка пайплайна

На последнем шаге выберите, какие данные Yandex Metrica выгружать и как Renta будет их загружать.

Настройка отчёта

Укажите счётчик и выберите тип отчёта.

1. Ad accounts.
   Выберите счётчик Yandex Metrica, из которого выгружать данные. В списке показаны счётчики, доступные подключённому аккаунту Яндекса, по имени сайта.
2. Report Types.
   Выберите тип статистики для выгрузки.

Параметры

Выберите измерения, метрики и цели, которые попадут в таблицу назначения. Схема таблицы определяется выбранными здесь параметрами.

Список разбит на вкладки Dimensions, Metrics и Goals: более 300 измерений и около 200 метрик для отчёта Sessions, более 100 измерений и 9 метрик для отчёта Pageviews. Отметьте нужные параметры, найдите параметр по имени через поиск или нажмите Select All. Вкладка Selected показывает всё выбранное, а список Selected Parameters под пикером позволяет удалить параметр.

Вкладка Dimensions также содержит поля дат, которые Renta вычисляет из даты сессии или просмотра: год, квартал, месяц, неделя и поля дней. Если выбрано вычисляемое поле даты, Renta автоматически добавляет дату в отчёт.

Вкладка Goals появляется для отчёта Sessions. Renta загружает цели выбранного счётчика и предлагает метрики по каждой цели: коэффициент конверсии, коэффициент конверсии посетителей, целевые посетители, целевые визиты, достижения цели, достижения на посетителя и доход по цели. Для составных целей тот же набор метрик доступен по каждому шагу.

Измерения, зависящие от модели атрибуции (источники трафика, UTM-метки и данные кликов Яндекс Директа), показаны в списке отдельными вариантами для каждой модели: последний значимый источник, первый источник, последний источник, последний клик из Директа, кросс-девайс варианты и автоматическая. Выбирайте варианты той модели атрибуции, которую используете.

В таблице назначения имена колонок повторяют API-имена параметров без префиксов ym:s: и ym:pv:: ym:s:visits становится visits. Метрики дохода выгружаются в валюте счётчика, код валюты из имени колонки убирается. Также Renta добавляет в каждую строку колонку counter_id.

Имя таблицы и диапазон дат

Назовите пайплайн и задайте исторический период загрузки.

1. Integration name.
   Имя пайплайна. Используется только в интерфейсе Renta.
2. Table name.
   Имя таблицы в назначении. Можно оставить автоматически сгенерированное имя или задать своё.
3. Date start.
   Первая дата периода выгрузки.
4. Date end.
   Последняя дата периода выгрузки. Можно выбрать фиксированную дату или относительный вариант, например Today.

Период перезаписи

Период перезаписи определяет, сколько последних дней Renta перезагружает при каждом запуске. Настройка появляется после выбора параметра Date.

При каждом запуске Renta заново выгружает данные начиная с даты последнего успешного запуска минус период перезаписи. Затронутые дни удаляются из таблицы назначения и вставляются заново, более старые данные не затрагиваются. Варианты: от Without overwrite data до Overwrite all data; по умолчанию Last 1 day.

Расписание

Выберите, как часто будет запускаться пайплайн.

Для расписания Daily задайте Update time (точное время запуска), затем нажмите Create pipeline.

Новый пайплайн появится в разделе Pipelines на вкладке ETL, где можно отслеживать запуски, прогресс и имя таблицы назначения.

Как работает выгрузка

Renta строит отчёт через Reporting API по дням.

1. Renta определяет окно выгрузки: полный диапазон дат при первом запуске или инкрементальное окно при запусках по расписанию.
2. Для каждого дня окна Renta запрашивает отчёт с максимальной точностью Reporting API и читает ответ страницами по 10 000 строк. Загрузка по одному дню сохраняет выборку каждого запроса небольшой, поэтому сэмплирование почти не применяется.
3. Renta читает валюту из настроек счётчика и запрашивает метрики дохода в этой валюте.
4. Разобранные строки загружаются в таблицу назначения; каждая строка содержит counter_id счётчика, из которого она получена.

Стратегия синхронизации

Стратегия синхронизации зависит от того, включён ли в отчёт параметр Date.