Подключить Яндекс Метрику к приложению на iOS можно через SDK AppMetrica — именно эта библиотека отвечает за сбор статистики установок, событий и поведения пользователей в мобильных приложениях. Без неё счётчик на сайте не даст данных о том, что происходит внутри iPhone-версии продукта: ни источников установок, ни удержания аудитории, ни событийной аналитики.
Ниже разберём, чем отличается веб-Метрика от мобильной, как установить SDK через CocoaPods или Swift Package Manager, какие события стоит настроить в первую очередь и как проверить, что данные реально поступают в отчёты.
Чем AppMetrica отличается от обычной Яндекс Метрики
Классическая Яндекс Метрика работает с сайтами: счётчик вставляется в HTML-код страницы и собирает визиты, просмотры и цели. Мобильное приложение не имеет HTML-страниц, поэтому для него используется отдельный продукт — AppMetrica, который интегрирован в интерфейс Метрики, но требует собственного SDK.
Метрики тоже различаются. Вместо «визитов» и «отказов» здесь ключевые показатели — установки, активные пользователи (DAU/MAU), удержание (retention) и события внутри приложения. Атрибуция установок позволяет понять, из какой рекламной кампании пришёл пользователь.
Создание счётчика для iOS-приложения
Первый шаг — создать приложение в интерфейсе Метрики. Вам нужно авторизоваться в аккаунте Яндекса, перейти в раздел AppMetrica и нажать кнопку добавления нового приложения. Далее указывается название и выбирается платформа iOS.
После создания система выдаст API-ключ — уникальный идентификатор, который связывает SDK в приложении с вашим счётчиком. Именно этот ключ передаётся при инициализации библиотеки. Потеря или публикация ключа в открытом доступе нежелательна: чужие данные могут попасть в ваши отчёты.
- 📱 Укажите точное название приложения — оно отобразится в отчётах.
- 🔑 Сохраните API-ключ сразу после создания счётчика.
- 🗂 Для тестовой и боевой сборки лучше завести два отдельных счётчика, чтобы тестовые события не портили статистику.
Установка AppMetrica SDK в проект Xcode
Существует несколько способов подключить библиотеку. Самый распространённый — через CocoaPods: в Podfile добавляется зависимость, после чего выполняется установка командой в терминале.
pod 'AppMetricaAnalytics'pod installАльтернатива — Swift Package Manager: пакет добавляется через интерфейс Xcode по репозиторию библиотеки. Точный адрес репозитория и актуальную версию SDK следует брать из официальной документации AppMetrica, так как они периодически обновляются.
После подключения библиотеки необходимо инициализировать SDK при запуске приложения — обычно в методе делегата приложения didFinishLaunchingWithOptions или в структуре App для SwiftUI. В конфигурацию передаётся ваш API-ключ.
☑️ Подключение AppMetrica к iOS-приложению
⚠️ Внимание: не инициализируйте SDK с задержкой или только на отдельных экранах. Если активация произойдёт позже старта приложения, часть сессий и событий не попадёт в статистику.
Настройка событий и параметров
Базовая установка SDK уже даёт данные об установках, сессиях и устройствах. Но главная ценность — в пользовательских событиях: регистрация, добавление товара в корзину, оформление заказа, просмотр конкретного экрана.
Событие отправляется вызовом метода репортинга с именем события и, при необходимости, словарём параметров. Имейте в виду ограничения: имена событий и структуру параметров стоит продумать заранее и зафиксировать в документе, чтобы аналитика оставалась консистентной между версиями приложения.
- 🎯 Регистрация и авторизация — базовые события воронки.
- 🛒 Коммерческие события: покупка, оплата, добавление в корзину.
- 📄 Просмотры ключевых экранов — помогают построить карту путей пользователей.
- ⚙️ Ошибки и сбои — можно передавать как отдельные события для мониторинга стабильности.
Отслеживание установок и атрибуция
Одна из сильных сторон AppMetrica — атрибуция установок. SDK умеет связывать установку с источником: рекламной кампанией в Директе, трекинг-ссылкой, органикой. Для рекламных кампаний создаются трекинг-ссылки с параметрами, которые ведут в App Store.
Учитывайте особенности экосистемы Apple: политика App Tracking Transparency ограничивает доступ к рекламному идентификатору без согласия пользователя. Это влияет на точность атрибуции по рекламным сетям. Для корректной работы с приватностью ознакомьтесь с требованиями Apple и настройками SDK, касающимися сбора идентификаторов.
⚠️ Внимание: перед публикацией приложения в App Store проверьте, какие данные собирает SDK, и корректно заполните раздел о конфиденциальности (privacy manifest и анкету App Store Connect). Недостоверное декларирование сбора данных — частая причина отклонения сборок на ревью.
Проверка корректности работы
После интеграции обязательно проверьте, что данные поступают. Запустите приложение на тестовом устройстве или симуляторе, выполните несколько действий, вызывающих события, и откройте отчёты в интерфейсе Метрики. Данные появляются не мгновенно — возможна задержка, поэтому не делайте выводов сразу после запуска.
Полезно включить логирование SDK в debug-сборке: библиотека выводит в консоль Xcode информацию об отправляемых событиях. Это позволяет убедиться, что события формируются с правильными именами и параметрами ещё до того, как они появятся в отчётах.
| Проблема | Возможная причина | Что проверить |
|---|---|---|
| Нет данных в отчётах | Неверный API-ключ | Сверить ключ в коде с ключом счётчика |
| События не отображаются | Задержка обработки данных | Подождать и проверить отчёт позже |
| Установки не атрибутируются | Трекинг-ссылка настроена неверно | Проверить параметры ссылки и тестовую установку |
| Сессии слишком короткие | SDK инициализируется поздно | Перенести активацию на старт приложения |
| Ошибки при сборке проекта | Конфликт версий зависимостей | Обновить pods и проверить совместимость версии SDK |
Полезные отчёты для анализа iOS-приложения
Когда данные начали собираться, имеет смысл настроить регулярный просмотр ключевых отчётов. Отчёт по удержанию покажет, возвращаются ли пользователи после первого запуска. Отчёт по событиям — где пользователи «отваливаются» в воронке. Отчёт по устройствам и версиям ОС поможет понять, какие версии iOS нужно поддерживать.
Для команд с платной подпиской на рекламу особенно важен отчёт по источникам установок: он связывает расходы на кампании с реальными установками и последующими действиями пользователей. Связка «источник установки → событие покупки» — главный инструмент оценки окупаемости рекламы мобильного приложения.
Можно ли использовать AppMetrica вместе с другими аналитическими системами?
Да, SDK AppMetrica не конфликтует с другими аналитическими библиотеками. Многие команды параллельно используют несколько систем — например, для кросс-проверки данных или потому что разные отделы привыкли к разным инструментам. Учитывайте только, что каждая библиотека увеличивает размер приложения и объём собираемых данных, что нужно отражать в декларации конфиденциальности.
Часто задаваемые вопросы
Нужен ли отдельный счётчик Метрики для iOS и Android?
Нет, можно использовать один счётчик AppMetrica для обеих платформ — в отчётах данные разделяются по платформе. Но некоторые команды предпочитают раздельные счётчики для независимой настройки.
Работает ли AppMetrica с SwiftUI-приложениями?
Да, SDK совместим со SwiftUI. Разница лишь в месте инициализации: вместо AppDelegate активацию выполняют в инициализаторе структуры App или через адаптер делегата.
Почему данные в отчётах появляются с задержкой?
События с устройства отправляются пакетами, а затем обрабатываются на сервере. Это нормальное поведение: мгновенного отображения, как в реальном времени, ожидать не стоит.
Нужно ли запрашивать разрешение App Tracking Transparency для AppMetrica?
Это зависит от того, какие идентификаторы и для каких целей используются. Если применяется рекламный идентификатор для трекинга, требования Apple нужно соблюдать. Точный перечень собираемых данных уточняйте в документации SDK и правилах App Store.
Можно ли передавать в события персональные данные пользователей?
Не рекомендуется. Имена, телефоны, email и другие персональные данные не следует отправлять в параметрах событий — это создаёт юридические риски и нарушает правила работы с аналитическими системами.