PRO & ENTERPRISE METRICS

Kampanya & UTM Takip Rehberi

Sitenize gelen trafiğin kaynağını, reklam kanallarını ve pazarlama kampanyalarınızın dönüşüm performansını uçtan uca takip edin.

📌 UTM Parametreleri Nedir?

UTM (Urchin Tracking Module) parametreleri, web sitenizin bağlantılarının (URL) sonuna eklenen özel etiketlerdir. Google Ads, Facebook Ads, Instagram, E-posta bültenleri veya influencer yönlendirmelerinizin başarısını ölçmenizi sağlar.

📣

utm_source

Trafiğin geldiği ana kaynak (Örn: google, facebook, newsletter).

🚀

utm_medium

Pazarlama kanalı veya türü (Örn: cpc, email, social, banner).

🎯

utm_campaign

Spesifik pazarlama kampanyası adı (Örn: yaz_indirimi, lansman_2026).

🔑

utm_term

Arama motoru reklamlarında hedeflenen kelime (Örn: analitik_yazilimi).

🎨

utm_content

A/B testleri veya görsel ayrımı için (Örn: mavi_buton, banner_v2).

🛠️ Etkileşimli UTM Link Oluşturucu

Reklamlarınız ve sosyal medya paylaşımlarınız için hatasız UTM bağlantıları oluşturun:

https://example.com/yaz-kampanyasi?utm_source=google&utm_medium=cpc&utm_campaign=yaz_indirimi&utm_content=mavi_banner

⚡ Analytics Scripti Nasıl Yakalar?

Sitenizde tracker.js eklendiğinde, ziyaretçi yukarıdaki gibi bir UTM bağlantısına tıkladığında arka planda şu işlemler gerçekleşir:

// 1. Ziyaretçi sayfayı açtığında tracker.js URL arama parametrelerini ayrıştırır:
const urlParams = new URLSearchParams(window.location.search);

// 2. UTM değerlerini otomatik toplar ve ClickHouse veritabanına aktarır:
{
  domain_id: "YOUR_TRACKER_ID",
  event_name: "pageview",
  utm_source: urlParams.get('utm_source'),
  utm_medium: urlParams.get('utm_medium'),
  utm_campaign: urlParams.get('utm_campaign'),
  utm_term: urlParams.get('utm_term'),
  utm_content: urlParams.get('utm_content')
}

📊 API Üzerinden UTM Verilerini Sorgulama

ClickHouse üzerinde biriken kampanya verilerini /api/stats endpoint'i üzerinden çekebilirsiniz.

Metric Parametresi Açıklama Örnek Çıktı Boyutu
utms Tüm UTM kaynaklarının özet dağılımı (utm_source) Kaynak bazlı toplam gösterim
utm_campaigns Kampanyalarınıza göre tıklanma & trafik istatistikleri Kampanya adı bazlı tıklama
utm_mediums Pazarlama kanallarına göre dağılım (cpc, email vb.) Kanal bazlı trafik
bounce_by_source Kaynak bazlı hemen çıkma oranları (Bounce Rate %) Sitede kalma kalitesi analizi

Örnek cURL İsteği

curl -X GET "http://localhost:5400/api/stats?domain_id=YOUR_DOMAIN_ID&start_date=2026-08-01%2000:00:00&end_date=2026-08-30%2023:59:59&metric=utm_campaigns" \
     -H "x-api-key: YOUR_ADMIN_API_KEY"

Örnek JSON Yanıtı

{
  "data": [
    { "dimension": "yaz_indirimi", "value": 3420 },
    { "dimension": "lansman_2026", "value": 1280 },
    { "dimension": "black_friday", "value": 940 }
  ]
}

💡 UTM Kullanımında En İyi Pratikler

1. Küçük Harf Kullanın

UTM değerleri büyük/küçük harfe duyarlıdır. Karmaşıklığı önlemek için tüm parametreleri küçük harfle girin (facebook vs Facebook fark yaratır).

2. Tire (-) veya Alt Çizgi (_) Kullanın

Boşluk yerine kelimeleri yaz_indirimi veya yaz-indirimi şeklinde ayırın.

3. Tutarlı İsimlendirme Yapın

Tüm ekibinizin aynı utm_medium standartlarını kullandığından emin olun (cpc, social, email).