Genel Bakış

Hardal Web Script, web uygulamalarınızdan kullanıcı davranışlarını takip etmenizi ve analytics verilerini toplamanızı sağlar. Bu rehber, temel kurulum ve yapılandırma sürecinde size yol gösterecektir.

Hazırlık

Kuruluma başlamadan önce, aşağıdakilere sahip olduğunuzdan emin olun:

  • Websitenizin HTML kaynak koduna erişim
  • Hardal dashboard’unuza admin erişimi
  • HTML ve JavaScript hakkında temel bilgi

First-party veri sahipliği için custom domain oluşturmanız önerilir. Kurulumdan önce bir custom domain oluşturmak en iyi uygulamadır.

Kurulum

1

Hardal Script'inizi Alın

  1. Hardal hesabınıza giriş yapın
  2. Ayarlara gidin
  3. “Setup” sekmesinden Hardal Script’inizi kopyalayın

2

Script'i Ekleyin

Hardal Script’inizi HTML dosyanıza, tercihen <head> bölümüne ekleyin. Script aşağıdaki gibi görünmelidir:

<script>
  !function() {
    var hardalEndpoint = "https://<your-hardal-signal-id>-signal.usehardal.com";
    
    // Create script element
    var script = document.createElement('script');
    script.async = true;
    script.src = hardalEndpoint + "/hardal";
    
    // Add data attributes for configuration
    script.setAttribute('data-website-id', '<your-hardal-signal-id>'); 
    script.setAttribute('data-host-url', hardalEndpoint);
    script.setAttribute('data-auto-track', 'true');
     
    // Insert script into the document
    var firstScript = document.getElementsByTagName('script')[0];
    firstScript.parentNode.insertBefore(script, firstScript);
  }();
</script>

<your-hardal-signal-id> kısmını gerçek Signal ID’niz ile değiştirin.

Aynı setup sayfasında custom domain oluşturup kontrol ederseniz, Hardal Script’iniz ilgili endpoint ile güncellenecektir.

3

Kurulumu Doğrulayın

Kurulumunuzu doğrulamak için:

  1. Tarayıcınızın developer tools’unu açın (F12 veya sağ tıklayıp → Inspect)
  2. Network sekmesine gidin
  3. Sayfanızı yenileyin
  4. Hardal endpoint’inize yapılan istekleri kontrol edin
  5. Sayfa görüntüleme event’lerinin başarıyla gönderildiğini doğrulayın
  6. Hardal Dashboard’unuzu kontrol ederek real-time event’lerin uygun şekilde yansıdığını görün

Custom Event Tracking

Hardal script yalnızca sayfa görüntüleme event’lerini otomatik olarak gönderir. Diğer tüm event’ler (satın almalar, sepete ekleme vb.) aşağıdaki yöntemlerden birini kullanarak eklenmelidir.

Yöntem 1: Hardal Data Layer Kullanımı (Önerilen)

Custom event’leri izlemenin önerilen yolu Hardal Data Layer kullanmaktır. Bu yaklaşım, tag management sistemleriyle daha iyi uyumluluk ve daha kolay hata ayıklama sağlar.

Data layer’ı başlatın ve event’leri gönderin:

window.hardalDataLayer = window.hardalDataLayer || [];
window.hardalDataLayer.push({
  event: 'event_adı',
  özellik1: değer1,
  özellik2: değer2
});

Yaygın Event Örnekleri (Data Layer Yöntemi)

<script>
window.hardalDataLayer = window.hardalDataLayer || [];
window.hardalDataLayer.push({
  event: 'add_to_cart',
  currency: "TRY",
  value: dataLayerValue,
  items: dataLayerItems
});
</script>

Yöntem 2: hardal.track() Kullanımı (Alternatif)

Custom event’leri göndermek için hardal.track() metodunu da kullanabilirsiniz:

hardal.track(eventName, eventProperties);

Yaygın Event Örnekleri (hardal.track Yöntemi)

<script>
hardal.track("add_to_cart", {
  currency: "TRY",
  value: dataLayerValue,
  items: dataLayerItems
});
</script>

Data Layer Değişkenleri

Google Tag Manager uygulamasında, tipik olarak çift süslü parantez kullanarak data layer değişkenlerine referans verirsiniz. Örneğin: DLV - Value, DLV - Transaction ID ve DLV - ecommerce.items.

Tam değişken adları, özel uygulamanıza bağlı olacaktır.

Her müşterinin şunlar için farklı değişken adları olabilir:

  • İşlem ID’leri
  • Ürün değerleri
  • Öğe dizileri
  • Para birimi formatları

Özel uygulamanız için doğru değişkenlerin kullanıldığından emin olmak için geliştirme ekibinizle birlikte çalışın.

Sorun Giderme

Yaygın Kurulum Sorunları