AppMetrica: что это и как подключить аналитику приложения

AppMetrica — сервис Яндекса для аналитики мобильных приложений. В приложение встраивают SDK, и он передаёт установки, сессии, события, покупки и крэши, а AppMetrica строит по ним отчёты и атрибутирует установки рекламным источникам. Начать можно бесплатно: стандартные отчёты и базовые события не ограничены, лимит действует только на пользовательские события — 3,25 млн в сутки. Для подключения нужны Яндекс ID, API-ключ приложения и разработчик, который добавит библиотеку в код.

Что такое AppMetrica и что она измеряет

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

Отчёты в интерфейсе разделены на группы:

• Маркетинг — User Acquisition (установки и действия по источникам), User Acquisition SKAdNetwork, Ремаркетинг, Push-кампании, Конверсии.
• Продукт — События, Воронки, Retention-анализ, Когортный анализ, Вовлечённость, Аудитория, Профили.
• Монетизация — In-app и Ad Revenue, Ecommerce, Офферы.
• Технологии — версии приложения и SDK, операционные системы, модели устройств, экраны, операторы, тип соединения.
• Крэши и ошибки — крэши, ошибки, ANR (зависания приложения на Android).

Кроме отчётов, в AppMetrica есть push-уведомления, A/B-эксперименты и флаги конфигурации, антифрод FraudScore, прогнозы LTV и оттока, выгрузка сырых данных через Logs API и Data Stream API. Часть этих инструментов доступна только на платных тарифах — о них ниже.

Чем AppMetrica отличается от Яндекс Метрики

Оба сервиса принадлежат Яндексу и работают через один Яндекс ID, но кабинеты, данные и доступы у них раздельные. Метрика отслеживает сайты, AppMetrica — мобильные приложения. Подробно о Метрике рассказано в статье что такое Яндекс Метрика.

Параметр	Яндекс Метрика	AppMetrica
Что отслеживает	Сайты	Приложения для Android и iOS, включая кросс-платформенные
Как подключается	JavaScript-код счётчика на страницах	SDK в коде приложения, разработчик выпускает новую версию
Идентификатор	Номер счётчика	API-ключ приложения
Единица данных	Визиты, просмотры, цели	Сессии, события, профили пользователей
Источники трафика	UTM-метки, реферы, рекламные системы	Трекеры и трекинговые ссылки с атрибуцией установок
Специфические отчёты	Вебвизор, карты кликов	Крэши и ошибки, retention, SKAdNetwork, push-кампании
Связь с Директом	Цели счётчика для стратегий	Установки и события приложения через постбэки
Аудитории	Сегменты Метрики	Сегменты AppMetrica в Яндекс Аудиториях

Если у бизнеса есть и сайт, и приложение, нужны оба сервиса. Доступ к счётчику Метрики не даёт доступа к приложению в AppMetrica, и наоборот.

С чего начать: регистрация и API-ключ

1. Войдите на appmetrica.yandex.ru под Яндекс ID. Адрес appmetrica.yandex.com ведёт в тот же сервис.
2. На странице создания кабинета заполните три блока. Компания — название и страна регистрации (она важна, если позже понадобятся платные инструменты), сайт по желанию. Профиль — команда и почта для уведомлений, здесь же принимаются условия использования. Приложение — ссылка на приложение в Google Play или App Store, название для кабинета и часовой пояс отчётов.
3. Скопируйте API-ключ, который появится после создания. Если не успели, он хранится в разделе Настройки → Основное.
4. Передайте ключ разработчику. Используйте один ключ для всех версий и платформ приложения, иначе данные разойдутся по разным кабинетам.

Третий блок регистрации — данные о приложении

Скриншоты — из официальной справки AppMetrica: «Регистрация».

После создания приложения остаётся скопировать ключ и выбрать платформу SDK

Если приложений несколько, сначала добавьте одно, остальные — позже из того же кабинета организации.

Подключение SDK на Android

AppMetrica SDK для Android распространяется через Maven. Актуальная версия на октябрь 2026 года — 8.6.0.

1. Добавьте зависимость в build.gradle.kts:

   implementation("io.appmetrica.analytics:analytics:8.6.0")
   

   В Groovy-файле build.gradle строка выглядит так: implementation 'io.appmetrica.analytics:analytics:8.6.0'.

2. Создайте класс-наследник Application и активируйте библиотеку в onCreate():

   class YourApplication : Application() {
       override fun onCreate() {
           super.onCreate()
           val config = AppMetricaConfig.newConfigBuilder(API_KEY).build()
           AppMetrica.activate(this, config)
       }
   }
   

3. Соберите приложение, запустите на устройстве с интернетом и проверьте данные в кабинете — как это сделать, описано ниже.

Через расширенную конфигурацию (newConfigBuilder) включают логирование, меняют тайм-аут сессии методом withSessionTimeout и задают другие параметры. По умолчанию новая сессия начинается, если пользователь вернулся в приложение больше чем через 10 секунд.

Подключение SDK на iOS

Для iOS актуальна версия SDK 7.0.0. Библиотека разбита на модули:

• AppMetricaCore — основной, обязателен;
• AppMetricaCrashes — сбор крэшей;
• AppMetricaWebKit — события из WebView;
• AppMetricaAdSupport — сбор IDFA (рекламного идентификатора Apple). Подключайте его, только если IDFA действительно нужен.

Установить SDK можно тремя способами:

• Swift Package Manager в Xcode — File → Add Package Dependencies..., адрес https://github.com/appmetrica/appmetrica-sdk-ios. Для ненужных модулей в Add to Target выберите None.
• Package.swift — .package(url: "https://github.com/appmetrica/appmetrica-sdk-ios", from: "7.0.0") и модули через .product(name: "AppMetricaCore", package: "AppMetrica").
• CocoaPods — pod 'AppMetricaAnalytics', '~> 7.0.0'. Для детских приложений и выборочной установки подключают отдельные поды AppMetricaCore, AppMetricaCrashes, AppMetricaWebKit.

Активация на Swift — в application(_:didFinishLaunchingWithOptions:):

import AppMetricaCore

let configuration = AppMetricaConfiguration(apiKey: "API key")
AppMetrica.activate(with: configuration!)

На Objective-C используют AMAAppMetricaConfiguration с initWithAPIKey: и [AMAAppMetrica activateWithConfiguration:configuration]. Если цели статически линкуются с AppMetrica, добавьте флаг компоновщика -ObjC.

С iOS 14.5 приложение должно запрашивать согласие на отслеживание (App Tracking Transparency), без него IDFA недоступен. Часть рекламных установок на iOS атрибутируется через SKAdNetwork — для них в AppMetrica есть отдельный отчёт.

Кросс-платформенные приложения: Flutter, React Native, Unity

Для кросс-платформенных фреймворков есть официальные плагины. Они работают поверх нативных SDK для Android и iOS, поэтому возможности почти те же.

Платформа	Версия плагина	Установка	Активация
Flutter	4.1.0	flutter pub add appmetrica_plugin	AppMetrica.activate(AppMetricaConfig("API_KEY"))
React Native	4.2.0	npm install @appmetrica/react-native-analytics или yarn add	AppMetrica.activate({ apiKey: 'API_KEY' })
Unity	6.10.0	Через Package Manager: зависимости в Packages/manifest.json	AppMetrica.Activate() с AppMetricaConfig в статическом методе с атрибутом RuntimeInitializeOnLoadMethod

В React Native на Expo плагин требует development build: сначала ставят expo-dev-client, затем npx expo install @appmetrica/react-native-analytics. Push-уведомления для Flutter и Unity подключаются отдельными плагинами Push SDK.

Как проверить, что данные приходят

Первые сессии появляются в кабинете через несколько минут после запуска версии с SDK. Перед релизом:

1. Запустите приложение на устройстве с интернетом и пройдите основные сценарии.
2. Проверьте, что в отчёте Аудитория появился новый пользователь.
3. Откройте Вовлечённость → Сессии: число сессий должно расти.
4. В отчётах События и Профили найдите отправленные события и атрибуты.

Тестовые данные удобно отправлять на отдельный тестовый API-ключ или отметить устройства как тестовые в настройках, чтобы они не смешивались с боевой статистикой. Если отчёты пустые, проверьте, что в сборке указан API-ключ именно этого приложения, у устройства есть интернет, а библиотека активируется один раз при запуске.

События: что собирается само, а что настроить

После подключения SDK AppMetrica сама фиксирует установки (первый запуск с активированной библиотекой), начало и конец сессий, открытия по диплинкам, покупки и подписки через App Store и Google Play, крэши и push-токены. Всё остальное разработчик отправляет из кода.

Что передать	Метод на Android	Зачем
Пользовательское событие	AppMetrica.reportEvent(name) или с параметрами — JSON или Map	Регистрация, пройденный уровень, нажатие ключевой кнопки
Доход от покупки	AppMetrica.reportRevenue(Revenue)	Выручка по источникам, ROI рекламы
Электронная коммерция	AppMetrica.reportECommerce(ECommerceEvent)	Просмотр карточки, корзина, оформление, покупка
Профиль пользователя	setUserProfileID и reportUserProfile	Сегменты по уровню, статусу лояльности, тарифу
Доход от рекламы	reportAdRevenue или reportExternalAdRevenue	Монетизация через рекламные сети
Ошибка	AppMetrica.reportError	Обработанные ошибки с группировкой
Открытие по диплинку	AppMetrica.reportAppOpen	Ручной учёт, если автосбор выключен

На iOS и в плагинах методы называются так же или близко. Событие с вложенными параметрами считается за одно. В веб-интерфейсе видно до пяти уровней вложенности, через API отчётов — до десяти.

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

Трекинг установок: трекеры и атрибуция

Чтобы понять, какая реклама принесла установку, в AppMetrica создают трекер. Он выдаёт трекинговую ссылку вида https://redirect.appmetrica.yandex.com/serve/..., которую ставят в объявление. Схема работы:

1. Пользователь кликает по рекламе и через редирект AppMetrica попадает в магазин приложений.
2. Устанавливает и открывает приложение — первый запуск считается установкой.
3. SDK сообщает об установке, и AppMetrica сопоставляет её с кликом или показом.
4. Рекламный партнёр получает постбэк — уведомление о конверсии — и учитывает его в статистике и обучении.

Трекеры находятся в разделе Трекинг. Для каждого выбирают партнёра (рекламную сеть), платформу, диплинк, настройки атрибуции и постбэки. Параметр click_id в ссылке обязателен: по нему AppMetrica исключает дубли. Для более точного учёта можно передавать рекламные идентификаторы устройств — Google AID, IDFA, Huawei OAID.

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

Кроме Директа, трекинговые ссылки AppMetrica принимают и другие рекламные системы — например, VK Реклама. Макросы для ссылки у каждой системы свои, для VK они описаны в статье UTM-метки для VK Рекламы.

Интеграция с Яндекс Директом

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

Трекер для Единой перфоманс-кампании

1. В разделе Трекинг нажмите Создать трекер и задайте название.
2. Выберите партнёра Yandex.Direct. Другой партнёр для ЕПК не подойдёт.
3. Отключите опцию SmartLink.
4. Укажите одну платформу: для Android и iOS нужны отдельные трекеры и отдельные кампании. SDK уже должен быть в приложении.
5. Для ремаркетинговой кампании обязательно заполните Deeplink. Проверьте его заранее: откройте ссылку на телефоне и убедитесь, что запускается приложение.
6. Настройку атрибуции оставьте по умолчанию.
7. Скопируйте трекинговую ссылку и добавьте её в библиотеку приложений Директа. В ссылке должен быть параметр click_id={logid} — используйте вариант со всеми предзаполненными параметрами.

Постбэки и события

Постбэк на установку создаётся автоматически. Для остальных событий нажмите Добавить постбек, выберите тип события и шаблон. Шаблоны названы так же, как цели Директа для приложений (Purchased, Completed registration и другие), а событие в AppMetrica может называться по-своему.

Две опции постбэка:

• Отправлять постбек только для первого целевого события — в Директ уходит первое событие, повторные видны только в AppMetrica.
• Отправлять постбек по действиям всех пользователей — данные уходят независимо от источника установки, без атрибутивных параметров. Если нужны оба варианта, создайте два постбэка. В остальных случаях опцию не включайте.

Верификация, Smart TV и медийная реклама

• Верификация. Если кабинеты Директа и AppMetrica на одном логине, приложение верифицируется автоматически. Если нет — откройте в AppMetrica Настройки → Управление доступом и выдайте доступ логину, с которого запускаются кампании.
• Показы на Smart TV и компьютерах. В трекере на вкладке настроек атрибуции включите атрибуцию CTV/Desktop, задайте окно и скопируйте Impression url для кампании.
• Медийные кампании. Трекинговую ссылку ставят в поле Ссылка в объявлении, а Impression URL из AppMetrica — в поле Счётчик показов. Пиксель бесплатный, но учитывает только тех, кто установил приложение после показа или клика: события пользователей, у которых приложение уже стояло, к кампании не привязываются.

Почему цифры в Директе и AppMetrica расходятся

AppMetrica относит установку к дате установки, Директ — к дате клика. Клики и показы Директ фильтрует своим антифродом, а AppMetrica не учитывает клики роботов только при флаге IsBot в UserAgent. Небольшое расхождение — норма, большое — повод проверить постбэки и окна атрибуции.

Сегменты для ретаргетинга

Пользователей приложения можно вернуть рекламой через Яндекс Аудитории: Создать сегмент → На основе данных Яндекса → AppMetrica, затем выбрать приложение и условия — событие и период. Сегмент строится по данным за 90 дней, обрабатывается до двух часов и становится «Готов» при охвате от 100 анонимных идентификаторов. Для ретаргетинга выбирайте режим In-Device. Как работать с сегментами дальше, описано в статье про Яндекс Аудитории.

Тарифы и лимиты AppMetrica

Стандартные отчёты, базовые события, трекинг in-app подписок, анализ выручки, push-кампании и доступ к API входят во все тарифы. Платить приходится за объём пользовательских событий и дополнительные инструменты.

Тариф	Цена	Пользовательские события	Что ещё
Базовый	0 ₽	100 млн в месяц, 3,25 млн в сутки	Data Stream API до 100 млн событий в месяц, до 2 A/B-экспериментов и 100 флагов одновременно, 20 рабочих пространств, 100 сохранённых отчётов, поддержка через форму. Докупить инструменты нельзя
Конструктор	Зависит от набора опций	Базово как в бесплатном, расширяется пакетами; сверх лимита — 67 ₽ за каждый миллион	Антифрод FraudScore, расширенные A/B-тесты, флаги и Data Stream API по выбору. Прогнозов LTV и оттока нет
Максимальный	От 302 850 ₽	20 000 млн в месяц, 650 млн в сутки; сверх лимита — 67 ₽ за миллион	Всё из Конструктора, прогнозы LTV и оттока, персональная поддержка в отдельном чате

Стоимость Конструктора и Максимального считает калькулятор на странице тарифов AppMetrica. Например, расширение до 300 млн пользовательских событий (9,75 млн в сутки) стоит там 41 338 ₽. Оплачивают тариф в интерфейсе: Организация → Оплата и тариф.

Как работает лимит событий

• В лимит входят только пользовательские события — те, что вы назвали сами и отправили через SDK или Post API. Установки, сессии, диплинки, revenue- и ecommerce-события, крэши, ошибки, push-уведомления и атрибуты профиля не считаются.
• Лимит общий для всех приложений организации, отдельной квоты на приложение нет. Текущий расход смотрят на вкладке Организация в боковой панели.
• События сверх суточного лимита попадают в буфер и записываются по очереди — в отчётах это выглядит как задержка данных.
• Если лимит превышается регулярно и событие пролежало в буфере 14 дней, AppMetrica перестаёт принимать пользовательские события из SDK и Post API, а буфер не записывается. Возобновить приём можно на платном тарифе через поддержку.

Пример расчёта. У приложения 150 000 активных пользователей в день, каждый в среднем генерирует 25 пользовательских событий: 150 000 × 25 = 3,75 млн в сутки. Это выше бесплатных 3,25 млн. Варианты: убрать из плана малополезные события (например, отдельное событие на каждый просмотр экрана) или расширить лимит в Конструкторе.

Доступы для команды и подрядчиков

Доступ к приложению выдают в Приложение → Настройки → Управление доступом: укажите Яндекс-логин и роль.

Роль	Кому подходит
Только чтение	Аналитик, руководитель, который смотрит отчёты
Чтение/редактирование	Продакт-менеджер, разработчик, маркетолог, который создаёт трекеры
Агентство: чтение	Подрядчик по рекламе — видит данные только по выбранным источникам трафика и целевым событиям
Агентство: чтение/редактирование	Агентство, которое само создаёт трекеры и постбэки

Права на уровне организации (просмотр или редактирование, включая оплату) выдаются отдельно: кнопка К организации → Сотрудники → Выдать доступ. Для Директа обязательно выдайте доступ логину, с которого запускаются кампании, — без этого не пройдёт верификация приложения. Принципы выдачи доступов в Метрике описаны в статье как дать доступ к Яндекс Метрике.

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

Где войти в AppMetrica?

На appmetrica.yandex.ru под Яндекс ID. Если вам выдали доступ к чужому приложению, оно появится в списке после входа под тем логином, на который выдан доступ.

Можно ли отслеживать сайт в AppMetrica?

Нет, для сайтов нужна Яндекс Метрика. Если часть приложения открывается во WebView, события из веб-страниц можно передавать в AppMetrica через модуль AppMetricaWebKit на iOS. Как поставить счётчик на сайт, рассказано в статье как установить Яндекс Метрику.

Нужен ли разработчик, чтобы подключить AppMetrica?

Да. SDK встраивается в код приложения, после этого выпускается новая версия в магазине. Без разработчика можно зарегистрироваться, получить API-ключ, создать трекеры и выдать доступы, но данные пойдут только после обновления приложения.

Нужен ли отдельный API-ключ для Android и iOS?

Нет. Яндекс рекомендует один ключ на все платформы и версии, чтобы данные собирались в одном кабинете. Отдельными делают только трекеры для рекламы: у каждого трекера одна платформа.

Можно ли перейти на AppMetrica с другого трекера, не потеряв данные об уже установивших?

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

Что будет, если закончится лимит событий на бесплатном тарифе?

Установки, сессии, покупки и крэши продолжат собираться — они в лимит не входят. Пользовательские события сверх 3,25 млн в сутки встанут в очередь. Если превышение регулярное и события копятся в буфере 14 дней, приём пользовательских событий остановится до перехода на платный тариф.

Обязательно ли использовать AppMetrica для рекламы приложения в Директе?

Нет. Директ принимает данные от AppMetrica, AppsFlyer, Adjust, Branch, Kochava, MyTracker, Singular, Tenjin и AirBridge. SKAdNetwork и показы на Smart TV поддерживают только AppMetrica, AppsFlyer и Adjust. Плюс AppMetrica — бесплатный старт и автоматическая верификация при общем логине с Директом.

Где научиться работать с AppMetrica?

В документации на appmetrica.yandex.ru/docs есть пошаговые руководства по SDK для каждой платформы и раздел о трекинге. На портале сертификации Яндекса есть базовый тест по AppMetrica. Для старта удобен раздел «Начало работы».