Flux Analytics JS SDK 🌐

Flux Analytics, web uygulamaları için geliştirilmiş yüksek performanslı, esnek ve akıllı bir veri analitiği çözümüdür. SPA (React, Vue, Angular) ve geleneksel web projeleriyle tam uyumludur.

📋 İçindekiler

• Başlangıç
• Kullanıcı Tanımlama
• Event Takibi
• Gelişmiş Metrik Analizi (Pro)
• Otomatik Özellikler

📦 Kurulum

NPM üzerinden paketi projenize dahil edin:

npm install flux-analytics-sdk

Veya doğrudan script tagı ile kullanın (CDN):

<script src="dist/Flux.min.js"></script>

🚀 Başlangıç

SDK'yı uygulamanızın girişinde bir kez ilklendirin:

import Flux from 'flux-analytics-sdk';

await Flux.init('YOUR_APP_ID_UUID', 'YOUR_FIRM_ID_UUID', {
  debug: true, // Geliştirme anında konsolda logları gösterir
  logLevel: Flux.LogLevel.CRITICAL, // NONE, CRITICAL, VERBOSE
  baseUrl: 'https://api.yourdomain.com' // Opsiyonel özel backend adresi
});

👤 Kullanıcı Tanımlama

Kullanıcı davranışlarını kişi bazlı takip etmek için:

// Login sonrası kullanıcıyı tanımla
Flux.identify('user_id_from_db');

// Anonim ID'yi manuel almak gerekirse
const anonId = Flux.anonymousId;

📊 Event Takibi

Standart Track (Loglama)

Kullanıcının yaptığı bir eylemi kaydetmek için:

Flux.track('purchase_completed', {
  amount: 250,
  currency: 'TRY',
  items_count: 3
});

⏱️ Gelişmiş Metrik Analizi (PRO)

trackMetric özelliği, verilerinizi dashboard üzerinde otomatik görselleştirilen KPI'lara dönüştürür.

1. Ortalama Hesaplama (Average Mode)

Örneğin, bir sayfanın yüklenme hızını veya API yanıt süresini ölçmek için:

Flux.trackMetric('search_api_latency', 1200, {
  type: 'latency',
  typeLabel: 'Arama Motoru Hızı',
  mode: 'avg', // Ortalama hesaplar
  unit: 'ms',
  icon: 'latency'
});

2. Kategorik Dağılım (Distribution Mode)

Kullanıcıların hangi tarayıcıyı veya hangi özelliği daha çok tercih ettiğini görmek için:

Flux.trackMetric('subscription_plan', 'pro_plus', {
  type: 'revenue_plan',
  typeLabel: 'Plan Dağılımı',
  mode: 'dist' // Dashboard'da yüzdelik dağılım grafiği oluşturur
});

3. Toplam Değer (Sum Mode)

Uygulama içinde toplanan puanları veya toplam satış miktarını görmek için:

Flux.trackMetric('order_total', 150.5, {
  type: 'revenue',
  typeLabel: 'Toplam Ciro',
  mode: 'sum', // Tüm değerleri toplar
  unit: 'TL'
});

📱 Otomatik Özellikler

Otomatik Session Yönetimi

SDK, sayfanın görünüp görünmemesine (visibility state) göre oturum süresini otomatik hesaplar. Kullanıcı sekmeyi kapatıp yarım saat sonra geldiğinde otomatik yeni session başlar.

Smart Offline Queue

İnternet kesildiğinde veriler localStorage üzerinde güvenli bir kuyrukta saklanır. Bağlantı geldiğinde öncelik sırasına göre otomatik olarak tek tek gönderilir.

Attribution (Pazarlama)

URL üzerindeki utm_source, utm_campaign, click_id gibi parametreleri SDK otomatik olarak yakalar ve app_install olayına bağlar. Pazarlama kanallarınızı ölçmek için ek kod yazmanıza gerek kalmaz.

📝 Lisans

© 2026 KoçSistem. Tüm hakları saklıdır.