saas-analytics
Skill2 starsChanged 8 months agoMITView on GitHub
SaaS uygulaması için PostHog analytics ve ürün analizi kur. Event tracking, kullanıcı tanımlama, feature flag, session replay, funnel analizi ve gizlilik uyumlu yapılandırma. Bu skill'i kullanıcı analytics, PostHog, event tracking, kullanıcı davranışı, feature flag, A/B test, dönüşüm analizi veya metrik takibi ile ilgili bir şey istediğinde kullan. "Analytics kur", "kullanıcıları takip et", "PostHog ekle", "feature flag yap" gibi ifadeler tetikler.
- Installs packages
1 other project uses a version of this.
Adopted by
Most recently taken up by
- TheWayWithin/agent-11their own version, first seen Aug 4, 2026
Other versions1 project uses a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 1
- TheWayWithin/agent-11★ 17same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository12 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- saas-api-securitySkill
- saas-authSkill
- saas-databaseSkill
- saas-deploymentSkill
- saas-emailSkill
- saas-landing-seoSkill
- saas-launcherSkill
- saas-legalSkill
- saas-paymentsSkill
- saas-storageSkill
- saas-testingSkill
The file
Files
SaaS Analytics — PostHog ile Ürün Analizi
Bu skill, bir SaaS uygulamasının analitik katmanını kurar. Göremediğin şeyi iyileştiremezsin — kullanıcıların ürünü nasıl kullandığını, nerede takıldığını ve neden ayrıldığını anlamak büyümenin temelidir.
Bağımlılık: Bu skill saas-launcher orkestratör skill'inin deployment fazıyla birlikte veya sonrasında uygulanır. Bağımsız olarak da kullanılabilir.
Bağlı skill'ler:
- saas-auth — Kullanıcı kimliği analytics ile ilişkilendirilir.
- saas-payments — Gelir metrikleri ve dönüşüm hunileri.
- saas-legal — KVKK/GDPR uyumlu tracking yapılandırması.
Neden PostHog
Alternatiflerle Karşılaştırma
PostHog vs. Google Analytics:
- PostHog ürün analizi için tasarlanmış (event bazlı), GA pazarlama analizi için (sayfa görüntüleme bazlı)
- PostHog self-host edilebilir (veri sende kalır — KVKK avantajı)
- PostHog'da session replay, feature flag, A/B test dahili
- GA cookie consent gerektirir (GDPR), PostHog cookieless mode'da çalışabilir
PostHog vs. Mixpanel:
- PostHog açık kaynak, self-host seçeneği
- PostHog ücretsiz katmanı çok cömert (1M event/ay)
- Mixpanel'in analiz arayüzü daha olgun ama PostHog hızla yaklaşıyor
PostHog vs. Plausible:
- Plausible sadece sayfa analizi — event tracking, funnel, session replay yok
- Plausible gizlilik odaklı basit analitik için iyi ama SaaS ürün analizi için yetersiz
Sonuç: SaaS için PostHog en dengeli seçim — ürün analizi, feature flag ve session replay tek platformda.
PostHog Kurulumu
Cloud vs. Self-Host
PostHog Cloud (önerilen başlangıç): Kayıt ol, proje oluştur, API key al. Ücretsiz katman: aylık 1M event, 5K session recording, 1M feature flag değerlendirmesi.
Self-host: Docker Compose ile kendi sunucunda çalıştır. Avantaj: veri tamamen sende, KVKK endişesi sıfır. Dezavantaj: sunucu yönetimi, güncelleme sorumluluğu. Büyüdükçe veya yasal gereklilik varsa değerlendir.
Next.js Entegrasyonu
PostHog'un resmi posthog-js kütüphanesini kur:
npm install posthog-jsPostHog Provider oluştur: Client component olarak bir provider yaz. App Router'da root layout'a ekle. Ortam değişkenleri:
NEXT_PUBLIC_POSTHOG_KEY— proje API anahtarı (public)NEXT_PUBLIC_POSTHOG_HOST— PostHog instance URL'si (cloud içinhttps://us.i.posthog.comveyahttps://eu.i.posthog.com)
EU instance kullan. Türkiye'den çalışıyorsan ve KVKK uyumluluğu önemliyse EU instance seç — veri Avrupa'da kalır.
Server-Side Tracking
API route'ları ve server component'lerde event göndermek için posthog-node kütüphanesini kullan. Server-side tracking özellikle ödeme event'leri, webhook işlemleri ve arka plan görevleri için gerekli.
Event Tracking Tasarımı
İsimlendirme Kuralları
Tutarlı event isimlendirmesi kritiktir. Kaotik isimler analizi imkânsız kılar.
Format: nesne_eylem — küçük harf, alt çizgi ile ayır.
user_signed_up(kayıt oldu)plan_upgraded(plan yükseltti)project_created(proje oluşturdu)checkout_started(ödeme başlattı)checkout_completed(ödeme tamamladı)
Yapma: SignUp, user-sign-up, Signed Up, signup — tutarsız isimlendirme analiz yapılmasını engeller.
Temel Event'ler
Her SaaS'ta izlenmesi gereken event'ler:
Dönüşüm hunisi:
page_viewed(properties: path, referrer)signup_started(kayıt formunu açtı)user_signed_up(kayıt tamamlandı, properties: method — google/magic_link)checkout_started(plan seçti, properties: plan, period)checkout_completed(ödeme başarılı, properties: plan, amount)
Ürün kullanımı:
feature_used(properties: feature_name)project_created/project_deletedsettings_updated
Ayrılma sinyalleri:
plan_cancelled(iptal etti)plan_downgraded(düşürdü)account_deleted(hesabı sildi)
Property'ler
Her event'e bağlam ekleyen metadata:
- Kullanıcı property'leri: plan, kayıt tarihi, ülke
- Event property'leri: sayfa yolu, buton konumu, seçilen plan
- Süper property'ler: her event'e otomatik eklenen ortak veriler
Kullanıcı Tanımlama
Anonim → Tanımlı Geçiş
PostHog her ziyaretçiye anonim bir ID atar. Kullanıcı giriş yapınca posthog.identify() ile gerçek kimliğini bağla. Bu sayede giriş öncesi ve sonrası davranışlar tek profilde birleşir.
Identify çağrısında gönderilecek property'ler:
- name
- plan
- created_at
- stripe_customer_id (opsiyonel)
Identify'ı auth callback'inde yap. Giriş başarılı olduktan sonra, dashboard'a yönlendirmeden önce.
Group Analytics
Takım/organizasyon bazlı SaaS'larda kullanıcıları gruplara bağla. Bu sayede "şirket bazında kaç aktif kullanıcı var?" gibi soruları cevaplayabilirsin. Tek kullanıcılı SaaS'larda gerekmez.
Feature Flags
Neden PostHog Feature Flags
Ayrı bir feature flag servisi (LaunchDarkly, Flagsmith) yerine PostHog'un dahili feature flag'lerini kullan — ek maliyet yok, analytics ile doğal entegre, aynı dashboard'da yönetim.
Kullanım Alanları
- Kademeli rollout: Yeni özelliği önce %10 kullanıcıya aç, sorun yoksa %100'e çıkar
- Beta testi: Belirli kullanıcılara veya planlara özel özellik erişimi
- A/B testi: İki farklı UI varyantını karşılaştır, dönüşüm oranlarını ölç
- Kill switch: Sorunlu özelliği anında kapat — deploy gerekmez
Server-Side Flag Kontrolü
Feature flag'leri sadece UI'da değil, API route'larında da kontrol et. Client-side flag kontrolü UX içindir (UI'yı gizle/göster), güvenlik için server-side kontrol zorunludur — client-side kontrol bypass edilebilir.
Session Replay
PostHog'un session replay özelliği kullanıcının ne yaptığını video olarak kaydeder. Hata raporlarını anlamak, UX sorunlarını tespit etmek ve kullanıcı davranışını gözlemlemek için güçlü araç.
Gizlilik Ayarları
- Hassas input'ları otomatik maskele (şifre, kart bilgisi, kişisel veri)
- Belirli element'leri maskelemek için
data-posthog-maskattribute'ü ekle - KVKK uyumluluğu için session replay'i cookie consent'e bağla veya tamamen devre dışı bırak
Dikkat: Session replay çok veri tüketir. Ücretsiz planda 5K kayıt/ay — tüm trafiğe açarsan hızla tükenir. Sampling oranını düşür veya sadece belirli sayfalarda aktifleştir.
Dashboard ve Metrikler
Her SaaS'ın İzlemesi Gereken Metrikler
Büyüme:
- Haftalık/aylık kayıt sayısı (trend)
- Kayıt → aktifleşme oranı (ilk anlamlı aksiyonu yapan oran)
- Organik vs. referral vs. direkt trafik dağılımı
Gelir:
- MRR (Aylık Tekrarlayan Gelir)
- Yeni MRR vs. Churn MRR
- Plan dağılımı (free/starter/pro)
- Ortalama gelir per kullanıcı (ARPU)
Etkileşim:
- Günlük/haftalık/aylık aktif kullanıcı (DAU/WAU/MAU)
- Core feature kullanım sıklığı
- Oturum süresi ve derinliği
Kayıp:
- Churn oranı (aylık iptal / toplam abone)
- İptal öncesi davranış kalıpları
- İptal nedenleri (anket entegrasyonu)
PostHog Dashboard Oluşturma
Dashboard'da insight'lar oluştur: trend grafikleri, huniler (funnel), tutma analizi (retention), kullanıcı yolculukları (paths). Takım ile paylaş ve haftalık gözden geçirme ritüeli oluştur.
Gotchas
- Event spam'i: Her tıklamayı ve fare hareketini izleme. Sadece anlamlı aksiyonları event olarak gönder — aksi halde event kotanı gereksiz tüketirsin.
- Gizlilik yasaları: KVKK ve GDPR, kullanıcı verisi toplamadan önce bilgilendirme gerektirir. En azından gizlilik politikasında analytics kullanımını belirt. Cookie consent gerekiyorsa PostHog'un cookieless mode'unu değerlendir.
- Adblocker'lar PostHog'u engeller. Kullanıcıların %20-30'u adblocker kullanır. Server-side tracking ile tamamla veya PostHog'un reverse proxy yöntemini kullan.
- Development event'lerini ayır. Development ortamındaki event'ler production verisini kirletir. Ayrı PostHog projesi veya environment filtresi kullan.
- Çok fazla dashboard, az aksiyon. Dashboard oluşturmak kolay, insight'ı aksiyona dönüştürmek zor. Her metrik için "bu düşerse/yükselirse ne yapacağız?" sorusunu cevapla.
- Identify'dan önce event gönderme. Kullanıcı giriş yaptıktan sonra önce
identify(), sonra event gönder. Sıra yanlışsa event'ler anonim kalır ve profille birleşmez.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

