Referensi kompatibilitas dan terjemahan peristiwa e-commerce (gtag.js)

Dokumen ini menjelaskan kompatibilitas dan terjemahan peristiwa e-commerce antara Universal Analytics (UA) dan Google Analytics 4 (GA4).

Latar belakang

Peristiwa e-commerce GA4 secara otomatis diterjemahkan ke peristiwa setara UA saat dikirim ke properti UA. Terjemahan juga terjadi saat mengirim peristiwa e-commerce UA ke properti GA4. Dokumen ini menjelaskan cara kerja terjemahan, kompatibilitas peristiwa, dan kompromi apa pun yang mungkin harus Anda lakukan saat mengandalkan terjemahan otomatis.

Tujuan

Terjemahan antara peristiwa e-commerce UA dan GA4 akan membantu hal berikut:

  • Kemudahan penerapan: gunakan e-commerce GA4 melalui penerapan UA yang sudah ada dengan update kecil pada konfigurasi.
  • Menghapus kebutuhan tag ganda: Anda dapat mengirim peristiwa e-commerce yang sama ke properti UA dan GA4. Ini menyediakan opsi untuk transisi ke GA4 dan mempertahankan penerapan e-commerce UA Anda, tanpa perlu mempertahankan konfigurasi tag ganda.

Kompromi

Kompatibilitas memberikan fleksibilitas untuk memilih jalur migrasi GA4 yang paling sesuai untuk memenuhi persyaratan jangka pendek dan jangka panjang Anda dalam mempertahankan penerapan UA.

Sebagian besar peristiwa/parameter e-commerce GA4 kompatibel dengan UA dan sebaliknya. Untuk sejumlah kecil kasus yang menghadapi masalah kompatibilitas, bergantung pada pilihan migrasi yang Anda buat, laporan e-commerce UA atau GA4 Anda mungkin tidak sepenuhnya terisi data.

Anda harus meninjau setiap opsi migrasi untuk mengetahui detail tentang kompatibilitas dan konfigurasi yang diperlukan.

Cara kerja terjemahan

  • Saat peristiwa e-commerce GA4 dikirim ke properti UA, peristiwa tersebut akan diterjemahkan ke peristiwa e-commerce UA (gtag.js) yang setara.
    • Parameter peristiwa UA diisi dengan nilai dari parameter GA4 yang sebanding. Jika parameter UA tidak dapat diisi dari peristiwa GA4 (yaitu tidak ada parameter yang sebanding), parameter tersebut akan dihilangkan saat peristiwa dikirim ke properti UA.
  • Saat peristiwa e-commerce UA (gtag.js) dikirim ke properti GA4, peristiwa tersebut diterjemahkan ke peristiwa e-commerce GA4 yang setara.
    • Parameter peristiwa GA4 diisi dengan nilai dari parameter UA yang sebanding. Jika parameter GA4 tidak dapat diisi dari peristiwa UA (yaitu tidak ada parameter yang setara), parameter tersebut akan dihilangkan saat peristiwa dikirim ke properti GA4. Dalam beberapa kasus, jika parameter UA tidak memiliki parameter GA4 yang sebanding, parameter akan dikirim dengan peristiwa GA4 sebagai parameter kustom.
  • Semua terjemahan dari GA4 ke UA dan sebaliknya dilakukan dari sisi klien.
  • Terjemahan peristiwa/parameter diaktifkan secara default, tidak diperlukan konfigurasi pengguna dan tidak dapat dinonaktifkan.

Parameter yang sebanding untuk UA dan GA4

Tabel berikut menunjukkan parameter e-commerce yang sebanding untuk Universal Analytics dan Google Analytics 4.

Nama parameter Universal Analytics Nama parameter Google Analytics 4 Catatan
affiliation affiliation
checkout_step
checkout_option
content_type
coupon coupon
currency currency Saat mengirim peristiwa UA ke properti GA4, nilai mata uang ini akan digunakan untuk parameter items[].currency GA4.
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
Kategori item. Hingga 5 tingkat hierarki dapat ditentukan.

Lihat Terjemahan parameter kategori untuk mengetahui detail tentang cara penanganan terjemahan kategori antara peristiwa UA dan GA4.
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[] Untuk GA4, items[] digunakan dengan parameter khusus promosi seperti items[].promotion_id.
promotions[].id items[].promotion_id Parameter ini tidak diterjemahkan saat mengirim peristiwa UA ke GA4 atau sebaliknya.
promotions[].name items[].promotion_name Parameter ini tidak diterjemahkan saat mengirim peristiwa UA ke GA4 atau sebaliknya.
promotions[].creative_name
promotions[].creative_slot items[].creative_slot Parameter ini tidak diterjemahkan saat mengirim peristiwa UA ke GA4 atau sebaliknya.

Terjemahan parameter kategori

Terjemahan untuk parameter kategori ditangani sebagai kasus khusus saat mengirim peristiwa GA4 ke UA atau sebaliknya.

Untuk Universal Analytics, saat menetapkan parameter items[].category, Anda menggunakan / sebagai pembatas untuk menentukan hingga lima tingkat hierarki. Di Google Analytics 4, Anda menggunakan parameter kategori terenumerasi untuk menentukan hingga lima tingkat hierarki: items[].item_category, items[].item_category2, items[].item_category3, items[].item_category4, dan items[].item_category5.

Perilaku untuk terjemahan kategori adalah sebagai berikut:

  • Untuk peristiwa GA4 yang diterjemahkan ke UA, kategori terenumerasi akan digabungkan menjadi satu parameter category, dengan setiap kategori yang dibatasi oleh /.
  • Untuk peristiwa UA yang diterjemahkan ke GA4, nilai parameter kategori akan dipisahkan untuk mengisi kategori terenumerasi GA4 yang sesuai.
  • Jika Anda ingin mengirim peristiwa GA4 ke UA, sebaiknya Anda tidak menggunakan karakter / dalam nilai kategori, karena ini akan ditafsirkan sebagai pembatas kategori saat menerjemahkan ke UA.
  • Hanya 5 tingkat kategori pertama yang akan digunakan, berapa pun jumlah yang ditentukan.

Contoh terjemahan kategori

Contoh berikut menunjukkan parameter kategori UA yang diterjemahkan ke GA4. Prinsip yang sama berlaku saat menerjemahkan peristiwa GA4 ke UA.

Peristiwa UA dengan kategori yang menentukan 5 tingkat hierarki:

gtag("event", "add_to_cart", {
  items: [{
    ...
    category: "Apparel/Adult/Shirts/Crew/Short sleeve",
    ...
  }]
});

Peristiwa UA yang diterjemahkan ke peristiwa GA4, dengan kategori terenumerasi:

gtag("event", "add_to_cart", {
  items: [{
    ...
    item_category: "Apparel",
    item_category2: "Adult",
    item_category3: "Shirts",
    item_category4: "Crew",
    item_category5: "Short sleeve",
    ...
  }]
});

Kompatibilitas antara peristiwa UA dan GA4

Tabel di bawah menunjukkan peristiwa e-commerce yang sebanding untuk Universal Analytics dan Google Analytics 4 serta perilaku terjemahan saat mengirim peristiwa UA ke GA4, dan sebaliknya.

Untuk setiap baris dalam tabel, setiap kolom memberikan informasi berikut:

  • Kolom peristiwa UA dan peristiwa GA4 menunjukkan peristiwa yang sebanding berdasarkan pada hal yang akan diukur.
  • Parameter mencantumkan parameter tanpa padanan antara peristiwa UA dan GA4 masing-masing. Khusus GA4 mencantumkan parameter yang hanya digunakan dengan peristiwa GA4 dan khusus UA mencantumkan parameter yang hanya digunakan dengan peristiwa UA.
  • Perilaku terjemahan (Mengirim UA ke GA4) menjelaskan perilaku terjemahan saat mengirim peristiwa UA ke properti GA4. Catatan tersebut memberikan detail tentang data yang dikirim, perbedaan dengan peristiwa GA4, dan pengaruh penting apa pun di laporan GA4.
  • Perilaku terjemahan (Mengirim GA4 ke UA) menjelaskan perilaku terjemahan saat mengirim peristiwa UA ke properti GA4. Catatan tersebut memberikan detail tentang data yang dikirim, perbedaan dengan peristiwa UA, dan pengaruh penting apa pun di laporan UA.
Peristiwa UA Peristiwa GA4 Parameter Perilaku terjemahan
(Mengirim UA ke GA4)
Perilaku terjemahan
(Mengirim GA4 ke UA)
view_item_list Khusus GA4:
item_list_id
item_list_name
items[].affiliation
items[].currency
items[].discount
items[].item_list_id
items[].location_id
Kompatibel.

Semua parameter UA diterjemahkan ke padanan GA4 dan dikirim.

Laporan GA4 yang memerlukan parameter khusus GA4 tidak akan lengkap.
Kompatibel.

Parameter GA4 dengan parameter UA yang setara diterjemahkan dan dikirim. Parameter khusus GA4 tidak dikirim. Parameter item_list_name tingkat peristiwa diabaikan, hanya item_list_name tingkat item yang akan dikirim.

Laporan UA yang diisi dengan data dari peristiwa GA4 akan lengkap/tidak berubah.
select_content (items) Khusus GA4:
item_list_id
item_list_name
items[].affiliation
items[].currency
items[].discount
items[].item_list_id
items[].location_id

Khusus UA:
content_type
Tidak kompatibel.

Peristiwa kustom select_content dan parameter kustom content_type dikirim. Tidak ada data items yang dikirim.
Tidak kompatibel.

Hit peristiwa UA dikirim dengan general sebagai event_category dan select_item sebagai event_action. Tidak ada data items yang dikirim.
select_content (promotions) Khusus GA4:
creative_name
creative_slot
location_id
promotion_id
promotion_name
items

Khusus UA:
content_type
promotions
Tidak kompatibel.

Peristiwa kustom select_content dikirim dengan content_type dan promotions sebagai parameter kustom. Parameter kustom promotions tidak berisi data apa pun yang berguna.
Tidak kompatibel.

Hit peristiwa UA dikirim dengan general sebagai event_category dan select_promotion sebagai event_action. Tidak ada data promotions yang dikirim.
view_item Khusus GA4:
currency
value
items[].affiliation
items[].currency
items[].discount
items[].item_list_id
items[].location_id
Kompatibel.

Semua parameter UA diterjemahkan ke padanan GA4 dan dikirim.

Laporan GA4 yang memerlukan parameter khusus GA4 tidak akan lengkap.
Kompatibel.

Parameter GA4 dengan parameter UA yang setara diterjemahkan dan dikirim. Pengecualiannya adalah item_list_name, yang tidak akan dikirim. Dari parameter khusus GA4, currency dan value dikirim dengan hit masing-masing sebagai mata uang dan Pendapatan transaksi. event_value juga ditetapkan ke parameter value, sebagai bilangan bulat. Perhatikan bahwa terjemahan dari GA4 ke UA mencakup event_value, tetapi biasanya tidak ditetapkan untuk hit UA.

Laporan UA yang diisi dengan data dari GA4 sebagian besar akan lengkap/tidak berubah. Nama daftar item tidak akan ada.
add_to_wishlist*

*Data items tidak didukung untuk UA.
Khusus GA4:
items[].affiliation
items[].currency
items[].discount
items[].item_list_id
items[].location_id
Kompatibel.

Semua parameter UA diterjemahkan ke padanan GA4 dan dikirim.

Laporan GA4 yang memerlukan parameter khusus GA4 tidak akan lengkap.
Kompatibel.

Hit peristiwa yang setara dikirim dengan e-commerce sebagai event_category, add_to_wishlist sebagai event_action, dan parameter value sebagai event_value.

Laporan UA yang diisi dengan data dari peristiwa GA4 akan lengkap/tidak berubah. Karena secara umum tidak didukung dalam laporan e-commerce UA, peristiwa ini tidak akan memiliki efek yang luar biasa.
add_to_cart Khusus GA4:
items[].affiliation
items[].currency
items[].discount
items[].item_list_id
items[].location_id
Kompatibel.

Semua parameter UA diterjemahkan ke padanan GA4 dan dikirim.

Laporan GA4 yang memerlukan parameter khusus GA4 tidak akan lengkap.
Kompatibel.

Parameter GA4 dengan parameter UA yang setara diterjemahkan dan dikirim.* Parameter khusus GA4 tidak dikirim.

*item_list_name tidak dikirim, tetapi perilaku ini konsisten dengan gtag.js (UA), yang tidak mengirim list_name.

Laporan UA yang diisi dengan data dari peristiwa GA4 akan lengkap/tidak berubah.
remove_from_cart Khusus GA4:
items[].affiliation
items[].currency
items[].discount
items[].item_list_id
items[].location_id
Kompatibel.

Semua parameter UA diterjemahkan ke padanan GA4 dan dikirim.

Laporan GA4 yang memerlukan parameter khusus GA4 tidak akan lengkap.
Kompatibel.

Parameter GA4 dengan parameter UA yang setara diterjemahkan dan dikirim.* Parameter khusus GA4 tidak dikirim.

*item_list_name tidak dikirim, tetapi perilaku ini konsisten dengan gtag.js (UA), yang tidak mengirim list_name.

Laporan UA yang diisi dengan data dari peristiwa GA4 akan lengkap/tidak berubah.
T/A Peristiwa hanya direkomendasikan untuk GA4.
Tidak kompatibel*.

*Penerapan UA Anda kemungkinan tidak akan mengirim peristiwa ini karena bukan peristiwa yang direkomendasikan. Untuk memastikan laporan GA4 lengkap, Anda dapat menerapkan peristiwa ini agar UA menggunakan format GA4.

Jika Anda menerapkan peristiwa GA4 untuk UA, ini akan muncul sebagai peristiwa tanpa data items, yang mungkin tidak terlalu berguna. Peristiwa ini tidak akan memengaruhi pelaporan e-commerce UA.
Tidak kompatibel.

Hit peristiwa dikirim dengan general sebagai event_category, view_cart sebagai event_action, dan parameter value sebagai event_value. Data items tidak dikirim.

Karena secara umum tidak didukung dalam laporan e-commerce UA, peristiwa ini tidak akan memiliki efek yang luar biasa.
begin_checkout Khusus GA4:
items[].affiliation
items[].currency
items[].discount
items[].item_list_id
items[].location_id
Kompatibel.

Semua parameter UA diterjemahkan ke padanan GA4 dan dikirim.

Laporan GA4 yang memerlukan parameter khusus GA4 tidak akan lengkap.
Kompatibel.

Parameter GA4 dengan parameter UA yang setara diterjemahkan dan dikirim.* Parameter khusus GA4 tidak dikirim.

*item_list_name tidak dikirim, tetapi perilaku ini konsisten dengan gtag.js (UA), yang tidak mengirim list_name.

begin_checkout secara efektif setara dengan mengirim peristiwa checkout_progress dengan checkout_step ditetapkan ke 1.

Laporan UA yang diisi dengan data dari peristiwa GA4 akan lengkap/tidak berubah.
add_payment_info Khusus GA4:
currency
value
coupon
payment_type
items

UA:
T/A: Parameter tidak didukung.
Tidak kompatibel*.

*Karena UA tidak mendukung parameter untuk peristiwa ini, tidak ada parameter yang dikirim. Peristiwa ini akan berfungsi, tetapi kemungkinan besar tidak akan berguna.

Laporan GA4 yang memerlukan parameter peristiwa apa pun tidak akan lengkap.
Kompatibel.

Hit peristiwa yang setara dikirim dengan e-commerce sebagai event_category, add_to_wishlist sebagai event_action, dan parameter value (digolongkan menjadi bilangan bulat) sebagai event_value. Perhatikan bahwa terjemahan dari GA4 ke UA mencakup event_value, tetapi biasanya tidak ditetapkan untuk hit UA.

Laporan UA yang diisi dengan data dari peristiwa GA4 akan lengkap/tidak berubah. Karena secara umum tidak didukung dalam laporan e-commerce UA, peristiwa ini tidak akan memiliki efek yang luar biasa.
T/A Peristiwa hanya direkomendasikan untuk GA4.
Tidak kompatibel*.

*Penerapan UA Anda kemungkinan tidak akan mengirim peristiwa ini karena bukan peristiwa yang direkomendasikan. Untuk memastikan laporan GA4 lengkap, Anda dapat menerapkan peristiwa ini agar UA menggunakan format GA4.

Jika Anda menerapkan peristiwa GA4 untuk UA, ini akan muncul sebagai peristiwa tanpa data items, yang mungkin tidak terlalu berguna. Peristiwa ini tidak akan memengaruhi pelaporan e-commerce UA.
Tidak kompatibel*.

Hit peristiwa dikirim dengan general sebagai event_category, add_shipping_info sebagai event_action, dan parameter value (digolongkan menjadi bilangan bulat) sebagai event_value. Parameter currency GA4 dikirim dengan hit sebagai mata uang.

Karena secara umum tidak didukung dalam laporan e-commerce UA, peristiwa ini tidak akan memiliki efek yang luar biasa.
checkout_progress
set_checkout_option
T/A Peristiwa hanya direkomendasikan untuk UA.
Peristiwa akan diperlakukan sebagai peristiwa kustom. Hanya parameter tingkat peristiwa yang akan dikirim, tidak ada data items yang akan dikirim.

Karena umumnya tidak didukung dalam laporan e-commerce GA4, peristiwa ini tidak akan memiliki efek yang luar biasa.
T/A
view_promotion Khusus GA4:
creative_name
creative_slot
location_id
promotion_id
promotion_name
items

Khusus UA:
promotions
Tidak kompatibel.

Peristiwa kustom view_promotion dikirim dengan promotions sebagai parameter kustom. Parameter kustom promotions tidak berisi data yang berguna.
Tidak kompatibel.

Hit peristiwa UA dikirim dengan engagement sebagai event_category dan view_promotion sebagai event_action. Tidak ada data promotions yang dikirim. Peristiwa ditandai sebagai peristiwa Non-Interaksi.
purchase Khusus GA4:
items[].affiliation
items[].currency
items[].discount
items[].item_list_id
items[].location_id
Kompatibel.

Semua parameter UA diterjemahkan ke padanan GA4 dan dikirim.

currency tingkat peristiwa digunakan karena currency tingkat item tidak didukung.

Laporan GA4 yang memerlukan parameter khusus GA4 tidak akan lengkap.
Kompatibel.

Parameter GA4 dengan parameter UA yang setara diterjemahkan dan dikirim.* Parameter khusus GA4 tidak dikirim.

*item_list_name tidak dikirim, tetapi perilaku ini konsisten dengan gtag.js (UA), yang tidak mengirim list_name.

Laporan UA yang diisi dengan data dari peristiwa GA4 akan lengkap/tidak berubah.
refund Khusus GA4:
affiliation
items[].affiliation
items[].currency
items[].discount
items[].item_list_id
items[].location_id
Kompatibel.

Semua parameter UA diterjemahkan ke padanan GA4 dan dikirim.

currency tingkat peristiwa digunakan karena currency tingkat item tidak didukung.

Laporan GA4 yang memerlukan parameter khusus GA4 tidak akan lengkap.
Kompatibel.

Parameter GA4 dengan parameter UA yang setara diterjemahkan dan dikirim.* Parameter khusus GA4 tidak dikirim.

*item_list_name tidak dikirim, tetapi perilaku ini konsisten dengan gtag.js (UA), yang tidak mengirim list_name.

Laporan UA yang diisi dengan data dari peristiwa GA4 akan lengkap/tidak berubah.