Приложения

AppMetrica: установки приложения, события и реклама Яндекса

AppMetrica — аналитика мобильных приложений Яндекса. Она помогает связать установку и действия в приложении с источником привлечения. Это не веб-счётчик, который достаточно вставить на сайт.

Содержание статьи

Простыми словами

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

Термины простыми словами · 6
SDK
Библиотека, которую разработчик добавляет в приложение для передачи событий.
Трекер
Настройка связи рекламного перехода с установкой и действиями.
Deeplink
Ссылка на конкретный экран установленного приложения, например выбранный тур.
API
Способ для одной программы обратиться к другой по установленным правилам. Например, передать подтверждённый заказ из CRM в рекламную систему.
ID
Идентификатор — код конкретного объекта. Например, номер счётчика или код товара. При настройке нужно брать ID нужного объекта, а не любой похожий номер.
Ретаргетинг
Реклама для выбранной аудитории, которая уже взаимодействовала с сайтом, приложением или профилем, когда площадка поддерживает такой способ показа.
Что даст эта статья

SDK передаёт проверенные события, трекер ведёт в правильный магазин или экран, ЕПК приложения использует согласованную цель.

Что подготовить перед началом

  • Подготовьте опубликованное приложение и ссылки соответствующих магазинов, доступ владельца AppMetrica и разработчика Android/iOS.
  • Согласуйте события registration_complete, booking_complete и покупки с подтверждением сервера; подготовьте тестовые устройства.
  • Получите доступ к кабинету Директа и согласуйте бюджет, магазин, платформу и основной результат установки либо in-app.

01Создайте приложение и найдите ключ SDK

В интерфейсеAppMetrica → Добавить приложение → Настройки → Основное

Укажите правильную платформу, название и данные приложения. Ключ SDK идентифицирует приложение в сборе аналитики; он отличается от OAuth-токена административного API. Подготовьте отдельную тестовую среду или тестовый ключ, если это нужно для чистой статистики. Права маркетолога и разработчика выдавайте через предусмотренные доступы, сохраняя владение у компании.

  1. Создайте приложение и проверьте магазин, bundle/package ID.
  2. Скопируйте ключ SDK из Настройки → Основное и передайте разработчику безопасным рабочим способом.
  3. Опишите события и типы параметров до начала рекламы; укажите критерий успеха каждого события.
Пример заполнения

booking_complete означает подтверждённое бронирование, а не открытие экрана календаря.

Проверка

Компания владеет приложением в AppMetrica; тестовые события не перепутаны с рабочими.

02Интегрируйте актуальный SDK

В интерфейсеAndroid → Gradle и Application; iOS → SPM/CocoaPods и инициализация

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

  1. Добавьте библиотеку по официальному quick start и проверьте платформенные требования.
  2. Инициализируйте SDK с ключом нужного приложения; убедитесь, что Application подключён в manifest Android.
  3. На тестовом устройстве откройте приложение с интернетом и проверьте нового пользователя, сессию и собственное событие.
Пример заполнения

Android-пример показывает вызов после старта Application; imports и зависимость берите для установленной версии SDK.

Пример кода
override fun onCreate() {
    super.onCreate()
    val config = AppMetricaConfig.newConfigBuilder("YOUR_APP_API_KEY").build()
    AppMetrica.activate(this, config)
}
// После подтверждённой регистрации:
AppMetrica.reportEvent("registration_complete")
Замените демонстрационные идентификаторы на значения своего проекта.
Проверка

В AppMetrica появляются сессия и ожидаемые события без повторной инициализации.

03Создайте трекер после проверки SDK

В интерфейсеAppMetrica → Трекинг → Создать трекер

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

  1. Укажите имя, например «Yandex — Android — new users».
  2. Выберите нужного партнёра Yandex.Direct и Основной тип трекера.
  3. Проверьте доступную специальную интеграцию Директа и необходимые настройки конверсий/постбеков.
Пример заполнения

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

Проверка

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

04Настройте SmartLink и deeplink

В интерфейсеТрекер → SmartLink → целевая ссылка магазина → Deeplink → Fallback

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

  1. Согласуйте два сценария: приложения нет → магазин, приложение есть → нужный экран.
  2. Попросите разработчика настроить и проверить поддерживаемые ссылки для платформы.
  3. Сверьте требования рекламного партнёра: не заменяйте требуемую прямую ссылку произвольным SmartLink.
  4. Проверьте оба сценария на настоящем устройстве.
Пример заполнения

Без приложения открывается магазин; с приложением — согласованный экран тура, а не случайная главная.

Настройка SmartLink, целевой ссылки и deeplink: настоящий скриншот из официальной документации AppMetrica.
Настройка SmartLink, целевой ссылки и deeplink: настоящий скриншот из официальной документации AppMetrica. Рассмотреть крупнее ↗ · Официальный источник ↗
Проверка

Каждый маршрут проверен на соответствующем устройстве, а SDK и ссылка относятся к одному приложению.

05Задайте атрибуцию и конверсии

В интерфейсеТрекер → Настройка атрибуции → Постбеки; AppMetrica → Конверсии

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

  1. Создайте конверсию по нужному событию и проверьте её фактическую отправку.
  2. Проверьте шаблон постбека партнёра и набор передаваемых данных.
  3. Сохраните атрибуционные окна; используйте тестовое устройство для повторной проверки установок.
Пример заполнения

registration_complete помогает стартовому обучению; оплаченная booking_complete — более глубокий результат при достаточном объёме.

Проверка

Директ получает именно согласованные события, а аналитика не дублирует покупку.

06Создайте ЕПК мобильного приложения

В интерфейсеДирект → Добавить → Кампанию → Режим эксперта → ЕПК

В «Что будете продвигать?» вставьте ссылку App Store/Google Play/RuStore или подходящую трекинговую ссылку. При необходимости пройдите верификацию. Выберите «Привлечение новых пользователей» либо «Ретаргетинг» до сохранения: цель не меняется после создания. Для ретаргетинга место показа выбирается отдельно, одновременно поиск и РСЯ недоступны.

  1. Укажите рекламируемое приложение и проверьте иконку/магазин.
  2. Для новых пользователей выберите установки или доступные события приложения и нужные места показа.
  3. Для iOS проверьте опцию Использовать SKAdNetwork; для Android альтернативные установки выбирайте только при реальном наличии приложения в поддерживаемом магазине.
Пример заполнения

Привлечение Android оптимизируется на установку; возврат существующих пользователей требует правильного deeplink и in-app результата.

Проверка

Не перепутаны веб-цели Метрики и мобильные события; неизменяемые настройки выбраны осознанно.

07Протестируйте рекламу и отчёт

В интерфейсеAppMetrica → тестовые устройства / тестирование атрибуции → отчёт источников

Пройдите по реальной трекинговой ссылке с тестового устройства, установите и впервые откройте приложение, затем выполните целевое действие. Повторная установка уже известного устройства имеет особенности реатрибуции, поэтому используйте официальный режим тестирования. Сверьте источник, событие и идентификаторы кампании; агрегированное iOS-измерение не обещает детальную атрибуцию каждого человека.

  1. Проверьте клик → магазин → первый запуск → событие.
  2. Сверьте данные AppMetrica, Директа и платёжной системы за одинаковый период.
  3. После модерации и запуска оценивайте регистрации, покупки и удержание вместе со стоимостью установки.
Пример заполнения

Дешёвые установки без первого бронирования не считаются успехом продвижения сервиса записи.

Проверка

Есть успешный контрольный маршрут для каждой рекламируемой платформы.

УЧЕБНЫЙ РАЗБОР

Установки приложения подбора туров

Учебный пример: цифры и названия показывают способ работы, а не результаты клиента.

НА ПРИМЕРЕДва пути ссылки
Реклама

Ссылка согласованного трекера

Нет приложения

Переход в нужный магазин

Есть приложение

Открытие согласованного экрана

Измерение

SDK передаёт проверенные события

Маршруты зависят от платформы и интеграции рекламного партнёра.

Авторская учебная схема SOAgency
  1. Создайте проект приложения и передайте его SDK-ключ разработчику по рабочему каналу.
  2. Проверьте тестовую установку и полезное событие, например сохранение тура.
  3. Создайте трекер нужного рекламного партнёра и проверьте маршрут в магазин.
  4. На устройстве с приложением и без него проверьте переход и регистрацию действий.
Что должно получиться

Проверены установка и нужный экран, а полезное действие отделено от запуска приложения.

Выполните и проверьте

Отмечайте шаг после проверки результата. Отметки действуют до перезагрузки страницы; они не подтверждают, что настройка выполнена правильно.

Чек-лист по шагам · 7

AppMetrica: установки приложения, события и реклама Яндекса

    • Создайте приложение и проверьте магазин, bundle/package ID.
    • Скопируйте ключ SDK из Настройки → Основное и передайте разработчику безопасным рабочим способом.
    • Опишите события и типы параметров до начала рекламы; укажите критерий успеха каждого события.

    Проверка: Компания владеет приложением в AppMetrica; тестовые события не перепутаны с рабочими.

    • Добавьте библиотеку по официальному quick start и проверьте платформенные требования.
    • Инициализируйте SDK с ключом нужного приложения; убедитесь, что Application подключён в manifest Android.
    • На тестовом устройстве откройте приложение с интернетом и проверьте нового пользователя, сессию и собственное событие.

    Проверка: В AppMetrica появляются сессия и ожидаемые события без повторной инициализации.

    • Укажите имя, например «Yandex — Android — new users».
    • Выберите нужного партнёра Yandex.Direct и Основной тип трекера.
    • Проверьте доступную специальную интеграцию Директа и необходимые настройки конверсий/постбеков.

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

    • Согласуйте два сценария: приложения нет → магазин, приложение есть → нужный экран.
    • Попросите разработчика настроить и проверить поддерживаемые ссылки для платформы.
    • Сверьте требования рекламного партнёра: не заменяйте требуемую прямую ссылку произвольным SmartLink.
    • Проверьте оба сценария на настоящем устройстве.

    Проверка: Каждый маршрут проверен на соответствующем устройстве, а SDK и ссылка относятся к одному приложению.

    • Создайте конверсию по нужному событию и проверьте её фактическую отправку.
    • Проверьте шаблон постбека партнёра и набор передаваемых данных.
    • Сохраните атрибуционные окна; используйте тестовое устройство для повторной проверки установок.

    Проверка: Директ получает именно согласованные события, а аналитика не дублирует покупку.

    • Укажите рекламируемое приложение и проверьте иконку/магазин.
    • Для новых пользователей выберите установки или доступные события приложения и нужные места показа.
    • Для iOS проверьте опцию Использовать SKAdNetwork; для Android альтернативные установки выбирайте только при реальном наличии приложения в поддерживаемом магазине.

    Проверка: Не перепутаны веб-цели Метрики и мобильные события; неизменяемые настройки выбраны осознанно.

    • Проверьте клик → магазин → первый запуск → событие.
    • Сверьте данные AppMetrica, Директа и платёжной системы за одинаковый период.
    • После модерации и запуска оценивайте регистрации, покупки и удержание вместе со стоимостью установки.

    Проверка: Есть успешный контрольный маршрут для каждой рекламируемой платформы.

Скачать чек-лист TSV

TSV открывается в таблицах с разделителем «табуляция». В файле сохранены шаги, действия и критерии проверки этой статьи.

Удалось решить задачу?

Отправляются адрес статьи, выбранный результат, номер шага, категория и случайный номер отправки. Имя, телефон и комментарий не запрашиваются.

Частые ошибки

  • UTM сайта пытаются использовать вместо атрибуции приложения.
  • Трекер готовят без работающего SDK.
  • Deep link не проверяют на разных состояниях приложения.

Вопросы и ответы

Достаточно ли поставить UTM в магазин?

Нет. Для мобильной атрибуции нужны SDK, трекер и интеграция рекламного партнёра. UTM веб-перехода не заменяет установку и события приложения.

Можно ли поменять приложение или цель после создания ЕПК?

Текущая справка ограничивает изменение объекта рекламы и цели. Для другого приложения или принципиально другого сценария создайте отдельную кампанию.

Чем ключ SDK AppMetrica отличается от OAuth-токена?

Ключ SDK связывает события сборки с приложением в AppMetrica. OAuth-токен используется для авторизованного доступа к API и не заменяет интеграцию SDK. При тестировании сверяйте платформу и приложение, чтобы данные не попадали в чужой проект.

Официальные источники

Материал написан своими словами по указанным справкам. Примеры и рекомендации so-agency адаптированы к задачам бизнеса; доступность функций и интерфейс могут отличаться.

Связанные инструкции

Meta / Instagram

Реклама приложения в Instagram и Facebook: настройка

Как настроить App promotion для рекламы приложения в Instagram и Facebook: объект приложения, ссылки магазинов, SDK или MMP и события. Проверим установки и полезные действия отдельно от кликов.

Читать инструкцию ↗
Приложения

Продвижение приложения в App Store: Apple Ads и измерение

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

Читать инструкцию ↗
Аналитика / UTM

Отчёт по рекламе в Data Studio и Supermetrics: расходы, заявки и продажи в одном месте

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

Читать инструкцию ↗
Написать в WhatsApp

Как используются ваши данные

Имя, телефон и описание задачи нужны, чтобы ответить на вашу заявку. Они не используются для рассылок.

Заявка передаётся владельцу so-agency через Telegram. Вместе с ней передаём страницу, с которой вы обратились, и метки источника, канала и рекламной кампании, если они есть в ссылке. При выборе WhatsApp откроется чат с подготовленным текстом; отправку сообщения подтверждаете вы.

Используем Google Tag Manager для управления аналитикой. Она помогает понять, какие страницы и услуги полезны: учитываем обращения к контактам, переходы в проекты, глубину просмотра статей, действия с инструментами и учебной демонстрацией, а также начало заполнения, отправку, ошибки и успешную доставку заявки.

В параметры этих событий не передаём имя, телефон, текст обращения, исходные списки, ссылку для QR-кода или загруженные изображения. Сервисы аналитики могут получать технические сведения об устройстве и посещённых страницах, примерном регионе и cookies в зависимости от настроек подключённых тегов.

Данные инструментов обрабатываются в вашем браузере. Шаблон названий кампаний сохраняется на устройстве только по кнопке «Сохранить шаблон на этом устройстве». При передаче списка в другой инструмент он временно сохраняется в пределах текущей вкладки.

Сайт не публикует заявки и не просит пароли от рекламных кабинетов. По вопросам данных: +7 708 900 77 26.

Напишите в WhatsApp

Откройте камеру телефона и наведите её на QR-код. Откроется чат с so-agency.

QR-код: чат WhatsApp so-agency+7 708 900 77 26
Открыть WhatsApp на компьютере ↗

Сообщение отправите вы — чат открывается без автоматической рассылки.