# AppMetrica

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

Мобильная аналитика Яндекса — установки, сессии, события, краши, выручка, push-кампании

## Как агент работает с AppMetrica

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

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

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

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

## Сценарии интеграции

### Источники установок и качество трафика
Агент разложит установки и сессии по партнёрам и источникам, посчитает выручку и ARPU и покажет, какие каналы приводят платящих пользователей.

### Краши по версиям приложения
Агент соберёт краши и ошибки в разрезе версий, ОС и моделей устройств, посчитает задетые устройства и покажет, какой релиз ломает приложение.

### Ежедневная сводка по продукту
Агент подтянет активные устройства, сессии, retention и выручку за сутки и пришлёт короткую сводку в разрезе стран и версий приложения.

### Выгрузка сырых событий
Агент выгрузит через Logs API установки, кастомные события и краши построчно за период и сведёт их в разрез, которого нет в отчётах кабинета.

### Push-рассылка по группе
Агент заведёт группу push-кампании, покажет параметры и текст до отправки, отправит после подтверждения и перечитает статус — дошла рассылка или отвалилась.

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

## Как подключить

**Перед подключением**

- Аккаунт Яндекса с доступом к приложению в AppMetrica
- Уровень доступа «Только чтение» или выше, не агентский
- SDK в приложении инициализирован — иначе отчёты пустые

### Войдите нужным Яндекс ID
Откройте appmetrica.yandex.ru и войдите тем Яндекс ID, в чьём списке видно приложение. Код подтверждения нужно будет вводить под этим же логином.

### Проверьте, что приложение шлёт данные
Приложение должно быть в списке кабинета. Если его нет, заведите новое и отдайте разработчику API key из «Настройки» → «Основное».

### Выдайте логину доступ к приложению
Настройки приложения → «Управление доступом» → добавьте почту Яндекс ID. Отчётам хватит «Только чтение», push-кампаниям — «Чтение/редактирование».

### Не берите агентский уровень
«Агентство: чтение» показывает только выбранные источники трафика и целевые события, поэтому сводка по установкам, выручке и крашам придёт неполной.

### Настройте «Допускать неточные результаты»
«Настройки» → «Основное» → «Экспорт данных». Включённая опция отдаёт выгрузку при сбое части серверов, теряя менее 1% строк; выключенная ждёт всех.

## Частые вопросы

### Как подключить AppMetrica?
Входом в аккаунт Яндекса по коду: вы подтверждаете доступ, токен агент получает сам. Заранее проверьте, что этому логину в «Управление доступом» приложения выдан уровень «Только чтение» или выше — агентский уровень отдаёт данные не полностью.

### Какие данные видит агент?
Список приложений кабинета, отчёты Reporting API — установки, сессии, активные устройства, кастомные события, краши и выручку — и построчные выгрузки Logs API по тем приложениям, к которым у вашего логина есть доступ.

### Может ли агент что-то менять в AppMetrica?
Да, если уровень доступа «Чтение/редактирование»: агент умеет заводить группы push-кампаний, отправлять рассылки и править настройки приложения. С уровнем «Только чтение» остаются отчёты и выгрузки.

### Почему выгрузка Logs API приходит не сразу?
Logs API готовит файл асинхронно: первый запрос ставит задачу, данные приезжают после подготовки, поэтому агент повторяет запрос до готовности. Пагинации там нет, большой период он режет на куски по датам.

[Открыть AppMetrica](https://appmetrica.yandex.ru)