Panduan ini menjelaskan cara menggunakan analytics.js untuk mengukur aktivitas halaman di situs yang kontennya dimuat secara dinamis tanpa pemuatan halaman penuh yang biasa.
Ringkasan
Aplikasi Web Satu Halaman (SPA) adalah aplikasi web atau situs yang memuat semua resource yang diperlukan untuk menjelajahi seluruh situs pada pemuatan halaman pertama. Saat pengguna mengklik link dan berinteraksi dengan halaman, konten berikutnya dimuat secara dinamis. Aplikasi ini akan sering memperbarui URL di kolom URL untuk mengemulasikan navigasi halaman biasa, tetapi permintaan halaman penuh lainnya tidak akan pernah dibuat.
Tag Google Analytics default berfungsi baik pada situs biasa karena kode cuplikan dijalankan setiap kali pengguna memuat halaman baru. Namun, untuk aplikasi web satu halaman yang memuat konten halaman baru secara dinamis, dan bukan sebagai pemuatan halaman penuh, kode cuplikan analytics.js hanya dijalankan satu kali. Ini berarti pageview (virtual) berikutnya harus dicatat secara manual saat konten baru dimuat.
Melacak pageview virtual
Saat aplikasi Anda memuat konten secara dinamis dan memperbarui URL di kolom URL, data yang tersimpan di pelacak Anda juga akan diperbarui.
Untuk memperbarui pelacak, gunakan perintah set dan berikan nilai page baru:
ga('set', 'page', '/new-page.html');
Setelah Anda menetapkan nilai halaman baru, semua hit berikutnya yang dikirim akan menggunakan nilai baru tersebut. Untuk mencatat kunjungan halaman, kirim hit kunjungan halaman segera setelah memperbarui pelacak.
ga('set', 'page', '/new-page.html');
ga('send', 'pageview');
Meskipun secara teknis perintah send untuk hit kunjungan halaman menerima kolom page opsional sebagai parameter ketiga, meneruskan kolom page dengan cara tersebut tidak direkomendasikan saat mengukur aplikasi web satu halaman. Hal ini karena kolom yang diteruskan melalui perintah send tidak ditetapkan di pelacak—kolom tersebut hanya diterapkan pada hit saat ini. Tidak memperbarui pelacak akan menyebabkan masalah jika aplikasi Anda mengirim hit non-kunjungan halaman (misalnya peristiwa atau interaksi sosial), karena hit tersebut akan dikaitkan dengan nilai page apa pun yang dimiliki pelacak saat dibuat.
Menangani beberapa URL untuk resource yang sama
Beberapa Aplikasi Web Satu Halaman hanya memperbarui bagian hash URL saat memuat konten secara dinamis. Praktik ini dapat mengakibatkan situasi ketika banyak jalur halaman yang berbeda mengarah ke resource yang sama. Dalam kasus seperti itu, sebaiknya Anda memilih URL kanonis dan hanya mengirim nilai page tersebut ke Google Analytics.
Misalnya, pertimbangkan situs dengan halaman "Tentang Kami" yang dapat dijangkau melalui salah satu URL berikut:
/about.html/#about.html/home.html#about.html
Untuk menghindari duplikasi dalam laporan, sebaiknya catat semua kunjungan halaman tersebut sebagai /about.html.
Pertimbangan penting
Jangan perbarui perujuk dokumen
Saat Anda membuat objek pelacak menggunakan perintah create, nilai document.referrer disimpan di kolom referrer pelacak. Dalam konteks aplikasi web satu halaman yang tidak menggunakan pemuatan halaman penuh, kolom referrer akan selalu sama.
Meskipun demikian, kolom perujuk tidak perlu diperbarui secara manual sebelum mengirim hit kunjungan halaman. Google Analytics dapat otomatis menentukan jalur navigasi yang benar.
Jangan perbarui lokasi dokumen
Dengan cara yang sama seperti pelacak menggunakan document.referrer untuk kolom referrer, pelacak menggunakan document.location untuk kolom location, yang mungkin berisi data kampanye atau metadata lainnya dalam bentuk parameter kueri yang ditambahkan ke bagian akhir URL.
Memperbarui salah satu kolom kampanye atau metadata lainnya yang diperiksa Google Analytics dapat menyebabkan sesi saat ini berakhir dan sesi baru dimulai. Untuk menghindari masalah ini, jangan perbarui kolom location saat mengukur tayangan halaman virtual dalam aplikasi web satu halaman. Gunakan kolom page sebagai gantinya.
Jangan buat pelacak baru
Jangan buat pelacak baru di Aplikasi Web Satu Halaman guna mencoba meniru fungsi cuplikan pelacakan JavaScript untuk situs biasa. Tindakan tersebut berisiko mengirimkan perujuk dan data kampanye yang salah seperti yang dijelaskan di atas.