- Konu sahibi
- #1
GA4’te iade olayını doğrulamak için önce gönderilen olayın adının
Tam iade için olay, satın alma işlemindeki işlem kimliğini kullanmalıdır. Kısmi iadede ise iade edilen tutar ve mümkünse iade edilen ürünler gönderilmelidir. Aşağıdaki gtag örneği, etiketi kurulmuş ayrı test ortamında yalnız doğrulanmış iade sonucuna bağlanacak yapı örneğidir. GA4’e refund göndermek ödeme sisteminden para iade etmez:
Bu örnekte
Başarılı kontrolde olay adı
Aynı olayı farklı katmanlarda incelemek, sorunun gönderimde mi yoksa raporlamada mı olduğunu anlamayı kolaylaştırır.
En yaygın hata, satın alma sırasında kullanılan işlem kimliği yerine iade kaydı için yeni bir kimlik göndermektir. Bir diğer hata, kısmi iade tutarı yerine orijinal siparişin tamamını göndermek veya kısmi iadede iade edilmeyen ürünleri de
Önce raporların işlenme süresini bekleyin ve doğru GA4 mülkü ile tarih aralığını açtığınızı kontrol edin. Ham veride olayın bulunması, rapor arayüzündeki toplulaştırmanın tamamlandığı anlamına gelmeyebilir.
Ayrı bir test mülkü veya test sipariş akışı kullanın. Gerçek siparişin iadesini yalnızca analitik testi için tetiklemek yerine, üretim entegrasyonunun gönderdiği veriyi kontrollü bir işlemle inceleyin.
refund olduğunu, transaction_id değerinin orijinal satın alma işlemindeki değerle aynı olduğunu ve iade tutarıyla para biriminin doğru aktarıldığını kontrol edin. Ardından olayı DebugView’da görün, daha sonra raporlarda veya ham veride iade gelirinin işlendiğini doğrulayın. DebugView’da görünmesi, iadenin raporlara hemen yansıdığı anlamına gelmez.Doğrulanması gereken alanlar
Tam iade için olay, satın alma işlemindeki işlem kimliğini kullanmalıdır. Kısmi iadede ise iade edilen tutar ve mümkünse iade edilen ürünler gönderilmelidir. Aşağıdaki gtag örneği, etiketi kurulmuş ayrı test ortamında yalnız doğrulanmış iade sonucuna bağlanacak yapı örneğidir. GA4’e refund göndermek ödeme sisteminden para iade etmez:
JavaScript:
gtag('event', 'refund', {
transaction_id: 'SIPARIS-1001',
value: 249.90,
currency: 'TRY',
items: [{
item_id: 'URUN-42',
quantity: 1,
price: 249.90
}]
});Bu örnekte
SIPARIS-1001 değeri, daha önce gönderilmiş purchase olayındaki işlem kimliğiyle birebir aynı olmalıdır. currency değeri sitenin işlem sırasında kullandığı para birimiyle eşleşmelidir. Ürün bazlı iade gönderiliyorsa items içindeki ürün, miktar ve fiyat bilgisi gerçekten iade edilen kısmı göstermelidir.value ve ürün miktarlarını iade edilen bölüm için pozitif değerlerle gönderin; negatif purchase üretmeyin. Ürün toplamı, iade edilen price × quantity değerleriyle tutarlı olmalı, kargo/vergi uygun alanlarda ayrı ele alınmalıdır. Aynı siparişe ait iki farklı kısmi iade aynı orijinal transaction_id kullanabilir; gerçek ayrı iadeleri tekrar gönderimle karıştırmamak için uygulamadaki iade kaydı kimliğiyle kendi tekilleştirme takibinizi yapın. Purchase tekilleştirme kuralının bütün refund tekrarlarını otomatik çözdüğünü varsaymayın.Uygulamalı doğrulama adımları
- Test ortamında veya gerçek sipariş verisi üretmeyen kontrollü bir işlemde iade akışını başlatın. İade işlemi tamamlanmadan GA4’e
refundgöndermeyin; yalnızca sipariş iptali ile para iadesini birbirine karıştırmayın. - Kullandığınız etiket yöneticisi, e-ticaret eklentisi veya sunucu entegrasyonunda olay adını
refundolarak kontrol edin.Refund,refund_eventveya Türkçe bir ad kullanılması GA4’ün önerilen e-ticaret olayından farklıdır. - İstek gönderilmeden hemen önce tarayıcı geliştirici araçlarının Network bölümünü veya etiket yöneticisinin önizleme ekranını açın. Etikete verilen nesnede işlem kimliği, tutar, para birimi ve ürün listesini doğrulayın; tarayıcı gönderimi bunları kodlanmış alanlarla taşıyabilir, düz JSON beklemeyin. Sunucu entegrasyonunda ise isteği sunucunun kendi kontrollü teşhis kaydından inceleyin; API sırrını tarayıcıya veya günlüğe çıkarmayın.
- GA4 mülkünde DebugView’ı açın ve aynı test oturumundan gelen
refundolayını seçin. Olay ayrıntılarında parametre adlarını ve değerlerini tek tek inceleyin. - İşlem kimliğini GA4’teki satın alma olayıyla karşılaştırın. Kimlik farklıysa iade, satın alma işlemiyle eşleştirilemez; yeni bir rastgele kimlik üretmek yerine orijinal sipariş kimliğini kullanın.
- Son olarak e-ticaret raporlarını veya erişilebiliyorsa dışa aktarılan ham veriyi kontrol edin. İade tutarının ilgili gelir metriklerine yansıması işleme gecikmesine bağlı olabilir; DebugView sonucu ile rapor sonucunu aynı anda beklemeyin.
Başarılı kontrolde olay adı
refund olarak görünür, transaction_id satın alma olayıyla eşleşir ve gönderilen değerler iade kaydıyla aynıdır. Olay DebugView’da hiç görünmüyorsa sorun genellikle etiketin tetiklenmemesi, yanlış GA4 ölçüm kimliği, engellenen istek veya debug sinyalinin bulunmamasıdır. Görünüyor fakat raporda sonuç yoksa önce tarih aralığını, mülkü ve veri işleme gecikmesini kontrol edin; aynı iade olayını düzeltmek amacıyla art arda tekrar göndermeyin.Kontrol noktalarını ayırma
Aynı olayı farklı katmanlarda incelemek, sorunun gönderimde mi yoksa raporlamada mı olduğunu anlamayı kolaylaştırır.
| Kontrol yeri | Ne doğrulanır? | Başarısızsa olası anlamı |
|---|---|---|
| Etiket önizleme veya Network | İsteğin gönderilmesi ve parametre değerleri | Tetikleyici, ölçüm kimliği veya veri eşlemesi sorunu |
| GA4 DebugView | GA4’ün olayı alması ve olay parametreleri | Olay ulaşmıyor ya da debug/test koşulu sağlanmıyor |
| Standart raporlar veya ham veri | İadenin işlenmiş verilere yansıması | Gecikme, yanlış tarih aralığı veya yanlış mülk kontrolü |
Sık yapılan hatalar
En yaygın hata, satın alma sırasında kullanılan işlem kimliği yerine iade kaydı için yeni bir kimlik göndermektir. Bir diğer hata, kısmi iade tutarı yerine orijinal siparişin tamamını göndermek veya kısmi iadede iade edilmeyen ürünleri de
items listesine eklemektir. Tutarın kuruş/ondalık biçimini ve para birimini de ödeme sisteminizle karşılaştırın. Ayrıca aynı sunucu yanıtı yeniden işlendiğinde aynı iadenin birden fazla kez gönderilmesini önleyecek olay tekrar kontrolünü uygulamanız gerekir.Kaynaklar
Sık sorulan sorular
DebugView’da refund görünüyor ama gelir hâlâ değişmiyorsa ne yapılmalı?
Önce raporların işlenme süresini bekleyin ve doğru GA4 mülkü ile tarih aralığını açtığınızı kontrol edin. Ham veride olayın bulunması, rapor arayüzündeki toplulaştırmanın tamamlandığı anlamına gelmeyebilir.
İade olayını canlı müşteriyi etkilemeden nasıl test ederim?
Ayrı bir test mülkü veya test sipariş akışı kullanın. Gerçek siparişin iadesini yalnızca analitik testi için tetiklemek yerine, üretim entegrasyonunun gönderdiği veriyi kontrollü bir işlemle inceleyin.
