Website Kurulumu (Hard-coded)
Web uygulamalarınız için Hardal’ı kurun ve yapılandırın
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
Hardal Script'inizi Alın
- Hardal hesabınıza giriş yapın
- Ayarlara gidin
- “Setup” sekmesinden Hardal Script’inizi kopyalayın
Script'i Ekleyin
Hardal Script’inizi HTML dosyanıza, tercihen <head>
bölümüne ekleyin. Script aşağıdaki gibi görünmelidir:
<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.
Kurulumu Doğrulayın
Kurulumunuzu doğrulamak için:
- Tarayıcınızın developer tools’unu açın (F12 veya sağ tıklayıp → Inspect)
- Network sekmesine gidin
- Sayfanızı yenileyin
- Hardal endpoint’inize yapılan istekleri kontrol edin
- Sayfa görüntüleme event’lerinin başarıyla gönderildiğini doğrulayın
- 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:
Yaygın Event Örnekleri (Data Layer Yöntemi)
Yöntem 2: hardal.track() Kullanımı (Alternatif)
Custom event’leri göndermek için hardal.track()
metodunu da kullanabilirsiniz:
Yaygın Event Örnekleri (hardal.track Yöntemi)
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.