Mengukur waktu pengguna dengan gtag.js

Mempercepat waktu muat halaman dapat meningkatkan pengalaman pengguna situs secara keseluruhan. Halaman ini menjelaskan cara mengirim informasi waktu pengguna ke Google Analytics.

Penerapan

Gunakan perintah event untuk mengirim peristiwa timing_complete:

gtag('event', 'timing_complete', {<timing_parameters>});

dengan <timing_parameters> adalah satu atau beberapa pasangan nilai-parameter. Pisahkan setiap pasangan dengan koma. Misalnya, perintah ini mengirim peristiwa waktu pengguna ke Google Analytics yang menunjukkan bahwa halaman web saat ini memerlukan waktu 3.549 milidetik untuk memuat semua dependensi JavaScript eksternal.

gtag('event', 'timing_complete', {
  'name' : 'load',
  'value' : 3549,
  'event_category' : 'JS Dependencies'
});

Parameter waktu pengguna

Tabel ini meringkas parameter waktu pengguna:

Nama parameter	Jenis data	Wajib	Deskripsi
name	string	Ya	String untuk mengidentifikasi variabel yang dicatat (misalnya, 'load').
value	integer	Ya	Jumlah waktu berlalu dalam milidetik untuk dilaporkan ke Google Analytics (misalnya, 20).
event_category	string	Tidak	String untuk mengelompokkan semua variabel waktu pengguna ke dalam grup logis (misalnya, 'JS Dependencies').
event_label	string	Tidak	String yang dapat digunakan untuk menambah fleksibilitas dalam memvisualisasikan waktu pengguna dalam laporan (misalnya, 'Google CDN').

Mengukur waktu

Peristiwa timing_complete memerlukan parameter value yang menentukan waktu berlalu dalam milidetik. Anda perlu menulis kode yang mencatat nilai ini.

Cara termudah untuk melakukannya adalah dengan membuat stempel waktu di awal periode dan membuat stempel waktu lain di akhir periode. Kemudian, hitung waktu yang berlalu antar-stempel waktu.

Sebagian besar browser modern mendukung Navigation Timing API, yang mencakup metode di objek window.performance untuk mengukur performa halaman web melalui data waktu resolusi tinggi.

Contoh berikut menggunakan metode performance.now(), yang menampilkan jumlah waktu yang telah berlalu sejak halaman pertama kali mulai dimuat:

// Feature detects Navigation Timing API support.
if (window.performance) {
  // Gets the number of milliseconds since page load
  // (and rounds the result since the value must be an integer).
  var timeSincePageLoad = Math.round(performance.now());

  // Sends the timing event to Google Analytics.
  gtag('event', 'timing_complete', {
    'name': 'load',
    'value': timeSincePageLoad,
    'event_category': 'JS Dependencies'
  });
}

Pertimbangan pengambilan sampel

Google Analytics akan mengambil sampel peristiwa pengaturan waktu untuk memastikan distribusi resource sistem yang setara untuk fitur ini.

Frekuensi pengambilan sampel peristiwa pengaturan waktu ditentukan oleh jumlah total tayangan halaman yang diterima selama hari sebelumnya untuk properti tersebut. Tabel berikut menjelaskan cara menentukan rasio pengambilan sampel waktu:

Total jumlah tayangan halaman (hari sebelumnya)	Jumlah maksimum peristiwa pengaturan waktu yang akan diproses
0 - 1.000	100
1.000—100.000	10% dari total jumlah tayangan halaman
100.000—1.000.000	10.000
1.000.000+	1% dari total jumlah tayangan halaman