AppMetrica
AppMetrica делит статистику приложения на активность внутри него и привлечение пользователей через трекеры. Renta выгружает и то и другое агрегированной таблицей: вы выбираете один тип отчёта, а затем измерения и метрики, из которых складываются строки.
Аутентификация
Renta использует OAuth для аутентификации в Яндексе. Вы будете перенаправлены на страницу Яндекса, чтобы предоставить Renta ограниченный доступ к приложениям в AppMetrica.
Подключение источника AppMetrica
Выполните эти шаги, чтобы добавить AppMetrica как источник в Renta через OAuth-аутентификацию.
- Откройте раздел Connections > Catalog в левом меню.
- Откройте категорию Analytics и нажмите карточку AppMetrica.
Нажмите Log in to your Appmetrica account. Вы будете перенаправлены на страницу Яндекса для предоставления доступа.
Яндекс покажет экран входа со списком разрешений, которые запрашивает Renta, включая доступ к статистике ваших приложений в AppMetrica. Выберите аккаунт, у которого есть доступ к нужным приложениям, и подтвердите. После этого вы вернётесь в Renta.
Завершите настройку:
- Source name.
Укажите имя источника данных. Оно используется только в интерфейсе Renta. - Access granted.
Убедитесь, что аккаунт подключён успешно.
Нажмите Save, чтобы завершить.
Новый источник появится в списке Sources со статусом Active. Теперь его можно использовать в пайплайнах.
Создание пайплайна AppMetrica
Свяжите источник AppMetrica с назначением и настройте пайплайн.
В левом меню нажмите New pipeline. На шаге Source выберите AppMetrica в блоке Already connected и нажмите Next step.
Выберите созданное ранее подключение AppMetrica и нажмите Next step.
На шаге Destination выберите назначение (например, Google BigQuery) и нажмите Next step.
Выберите подключение назначения, куда нужно загружать данные, и нажмите Next step.
Настройка пайплайна
На последнем шаге выберите, какие данные AppMetrica выгружать и как Renta будет их загружать.
Настройка отчёта
Укажите приложение и выберите тип отчёта.
-
Counters Выберите приложение, из которого выгружаются данные. В списке перечислены приложения, доступные подключённому акка унту Яндекса, по их названиям. Один пайплайн выгружает одно приложение.
-
Report Types Выберите тип выгружаемой статистики. Один пайплайн выгружает один тип отчёта.
Тип отчёта Что показывает Метрики General events (активность в приложении) Активность внутри приложения в разрезе атрибутов приложения и устройства: версия приложения, тип устройства, операционная система, разрешение экрана и география. Users, Sessions, Devices Custom events (свои события) События, которые вы отправляете из приложения сами, с теми же атрибутами приложения и устройства плюс метка события. Параметры, приложенные к событию, доступны средними значениями и суммами. Users, Sessions, Devices, Client Events, Average Parameters, Sum Parameters Campaigns (клики по трекерам) Клики по трекерам в разрезе кампаний и площадок: сколько трафика привёл каждый источник привлечения. Clicks Installs (установки) Атрибутированные установки в разрезе кампаний и площадок: из каких источников привлечения пришли установки. Install Devices
Параметры
Выберите измерения и метрики, которые попадут в таблицу назначения. Схема набора данных определяется выбранными здесь параметрами.
- Dimensions.
Атрибуты, по которым группируются строки. Под каждым названием показано имя параметра в API: под Campaign значитсяym:i:campaign. - Metrics.
Числовые колонки. Выберите хотя бы одну метрику: отчёту без метрик нечего считать, и AppMetrica его отклонит.
Ищите параметр по названию через поле поиска или нажмите Unselect All, чтобы очистить выбор. Вкладка Selected показывает всё выбранное, а список Selected Parameters под выбором позволяет удалить параметр кнопкой с минусом.
В таблице назначения имена колонок повторяют имена параметров в API без префиксов ym:ge:, ym:ce:, ym:c: и ym:i:: ym:ge:appVersion становится appVersion. Описание каждого параметра Renta переносит в описание соответствующей колонки.
Параметры даты
Во вкладке Dimensions отчётов General events и Custom events есть поля дат: Date и Today, а также календарные поля Year, Quarter, Month, Week, Day of week и другие. Календарные поля Renta вычисляет из даты события и сама добавляет дату в отчёт, когда вы выбираете одно из них.
Имя таблицы и диапазон дат
Задайте имя пайплайна и исторический период загрузки.
- Integration name.
Имя пайплайна. Используется только в интерфейсе Renta. - Table name.
Имя таблицы в назначении. Можно оставить сгенерированное имя или задать своё. - Date start.
Первая дата периода выгрузки. - Date end.
Последняя дата периода выгрузки. Можно указать фиксированную дату или относительный вариант, например Today.
Overwrite period
Overwrite period задаёт, сколько последних дней Renta перезагружает при каждом запуске. Настройка появляется после того, как в разделе Parameters выбран параметр даты.
При каждом запуске Renta заново запрашивает данные начиная с даты последнего успешного запуска минус период перезаписи. Затронутые дни удаляются из таблицы назначения и вставляются заново, а более ранние данные остаются нетронутыми.
Расписание
Выберите, как часто запускается пайплайн.
| Тип расписания | Описание |
|---|---|
| Manual | Пайплайн запускается только вручную через интерфейс или по API. |
| Daily | Пайплайн запускается раз в сутки в указанное время обновления. |
| Interval | Пайплайн запускается через заданные интервалы времени. |
| Cron Expression | Пайплайн запускается по расписанию, заданному cron-выражением. |
Для расписания Daily укажите Update time (точное время запуска), затем нажмите Create pipeline.
Новый пайплайн появится в разделе Pipelines на вкладке ETL, где можно отслеживать запуски, прогресс и имя таблицы назначения.
Стратегия синхронизации
Стратегия синхронизации зависит от того, включён ли в отчёт параметр даты.
| Стратегия | Поддерживаемые типы отчётов | Описание |
|---|---|---|
| Инкрементальное обновление | General events, Custom events (с выбранным параметром Date или Today) | Каждая строка несёт свою дату, и табли ца назначения партиционируется по этой колонке. При каждом запуске Renta запрашивает окно от даты последнего успешного запуска минус период перезаписи до конца диапазона дат: затронутые дневные партиции удаляются и вставляются заново, а более ранние партиции остаются нетронутыми. |
| Полная перезагрузка | Campaigns, Installs, а также General events и Custom events, когда параметр даты не выбран | В отчёте нет колонки с датой, по которой можно партиционировать, поэтому Renta запрашивает весь заданный диапазон дат и заменяет набор данных при каждом запуске. |
Ready to get started?
Build your data pipeline today or get a personalized demo. Start free!
Need help?
Get expert support to ensure your project succeeds. We're here to help!
Feature requests?
Help shape our product! Share your ideas for new features and integrations.