Genel Bakış

Hardal, ziyaretçi verilerini first-party bir veri hattı üzerinden toplama ve işleme imkanı sunan bir server-side analytics çözümüdür. Bu rehber, website kodunuzu doğrudan değiştirmeden uygulama ve yönetimi kolaylaştıran Google Tag Manager (GTM) kullanarak Hardal’ı websitenize nasıl kuracağınızı adım adım anlatacaktır.

Hardal’ı GTM üzerinden kurarak, website kodunuzu doğrudan değiştirmeden analytics uygulamanızı kolayca yönetebilirsiniz.

Hazırlık

Kuruluma başlamadan önce, şunlara sahip olduğunuzdan emin olun:

  • Google Tag Manager hesabınıza erişim
  • Signal ID ve endpoint URL içeren bir Hardal hesabı
  • GTM container değişikliklerini yayınlamak için admin yetkileri
  • GTM trigger’ları ve değişkenleri hakkında temel bilgi

Hardal Tag Kurulumu

1

Hardal Script'inizi Alın

  1. Hardal hesabınıza giriş yapın
  2. Ayarlara gidin

  1. “Setup” sekmesinden Hardal Script’inizi kopyalayın
2

Bir Hardal Tag'i Oluşturun

  1. Google Tag Manager hesabınıza giriş yapın
  2. Web GTM container’ınızı seçin
  3. Sol menüden Tags seçeneğine gidin
  4. Yeni bir tag oluşturmak için New butonuna tıklayın
  5. Tag’inize “Hardal” adını verin
  6. Tag configuration alanına tıklayın

  1. Tag türü olarak Custom HTML seçin
3

Hardal Script'ini Ekleyin

  • Hardal Script’inizi Tag’inizin HTML koduna yapıştırın.

Hardal için custom domain kurduysanız, varsayılan endpoint yerine hardalEndpoint olarak kendi domain’inizi kullanın.

4

Tag için Trigger Ayarlayın

  1. Triggering bölümüne tıklayın
  2. Tag’in tüm sayfalarda çalışması için All Pages trigger’ını seçin
  3. Alternatif olarak, sadece belirli sayfaları izlemek istiyorsanız özel bir trigger oluşturun
5

Tag'i Kaydedin

  1. Tag yapılandırmanızı kaydetmek için Save butonuna tıklayın

Önemli: Temel Hardal kurulumu SADECE otomatik olarak sayfa görüntülemelerini takip eder. Satın alma, sepete ekleme vb. diğer event’leri takip etmek için ek tag’ler oluşturmanız gerekir.

Event Tracking Kurulumu

Temel sayfa görüntülemelerin ötesinde event’leri takip etmek için, Hardal Google Tag Manager ile sorunsuz çalışan bir data layer yaklaşımı sunar:

1

Event'e Özel Tag'ler Oluşturun

İzlemek istediğiniz her event için GTM’de yeni bir Custom HTML tag’i oluşturun:

  1. Tags bölümüne gidin ve New butonuna tıklayın
  2. Tag’inize bir isim verin (örn. “Hardal - Purchase”, “Hardal - Add To Cart”, vb.)

  1. Tag türü olarak Custom HTML seçin
2

Event Tracking Kodunu Ekleyin

İzlemek istediğiniz event için Hardal Data Layer yöntemini kullanarak uygun kod parçasını ekleyin:

Purchase Event:

<script>
window.hardalDataLayer = window.hardalDataLayer || [];
window.hardalDataLayer.push({
  event: 'purchase',
  transaction_id: {{Transaction ID}},
  currency: {{Currency}},
  value: {{Value}},
  items: {{Items}}
});
</script>

Add to Cart Event:

<script>
window.hardalDataLayer = window.hardalDataLayer || [];
window.hardalDataLayer.push({
  event: 'add_to_cart',
  currency: {{Currency}},
  value: {{Value}},
  items: {{Items}}
});
</script>

View Item Event:

<script>
window.hardalDataLayer = window.hardalDataLayer || [];
window.hardalDataLayer.push({
  event: 'view_item',
  currency: {{Currency}},
  value: {{Value}},
  items: {{Items}}
});
</script>

Google Tag Manager’da, yer tutucu değişkenleri (, gibi) değişken seçme arayüzünü kullanarak gerçek GTM değişkenlerinizle değiştirin.

3

Event Tag'leri için Trigger'lar Oluşturun

  1. Her event tag’i için Triggering bölümüne tıklayın
  2. Event için uygun trigger’ı oluşturun veya seçin

  1. Yaygın trigger’lar şunları içerir:
    • Custom Event trigger’ları (örn. “Custom Event - Purchase”)
    • Click trigger’ları (düğme tıklamalarını izlemek için)
    • Form submission trigger’ları
    • History change trigger’ları (tek sayfalı uygulamalar için)
4

Her Event Tag'ini Kaydedin ve Test Edin

  1. Yapılandırmadan sonra her event tag’ini kaydedin
  2. GTM Preview modu kullanarak tag’leri tek tek test edin (Doğrulama bölümüne bakın)

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

Hardal Data Layer önerilen yaklaşım olsa da, alternatif olarak doğrudan hardal.track() metodunu da kullanabilirsiniz:

<script>
hardal.track("add_to_cart", {
  currency: {{Currency}},
  value: {{Value}},
  items: {{Items}}
});
</script>

Hardal Data Layer yaklaşımı, data layer standartlarıyla daha iyi uyumlu olduğu ve tag management sistemleriyle daha iyi uyumluluk sağladığı için tercih edilmektedir.

Değişken Kurulumu

Event’leri düzgün şekilde izlemek için, özel data layer yapınıza karşılık gelen GTM değişkenleri kurmanız gerekecektir.

Google Tag Manager’da, tag’leri düzenlerken değişken seçimi butonuna (yapboz parçası simgesi) tıklayarak değişkenleri seçersiniz.

Kurmanız gereken yaygın değişkenler:

İhtiyaç Duyulan VeriDeğişken AmacıAçıklama
Transaction IDSatın alma event’leri içinSatın alma işlemleri için benzersiz kimlik
ValueParasal değerler içinEvent’in parasal değeri
ItemsÜrün detayları içinÜrün bilgileri dizisi
Currencyİşlem detayları içinİşlem para birimi
CustomÖzel ihtiyaçlar içinÖzel veri

Bu değişkenleri oluşturmak için:

  1. GTM’de Variables bölümüne gidin
  2. User-Defined Variables altında New butonuna tıklayın
  3. Tür olarak Data Layer Variable seçin
  4. Data layer yolunu girin (örn. “ecommerce.items”)
  5. Değişkeni uygun bir isimle kaydedin

Yapılandırmanızı Yayınlama

1

Önizleme ve Test

  1. Yayınlamadan önce tag’lerinizi test etmek için Preview butonuna tıklayın
  2. Tüm tag’lerin beklendiği gibi çalıştığını doğrulayın (Doğrulama bölümüne bakın)
2

Gönder ve Yayınla

  1. Test tamamlandıktan sonra, Submit butonuna tıklayın
  2. Versiyon adı ve açıklaması ekleyin
  3. Değişikliklerinizi yayınlamak için Publish butonuna tıklayın

Doğrulama

Kurulumdan sonra, Hardal’ın doğru çalıştığını şu şekilde doğrulayabilirsiniz:

1

GTM Preview Mode Kullanın

  1. GTM arayüzünüzde Preview butonuna tıklayın
  2. Website URL’nizi girin ve Start butonuna tıklayın
  3. Websiteniz GTM debug paneli ile açılacaktır
  4. Hardal temel tag’inin sayfa yüklendiğinde çalıştığını doğrulayın
  5. Event tag’lerinizi tetiklemesi gereken eylemleri gerçekleştirin (satın almalar, sepete ekleme, vb.)
  6. Bu tag’lerin uygun zamanlarda çalıştığını doğrulayın
2

Network İsteklerini Kontrol Edin

  1. Tarayıcınızın geliştirici araçlarını açın (F12 veya Sağ tıklama > İncele)
  2. Network sekmesine gidin
  3. Sayfayı yenileyin
  4. Hardal endpoint domain’inize yapılan istekleri arayın
  5. Event’lerin başarıyla gönderildiğini doğrulayın
3

Hardal Dashboard'ı Kontrol Edin

  1. Hardal dashboard’unuza giriş yapın
  2. Analytics bölümüne gidin
  3. Verilerin doğru şekilde toplanıp görüntülendiğini doğrulayın

Sorun Giderme