GA4 DebugView nasıl kullanılır?

GA4 DebugView, web sitenizden veya uygulamanızdan gönderilen olayları test sırasında neredeyse anlık görmenizi sağlar. Bir sayfa görüntüleme, form gönderimi ya da satın alma gibi olayın GA4'e ulaşıp ulaşmadığını; olay adını, parametrelerini ve kullanıcı özelliklerini kontrol etmek için kullanılır. DebugView'ı açmak tek başına veri üretmez; test ettiğiniz cihazın GA4'e hata ayıklama sinyali göndermesi gerekir.

Başlamadan önce​

Önce doğru GA4 mülkünü ve veri akışını seçin. Web sitenizde Google etiketi, gtag.js veya Google Etiket Yöneticisi üzerinden GA4 ölçümü çalışıyor olmalıdır. Çerez onayı veya Consent Mode kullanılıyorsa, test sırasında analitik depolamaya izin verilmediğinde olayların DebugView'da görünmemesi normaldir.

Testi mümkünse ayrı bir test mülkünde yapın. Gerçek mülkte yapılan testler, kullanılan kuruluma ve işleme durumuna bağlı olarak etkinlik verilerinin raporlara karışmasına neden olabilir. Ayrıca tarayıcı eklentileri, reklam engelleyiciler ve kurumsal ağ filtreleri ölçüm isteklerini engelleyebilir.

DebugView nasıl kullanılır?​

1. GA4 mülkünüzü açın ve DebugView paneline gidin. Panel, hata ayıklama sinyali gönderen cihazlardan gelen kullanıcıları ve olay akışını gösterir.
2. Test yöntemini etkinleştirin. Google Etiket Yöneticisi kullanıyorsanız ilgili konteyner için Önizleme modunu başlatın. Doğrudan gtag.js kullanıyorsanız yalnız test cihazınıza koşullandırılmış mevcut config çağrısına debug_mode ekleyin; ikinci bir config çağrısını körlemesine eklemek fazladan page_view üretebilir. Aşağıdaki kimliği kendi test akışınızın kimliğiyle değiştirin:
   
   Kod:

   <script>
   gtag('config', 'G-XXXXXXXXXX', { debug_mode: true });
   </script>

3. Tag Assistant/Önizleme ile bağladığınız test penceresini kullanın; bağlantısız yeni bir gizli pencere debug ayarını devralmayabilir. Test sayfasını gerektiğinde aynı bağlı oturumda yenileyin. Test etmek istediğiniz işlemi yalnızca bir kez gerçekleştirin; böylece hangi olayın hangi adımdan geldiğini ayırt edebilirsiniz.
4. DebugView'da ilgili cihazı seçin. Zaman akışındaki olay adına tıklayarak olay parametrelerini, değerlerini ve varsa kullanıcı özelliklerini inceleyin.
5. Beklenen olay görünüyorsa olay adını ve parametrelerini GA4'te tanımladığınız planla karşılaştırın. Özellikle büyük-küçük harf, alt çizgi, parametre adı ve değer türü farklılıklarını kontrol edin.
6. Testi tamamladıktan sonra GTM Önizleme bağlantısını kapatın ve yalnız test için eklenen debug_mode alanını kaldırın. Alanı false yapmak Google’ın belgesine göre debug modunu kapatmaz; alanı hiç göndermemek gerekir. Ardından normal raporlarda kullanılacak gerçek ölçüm akışını ayrıca doğrulayın.

Doğrudan gtag.js yerine Google Etiket Yöneticisi kullanıyorsanız, debug_mode değerini GA4 yapılandırma etiketinde veya yalnızca test edeceğiniz GA4 olay etiketinde etkinleştirebilirsiniz. Aynı olayın birden fazla etiket tarafından gönderilmediğinden emin olun; aksi halde DebugView'da görünen tekrarlar kurulum hatası gibi görünebilir.

Görünen sonuca göre ne yapmalı?​

DebugView'da olayın görünmesi, isteğin GA4'e ulaştığını gösterir; olayın iş raporlarında doğru şekilde kullanılacağı anlamına gelmez. Bunun için olay adının, parametrelerinin ve dönüşüm olarak işaretlenen olayların ayrıca kontrol edilmesi gerekir.


Bir olay görünmüyorsa önce birkaç saniye bekleyip doğru cihaz seçiminizi kontrol edin; ardından seçili Debug Device kaydının gerçekten test sinyali gönderen cihazınıza ait olduğundan emin olun. GA4 panelini ve test sitesini aynı sekmede açmak gerekmez. Sorun devam ederse tarayıcının geliştirici araçlarında ağ isteklerinin oluşup oluşmadığını ve etiket yöneticisinin önizleme hata panelini inceleyin. İstek hiç oluşmuyorsa sorun GA4 raporunda değil, etiketin yüklenmesi veya tetiklenmesindedir.

Parametrenin DebugView’da görünmesi için mutlaka özel boyut kaydı açılması gerekmez. Ancak bazı özel parametreleri standart rapor/Keşif boyutu olarak kullanmak için uygun kapsamda özel tanım gerekir; bu kayıt geçmiş veriyi geriye dönük doldurmaz. Debug modu açmak da geliştirici trafiğini kendiliğinden bütün raporlardan çıkarmaz; gerekiyorsa ilgili veri filtresini ayrıca test edin.

Sık yapılan hatalar​

Yanlış mülkte test yapmak: Ölçüm kimliğinin test ettiğiniz GA4 veri akışına ait olduğunu doğrulayın.

DebugView'ı normal rapor sanmak: DebugView teknik doğrulama içindir. Standart raporların işlenmesi ve boyutların kullanılabilir hale gelmesi farklı süreçlerdir.

Sadece olay adına bakmak: Olayın görünmesi yeterli değildir. Değer, para birimi, ürün kimliği veya form türü gibi iş açısından gerekli parametreleri de kontrol edin.

Test ayarını kalıcı bırakmak: debug_mode değerini üretim kurulumunda gereksiz yere sürekli açık bırakmayın; test tamamlanınca ayarı kaldırıp normal kullanıcı akışını yeniden doğrulayın.

Kaynaklar​

• Google Analytics: DebugView ve debug_mode
• Google Analytics: Olayların işlenmesi

Sık sorulan sorular​

DebugView'da olay neden birkaç saniye sonra görünüyor?​

İstek ile arayüzün olayı göstermesi arasında kısa bir gecikme olabilir. Önce doğru cihazın seçildiğini ve test sinyalinin açık olduğunu kontrol edin; uzun süre hiçbir olay gelmiyorsa etiket ve izin ayarlarını inceleyin.

DebugView'da gördüğüm olay neden normal raporda hemen yok?​

DebugView anlık teknik kontrol ekranıdır. Normal raporların işlenmesi, filtreleri ve boyutları farklı olduğundan aynı olayın raporlarda görünme zamanı ve biçimi farklı olabilir.