Інтеграція аналітики AppMetrica (Яндекс) у мобільний додаток

Інтеграція аналітики AppMetrica (Яндекс) у мобільний додаток

AppMetrica — основний вибір для додатків, які працюють на російському ринку: немає блокування Google-сервісів на частині пристроїв, дані обробляються в РФ, інтеграція з Яндекс.Директ працює без додаткових налаштувань. SDK доступний для iOS, Android та Flutter.

Підключення SDK

iOS — через Swift Package Manager або CocoaPods:

pod 'YandexMobileMetrica/Dynamic', '~> 5.0'

Ініціалізація в AppDelegate:

import YandexMobileMetrica

func application(_ application: UIApplication,
                 didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    let config = YMMYandexMetricaConfiguration(apiKey: "YOUR_API_KEY")
    config?.sessionTimeout = 120
    config?.logs = false // вимкнути в release
    YMMYandexMetrica.activate(with: config!)
    return true
}

Android через Gradle:

// build.gradle (app)
implementation("io.appmetrica.analytics:analytics:7.0.0")

// Application.onCreate()
val config = AppMetricaConfig.newConfigBuilder("YOUR_API_KEY")
    .withSessionTimeout(120)
    .withLogs(BuildConfig.DEBUG)
    .build()
AppMetrica.activate(applicationContext, config)
AppMetrica.enableActivityAutoTracking(this)

enableActivityAutoTracking автоматично логує зміни Activity — аналог автоматичного screen_view.

Користувацькі события та профіль користувача

// iOS
YMMYandexMetrica.reportEvent("checkout_started", parameters: [
    "cart_value": 4990,
    "item_count": 3,
    "payment_method": "card"
], onFailure: nil)

Профіль користувача — потужна функція AppMetrica, яку часто не використовують. Атрибути профілю дозволяють сегментувати аудиторію в панелі управління:

let profile = YMMMutableUserProfile()
profile.apply(YMMProfileAttribute.customString("subscription_plan").withValue("premium"))
profile.apply(YMMProfileAttribute.customNumber("lifetime_orders").withValue(17))
profile.apply(YMMProfileAttribute.birthDate().withAge(28))
YMMYandexMetrica.report(profile, onFailure: nil)

На Android те саме через UserProfile.newBuilder().

Атрибуція та трекінг установок

AppMetrica підтримує атрибуцію установок без окремого SDK: якщо користувач приходить з Яндекс.Директ або через deeplink з UTM-тегами, AppMetrica автоматично прив'язує першу сесію до джерела. Для сторонніх мереж (Facebook Ads, Google UAC) налаштовується інтеграція через партнерські постбеки в консолі.

Для диплінків:

YMMYandexMetrica.handleOpen(url)

AppMetrica.reportAppOpen(activity)

Push-повідомлення через AppMetrica Push

AppMetrica Push — вбудований інструмент для push-кампаній без Firebase Cloud Messaging (хоча сумісний з FCM). Для активації передайте push-токен:

// iOS
YMMYandexMetrica.setUserProfileID("user_\(userId)")

Сегменти для розповсюджень будуються на основі тих же подій та профілів — окремої інтеграції не потрібно.

Відмінність від Firebase Analytics

Що входить до роботи

• Підключення SDK та ініціалізація для iOS/Android/Flutter
• Налаштування користувацьких подій за планом трекінгу
• Профілі користувачів з атрибутами для сегментації
• Передача deeplink-трафіку
• Перевірка даних у панелі управління AppMetrica

Сроки

Базова інтеграція з подіями та профілями: 1–2 дні. Вартість розраховується індивідуально після аналізу вимог.