Event Tracking mobil tətbiqlərdə: bu nədir, hadisə növləri və necə qurulur

Event Tracking nədir?

Event Tracking — tətbiqdə istifadəçinin diskret hərəkətlərinin toplanması, saxlanması və təhlili prosesidir. Hər bir hadisə ad (event_name) və parametrlər dəstindən (event_params) ibarətdir. Məsələn, purchase hadisəsi price, currency, product_id, quantity parametrlərinə malikdir.

Ekranın açılmasını qeyd edən Screen View-dən fərqli olaraq, Event Tracking istifadəçinin məhz həmin ekranda nə etdiyini təsvir edir: “Al” düyməsini basdı, səbəti açdı, promokod tətbiq etdi. Hadisələr olmadan istifadəçinin motivasiyasını və hərəkət kontekstini anlamaq mümkün deyil.

Hadisə strukturu

Hər bir Analytics Event məcburi və isteğe bağlı sahələri ehtiva edir. Məcburi: event_name, event_timestamp, user_id (və ya device_id). İsteğe bağlı: parametrlər, kontekst təsviri.

Revenue parametri xüsusilə vacibdir — ROAS və LTV-nin avtomatik hesablanması üçün MMP platformalarına ötürülür.

Mobil analitikada hadisə növləri

Hadisələr mənşəyinə və təyinatına görə təsnif edilir. Bölgü məlumat strukturunu təşkil etməyə və müxtəlif komandalar üçün giriş hüquqlarını təyin etməyə kömək edir.

Avtomatik hadisələr (SDK)

SDK analitik platformaları avtomatik olaraq əsas hadisələri toplayır: app_install, app_remove, session_start, screen_view. Firebase Analytics heç bir kod sətri olmadan təxminən 20 avtomatik hadisə yaradır. Bu hadisələr əsas metrikaları əhatə edir, lakin biznes məntiqini anlamağa imkan vermir.

Fərdi hadisələr (Custom Events)

Fərdi hadisələr — Event Tracking-i dəyərli edən şeydir. Onlar biznes hərəkətlərini təsvir edir: add_to_cart, start_subscription, level_complete, share_content, search_performed. Fərdi hadisələr tətbiq kodundan açıq şəkildə göndərilməyi tələb edir.

// Firebase-ə fərdi hadisənin göndərilməsi
val bundle = Bundle().apply {
    putString(AnalyticsParam.ITEM_ID, "prod_789")
    putString(AnalyticsParam.ITEM_NAME, "Premium Subscription")
    putString(AnalyticsParam.CURRENCY, "USD")
    putDouble(AnalyticsParam.PRICE, 29.99)
    putString(AnalyticsParam.SOURCE, "onboarding_screen")
}
FirebaseAnalytics.getInstance(this)
    .logEvent("subscribe_premium", bundle)

Nümunədə subscribe_premium hadisəsi dörd kontekst parametrini ehtiva edir. Source parametri istifadəçinin abunəni hansı ekrandan — onboarding, parametrlər və ya paywall vasitəsilə rəsmiləşdirdiyini anlamağa imkan verir.

User Properties və Super Properties

Hadisələrlə yanaşı, Event Tracking User Properties — istifadəçiyə aid atributları əhatə edir: abunə səviyyəsi, ölkə, tətbiq versiyası. User Property bir dəfə göndərilir və sessiyanın bütün sonrakı hadisələrinə tətbiq olunur. Bu, hər hadisəyə parametr əlavə etmədən analitikanı seqmentləşdirməyə imkan verir.

Super Properties (Amplitude) və ya Global Properties (Mixpanel) — istifadəçiyə deyil, sessiyaya aid atributlardır. A/B testləri üçün istifadə olunur: variant_id Super Property kimi sessiyanın bütün hadisələrinə əlavə edilir və analitik istifadəçinin hansı qrupa aid olduğunu görür.

Revenue-hadisələri

Revenue-hadisələri — əməliyyatların qeydiyyatı üçün ayrıca sinifdir. Onlar məbləğ, valyuta və satınalma növünü (abunə, birdəfəlik satınalma, bərpa) ehtiva edir. MMP platformaları (AppsFlyer, Adjust) ROAS hesablanması üçün revenue-hadisələrini tələb edir.

Branch (2024) məlumatlarına görə, revenue-hadisələrini MMP-yə düzgün ötürən tətbiqlər atribusiya üzrə 25% daha dəqiq məlumatlar alır və kampaniyaları CPI deyil, LTV əsasında optimallaşdıra bilir.

Event Tracking necə qurulur?

Event Tracking-in qurulması üç mərhələdən ibarətdir: hadisə sxeminin planlaşdırılması, SDK inteqrasiyası, məlumatların validasiyası.

Mərhələ 1: Hadisə sxeminin dizaynı

Event Taxonomy — hər bir hadisənin təsvir olunduğu sənəd yaradın: ad, parametrlər, göndərmə trigger-i, sahib. E-ticarət üçün nümunə: order_completed → parametrlər: order_id, total_price, items_count, payment_method, shipping_city.

• Hər bir hadisə suala cavab verir: istifadəçi nə etdi?
• Hər bir parametr suala cavab verir: hansı kontekstdə?
• Parametrsiz hadisələrdən qaçın — onlar analiz üçün faydasızdır

Mərhələ 2: SDK inteqrasiyası

Analytics SDK-ni layihəyə qoşun. Firebase Analytics, Amplitude, Mixpanel — hər bir SDK Application.onCreate() daxilində inisializasiya tələb edir. Flutter üçün nümunə:

import 'package:firebase_analytics/firebase_analytics.dart';

class AnalyticsService {
  final _analytics = FirebaseAnalytics.instance();

  Future<void> logPurchase({
    required String productId,
    required double price,
    required String currency,
  }) async {
    await _analytics.logEvent(
      name: 'purchase_completed',
      parameters: {
        'product_id': productId,
        'price': price,
        'currency': currency,
        'timestamp': DateTime.now().millisecondsSinceEpoch,
      },
    );
  }
}

AnalyticsService sinfi bütün hadisələrin göndərilməsini mərkəzləşdirir. Hər bir metod biznes hərəkətinə uyğun gəlir. Bu, göndərmənin axtarışını asanlaşdırır — hadisə gəlmirsə, kodda metod adı ilə axtarırsınız. Layihə miqyaslandıqca metodların sayı 50–100-ə qədər arta bilər, lakin struktur funksiyalar üzrə qruplaşdırma sayəsində oxunaqlı qalır.

Mərhələ 3: DebugView vasitəsilə validasiya

Firebase DebugView tərtibatçı cihazında hadisələri real vaxtda görməyə imkan verir. Rejimi aktivləşdirin: adb shell setprop debug.firebase.analytics.app your.package. Bütün hadisələr 5 saniyədən az gecikmə ilə Firebase konsolunda görünəcək.

DebugView-i aktivləşdirdikdən sonra tətbiqi açın və test ssenarisini yerinə yetirin — qeydiyyat, satınalma, kataloqa baxış. Konsolda yoxlayın: bütün hadisələr göndərilibmi, parametrlər düzgündürmü, təkrarlanma varmı. Amplitude oxşar alət təklif edir — iOS və Android üçün Amplitude Debugger.

CI/CD vasitəsilə avtomatik validasiya — keyfiyyətin növbəti səviyyəsidir. Pipeline-ə skript əlavə edin ki, sxemdəki hər bir hadisənin test qaçışı zamanı ən azı bir dəfə göndərildiyini yoxlasın. Bu, buraxılmış hadisələrlə versiyaların çıxarılmasının qarşısını alır və QA mühəndislərinin vaxtına qənaət edir.

Hadisələrin adlandırılması üzrə ən yaxşı təcrübələr

Hadisələrin adlandırılması — Event Tracking-in ən az qiymətləndirilən aspektidir. Yanlış ad layihədə 50-dən çox hadisə olduqda analitikanı yararsız edir.

Object + Action standartı

object_action nümunəsindən istifadə edin (kiçik hərflər, snake_case): product_added, cart_opened, payment_failed, subscription_cancelled. Obyekt — varlıq, hərəkət — keçmiş zamanda fel. Bu, cümlə kimi oxunur: “məhsul əlavə edildi”, “səbət açıldı”.

• product_viewed, “tap_on_product_card” yox (hadisə — nəticə, hərəkət deyil)
• order_completed, “successful_payment_transaction” yox (qısa və aydın)
• level_started, “begin_level_with_parameters” yox (əlavə sözlər olmadan)

Qadağan olunmuş nümunələr

İSTİFADƏ ETMƏYİN boşluqlar (“Add to Cart”), CamelCase (“AddToCart”), nöqtə (“add.to.cart”), defis (“add-to-cart”). Əksər SDK snake_case tövsiyə edir. UI elementlərinin adlarından (“btn_submit_clicked”) istifadə ETMƏYİN — hadisə biznes, texniki deyil.

Prefix üçün funksiya və ya ekran adını əlavə edin: onboarding_step_completed, checkout_payment_selected. Bu, hesabatlarda hadisələri funksionallıq üzrə filtrləməyə imkan verir.

Hadisə parametrlərinin növləri

Parametrlər üç növə bölünür: string (dəyər), number (aqreqasiya üçün ədəd), boolean (bayraq). String parametrləri kateqoriyalı məlumatları ehtiva edir: ölkə, trafik mənbəyi, məhsul adı. Number parametrləri metrikalar üçün xidmət edir: qiymət, miqdar, müddət. Boolean parametrləri vəziyyəti qeyd edir: is_trial, is_promo_applied.

Bir parametrdə obyekt və ya massiv ötürməkdən çəkinin — analitik platformalar onları parse edə bilmir. Bir sahədə JSON-string əvəzinə bir neçə düz parametr ötürün. Məsələn, items_count_total əvəzinə items_count və total_price-i ayrıca ötürün.

Event Tracking üçün platformalar

Platforma seçimi Event Tracking layihənin miqyasından və komandadan asılıdır. Müxtəlif səviyyəli üç variantı nəzərdən keçirək.

Firebase Analytics (pulsuz, 500 hadisəyə qədər)

Firebase — startaplar üçün standart seçimdir. Pulsuz limit — 500 müxtəlif event_name, məhdudiyyətsiz sayda parametr. Xüsusi analitika üçün BigQuery ilə inteqrasiya. Mənfi cəhətləri: məhdud seqmentasiya, hadisələrin sessiyada avtomatik əlaqələndirilməsinin olmaması.

Amplitude (Pro ayda 1000 USD-dən)

Amplitude — məhsul analitikası üçün platformadır. Behavioural Cohorts, Funnel Analysis, Pathfinder-ı dəstəkləyir. Real hadisələrin kombinasiyasından virtual hadisələr yaratmağa imkan verir. Segment vasitəsilə 50+ alətlə inteqrasiya edir.

Segment (ayda 120 USD-dən)

Segment — hadisələrin idarə edilməsi üçün middleware-dir. Hadisələri Segment-ə göndərirsiniz, o isə onları 300+ alətə paylayır. Eyni vaxtda Firebase, Amplitude, Mixpanel, Braze və Salesforce istifadə edən enterprise-lərdə faydalıdır.

PostHog (open-source alternativ)

PostHog — öz Event Tracking-i olan open-source məhsul analitikası platformasıdır. Hadisələrin avtomatik tutulmasını, sessiyaların yazılmasını və feature flags-ı dəstəkləyir. Öz serverinizdə yerləşdirilir ki, bu da GDPR və ya məxfi məlumatları olan layihələr üçün vacibdir. ETL boru kəmərləri üçün Python-uyumlu API təqdim edir.

Flutter layihələri üçün flutterfire_analytics + amplitude_flutter plugin vasitəsilə Amplitude tövsiyə olunur. React Native üçün — react-native-firebase + mixpanel-react-native.