Pintelly

Analytics Özellikleri

Pintelly SDK'nın Analytics modülü, ziyaretçi hareketlerini hiçbir harici bağımlılık olmadan yakalamak, kuyruğa almak ve verimli şekilde iletmek üzere tasarlanmıştır.

Otomatik Yakalama Özellikleri

Başlatıldıktan sonra SDK, sizin tarafınızdan ekstra bir kod yazılmasına gerek kalmadan aşağıdaki standart metrikleri otomatik olarak toplar:

  • Sayfa Görüntülemeleri (PageViewed): İlk yüklemede, SPA navigasyonunda (pushState/replaceState) ve hash değişikliklerinde tetiklenir.
  • Öğe Tıklamaları (ElementClicked): BUTTON, A, INPUT, SELECT ve TEXTAREA öğeleriyle etkileşimleri otomatik olarak izler. Herhangi bir öğeyi data-analytics-id="kendi-id'niz" attribute'unu ekleyerek açıkça takip için işaretleyebilirsiniz.
  • Cihaz ve Tarayıcı Bağlamı: İşletim sistemi, tarayıcı türü, viewport boyutu ve yönlendiren (referrer) URL'ler.
  • Performans (PagePerformance): Core Web Vitals izlemesi için First Contentful Paint (FCP) ve Largest Contentful Paint (LCP) değerlerini kaydeder.

Programatik Takip

Otomatik yakalama kullanım senaryolarının %90'ını karşılasa da, global MyAnalytics nesnesini kullanarak kendi özel iş mantığınızı da takip edebilirsiniz.

Özel Event Takibi

MyAnalytics.track('Purchase_Completed', {
  productId: 'prod_123',
  price: 29.99,
  currency: 'USD'
});

Tüm özel event'ler bağlamsal özellikleri (Session ID, User ID, zaman damgası, User Agent, Sayfa URL'i) otomatik olarak devralır.

Kullanıcıları Tanımlama

Kullanıcılarınız uygulamanıza giriş yapıyorsa, etkileşimlerini gerçek Kimlikleriyle eşleyebilirsiniz:

MyAnalytics.identify('user_987654');

[!TIP] identify çağrısı, kullanıcının daha önceki anonim oturum etkileşimlerini yeni tanımlanan User ID'sine bağlar.

Veri Senkronizasyonu

Sitenizin performansının asla etkilenmemesi için SDK, birden fazla event'i otomatik olarak gruplar ve arka planda sunucuya gönderir.

  • Event'ler birkaç saniyede bir ya da kullanıcı sayfadan ayrıldığında otomatik olarak gönderilir.
  • Herhangi bir yapılandırma yapmanıza gerek yoktur; sistem tamamen otomatiktir.

Verinin hemen, zorla gönderilmesi gerektiği durumlarda (ör. kritik bir sayfa yönlendirmesinden hemen önce) kuyruğu manuel olarak boşaltabilirsiniz:

await MyAnalytics.flush();