Measurement Protocol ile GA4
Hardal analitik verilerinizi Measurement Protocol kullanarak Google Analytics 4’e nasıl göndereceğinizi öğrenin
Genel Bakış
Bu rehber, Hardal analitik verilerinizi Measurement Protocol kullanarak doğrudan Google Analytics 4’e (GA4) nasıl göndereceğinizi açıklar. Bu server-to-server entegrasyonu, client-side tracking ad blocker’lar veya gizlilik kontrolleri tarafından sınırlandırıldığında bile doğru analitiği korumayı sağlar.
Ön Koşullar
Bu entegrasyonu kurmadan önce, şunlara sahip olduğunuzdan emin olun:
-
Tracking script’i kurulu aktif bir Hardal hesabı
-
Google Analytics 4 özelliğinize erişim
-
Websiteniz veya uygulamanız için oluşturulmuş bir GA4 veri akışı
-
GA4 özelliğinizden API secret ve Measurement ID
-
HTTP istekleri ve JSON hakkında temel bilgi
GA4 Measurement Protocol Kurulumu
GA4 API kimlik bilgilerinizi alın
Google Analytics'e giriş yapın
analytics.google.com adresinden Google Analytics 4 özelliğinize erişin
Data Streams'e gidin
Admin > Data Streams’e gidin ve web veri akışınızı seçin
API secret'lara erişin
Akış ayarlarında Measurement Protocol API secrets’a tıklayın
Yeni bir secret oluşturun
Yeni bir API secret oluşturmak için Create butonuna tıklayın
Kimlik bilgilerini kopyalayın
Hem Measurement ID’nizi (G-XXXXXXXX) hem de yeni oluşturulan API Secret’ı kopyalayın
Hardal Entegrasyonunu Yapılandırma
Hardal destinations’a erişin
Hardal'a giriş yapın
app.usehardal.com adresinden Hardal dashboard’unuza giriş yapın
Marketing Destinations'a erişin
Ana menüdeki Marketing Destinations bölümüne gidin
Yeni destination ekleyin
Add Custom Destination butonuna tıklayın
GA4 şablonunu seçin
Mevcut şablonlardan “GA4 Measurement Protocol”ü seçin (veya mevcut değilse custom API bağlantısı oluşturun)
Endpoint Yapılandırması
GA4 endpoint’inizi aşağıdaki ayarlarla yapılandırın:
Event Eşleştirme
Temel Event Eşleştirme
Entegrasyon, yaygın Hardal event’lerini otomatik olarak GA4 event’lerine eşleştirir. İşte temel event’lerin nasıl eşleştirildiği:
Hardal Event | GA4 Event |
---|---|
page_view | page_view |
click | click |
purchase | purchase |
add_to_cart | add_to_cart |
begin_checkout | begin_checkout |
view_item | view_item |
Özel Event Eşleştirme
Özel event’ler için, özel bir eşleştirme oluşturmanız gerekebilir. İşte bir e-ticaret satın alma event’i için örnek bir eşleştirme:
Gelişmiş Yapılandırma
Kullanıcı Özelliklerini Dahil Etme
Event’lerinizle birlikte kullanıcı özelliklerini dahil etmek için, istek formatınıza bir user_properties
nesnesi ekleyin:
Özel Parametreler Ayarlama
Gelişmiş kullanım durumları için, event’lerinize özel parametreler dahil edebilirsiniz:
Event Doğrulama
Entegrasyonunuzu kurduktan sonra, event’lerin düzgün şekilde alındığını doğrulayın:
-
Hardal üzerinden test event’leri gönderin
-
GA4 DebugView’da event’lerin görünüp görünmediğini kontrol edin
-
Event’lerin GA4 raporlarında göründüğünü doğrulayın (24 saate kadar sürebilir)
Entegrasyonunuzu kurduktan sonra, event’lerin düzgün şekilde alındığını doğrulayın:
-
Hardal üzerinden test event’leri gönderin
-
GA4 DebugView’da event’lerin görünüp görünmediğini kontrol edin
-
Event’lerin GA4 raporlarında göründüğünü doğrulayın (24 saate kadar sürebilir)
-
Gerçek zamanlı event verilerini görmek için GA4 DebugView kullanın
-
Parametre değerlerinin doğru göründüğünden emin olun
-
client_id’nin düzgün ayarlandığını doğrulayın
-
Her event’te session_id’nin dahil edildiğinden emin olun
-
Eksik gerekli parametreler (client_id, session_id)
-
Yanlış Measurement ID veya API Secret
-
İstek gövdesinde hatalı JSON formatı
-
Limit aşan parametre değerleri uzunluğu
-
İstek limitlerini aşma (istek başına maksimum 25 event)
En İyi Uygulamalar
Performans Düşünceleri
-
Mümkün olduğunda birden çok event’i tek bir istekte toplu işleyin (25 event’e kadar)
-
Başarısız istekler için hata yönetimi ve yeniden deneme mantığı uygulayın
-
Yüksek trafik hacimlerini yönetmek için uygun önbelleğe alma stratejileri kullanın
Veri Kalitesi
-
Tüm event’lerle session_id ve engagement_time_msec dahil edin
-
Tutarlı parametre adlandırma kuralları kullanın
-
Kişisel Tanımlayıcı Bilgileri (PII) göndermekten kaçının
-
Göndermeden önce veri formatlarını doğrulayın (özellikle para birimi değerleri için)
Gizlilik Uyumluluğu
-
Veri toplamanızın gizlilik düzenlemelerine uyduğundan emin olun
-
Uygulanabilir olduğunda kullanıcı onay tercihlerine saygı gösterin
-
Gizlilik politikanızda uygun açıklamaları dahil edin
-
Hassas bilgiler için veri filtreleme uygulamayı düşünün
Sorun Giderme
Tam Uygulama Örneği
İşte Hardal’da GA4’e e-ticaret satın alma event’leri gönderen özel bir destination kurmak için tam bir uygulama örneği:
Sınırlamalar
Bu GA4 Measurement Protocol sınırlamalarının farkında olun:
-
İstek başına maksimum 25 event
-
Event başına maksimum 25 parametre
-
İstek başına maksimum 25 kullanıcı özelliği
-
Kullanıcı özelliği adları 24 karakterle sınırlıdır
-
Kullanıcı özelliği değerleri 36 karakterle sınırlıdır
-
Event adları 40 karakterle sınırlıdır
-
Parametre adları 40 karakterle sınırlıdır
-
Parametre değerleri 100 karakterle sınırlıdır (GA4 360 için 500)
-
Maksimum istek gövdesi boyutu 130KB