Чем этот источник отличается от источника AppMetrica Logs API?

Этот источник выгружает агрегированные отчёты: одна строка на каждое сочетание выбранных измерений, а в колонках метрик лежат количества и суммы. Источник AppMetrica Logs API выгружает сырые строки, где каждая строка соответствует отдельному событию или отдельной установке. Используйте этот источник для готовой статистики, а Logs API тогда, когда нужны данные на уровне событий, чтобы строить собственные агрегаты.

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

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

В каком часовом поясе указаны даты?

AppMetrica фиксирует события в часовом поясе, заданном для приложения, в разделе **Settings** > **Main** > **Time zone UTC** в интерфейсе AppMetrica. Renta даты не пересчитывает, поэтому значения в таблице назначения следуют этой настройке.

Почему цифры за последние дни меняются после первой загрузки?

AppMetrica относит установку к дате первого открытия приложения, но продолжает сопоставлять её с кликом ещё 10 дней после клика, а в зависимости от настроек трекера до 30 дней. Поэтому данные по кампаниям и площадкам за прошедшие даты продолжают уточняться. События, отправленные сверх дневного лимита, тоже буферизуются и записываются позже. Задайте **Overwrite period** так, чтобы он покрывал дни, которые могут измениться.

Применяет ли AppMetrica сэмплирование?

AppMetrica может применить сэмплирование на своей стороне, когда отчёт охватывает большое число пользователей. Решение о выборке принимает AppMetrica, в настройках Renta это не регулируется.

AppMetrica

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

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

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

Ваши учётные данные шифруются при передаче и хранении и не сохраняются в прикладной базе данных Renta. Вы сохраняете контроль и можете отозвать доступ в настройках аккаунта Яндекса в любой момент.

Подключение источника AppMetrica

Перейдите в каталогStep 1

Откройте раздел Connections > Catalog в левом меню.
Откройте категорию Analytics и нажмите карточку AppMetrica.

Соседняя карточка AppMetrica Logs API относится к другому источнику. Он выгружает сырые строки событий и установок вместо агрегированных отчётов.

Карточка AppMetrica в категории Analytics каталога источников Renta

Авторизуйте подключениеStep 2

Нажмите Log in to your Appmetrica account. Вы будете перенаправлены на страницу Яндекса для предоставления доступа.

Страница авторизации нового подключения AppMetrica в Renta

Выберите аккаунт ЯндексаStep 3

Яндекс покажет экран входа со списком разрешений, которые запрашивает Renta, включая доступ к статистике ваших приложений в AppMetrica. Выберите аккаунт, у которого есть доступ к нужным приложениям, и подтвердите. После этого вы вернётесь в Renta.

Страница входа Яндекса с выбором аккаунта и списком запрашиваемых Renta разрешений

Задайте имя подключения и сохранитеStep 4

Завершите настройку:

Source name.
Укажите имя источника данных. Оно используется только в интерфейсе Renta.
Access granted.
Убедитесь, что аккаунт подключён успешно.

Нажмите Save, чтобы завершить.

Если авторизация в Яндексе позже изменится (например, после смены пароля), нажмите Re-authorize у этого источника. Подключение обновится на месте, и все построенные на нём пайплайны продолжат работать.

Настройка подключения AppMetrica с полем имени источника и блоком предоставленного доступа

Источник созданStep 5

Новый источник появится в списке Sources со статусом Active. Теперь его можно использовать в пайплайнах.

Список источников с новым источником AppMetrica в статусе Active

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

Свяжите источник AppMetrica с назначением и настройте пайплайн.

Выберите AppMetrica в качестве источникаStep 1

В левом меню нажмите New pipeline. На шаге Source выберите AppMetrica в блоке Already connected и нажмите Next step.

Шаг выбора источника с AppMetrica в блоке Already connected

Выберите подключение AppMetricaStep 2

Выберите созданное ранее подключение AppMetrica и нажмите Next step.

Выберите назначениеStep 3

На шаге Destination выберите назначение (например, Google BigQuery) и нажмите Next step.

Выберите подключение назначенияStep 4

Выберите подключение назначения, куда нужно загружать данные, и нажмите Next step.

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

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

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

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

Выбор приложения AppMetrica и типа отчёта на шаге настройки пайплайна

Counters Выберите приложение, из которого выгружаются данные. В списке перечислены приложения, доступные подключённому аккаунту Яндекса, по их названиям. Один пайплайн выгружает одно приложение.

Report Types Выберите тип выгружаемой статистики. Один пайплайн выгружает один тип отчёта.

Тип отчёта	Что показывает	Метрики
General events (активность в приложении)	Активность внутри приложения в разрезе атрибутов приложения и устройства: версия приложения, тип устройства, операционная система, разрешение экрана и география.	Users, Sessions, Devices
Custom events (свои события)	События, которые вы отправляете из приложения сами, с теми же атрибутами приложения и устройства плюс метка события. Параметры, приложенные к событию, доступны средними значениями и суммами.	Users, Sessions, Devices, Client Events, Average Parameters, Sum Parameters
Campaigns (клики по трекерам)	Клики по трекерам в разрезе кампаний и площадок: сколько трафика привёл каждый источник привлечения.	Clicks
Installs (установки)	Атрибутированные установки в разрезе кампаний и площадок: из каких источников привлечения пришли установки.	Install Devices

Параметры

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

Выбор параметров AppMetrica со вкладкой Dimensions, отмеченными измерениями кампаний и площадок и списком Selected Parameters

Тип отчёта

Поиск

Dimensions31Metrics3

Название	Имя в API	Описание
App Version text	`ym:ge:appVersion`	The version of the application.
App Version and OS text	`ym:ge:appVersionAndOS`	Combination of app version and operating system.
Build Number text	`ym:ge:buildNumber`	The build number of the application.
App ID text	`ym:ge:appID`	The unique identifier for the application.
Operating System Version text	`ym:ge:operatingSystemVersion`	The version of the operating system on the device.
Mobile Device Branding text	`ym:ge:mobileDeviceBranding`	The branding of the mobile device.
Mobile Device Model text	`ym:ge:mobileDeviceModel`	The model of the mobile device.
Device Type text	`ym:ge:deviceType`	The type of device (e.g., smartphone, tablet).
iOS IDFA text	`ym:ge:iosIDFA`	The Identifier for Advertisers on iOS devices.
Screen Resolution text	`ym:ge:screenResolution`	The screen resolution of the device.
Month text	`ym:ge:month`	The specific month of the event.
Year text	`ym:ge:year`	The specific year of the event.
Region text	`ym:ge:region`	The geographical region of the user.
Region Area text	`ym:ge:regionArea`	The area within the region.
Region City text	`ym:ge:regionCity`	The city within the region.
Region Country text	`ym:ge:regionCountry`	The country of the user.
Today date	`date_today`	Today's date
Year text	`year`	Year of the date
Year of week (Sun-Sat) text	`yearofweek`	Year of week for US weeks
Year of week (Mon-Sun) text	`yearofweekiso`	Year of week for ISO weeks
Year & month text	`yearmonth`	Year and month combined
Quarter text	`quarter`	Quarter of the year
Month text	`month`	Month of the year
Year & week (Sun-Sat) text	`yearweek`	Year and week for US weeks
Year & week (Mon-Sun) text	`yearweekiso`	Year and week for ISO weeks
Week (Sun-Sat) text	`week`	US week number
Week (Mon-Sun) text	`weekiso`	ISO week number
Day of week (Sun-Sat) text	`dayOfWeekName`	Day of week name for US weeks
Day of week text	`dayOfWeekNameIso`	Day of week name for ISO weeks (Mon-Sun)
Day of month text	`dayOfMonth`	Day of the month
Date date	`date`	Specific date

Название	Имя в API	Описание
Users int	`ym:ge:users`	The number of unique users.
Sessions int	`ym:ge:sessions`	The number of sessions.
Devices int	`ym:ge:devices`	The number of devices.

Dimensions32Metrics6

Название	Имя в API	Описание
App Version text	`ym:ce:appVersion`	The version of the application.
App Version and OS text	`ym:ce:appVersionAndOS`	Combination of app version and operating system.
Build Number text	`ym:ce:buildNumber`	The build number of the application.
App ID text	`ym:ce:appID`	The unique identifier for the application.
Operating System Version text	`ym:ce:operatingSystemVersion`	The version of the operating system on the device.
Mobile Device Branding text	`ym:ce:mobileDeviceBranding`	The branding of the mobile device.
Mobile Device Model text	`ym:ce:mobileDeviceModel`	The model of the mobile device.
Device Type text	`ym:ce:deviceType`	The type of device (e.g., smartphone, tablet).
iOS IDFA text	`ym:ce:iosIDFA`	The Identifier for Advertisers on iOS devices.
Screen Resolution text	`ym:ce:screenResolution`	The screen resolution of the device.
Event Label text	`ym:ce:eventLabel`	Label of the custom event.
Month text	`ym:ce:month`	The specific month of the event.
Year text	`ym:ce:year`	The specific year of the event.
Region text	`ym:ce:region`	The geographical region of the user.
Region Area text	`ym:ce:regionArea`	The area within the region.
Region City text	`ym:ce:regionCity`	The city within the region.
Region Country text	`ym:ce:regionCountry`	The country of the user.
Today date	`date_today`	Today's date
Year text	`year`	Year of the date
Year of week (Sun-Sat) text	`yearofweek`	Year of week for US weeks
Year of week (Mon-Sun) text	`yearofweekiso`	Year of week for ISO weeks
Year & month text	`yearmonth`	Year and month combined
Quarter text	`quarter`	Quarter of the year
Month text	`month`	Month of the year
Year & week (Sun-Sat) text	`yearweek`	Year and week for US weeks
Year & week (Mon-Sun) text	`yearweekiso`	Year and week for ISO weeks
Week (Sun-Sat) text	`week`	US week number
Week (Mon-Sun) text	`weekiso`	ISO week number
Day of week (Sun-Sat) text	`dayOfWeekName`	Day of week name for US weeks
Day of week text	`dayOfWeekNameIso`	Day of week name for ISO weeks (Mon-Sun)
Day of month text	`dayOfMonth`	Day of the month
Date date	`date`	Specific date

Название	Имя в API	Описание
Users int	`ym:ce:users`	The number of unique users.
Sessions int	`ym:ce:sessions`	The number of sessions.
Devices int	`ym:ce:devices`	The number of devices.
Client Events int	`ym:ce:clientEvents`	The number of client-side events.
Average Parameters float	`ym:ce:avgParams`	Average value of event parameters.
Sum Parameters int	`ym:ce:sumParams`	Sum of event parameters.

Dimensions19Metrics1

Название	Имя в API	Описание
Campaign text	`ym:c:campaign`	The name of the marketing campaign.
Publisher ID text	`ym:c:publisherID`	The unique identifier of the publisher.
Publisher Name text	`ym:c:publisherName`	The name of the publisher.
Publisher text	`ym:c:publisher`	The publisher associated with the campaign.
Today date	`date_today`	Today's date
Year text	`year`	Year of the date
Year of week (Sun-Sat) text	`yearofweek`	Year of week for US weeks
Year of week (Mon-Sun) text	`yearofweekiso`	Year of week for ISO weeks
Year & month text	`yearmonth`	Year and month combined
Quarter text	`quarter`	Quarter of the year
Month text	`month`	Month of the year
Year & week (Sun-Sat) text	`yearweek`	Year and week for US weeks
Year & week (Mon-Sun) text	`yearweekiso`	Year and week for ISO weeks
Week (Sun-Sat) text	`week`	US week number
Week (Mon-Sun) text	`weekiso`	ISO week number
Day of week (Sun-Sat) text	`dayOfWeekName`	Day of week name for US weeks
Day of week text	`dayOfWeekNameIso`	Day of week name for ISO weeks (Mon-Sun)
Day of month text	`dayOfMonth`	Day of the month
Date date	`date`	Specific date

Название	Имя в API	Описание
Clicks int	`ym:c:clicks`	The number of clicks generated by the campaign.

Dimensions19Metrics1

Название	Имя в API	Описание
Campaign text	`ym:i:campaign`	The marketing campaign that led to the app install.
Publisher ID text	`ym:i:publisherID`	The unique identifier of the publisher responsible for the app install.
Publisher Name text	`ym:i:publisherName`	The name of the publisher responsible for the app install.
Publisher text	`ym:i:publisher`	The publisher associated with the app install campaign.
Today date	`date_today`	Today's date
Year text	`year`	Year of the date
Year of week (Sun-Sat) text	`yearofweek`	Year of week for US weeks
Year of week (Mon-Sun) text	`yearofweekiso`	Year of week for ISO weeks
Year & month text	`yearmonth`	Year and month combined
Quarter text	`quarter`	Quarter of the year
Month text	`month`	Month of the year
Year & week (Sun-Sat) text	`yearweek`	Year and week for US weeks
Year & week (Mon-Sun) text	`yearweekiso`	Year and week for ISO weeks
Week (Sun-Sat) text	`week`	US week number
Week (Mon-Sun) text	`weekiso`	ISO week number
Day of week (Sun-Sat) text	`dayOfWeekName`	Day of week name for US weeks
Day of week text	`dayOfWeekNameIso`	Day of week name for ISO weeks (Mon-Sun)
Day of month text	`dayOfMonth`	Day of the month
Date date	`date`	Specific date

Название	Имя в API	Описание
Install Devices int	`ym:i:installDevices`	The number of devices on which the app was installed.

Название	Имя в API	Описание
Crash Dump Object array_text	`ym:cr:crashDumpObj`	The object containing detailed information about a crash.
Today date	`date_today`	Today's date
Year text	`year`	Year of the date
Year of week (Sun-Sat) text	`yearofweek`	Year of week for US weeks
Year of week (Mon-Sun) text	`yearofweekiso`	Year of week for ISO weeks
Year & month text	`yearmonth`	Year and month combined
Quarter text	`quarter`	Quarter of the year
Month text	`month`	Month of the year
Year & week (Sun-Sat) text	`yearweek`	Year and week for US weeks
Year & week (Mon-Sun) text	`yearweekiso`	Year and week for ISO weeks
Week (Sun-Sat) text	`week`	US week number
Week (Mon-Sun) text	`weekiso`	ISO week number
Day of week (Sun-Sat) text	`dayOfWeekName`	Day of week name for US weeks
Day of week text	`dayOfWeekNameIso`	Day of week name for ISO weeks (Mon-Sun)
Day of month text	`dayOfMonth`	Day of the month
Date date	`date`	Specific date

Название	Имя в API	Описание
Year text	`ym:s:year`	The year when the session occurred.
Month text	`ym:s:month`	The month when the session occurred.
Today date	`date_today`	Today's date
Year text	`year`	Year of the date
Year of week (Sun-Sat) text	`yearofweek`	Year of week for US weeks
Year of week (Mon-Sun) text	`yearofweekiso`	Year of week for ISO weeks
Year & month text	`yearmonth`	Year and month combined
Quarter text	`quarter`	Quarter of the year
Month text	`month`	Month of the year
Year & week (Sun-Sat) text	`yearweek`	Year and week for US weeks
Year & week (Mon-Sun) text	`yearweekiso`	Year and week for ISO weeks
Week (Sun-Sat) text	`week`	US week number
Week (Mon-Sun) text	`weekiso`	ISO week number
Day of week (Sun-Sat) text	`dayOfWeekName`	Day of week name for US weeks
Day of week text	`dayOfWeekNameIso`	Day of week name for ISO weeks (Mon-Sun)
Day of month text	`dayOfMonth`	Day of the month
Date date	`date`	Specific date

Dimensions.
Атрибуты, по которым группируются строки. Под каждым названием показано имя параметра в API: под Campaign значится ym:i:campaign.
Metrics.
Числовые колонки. Выберите хотя бы одну метрику: отчёту без метрик нечего считать, и AppMetrica его отклонит.

Unselect All очищает выбор, а вкладка Selected показывает текущий набор.

В таблице назначения имена колонок повторяют имена параметров в 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 вычисляет из даты события и сама добавляет дату в отчёт, когда вы выбираете одно из них.

Включайте в отчёт параметр Date. С ним таблица назначения партиционируется по колонке date, а Renta загружает данные инкрементально. Он же включает настройку Overwrite period, которая появляется под диапазоном дат после выбора параметра даты. Без него Renta перезагружает весь диапазон дат при каждом запуске.

У отчётов Campaigns и Installs параметров даты нет вовсе. В их таблицах не будет колонки с датой, поэтому каждый запуск перезагружает весь диапазон. Используйте эти отчёты для итогов за выбранный период, а разбивку привлечения по дням берите из отчёта General events.

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

Задайте имя пайплайна и исторический период загрузки.

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

AppMetrica ограничивает аккаунт Яндекса 5000 запросов к отчётам в сутки, и лимит считается по всем пайплайнам этого аккаунта. Если одновременно загружать многолетнюю историю в нескольких пайплайнах, AppMetrica ответит ошибкой Too Many Requests. Загружайте длинную историю частями или дождитесь сброса квоты.

Overwrite period

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

При каждом запуске Renta заново запрашивает данные начиная с даты последнего успешного запуска минус период перезаписи. Затронутые дни удаляются из таблицы назначения и вставляются заново, а более ранние данные остаются нетронутыми.

AppMetrica сопоставляет установки с кликами ещё 10 дней после клика, а в зависимости от настроек трекера до 30 дней, поэтому данные по привлечению за прошедшие даты продолжают меняться. Задайте период перезаписи так, чтобы он покрывал используемое окно атрибуции.

Расписание

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

Выбор типа расписания AppMetrica с выбранным вариантом Daily

Тип расписания	Описание
Manual	Пайплайн запускается только вручную через интерфейс или по API.
Daily	Пайплайн запускается раз в сутки в указанное время обновления.
Interval	Пайплайн запускается через заданные интервалы времени.
Cron Expression	Пайплайн запускается по расписанию, заданному cron-выражением.

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

Выбор времени обновления AppMetrica и кнопка Create pipeline

Renta также поддерживает запуск по API и интеграцию с внешними оркестраторами, такими как Apache Airflow, Dagster и Prefect. Подробности в документации по расписаниям.

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

Список пайплайнов с новой интеграцией AppMetrica в статусе Completed

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

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

Стратегия	Поддерживаемые типы отчётов	Описание
Инкрементальное обновление	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.