Hardal Web SDK ile özel event’ler göndermek, hardal.track() metodu aracılığıyla esnek bir şekilde özel olayları izlemenize olanak tanır.

Bu rehber, farklı kullanım senaryoları için özel event izleme özelliğini nasıl uygulayacağınızı gösterecektir.

Event’leri Gönderme

Temel Event İzleme

İzlemenin en basit formu, sadece bir event adı göndermektir:

hardal.track("test_event")

Bu event’i hem client hem de server-side çalıştırabilirsiniz

Properties ile Event’ler

Event’lerinizle properties parametresini kullanarak ek veriler gönderebilirsiniz:

hardal.track("user_signup", {
  properties: {
    signup_method: "email",
    user_type: "new",
    referral_source: "friend",
    platform: "web",
    custom_param1: "user_tier",
    custom_param2: "region_europe"
    // ... göndermek istediğiniz diğer özellikler
  }
});

Bu event’i hem client hem de server-side çalıştırabilirsiniz

E-ticaret Pazarlama Event Örnekleri:

E-ticaret websiteleri için detaylı satın alma bilgilerini izleyebilirsiniz:

hardal.track("purchase", {
  properties: {
    transaction_id: "T_12345",
    currency: "USD",
    value: 125.99,
    items: [{
      item_id: "SKU_12345",
      item_name: "Premium Blue Jeans",
      item_category: "Apparel",
      price: 70.99,
      quantity: 1
    }, {
      item_id: "SKU_67890",
      item_name: "Casual White T-Shirt",
      item_category: "Apparel",
      price: 25.99,
      quantity: 2
    }],
    shipping_info: {
      method: "express",
      cost: 15.00
    },
    payment_method: "credit_card"
  }
});

Oyun Event’leri Örnekleri:

Oyun uygulamaları için oyuncu ilerlemesini ve etkileşimlerini izleyin:

hardal.track("level_complete", {
  properties: {
    player_id: "USER_789",
    game_id: "GAME_123",
    level_name: "Dragon's Lair",
    level_number: 5,
    score: 12500,
    time_spent: 345, // saniye
    achievements_unlocked: ["dragon_slayer", "speed_runner"],
    resources_collected: {
      gold: 1500,
      gems: 25,
      experience_points: 750
    },
    player_stats: {
      health: 85,
      mana: 65,
      strength: 120
    }
  }
});

Server-Side İşleme

Bu event’ler Hardal’a gönderildiğinde, veri şemasında gösterildiği gibi otomatik olarak ek bilgilerle zenginleştirilir:

Server tarafından oluşturulan distinct ID

Her oturum için benzersiz çerezsiz tanımlayıcı.

Example
hr_1734601539658_5080zh7of

SDK’nın tanımlayıcılar oluşturmasını etkinleştirebilir veya devre dışı bırakabilirsiniz. Bu sayede GDPR, KVKK veya diğer gizlilik standartları gibi pazarlama ve analitik düzenlemelerine daha iyi uyum sağlayabilirsiniz.

Sayfa Bilgileri

Mevcut sayfa hakkında detaylar.

SDK’dan autoPageView: True // False ayarıyla etkinleştirebilir veya devre dışı bırakabilirsiniz.

Ekran ve tarayıcı detayları

Cihaz ve tarayıcı özellikleri

  • Resolution: 1920x1080

  • Browser: Chrome

  • Version: 131.0.0.0

Cihaz tipi

Kullanılan cihazın tipi (örn., desktop, mobile, tablet)

Zaman dilimi

Kullanıcının zaman dilimi

Örnek: Europe/Istanbul

Zaman damgası

Server event gerçekleşme zamanı

  • 2024-12-19T09:45:39.659Z

Sorgu parametreleri

UTM’ler dahil herhangi bir URL sorgu parametresi.

https://example.com/products?utm_source=newsletter&utm_medium=email&utm_campaign=summer_sale&utm_term=discount&utm_content=header_banner&custom_param1=user_tier&custom_param2=region_europe

Standart UTM parametreleri gibi ayrılmış anahtar kelimelerle çakışmadığı sürece, pazarlama ve analitik hedeflerinizi özelleştirmek için istediğiniz kadar özel parametre ekleyebilirsiniz.

En İyi Uygulamalar

  1. Tutarlı İsimlendirme: Event adları ve özellikleri için snake_case kullanın

  2. Yapılandırılmış Veri: İlgili özellikleri iç içe nesnelerde gruplayın

  3. Veri Tipleri: Uygun veri tiplerini kullanın (string, sayılar, boolean, diziler)

  4. Zaman Damgası İşleme: Zamana duyarlı event’ler için zaman damgaları ekleyin

  5. Doğrulama: Göndermeden önce tüm gerekli özelliklerin mevcut olduğunu doğrulayın