Flux Analytics Flutter SDK 🚀

Flux Analytics, mobil uygulamalarınız için geliştirilmiş profesyonel bir olay takip, oturum yönetimi ve performans analiz çözümüdür.

📦 Kurulum

pubspec.yaml dosyanıza bağımlılığı ekleyin:

dependencies:
  flux_analytics_sdk: ^0.1.25

🚀 Başlangıç

SDK'yı uygulamanızın en başında ilklendirin:

import 'package:flux_analytics_sdk/flux_analytics_sdk.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();

  await Flux.init(
    appId: 'YOUR_APP_ID_UUID',
    firmId: 'YOUR_FIRM_ID_UUID',
    debug: true, // Geliştirme aşamasında logları görmek için
    logLevel: FluxLogLevel.critical, // critical, verbose veya none
  );

  runApp(MyApp());
}

👤 Kullanıcı Tanımlama

Kullanıcı giriş yaptığında veya tanımlandığında ID'sini set edebilirsiniz:

Flux.identify('user_123456');

Kalıcı kullanıcı özellikleri eklemek için:

Flux.setUserProperty('premium_user', true);
Flux.setUserProperty('user_segment', 'expert');

📊 Olay Takibi (Event Tracking)

Standart Olaylar

Basit bir eylemi takip etmek için:

Flux.track('button_clicked', {'button_name': 'subscribe'});

⏱️ Gelişmiş Metrik Takibi (Advanced Metrics) - YENİ!

Dashboard üzerinde özel analiz kartları ve grafikler oluşturmak için trackMetric kullanmalısınız. Bu metod, verilerinizi "gürültülü" loglardan ayırarak profesyonel bir analiz sunar.

Flux.trackMetric(
  eventName: 'kai_response_time',
  value: 4500,                    // Ölçülen değer
  type: 'latency',                // Teknik grup ID
  typeLabel: 'Asistan Cevap Hızı', // Dashboard'da görünecek temiz isim
  mode: 'avg',                    // Analiz modu: 'avg' (ortalama), 'dist' (dağılım), 'sum' (toplam)
  unit: 'ms',                     // Birim etiketi
  icon: 'latency',                // Dashboard ikonu: 'latency', 'person', 'trophy', 'activity'
  extraMetadata: {
    'agent_id': 'support_agent_01',
    'is_ai': true,
  },
);

Analiz Modları:

avg: Sayısal verilerin ortalamasını alır.
dist: Kategorik veriler (örn: Seviye Adı, Hata Tipi) için dağılım segmentasyonu (yüzdelik) oluşturur.
sum: Toplam değeri hesaplar (örn: Toplam Harcama).

📱 Ekran ve Süre Takibi

Bir sayfanın görüntülenmesini ve orada geçirilen süreyi otomatik ölçmek için:

// Sayfa açıldığında
Flux.startScreen('ProfilePage');

// Sayfa kapandığında (otomatik süre hesaplar ve gönderir)
Flux.endScreen('ProfilePage', {'from_tab': 'settings'});

💰 Gelir Takibi

Flux.trackRevenue(19.99, 'USD', {'product_id': 'premium_sub'});

🛠️ Hata ve Crash Takibi

Hataları manuel veya otomatik yakalayabilirsiniz:

// Manuel hata takibi
try {
  // ... bir işlem ...
} catch (e, stack) {
  Flux.trackError('Payment Failed', stackTrace: stack.toString());
}

// Otomatik Crash yakalama (main içinde bir kez çağırın)
Flux.autoTrackCrashes();

🔍 Performans Logları (Latency)

Spesifik bir operasyonun (örn: API isteği) süresini hızlıca loglamak için:

Flux.trackLatency('fetch_user_data', 120, metadata: {'status': 'success'});