Bu belgede, e-ticaret etkinlik uyumluluğu ve Universal Analytics (UA) ile Google Analytics 4 (GA4) arasındaki çeviri açıklanmaktadır.
Arka plan
GA4 e-ticaret etkinlikleri, bir UA mülküne gönderildiğinde otomatik olarak eşdeğer UA etkinliklerine dönüştürülür. Çeviri, bir GA4 mülküne UA e-ticaret etkinlikleri gönderilirken de gerçekleşir. Bu belgede, çevirinin işleyiş şekli, etkinliklerin uyumluluğu ve otomatik çeviriyi kullanırken sahip olabileceğiniz ödünleşimler açıklanmaktadır.
Amaç
UA ile GA4 e-ticaret etkinlikleri arasında çeviri yapmak şu konularda yardımcı olur:
- Uygulama kolaylığı: Mevcut UA uygulamanızı küçük bir yapılandırma güncellemesiyle kullanarak GA4 e-ticareti kullanmaya başlayın.
- Çift etiketleme ihtiyacını ortadan kaldırın: Aynı e-ticaret etkinliklerini UA ve GA4 mülküne gönderebilirsiniz. Bu sayede, çift etiket yapılandırmasıyla ilgilenmek zorunda kalmadan GA4'e geçiş yapabilir ve UA e-ticaret uygulamanızı kullanmaya devam edebilirsiniz.
Ödünler
Uyumluluk, UA uygulamanızı sürdürmek için kısa ve uzun vadeli gereksinimlerinizi karşılayacak en uygun GA4 taşıma yolunu seçme esnekliği sunar.
GA4 e-ticaret etkinliklerinin/parametrelerinin çoğu UA ile uyumludur. Bunun tersi de geçerlidir. Uyumsuzlukların bulunduğu nadir durumlarda, yaptığınız taşıma seçimine bağlı olarak UA veya GA4 e-ticaret raporlarınız verilerle tam olarak doldurulmayabilir.
Uyumluluk ve gerekli yapılandırma ile ilgili ayrıntılar için her bir taşıma seçeneğini incelemeniz önemlidir.
Çevirinin işleyiş şekli
GA4 Etkinlik Etiketi
- GA4 e-ticaret etkinliklerini göndermek için gtag kullanmanız önerilir. Ancak GA4 Etkinlik etiketi, Veri Katmanı'na aktarılan e-ticaret verilerini okuyabilir.
- Doğrudan bir GA4 etkinlik etiketinde yapılandırılan GA4 etkinlik parametreleri, gtag/veri katmanı veya özelleştirilebilen değişken tarafından sağlanan tüm verilere göre öncelikli olur.
- GA4 etkinlik etiketi, Universal Analytics için kullanılan e-ticaret etkinlik verileriyle geriye dönük uyumludur. Öncelik davranışı aşağıdaki gibidir:
- GA4 e-ticaret etkinliklerini kullanın.
- GA4 e-ticaret etkinlikleri bulunamazsa UA e-ticaret etkinliklerini arayıp kullanın.
- UA e-ticaret etkinliği GA4 etkinlik etiketiyle kullanılıyorsa etkinlik GA4 mülküne gönderilmeden önce eş değer GA4 e-ticaret etkinliğine dönüştürülür. Bu; gtag, Veri Katmanı veya Özel Nesne kullanılmasından bağımsız olarak geçerlidir.
Universal Analytics Etiketi
- Universal Analytics etiketi, GA4 e-ticaret etkinliklerinin (gtag kullanılarak gönderilen veriler dahil) okunmasını destekler.
- Etikette GA4 e-ticaret etkinliklerini okuma ayarı etkinse öncelik davranışı şu şekilde olur:
- GA4 e-ticaret etkinliklerini kullanın.
- GA4 e-ticaret etkinlikleri bulunamazsa UA e-ticaret etkinliklerini arayıp kullanın.
- Bir GA4 e-ticaret etkinliği Universal Analytics etiketiyle kullanılıyorsa etkinlik UA mülküne gönderilmeden önce eş değer UA e-ticaret etkinliğine dönüştürülür. Bu; gtag, Veri Katmanı veya Özel Nesne kullanıldığında geçerlidir.
UA ve GA4 için karşılaştırılabilir parametreler
Aşağıdaki tabloda, Universal Analytics ve Google Analytics 4 için benzer e-ticaret parametreleri gösterilmektedir.
Universal Analytics parametre adı | Google Analytics 4 parametre adı | Notlar |
---|---|---|
affiliation |
affiliation |
|
checkout_step |
||
checkout_option |
||
content_type |
||
coupon |
coupon |
|
currency |
currency |
Bir UA etkinliği GA4 mülküne gönderilirken GA4 items[].currency parametresi için bu para birimi değeri kullanılır. |
location_id |
||
payment_type |
||
shipping |
shipping |
|
shipping_tier |
||
tax |
tax |
|
transaction_id |
transaction_id |
|
value |
value |
|
items[] |
items[] |
|
items[].name |
items[].item_name |
|
items[].id |
items[].item_id |
|
items[].affiliation |
||
items[].brand |
items[].item_brand |
|
items[].category |
items[].item_category items[].item_category2 items[].item_category3 items[].item_category4 items[].item_category5 |
Öğenin kategorisi. En fazla 5 hiyerarşi düzeyi belirtilebilir.
Kategori çevirisinin UA ile GA4 etkinlikleri arasında nasıl işlendiğiyle ilgili ayrıntılar için Kategori parametresi çevirisi bölümüne bakın.
|
items[].currency |
||
items[].coupon |
items[].coupon |
|
items[].discount |
||
items[].list_name |
items[].item_list_name |
|
items[].list_position |
items[].index |
|
items[].location_id |
||
items[].price |
items[].price |
|
items[].quantity |
items[].quantity |
|
items[].variant |
items[].item_variant |
|
promotions[] |
GA4'te items[] , items[].promotion_id gibi promosyona özel parametrelerle kullanılır. |
|
promotions[].id |
items[].promotion_id |
GA4'e UA etkinliği gönderirken bu parametreler çevrilmez (veya tam tersi). |
promotions[].name |
items[].promotion_name |
GA4'e UA etkinliği gönderirken bu parametreler çevrilmez (veya tam tersi). |
promotions[].creative_name |
||
promotions[].creative_slot |
items[].creative_slot |
GA4'e UA etkinliği gönderirken bu parametreler çevrilmez (veya tam tersi). |
Kategori parametresi çevirisi
Kategori parametresinin çevirisi, GA4 etkinlikleri UA'ya gönderilirken özel durum olarak (veya tam tersi) olarak işlenir.
Universal Analytics'te items[].category
parametresini ayarlarken beş adede kadar hiyerarşi düzeyi belirtmek için sınırlayıcı olarak /
kullanırsınız. Google Analytics 4'te en fazla beş hiyerarşi düzeyi belirtmek için numaralanmış kategori parametreleri kullanırsınız: items[].item_category
, items[].item_category2
,
items[].item_category3
, items[].item_category4
ve
items[].item_category5
.
Kategori çevirisi için davranış aşağıdaki gibidir:
- UA'ya çevrilen GA4 etkinlikleri için numaralanmış kategoriler, her bir kategori
/
ile sınırlandırılacak şekilde tek bircategory
parametresinde birleştirilir. - GA4'e çevrilen UA etkinliklerinde kategori parametresinin değeri, ilgili GA4 numaralandırılmış kategorileri doldurmak için bölünür.
- UA'ya GA4 etkinlikleri göndermeyi planlıyorsanız kategori değerlerinde
/
karakterini kullanmamanız önerilir. Bu karakter, UA'ya çeviri yapılırken bir kategori sınırlayıcı olarak yorumlanır. - Kaç kategorinin tanımlandığından bağımsız olarak yalnızca ilk 5 kategori düzeyi kullanılır.
Kategori çevirisi örneği
Aşağıdaki örneklerde, GA4'e çevrilen bir UA kategori parametresi gösterilmektedir. Bir GA4 etkinliğini UA'ya çevirirken de aynı ilke geçerlidir.
5 hiyerarşi düzeyi tanımlayan bir kategoriye sahip UA etkinliği:
gtag("event", "add_to_cart", {
items: [{
...
category: "Apparel/Adult/Shirts/Crew/Short sleeve",
...
}]
});
UA etkinliği, numaralanmış kategorilerle GA4 etkinliğine dönüştürüldü:
gtag("event", "add_to_cart", {
items: [{
...
item_category: "Apparel",
item_category2: "Adult",
item_category3: "Shirts",
item_category4: "Crew",
item_category5: "Short sleeve",
...
}]
});
UA ile GA4 etkinlikleri arasında uyumluluk
Aşağıdaki tabloda, Universal Analytics ile Google Analytics 4 için benzer e-ticaret etkinlikleri ve GA4'e bir UA etkinliği gönderirken (ve bunun tersi) gösterilen çeviri davranışı gösterilmektedir.
Tablodaki her satır için her sütun aşağıdaki bilgileri sağlar:
- UA etkinliği ve GA4 etkinliği sütunları, ölçmeyi amaçladıkları öğelere dayalı olarak benzer etkinlikleri gösterir.
- Parametreler, ilgili UA ve GA4 etkinlikleri arasında eşdeğeri olmayan parametreleri listeler. Yalnızca GA4'te yalnızca GA4 etkinliğiyle kullanılan parametreler, Yalnızca UA etkinliğinde ise yalnızca UA etkinliğiyle kullanılan parametreler listelenir.
- Çeviri davranışı (UA'yı GA4'e gönderme), bir UA etkinliği GA4 mülküne gönderilirken gerçekleşen çeviri davranışını ifade eder. Notlar; gönderilen veriler, GA4 etkinliğinden farklılıklar ve GA4 raporları üzerindeki önemli etkiler hakkında ayrıntılı bilgi sağlar.
- Çeviri davranışı (GA4'ü UA'ya gönderme), bir UA etkinliği GA4 mülküne gönderilirken gerçekleşen çeviri davranışını ifade eder. Notlar; gönderilen veriler, UA etkinliğinden farklılıklar ve UA raporları üzerindeki önemli etkiler hakkında ayrıntılar sağlar.
UA etkinliği | GA4 etkinliği | Parametreler | Çeviri davranışı (UA'yı GA4'e gönderme) |
Çeviri davranışı (GA4'ü UA'ya gönderme) |
---|---|---|---|---|
Ürün
Gösterimleri (impressions )
|
|
Yalnızca GA4:
item_list_id item_list_name items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id |
Uyumlu.
Tüm UA parametreleri GA4 eşdeğerlerine çevrilerek gönderilir.
Yalnızca GA4 parametreleri gerektiren GA4 raporları tamamlanmaz.
|
Uyumlu.
Eşdeğer UA parametresi olan GA4 parametreleri çevrilir ve gönderilir. Yalnızca GA4 parametreleri gönderilmez.
Etkinlik düzeyindeki item_list_name parametresi yok sayılır, yalnızca öğe düzeyindeki item_list_name gönderilir.
GA4 etkinliğindeki verilerle doldurulan UA raporları tamamlanır veya değiştirilmez.
|
Ürün Tıklamaları (click )
|
|
Yalnızca GA4:
item_list_id item_list_name items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id Yalnızca UA: content_type |
Uyumlu değil. Bir select_content özel etkinliği ve bir content_type
özel parametresi gönderildi. items verisi gönderilmedi.
|
Uyumlu değil. Bir UA etkinlik isabeti event_category olarak genel ve event_action olarak select_item ile gönderilir. items verisi gönderilmez.
|
Promosyon Tıklamaları (promoClick )
|
|
Yalnızca GA4:
creative_name creative_slot location_id promotion_id promotion_name items Yalnızca UA: content_type promotions |
Uyumlu değil. Özel parametre olarak content_type ve promotions ile select_content bir özel etkinlik gönderildi. promotions özel parametresi, kullanışlı bir veri içermiyor.
|
Uyumlu değil.event_category değeri genel ve event_action değeri select_promotion ile bir UA etkinlik isabeti gönderilir. promotions verisi gönderilmedi.
|
Ürün Ayrıntıları
Görüntülemeleri (detail )
|
|
Yalnızca GA4:
currency value items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id |
Uyumlu.
Tüm UA parametreleri GA4 eşdeğerlerine çevrilerek gönderilir.
Yalnızca GA4 parametreleri gerektiren GA4 raporları tamamlanmaz.
|
Uyumlu.
Eşdeğer UA parametresi olan GA4 parametreleri çevrilir ve gönderilir. İstisna olan item_list_name ise gönderilmez. Yalnızca GA4 parametreleri arasından currency ve value , isabetle birlikte sırasıyla
para birimi ve
İşlem geliri olarak gönderilir. event_value de value parametresine tam sayı olarak ayarlanır.
GA4'ten UA'ya çevirinin event_value içerdiğini, ancak bu, normalde UA isabetleri için ayarlanmadığını unutmayın.
GA4'teki verilerle doldurulan UA raporları çoğunlukla eksiksizdir / değiştirilmemiştir.
Öğe listesi adı eksik.
|
add_to_wishlist*
*
items verileri UA için desteklenmez.
|
|
Yalnızca GA4:
items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id |
Uyumlu.
Tüm UA parametreleri GA4 eşdeğerlerine çevrilerek gönderilir.
Yalnızca GA4 parametreleri gerektiren GA4 raporları tamamlanmaz.
|
Uyumlu.
ecommerce değerini event_category , add_to_wishlist öğesini event_action ve value parametresini event_value olarak içeren eşdeğer bir
etkinlik isabeti gönderilir.
GA4 etkinliğindeki verilerle doldurulan UA raporları tamamlanır veya değiştirilmez.
Bu etkinlik UA e-ticaret raporlarında genel olarak desteklenmediğinden kayda değer bir etkisi olmaz.
|
Alışveriş Sepetine Ürün Ekleme (add )
|
|
Yalnızca GA4:
items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id |
Uyumlu.
Tüm UA parametreleri GA4 eşdeğerlerine çevrilerek gönderilir.
Yalnızca GA4 parametreleri gerektiren GA4 raporları tamamlanmaz.
|
Uyumlu.
Eşdeğer UA parametresi olan GA4 parametreleri çevrilir ve gönderilir.* Yalnızca GA4 parametreleri gönderilmez.
* item_list_name gönderilmedi, ancak bu davranış, list_name göndermeyen gtag.js (UA) ile tutarlı.
GA4 etkinliğindeki verilerle doldurulan UA raporları tamamlanır veya değiştirilmez.
|
Alışveriş Sepetinden Ürün
Kaldırma (remove )
|
|
Yalnızca GA4:
items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id |
Uyumlu.
Tüm UA parametreleri GA4 eşdeğerlerine çevrilerek gönderilir.
Yalnızca GA4 parametreleri gerektiren GA4 raporları tamamlanmaz.
|
Uyumlu.
Eşdeğer UA parametresi olan GA4 parametreleri çevrilir ve gönderilir.* Yalnızca GA4 parametreleri gönderilmez.
* item_list_name gönderilmedi, ancak bu davranış, list_name göndermeyen gtag.js (UA) ile tutarlı.
GA4 etkinliğindeki verilerle doldurulan UA raporları tamamlanır veya değiştirilmez.
|
Yok |
|
Etkinlik yalnızca GA4 için önerilir. |
Uyumlu değil*.
*Önerilen bir etkinlik olmadığından UA uygulamanızın bu etkinliği gönderme olasılığı düşüktür. GA4 raporlarının eksiksiz olduğundan emin olmak amacıyla bu etkinliği UA için GA4 biçimini kullanarak uygulayabilirsiniz.
UA için GA4 etkinliğini uygularsanız bu etkinlik,
items verileri olmadan bir etkinlik olarak görünür ve bu çok kullanışlı olmayabilir. Bu durum, UA e-ticaret raporlamasını etkilemez.
|
Uyumlu değil.
Etkinlik isabeti, genel event_category , view_cart event_action ve value parametresi event_value ile gönderilir.
items verileri gönderilmedi.
Bu etkinlik UA e-ticaret raporlarında genel olarak desteklenmediğinden kayda değer bir etkisi olmaz.
|
Ödeme
Adımları (checkout , checkout_option )
|
|
Yalnızca GA4:
items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id |
Uyumlu.
Tüm UA parametreleri GA4 eşdeğerlerine çevrilerek gönderilir.
Yalnızca GA4 parametreleri gerektiren GA4 raporları tamamlanmaz.
|
Uyumlu.
Eşdeğer UA parametresi olan GA4 parametreleri çevrilir ve gönderilir.* Yalnızca GA4 parametreleri gönderilmez.
* item_list_name gönderilmedi, ancak bu davranış, list_name göndermeyen gtag.js (UA) ile tutarlı.
begin_checkout , etkin bir şekilde checkout_step öğesi 1 olarak ayarlanmış bir checkout_progress etkinliği göndermeye eşdeğerdir.
GA4 etkinliğindeki verilerle doldurulan UA raporları tamamlanır veya değiştirilmez.
|
add_payment_info
|
|
Yalnızca GA4:
currency value coupon payment_type items UA: Yok: Parametreler desteklenmez.
|
Uyumlu değil*.
*UA bu etkinlik için parametreleri desteklemediğinden hiçbir parametre gönderilmez. İşe yarayacaktır ancak muhtemelen çok faydalı olmayacaktır.
Etkinlik parametresi gerektiren GA4 raporları tamamlanmaz.
|
Uyumlu.
ecommerce değeri event_category , add_to_wishlist (event_action ) ve value parametresi (tamsayıya yayınlanmış) event_value ile eşdeğer bir
etkinlik isabeti gönderilir. GA4'ten UA'ya çevirinin event_value içerdiğini, ancak bu, normalde UA isabetleri için ayarlanmadığını unutmayın.
GA4 etkinliğindeki verilerle doldurulan UA raporları tamamlanır veya değiştirilmez.
Bu etkinlik UA e-ticaret raporlarında genel olarak desteklenmediğinden kayda değer bir etkisi olmaz.
|
Yok |
|
Etkinlik yalnızca GA4 için önerilir. |
Uyumlu değil*.
*Önerilen bir etkinlik olmadığından UA uygulamanızın bu etkinliği gönderme olasılığı düşüktür. GA4 raporlarının eksiksiz olduğundan emin olmak amacıyla bu etkinliği UA için GA4 biçimini kullanarak uygulayabilirsiniz.
UA için GA4 etkinliğini uygularsanız bu etkinlik,
items verileri olmadan bir etkinlik olarak görünür ve bu çok kullanışlı olmayabilir. Bu durum, UA e-ticaret raporlamasını etkilemez.
|
Uyumlu değil*.
Etkinlik isabeti, genel event_category , event_action add_shipping_info ve value parametresi (tamsayıya yayınlanmış) event_value ile gönderilir. GA4 currency parametresi, isabetle birlikte
currency olarak gönderilir.
Bu etkinlik UA e-ticaret raporlarında genel olarak desteklenmediğinden kayda değer bir etkisi olmaz.
|
Ödeme
Adımları (checkout , checkout_option )
|
Yok | Etkinlikler yalnızca UA için önerilir. |
Etkinlik,
özel etkinlik olarak değerlendirilir. Yalnızca etkinlik düzeyindeki parametreler gönderilecek, items verileri gönderilmez.
Bu etkinlikler genel olarak GA4 e-ticaret raporlarında desteklenmediğinden
kayda değer bir etkisi olmaz.
|
Yok |
Tanıtım
Gösterim Sayısı (promoView )
|
|
Yalnızca GA4:
creative_name creative_slot location_id promotion_id promotion_name items Yalnızca UA: promotions |
Uyumlu değil. Özel parametre olarak promotions ile view_promotion bir özel etkinlik gönderildi. promotions özel parametresi, kullanışlı bir veri içermiyor.
|
Uyumlu değil.event_category değeri engagement ve event_action olarak view_promotion olmak üzere bir UA etkinlik isabeti gönderilir. promotions verisi gönderilmedi. Etkinlik,
Etkileşim Dışı etkinlik olarak işaretlenir.
|
Satın Alma İşlemlerini Ölçme (purchase )
|
|
Yalnızca GA4:
items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id |
Uyumlu.
Tüm UA parametreleri GA4 eşdeğerlerine çevrilerek gönderilir.
Öğe düzeyindeki currency desteklenmediğinden etkinlik düzeyindeki currency kullanılır.
Yalnızca GA4 parametreleri gerektiren GA4 raporları tamamlanmaz.
|
Uyumlu.
Eşdeğer UA parametresi olan GA4 parametreleri çevrilir ve gönderilir.* Yalnızca GA4 parametreleri gönderilmez.
* item_list_name gönderilmedi, ancak bu davranış, list_name göndermeyen gtag.js (UA) ile tutarlı.
GA4 etkinliğindeki verilerle doldurulan UA raporları tamamlanır veya değiştirilmez.
|
Geri Ödemeleri Ölçme (refund )
|
|
Yalnızca GA4:
affiliation items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id |
Uyumlu.
Tüm UA parametreleri GA4 eşdeğerlerine çevrilerek gönderilir.
Öğe düzeyindeki currency desteklenmediğinden etkinlik düzeyindeki currency kullanılır.
Yalnızca GA4 parametreleri gerektiren GA4 raporları tamamlanmaz.
|
Uyumlu.
Eşdeğer UA parametresi olan GA4 parametreleri çevrilir ve gönderilir.* Yalnızca GA4 parametreleri gönderilmez.
* item_list_name gönderilmedi, ancak bu davranış, list_name göndermeyen gtag.js (UA) ile tutarlı.
GA4 etkinliğindeki verilerle doldurulan UA raporları tamamlanır veya değiştirilmez.
|