Mağazanız add_to_cart demiyor

Size bir mağaza veriliyor, dataLayer’ın hazır olduğu söyleniyor ve GA4’ü bağlamanız isteniyor. Event listesini açıyor, sepete bir şey ekliyorsunuz ve gelen push’un adı productDetail. Ya da dl_add_to_cart. Ya da gtm4wp.addProductToCartEEC. Hiçbiri, okuduğunuz belgelerdeki ad değil.

Bu bir yapılandırma hatası değil. GTM entegrasyonu göndermiş her ticaret platformu aynı beş adım için kendi sözlüğünü uydurdu ve çoğu GA4’ünkinden eski.

Aynı huni, altı biçim

GA4’ün add_to_cart dediği şey, nerede durduğunuza göre şöyle yazılıyor:

• dl_add_to_cart — Elevar’lı Shopify. Bütün sözlüğü önekli: dl_view_item, dl_begin_checkout, dl_purchase.
• addToCart — VTEX’in GTM uygulaması; yanında productDetail, productClick ve orderPlaced.
• Yine addToCart — Adobe Commerce’in client data layer’ı; ayrıca productPageView, initiateCheckout ve placeOrder.
• gtm4wp.addProductToCartEEC — GTM4WP’nin eski Enhanced Ecommerce modundaki WooCommerce. Güncel GTM4WP zaten GA4 adlarını push’luyor, yani bu ad eklentinin eski olduğunu söyler.
• cart_add — Tealium’un standartlaştırdığı küme.
• ee-productView ve akrabaları — ee- öneki kendi başına bir sözlük değil, eski Universal Analytics sözlüğünün üstüne konmuş bir gelenek.

Bir de harf durumu var. AddToCart, ADD_TO_CART ve add-to-cart insan için aynı kelime, GTM için üç ayrı event.

Bunun bozduğu şeyler, maliyet sırasına göre

1. Hiç çalışmayan tetikleyiciler. Bir eğitimden kopyalanan Custom Event tetikleyicisi add_to_cart ile eşleşiyor, site ise dl_add_to_cart push’luyor. Preview Mode tag’in çalışmadığını gösterir ve sebep vermez; çünkü GTM tarafında bir yanlışlık yoktur: öyle bir event olmadı.
2. Sessizlikle geçen denetimler. GA4 adlarına bağlı her "e-ticaret katmanı doğru mu" kontrolü, hiç anlamadığı bir mağazada temiz sonuç döner.
3. Yarım kalmış geçişler. Eski sözlüğü push’layan bir tema ile GA4 sözlüğünü push’layan bir eklenti aynı anda yayındaysa, aynı sepete ekleme iki ayrı adla iki kez sayılır.

Adı okuyun, sonra eşleyin

Güvenilir hamle, varsaymayı bırakıp okumaktır. Sayfada tek bir şey yapın ve gelen event adına bakın — tek bir etkileşimin ürettiği push’u yakalamak tam olarak budur ve size adı, sitenin yazdığı biçimde, altındaki değerlerle birlikte verir.

Sonra yeniden adlandırmak yerine eşleyin. Sitenin kendi yazımıyla tetikleyin; GA4 adını tag’den gönderin. Çeviri, altınızdan güncellenecek bir platform uygulamasının kopyasında değil, sizin kontrol ettiğiniz tek bir yerde durur. Kurulumu bir ödeme akışındaki birkaç push’tan inşa ediyorsanız, aynı koleksiyon gerçek adları içinde taşıyan bir container dosyası olarak dışa aktarılabilir.

Listeye güvenmeden önce iki kontrol

Birincisi, her seferinde harf durumu. Adı yazmak yerine push’tan kopyalayın.

İkincisi, katmanın tamamını görüp görmediğiniz. Shopify’da ilgilendiğiniz event’ler denetçinizin ulaşamadığı bir yalıtımın içinde çalışıyor olabilir; o zaman ağa geçene kadar sözlük sorusu anlamsızdır. Göremediğiniz bir lehçe, lehçe sorunu değildir.

Sorular

Mağazam neden add_to_cart yerine dl_add_to_cart push’luyor?

Çünkü dl_ öneki GA4’ün değil, Elevar’ın Shopify sözlüğünün. Event add_to_cart anlamına geliyor; yalnızca yazımı farklı. Onu dinleyen tag’in, sitenin gerçekten push’ladığı adı dinlemesi gerekir.

GTM Custom Event tetikleyicisi büyük-küçük harfe duyarlı mı?

Evet. addToCart, AddToCart ve add_to_cart GTM için üç ayrı event’tir ve birine eşleşen tetikleyici diğerlerinde asla çalışmaz. Doğru görünen bir tetikleyicinin hiç çalışmamasının en yaygın sebebi budur.

Event’leri GA4 adlarına çevirmeli miyim?

Genelde hayır. Platform ne push’luyorsa onu push’lar; kaynakta yeniden adlandırmak, birinin uygulamasının çatallanmış bir kopyasını bakımda tutmak demektir. Bunun yerine eşleyin: sitenin yazımıyla tetikleyin, GA4 adını tag’de gönderin. Platform değişirse değiştirilecek tek yer olur.

Bir sitenin hangi lehçeyi kullandığını nasıl bulurum?

Sayfada bir şey yapın — ürün ekleyin, ödemeyi başlatın — ve gelen event adını okuyun. Güvenilir tek cevap budur; çünkü aynı platform, uygulama sürümlerine ve temalara göre farklı sözlükler gönderiyor.

Bunu panelde yapmak →

Bu kümenin geri kalanı: Mağazalar ve veri katmanları

• dataLayer’ı boş görünen mağaza

Mağazalar ve veri katmanları kümesinin tamamı