E-ticaret etkinlik uyumluluğu ve çeviri referansı (gtag.js)

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

  • Bir UA mülküne GA4 e-ticaret etkinliği gönderildiğinde, etkinlik eşdeğer UA (gtag.js) e-ticaret etkinliğine dönüştürülür.
    • UA etkinlik parametreleri, karşılaştırılabilir GA4 parametrelerinden değerlerle doldurulur. UA parametresi GA4 etkinliğinden doldurulamıyorsa (ör. karşılaştırılabilir bir parametre yoksa) etkinlik UA mülküne gönderildiğinde parametre atlanır.
  • Bir UA (gtag.js) e-ticaret etkinliği GA4 mülküne gönderildiğinde, bu etkinlik eşdeğer GA4 e-ticaret etkinliğine dönüştürülür.
    • GA4 etkinlik parametreleri, karşılaştırılabilir UA parametrelerinden değerlerle doldurulur. Bir UA etkinliğinden GA4 parametresi doldurulamıyorsa (ör. eşdeğer bir parametre yoksa) etkinlik GA4 mülküne gönderildiğinde parametre atlanır. Bazı durumlarda, UA parametresinde karşılaştırılabilir GA4 parametresi yoksa bu parametre, GA4 etkinliğiyle birlikte özel parametre olarak gönderilir.
  • GA4'ten UA'ya ve tam tersi tüm çeviriler istemci tarafında yapılır.
  • Etkinlik/parametre çevirileri varsayılan olarak etkindir. Kullanıcı yapılandırması gerekmez ve devre dışı bırakılamaz.

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 bir category 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)
view_item_list 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.
select_content (items) 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.
select_content (promotions) 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.
view_item 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.
add_to_cart 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.
remove_from_cart 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.
begin_checkout 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.
checkout_progress
set_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
view_promotion 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.
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.
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.