Panduan ini membahas proses migrasi penerapan Universal Analytics analytics.js
yang ada untuk menggunakan gtag.js
.
Ringkasan
analytics.js memiliki dua mekanisme utama untuk mengirim data ke Google Analytics:
-
Pelacak menentukan properti mana yang Anda ukur.
-
Jenis hit menentukan jenis interaksi apa yang Anda ukur.
Di gtag.js
, properti ditentukan melalui perintah config
, atau sebagai parameter ke perintah.
Tidak seperti analytics.js, gtag.js tidak menggunakan pelacak untuk mengirim data ke Google Analytics. gtag.js mengirim data ke properti Google Analytics yang diidentifikasi menurut ID mereka yang ditetapkan oleh perintah config
. Nama peristiwa yang diberikan ke gtag.js menentukan jenis data yang dikirim ke Google Analytics.
Untuk bermigrasi dari analytics.js ke gtag.js, lakukan hal berikut untuk setiap halaman web di situs Anda:
Ganti kode analytics.js dengan kode gtag.js yang setara untuk:
Mengganti cuplikan analytics.js dengan cuplikan gtag.js
Ganti cuplikan analytics.js di halaman web Anda:
<!-- Google Analytics -->
<script>
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
})(window,document,'script','https://www.google-analytics.com/analytics.js','ga');
ga('create', 'GA_MEASUREMENT_ID', 'auto');
ga('send', 'pageview');
</script>
<!-- End Google Analytics -->
dengan cuplikan gtag.js berikut:
<!-- Global Site Tag (gtag.js) - Google Analytics -->
<script async src="https://www.googletagmanager.com/gtag/js?id=GA_MEASUREMENT_ID"></script>
<script>
window.dataLayer = window.dataLayer || [];
function gtag(){dataLayer.push(arguments);}
gtag('js', new Date());
gtag('config', 'GA_MEASUREMENT_ID');
</script>
Mengukur kunjungan halaman
analytics.js menggunakan pelacak untuk mengirim kunjungan halaman ke Google Analytics. Pelacak memiliki ID pengukuran properti Google Analytics. gtag.js mengirim kunjungan halaman ke properti Google Analytics yang diidentifikasi oleh GA_MEASUREMENT_ID
yang ditentukan dalam perintah config
.
Mengukur kunjungan halaman dengan pelacak default
Hapus kode analytics.js berikut yang menggunakan pelacak default untuk send
kunjungan halaman ke Google Analytics:
// Creates the default tracker.
ga('create', 'GA_MEASUREMENT_ID', 'auto');
// Uses the default tracker to send a pageview to the
// Google Analytics property with tracking ID GA_MEASUREMENT_ID.
ga('send', 'pageview');
Kode berikut dalam cuplikan global gtag.js secara otomatis mengirim kunjungan halaman ke properti Google Analytics dengan ID pelacakan GA_MEASUREMENT_ID
:
gtag('config', 'GA_MEASUREMENT_ID');
Mengukur kunjungan halaman dengan pelacak yang ditentukan
Ganti kode analytics.js berikut yang menggunakan pelacak yang ditentukan untuk mengirim kunjungan halaman ke Google Analytics:
ga('create', 'GA_MEASUREMENT_ID', 'auto', 'trackerName');
ga('trackerName.send', 'pageview');
dengan perintah event
gtag.js berikut:
gtag('event', 'page_view', { 'send_to': 'GA_MEASUREMENT_ID' });
Mengukur peristiwa
Seperti yang disebutkan sebelumnya, analytics.js menggunakan pelacak untuk mengirim peristiwa ke Google Analytics. Pelacak memiliki ID pelacakan properti Google Analytics. Sebaliknya, gtag.js mengirim peristiwa ke properti Google Analytics yang diidentifikasi oleh GA_MEASUREMENT_ID
yang ditentukan dalam perintah config
.
Mengukur peristiwa dengan pelacak default
Ganti kode analytics.js berikut yang menggunakan pelacak default untuk send
peristiwa ke Google Analytics:
ga('create', 'GA_MEASUREMENT_ID', 'auto');
ga('send', 'event', [eventCategory], [eventAction], [eventLabel], [eventValue], [fieldsObject]);
dengan perintah
gtag.js event
berikut:
gtag('event', eventName, eventParameters);
dengan eventName
adalah nama peristiwa yang ingin Anda catat dalam log.
Contoh:
analytics.js:
// Creates the default tracker.
ga('create', 'GA_MEASUREMENT_ID', 'auto');
// Uses the default tracker to send the event to the
// Google Analytics property with tracking ID GA_MEASUREMENT_ID.
ga('send', 'event', 'Videos', 'play', 'Fall Campaign');
gtag.js:
// Sends the event to the Google Analytics property with
// tracking ID GA_MEASUREMENT_ID set by the config command in
// the global tracking snippet.
gtag('event', 'play', {
'event_category': 'Videos',
'event_label': 'Fall Campaign'
});
Mengukur peristiwa dengan pelacak yang ditentukan
Ganti kode analytics.js berikut yang menggunakan pelacak yang telah ditentukan untuk mengirim peristiwa ke Google Analytics:
ga('create', 'GA_MEASUREMENT_ID', 'auto', 'trackerName');
ga('trackerName.send', 'event', [eventCategory], [eventAction], [eventLabel], [eventValue], [fieldsObject]);
dengan perintah event
gtag.js berikut:
gtag('event', eventName, {
'send_to': 'GA_MEASUREMENT_ID',
'parameter1': 'value1',
'parameter2': 'value2',
// ...
});
Contoh:
analytics.js:
// Creates a tracker named <b>clientTracker</b>.
ga('create', 'GA_MEASUREMENT_ID', 'auto', 'clientTracker');
// Uses tracker clientTracker to send the event to the
// Google Analytics property with tracking ID GA_MEASUREMENT_ID.
ga('clientTracker.send', 'event', 'Videos', 'play', 'Fall Campaign');
gtag.js:
// Send the event to the Google Analytics property
// with tracking ID GA_MEASUREMENT_ID.
gtag('event', 'play', {
'send_to': 'GA_MEASUREMENT_ID',
'event_category': 'Videos',
'event_label': 'Fall Campaign'
});
Mengirim dimensi dan metrik kustom
Ganti perintah send
analytics.js di halaman web yang mengirim dimensi kustom ke Google Analytics:
ga('send', 'hitType', { 'dimension<Index>': 'dimension_value'});
dengan kode gtag.js berikut:
gtag('config', 'GA_MEASUREMENT_ID', {
'custom_map': {'dimension<Index>': 'dimension_name'}
});
gtag('event', 'any_event_name', {'dimension_name': 'dimension_value'});
Ganti GA_MEASUREMENT_ID
dengan ID Analytics Anda sendiri.
Ganti perintah send
analytics.js di halaman web Anda yang mengirim metrik kustom ke Google Analytics:
ga('send', 'hitType', { 'metric<Index>': 'metric_value'});
dengan kode gtag.js berikut:
gtag('config', 'GA_MEASUREMENT_ID', {
'custom_map': {'metric<Index>': 'metric_name'}
});
gtag('event', 'any_event_name', {'metric_name': 'metric_value'});
Ganti GA_MEASUREMENT_ID
dengan ID Analytics Anda sendiri.
Mengukur waktu pengguna
Ganti perintah send
analytics.js di halaman web Anda yang
melacak waktu pengguna:
ga('send', 'timing', 'timingCategory', 'timingVar', timingValue, 'timingLabel');
dengan perintah
gtag.js event
berikut:
gtag('event', 'timing_complete', {
'name': 'timingVar',
'value': timingValue,
'event_category': 'timingCategory',
'event_label': 'timingLabel'
});
Mengukur pengecualian
Ganti semua perintah send
analytics.js di halaman web Anda yang
melacak pengecualian:
ga('send', 'exception', {
'exDescription': 'error_message',
'exFatal': false // set to true if the exception is fatal
});
dengan perintah
event
gtag.js berikut:
gtag('event', 'exception', {
'description': 'error_message',
'fatal': false // set to true if the exception is fatal
});
Memetakan kolom analytics.js ke parameter gtag.js
Tabel berikut memetakan kolom analytics.js ke parameter gtag.js yang sesuai.
Peristiwa
kolom analytics.js | parameter gtag.js |
---|---|
eventAction |
event_action |
eventCategory |
event_category |
eventLabel |
event_label |
eventValue |
value |
Dimensi dan metrik kustom
kolom analytics.js | parameter gtag.js |
---|---|
dimension<Index> |
dimension<Index> |
metric<Index> |
metric<Index> |
dengan <Index>
adalah bilangan bulat non-negatif yang mewakili indeks dimensi atau metrik kustom.
Waktu pengguna
kolom analytics.js | parameter gtag.js |
---|---|
timingCategory |
event_category |
timingLabel |
event_label |
timingValue |
value |
timingVar |
name |
Pengukuran pengecualian
kolom analytics.js | parameter gtag.js |
---|---|
exDescription |
description |
exFatal |
fatal |
Data tindakan enhanced e-commerce
kolom analytics.js | parameter gtag.js |
---|---|
id |
transaction_id |
affiliation |
affiliation |
revenue |
value |
tax |
tax |
shipping |
shipping |
coupon |
coupon |
list |
list_name |
step |
checkout_step |
option |
checkout_option |
Data promosi
kolom analytics.js | parameter gtag.js |
---|---|
creative |
creative_name |
position (tayangan, produk) |
list_position |
position (promosi) |
creative_slot |
Tindakan produk dan promosi
kolom analytics.js | peristiwa gtag.js |
---|---|
add |
add_to_cart |
checkout (langkah pertama) |
begin_checkout |
checkout (langkah berikutnya) |
checkout_progress |
checkout_option |
set_checkout_option |
click |
select_content (tanpa promosi) |
detail |
view_item |
promo_click |
select_content (dengan promosi) |
purchase |
purchase |
refund |
refund |
remove |
remove_from_cart |
Client ID dan user ID
kolom analytics.js | parameter gtag.js |
---|---|
clientId |
client_id |
userId |
user_id |