GA4 dosya indirme olayları nasıl doğrulanır?

GA4’te dosya indirme takibini doğrulamak için önce bir dosya bağlantısını gerçekten tıklayın, ardından GA4 içindeki DebugView ve Gerçek zamanlı raporlarında file_download olayını arayın. Olay görünüyorsa dosya tıklaması GA4’e ulaşmıştır; görünmüyorsa ölçüm yapılandırmasını, bağlantı türünü veya tarayıcı engellemelerini kontrol etmelisiniz. Standart raporlarda verinin görünmesi DebugView kadar hızlı olmayabilir.

Dosya indirme olayı nasıl çalışır?​

GA4’in geliştirilmiş ölçüm özelliklerinde dosya indirme ölçümü etkinse, desteklenen bir dosya bağlantısına tıklanması file_download adlı olay oluşturabilir. Olayla birlikte dosya adı, uzantı, bağlantı metni ve bağlantı adresi gibi parametreler gönderilebilir. Bu işlem, dosyanın sunucudan başarıyla indirildiğini değil, kullanıcının dosya bağlantısını tıkladığını gösterir.

Örneğin bir sayfada şu bağlantı bulunduğunu varsayalım:


Bu bağlantıya tıklanmasından sonra DebugView’da file_download görülürse tıklama ölçülmüştür. Parametrelerde dosya adının urun-kilavuzu.pdf veya bağlantı adresinin ilgili dosya yolunu göstermesi, doğru bağlantının yakalandığını kontrol etmenize yardımcı olur.

Doğrulama adımları​

1. GA4 mülkünün doğru web veri akışında ölçüm kimliğinin bulunduğunu ve veri toplamaya devam ettiğini kontrol edin. Yanlış mülk veya akış açıkken yapılan test, doğru kurulumu hatalı gösterebilir.
2. GA4 arayüzünde DebugView’ı açın. DebugView’ın test ziyaretini tanıması için Google etiketinin debug sinyaliyle çalışması gerekir; Google Tag Assistant gibi bir test aracı kullanıyorsanız bağlantıyı test modunda açın.
3. Web sitenizde ölçülmesini istediğiniz PDF, ZIP veya benzeri desteklenen dosya bağlantısını test sayfasından normal biçimde tıklayın. Test sırasında mümkünse reklam ve çerez engelleyicilerini geçici olarak devre dışı bırakın; bunlar etiketi veya isteği engelleyebilir.
4. DebugView’da file_download olayını seçin. Olay hiç görünmüyorsa etiketin yüklenmesini, izin durumunu ve geliştirilmiş ölçümde dosya ölçümünün etkin olup olmadığını inceleyin.
5. Olayı açarak file_name, file_extension, link_text ve link_url gibi parametreleri kontrol edin. Değerler başka bir dosyaya aitse yanlış bağlantıyı test ediyor veya özel bir etiket yanlış veri gönderiyor olabilir.
6. Aynı testi Gerçek zamanlı raporda da kontrol edin. Gerçek zamanlı görünüm destekleyici bir kontroldür; kesin teşhis için olay ayrıntılarının ve test oturumunun doğru mülkte incelenmesi gerekir.
7. Test tamamlandıktan sonra normal kullanıcı davranışını bozmayacak şekilde raporları veya Keşifleri kullanarak file_download olayının sonraki veri işleme sürecinde görünüp görünmediğini kontrol edin. Olayı anahtar etkinlik olarak işaretlemediyseniz anahtar etkinlik raporunda aramayın.

Aşağıdaki ayrım, test sonucunu yorumlamayı kolaylaştırır:


Otomatik ölçüm, belgelenmiş yaygın uzantılara sahip bağlantıları tanır. Dosya gerçekte PDF olsa bile /download?id=42 gibi uzantısız bir uç nokta veya JavaScript’in ürettiği blob indirmesi aynı şekilde otomatik yakalanmayabilir. Gerçek URL ve etkileşimi test edin; dosyanın tarayıcıda açılmasıyla diske kaydedilmesi de farklıdır.

Olay görünmüyorsa ne yapılmalı?​

Önce test ettiğiniz bağlantının gerçekten bir dosya adresine gittiğini kontrol edin. JavaScript ile sonradan oluşturulan, indirmeyi özel bir butonla başlatan veya dosyayı yeni bir uygulama penceresinde açan bağlantılar otomatik ölçüm kapsamına girmeyebilir. Bu durumda Google Tag Manager veya gtag.js üzerinden özel bir olay tasarlanabilir; ancak özel olay adı ve parametreleri, mevcut otomatik file_download olayıyla çakışmayacak biçimde planlanmalıdır.

Consent Mode veya çerez izni verilmemesi, reklam ve gizlilik eklentileri, yanlış GA4 ölçüm kimliği ve farklı bir veri akışında test yapılması en yaygın nedenlerdir. Ayrıca indirme bağlantısına tıklamadan önce sayfadan ayrılmak, etiketin yüklenmesine fırsat bırakmamak veya DebugView’ı test sinyali olmadan izlemek de yanıltıcı sonuç verebilir.

Olay görünüyor fakat standart raporda görünmüyorsa hemen kurulumu değiştirmeyin. DebugView ve Gerçek zamanlı rapor doğruysa veri işleme gecikmesi veya rapor filtresi söz konusu olabilir. Dosya indirmelerini iş hedefi olarak kullanacaksanız, yalnızca doğrulanmış olay adını anahtar etkinlik olarak işaretleyin ve aynı tıklamayı hem otomatik hem özel etiketle çift göndermediğinizden emin olun.

Kaynaklar​

• Google Analytics: Otomatik dosya indirme olayları
• Google Analytics: DebugView

Sık sorulan sorular​

file_download olayının görünmesi dosyanın kesin indirildiğini kanıtlar mı?​

Hayır. Bu olay esas olarak dosya bağlantısına yapılan tıklamayı gösterir. Sunucu/CDN durum kodları, aktarılan baytlar ve aralıklı istekler aktarımı incelemeye yardımcı olur. HTTP 200/206 kaydı bile dosyanın kullanıcı tarafından kaydedildiğini veya açıldığını kesin kanıtlamaz; bu iddiayı tıklama metriğine yüklemeyin.

Bir dosyayı anahtar etkinlik olarak işaretlemek gerekir mi?​

Hayır. Dosya indirme yalnızca analiz amacıyla izleniyorsa normal olay olarak bırakılabilir. İşletme açısından değerli bir tamamlanma göstergesiyse anahtar etkinlik olarak işaretlenebilir; bu karar olayın görünmesinden bağımsızdır.

DebugView’da olay varken raporda neden kullanıcı sayısı farklı olabilir?​

DebugView tek bir test oturumunu gösterir; raporlar filtreler, kimlik birleştirme, izin durumu ve işleme kurallarıyla farklı sonuçlar sunabilir. Önce aynı mülk, veri akışı ve tarih kapsamının kullanıldığını kontrol edin.