Разбирайте источники установок и качество трафика в чате

Агент ходит в API AppMetrica под OAuth-токеном Яндекса: сначала забирает список приложений кабинета через management/v1/applications, затем снимает отчёты Reporting API — установки, сессии, активные устройства, кастомные события, краши и выручку — в разрезах по партнёрам и источникам трафика, версиям приложения, ОС, моделям устройств и странам. Поверх этого считаются ARPU и retention, а каналы сравниваются по платящим пользователям, а не по объёму установок.

Сырые данные AppMetrica отдаёт иначе, чем отчёты: Logs API готовит выгрузку асинхронно — первый запрос ставит задачу, а файл приезжает только после подготовки, поэтому агент повторяет обращение до готовности. Пагинации там нет, так что длинный период он режет на куски по датам и склеивает построчные установки, кастомные события и краши сам. Так собирается разрез, которого в отчётах кабинета нет.

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

Подключение идёт входом в аккаунт Яндекса по коду: токен агент получает и продлевает сам, копировать ключи вручную не нужно. Отчёты AppMetrica досчитывает не мгновенно — последние часы ещё догружаются, поэтому агент называет дату среза рядом с цифрами и не выдаёт неполные сутки за итог. Частоту запросов он выдерживает сам, а если данных за период нет — так и говорит, а не показывает пустую таблицу.