Renta / Документация / Источники / AppMetrica Logs API

AppMetrica Logs API

AppMetrica Logs API отдаёт сырые строки, из которых собираются отчёты: одну установку или одно событие e-commerce в строке, вместе с идентификаторами устройства и метками времени.

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

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

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

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

Выполните эти шаги, чтобы добавить AppMetrica Logs API как источник в Renta через OAuth-аутентификацию.

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

Соседняя карточка AppMetrica относится к другому источнику. Он выгружает агрегированные отчёты, построенные из измерений и метрик, а не сырые строки.

Карточка AppMetrica Logs API в категории Analytics каталога источников Renta
Авторизуйте подключениеStep 2

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

Страница авторизации нового подключения AppMetrica Logs API в Renta
Выберите аккаунт ЯндексаStep 3

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

Страница входа Яндекса с выбором аккаунта и списком запрашиваемых Renta разрешений
Задайте имя подключения и сохранитеStep 4

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

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

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

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

Настройка подключения AppMetrica Logs API с полем имени источника и блоком предоставленного доступа
Источник созданStep 5

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

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

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

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

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

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

Шаг выбора источника с AppMetrica Logs API в блоке Already connected
Выберите подключение AppMetrica Logs APIStep 2

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

Шаг выбора подключения AppMetrica Logs API с подключённым аккаунтом Яндекса
Выберите назначениеStep 3

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

Шаг выбора назначения с Google BigQuery в блоке Already connected
Выберите подключение назначенияStep 4

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

Шаг выбора подключения Google BigQuery с идентификаторами датасета и проекта

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

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

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

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

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

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

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

    Тип отчётаЧто содержит одна строка
    Installation report (установки)Одну установку: метки времени установки и клика, блок атрибуции (трекер, кампания, площадка, тип сопоставления, признаки реатрибуции и переустановки), идентификаторы устройства и атрибуты устройства, сети, географии и приложения.
    E-commerce report (события e-commerce)Одно событие e-commerce: его тип и атрибуты экрана, товара, корзины, заказа и источника перехода, вместе с идентификацией события, идентификаторами устройства и атрибутами устройства, сети, географии и приложения.

Параметры

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

Выбор параметров AppMetrica Logs API с плоским списком полей, кнопкой Select All и списком Selected Parameters

Список Parameters представляет собой один плоский перечень полей, доступных для выбранного типа отчёта, названных ровно так, как они называются в Logs API: installation_id, appmetrica_device_id, ecom_product_sku. Отметьте поля для выгрузки, найдите поле по названию через поиск или нажмите Select All. Вкладка Selected показывает всё выбранное, а список Selected Parameters под выбором позволяет удалить поле кнопкой с минусом.

Выберите хотя бы одно поле: пайплайн с пустым списком Parameters создать нельзя.

В списке отчёта Installation report есть атрибуция (tracker_name, publisher_name, click_datetime, attributed_touch_type, is_reattribution), метки времени установки, идентификаторы устройства (appmetrica_device_id, google_aid, ios_ifa, oaid), а также атрибуты устройства, сети, географии и приложения.

Список отчёта E-commerce report построен вокруг воронки: тип события в поле ecom_type, затем поля экрана, товара, корзины и заказа, плюс идентификация события (event_name, event_datetime, session_id) и те же атрибуты устройства и приложения.

В таблице назначения имена колонок повторяют имена полей Logs API как есть. В Google BigQuery Renta дополнительно переносит описание каждого поля в описание соответствующей колонки.

Параметры даты

В списке также есть поля дат, которые вычисляет Renta: Date и Today, а также календарные поля Year, Quarter, Month, Week, Day of week и другие. Renta выводит их из даты установки в отчёте Installation report и из даты события в отчёте E-commerce report.

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

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

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

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

Оставьте в поле Date end значение Yesterday. События попадают в Logs API с задержкой, поэтому выгрузка, захватывающая текущий день, вернёт его неполным, а запуск запишет частичный день как окончательный.

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

Overwrite period

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

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

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

Расписание

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

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

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

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

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

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

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

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

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

СтратегияПоддерживаемые типы отчётовОписание
Инкрементальное обновлениеInstallation report, E-commerce report (с выбранным параметром Date или Today)Каждая строка несёт свою дату, и таблица назначения партиционируется по колонке date. При каждом запуске Renta запрашивает окно от даты последнего успешного запуска минус период перезаписи до конца диапазона дат: затронутые дневные партиции удаляются и вставляются заново, а более ранние партиции остаются нетронутыми.
Полная перезагрузкаInstallation report, E-commerce report (без параметра даты)В таблице нет колонки с датой, по которой можно партиционировать, поэтому 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.