Tentang cuplikan gtag.js
Jika Anda menggunakan analytics.js untuk properti Universal Analytics saat ini, Anda harus menambahkan cuplikan gtag.js untuk properti Google Analytics 4 baru. Cuplikan gtag.js memiliki struktur berikut:
01: <script async src="https://www.googletagmanager.com/gtag/js?id=<Contoh ID Properti A>"></script>
02: <script>
03: window.dataLayer = window.dataLayer || [];
04: function gtag(){dataLayer.push(arguments);}
05: gtag('js', new Date());
06:
07: gtag('config', '<Contoh ID Properti A>');
08:
09: gtag('config', '<Contoh ID Properti B>');
10:
11: gtag('event', 'sign_up', { 'method': 'email' });
12:
13: gtag('event', 'view_video', { 'send_to': '<Contoh ID Properti B>' });
14:
15: </script>
Baris 7: Perintah "config" gtag mengaktifkan pengumpulan data untuk properti yang terkait dengan <Contoh ID Properti A>. Misalnya, penambahan perintah ini dengan ID tag untuk properti Google Analytics 4 akan mengirim peristiwa page_view ke properti tersebut.
ID properti dapat merepresentasikan berbagai produk Google, termasuk properti UA ("UA-XXXXXXXX"), properti Google Analytics 4 ("G-XXXXXXXX"), Google Ads ("AW-XXXXXXXX"), atau Floodlight ("DC-XXXXXXXX).
Baris 11: Perintah "event" gtag akan mengirim peristiwa. Dalam cuplikan yang berisi beberapa perintah "config" untuk beberapa properti, peristiwa akan dikirim ke semua properti.
Dalam contoh ini, parameter "sign_up" adalah nama peristiwa. Parameter terakhir adalah objek yang berisi kumpulan parameter peristiwa. Dalam hal ini, "method" adalah parameter dengan nilai "email".
Baris 13: Peristiwa di sini memiliki "send_to" sebagai parameter. Ini adalah parameter khusus yang "mengarahkan" peristiwa terkait ke properti tertentu. Dengan kata lain, peristiwa ini hanya akan dikirim ke properti yang ditunjukkan oleh <Contoh ID Properti B>.
Pengumpulan data dasar untuk properti Google Analytics 4 diaktifkan melalui perintah "config" gtag dan mengaktifkan pengumpulan peristiwa page_view sebagai peristiwa yang dikumpulkan secara otomatis saat dimuat di halaman.
Hit kunjungan halaman atau peristiwa page_view dapat diubah atau diblokir menggunakan parameter tertentu.
ID properti
ID properti Universal Analytics memiliki format "UA-XXXXXXXX". Hal ini terkadang disebut sebagai ID Pelacakan. Dalam panduan ini, kami akan menyebutnya sebagai ID Properti UA.
Aliran data web untuk properti Google Analytics 4 menggunakan ID tag dengan format "G-XXXXXXXX".
Dalam beberapa contoh dan dokumentasi kode, Anda mungkin melihat keduanya disebut sebagai "TAG_ID".
Pengumpulan data dasar
Mengaktifkan pengumpulan data dasar untuk properti Google Analytics 4 memungkinkan hal-hal berikut untuk dikumpulkan:
- peristiwa page_view
- peristiwa yang dikumpulkan secara otomatis
- peristiwa pengukuran yang ditingkatkan (jika diaktifkan di UI)
Agar dapat mengaktifkan pengumpulan data dasar untuk properti Google Analytics 4, tambahkan cuplikan gtag.js (tag Google) ke bagian <head> di setiap halaman.
Cuplikan gtag.js dibandingkan dengan cuplikan analytics.js
Cuplikan gtag.js untuk properti Google Analytics 4 memiliki tujuan yang sama dengan cuplikan analytics.js untuk properti Universal Analytics.
Perbedaan terbesar antara kedua cuplikan ini adalah kode analytics.js mencakup panggilan "send pageview" terpisah, sedangkan kode gtag.js tidak. Di gtag.js, pageview adalah peristiwa yang dikumpulkan secara otomatis yang dikirim bersama dengan perintah "config".
Properti Universal Analytics (analytics.js)
<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', 'TAG_ID', 'auto');
ga('send', 'pageview');
</script>
Properti Google Analytics 4 (gtag.js)
<script async src="https://www.googletagmanager.com/gtag/js?id=TAG_ID"></script>
<script>
window.dataLayer = window.dataLayer || [];
function gtag(){dataLayer.push(arguments);}
gtag('js', new Date());
gtag('config', 'TAG_ID');
</script>
Setelan konfigurasi untuk gtag.js
Anda dapat mengonfigurasi cuplikan gtag.js dasar untuk mengontrol setelan pengumpulan data seperti penyamaran IP, penyesuaian cookie, dan Sinyal Google yang mirip dengan analytics.js. Anda melakukannya melalui perintah "config" atau "set" di gtag.js (dibandingkan dengan perintah "set", "create", dan "require" di analytics.js.)
Properti Google Analytics 4 ("G-XXXXXXXX") mendukung penerapan setelan konfigurasi serupa melalui gtag.js. Ada perbedaan antara setelan ini untuk properti Universal Analytics dan Google Analytics 4. Perhatikan pertimbangan berikut:
- Penyamaran IP ditetapkan secara default ke "true" dan tidak dapat dikonfigurasi di properti Google Analytics 4. Dengan demikian, alamat IP akan otomatis disamarkan saat peristiwa standar dikirim ke properti Google Analytics 4 ("G-XXXXXXXX").
- Jika setelan global perlu diterapkan ke semua properti yang dikonfigurasi, perintah "set" di gtag.js harus digunakan untuk melakukan penerapan ke semua ID tag dan/atau ID properti.
- Perhatikan dengan cermat Fitur Iklan dan Personalisasi Iklan di analytics.js, yang paling sering diterapkan dengan baris "set".
Jika menggunakan perintah "set", "create", dan "require" dalam penerapan analytics.js saat ini, tinjau perintah mana yang secara otomatis ditetapkan di properti Google Analytics 4 dan mana yang harus ditentukan dalam kode properti Google Analytics 4 (pemetaan parameter).
Beberapa contoh konfigurasi bersama contoh kodenya di analytics.js (untuk properti UA) dan gtag.js (untuk properti Google Analytics 4) dijelaskan di bawah:
Mengaktifkan pengumpulan data dasar; mengonfigurasi User-ID
analytics.js
ga('create', 'TAG_ID', 'auto', {
userId: USER_ID
});
ga('send', 'pageview');
gtag.js
gtag('config', 'TAG_ID', {
'user_id': 'USER_ID'
});
Mengonfigurasi setelan cookie
analytics.js
ga('create', 'TAG_ID', {
'cookieName': 'gaCookie',
'cookieDomain': 'blog.example.co.uk',
'cookieExpires': 60 * 60 * 24 * 28 // Waktu dalam detik.
});
gtag.js
gtag('config', 'TAG_ID', {
'cookie_prefix': 'MyCookie',
'cookie_domain': 'blog.example.com',
'cookie_expires': 28 * 24 * 60 * 60 // 28 hari, dalam detik
});
Memblokir peristiwa page_view
Jika peristiwa page_view tidak perlu dikirim saat Anda memuat kode konfigurasi (misalnya jika memiliki pemuatan iframe), Anda dapat menyesuaikan setelan konfigurasi untuk memblokir peristiwa page_view. Pertimbangkan sebuah skenario saat peristiwa page_view dikirim, diikuti dengan pengguna yang login ke situs. Untuk interaksi login, Anda dapat menggunakan perintah "config" untuk menetapkan ID pengguna, tetapi sebaiknya jangan mengirim peristiwa page_view lagi. Kode berikut menggambarkan cara mencegah peristiwa page_view dikirim.
gtag('config', 'TAG_ID', {
'user_id': 'USER_ID',
'send_page_view': false
});
Nama Tag
Nama tag (dikenal sebagai "pelacak") digunakan jika Anda ingin mengirim data ke properti Universal Analytics lain di analytics.js. Di analytics.js, pelacak menentukan properti yang ingin Anda kirimi data. Hit setelah hit "create" awal tidak perlu lagi menentukan ID properti Universal Analytics, cukup nama pelacaknya saja.
Di gtag.js, pelacak tidak tersedia untuk properti Google Analytics 4 atau Universal Analytics. Jika Anda ingin mengirim semua hit ke beberapa properti (aliran data yang berbeda-beda di satu properti Google Analytics 4), tentukan semua ID tag atau ID properti di baris "config".
Peristiwa
Lihat Panduan migrasi peristiwa.Dimensi dan metrik kustom
Dimensi dan metrik kustom digunakan untuk memperluas informasi yang diukur di situs, dan untuk mengimpor data offline dari mis. sistem CRM. Di properti Universal Analytics ("UA-XXXXXXXX"), dimensi dan metrik kustom harus dibuat di UI, diberi ID, lalu dapat diterapkan atau diimpor. Dimensi dan metrik tersebut dapat dibuat dengan empat cakupan yang berbeda: hit, sesi, pengguna, produk.
Di properti Google Analytics 4 ("G-XXXXXXXX"), kasus penggunaan dimensi dan metrik kustom diterapkan dengan cara yang berbeda. Pengukuran dimensi dan metrik kustom di properti UA yang diterapkan melalui analytics.js perlu diterapkan kembali sebagai parameter di properti Google Analytics 4.
Dimensi kustom untuk properti Universal Analytics dapat diterapkan melalui analytics.js sebagai berikut:
ga('send', 'event', 'category_value', 'action_name', {'dimension5': 'custom data'
});
ATAU
ga('set', 'dimension5', 'custom data');
Dimensi kustom ini dapat diterjemahkan ke properti Google Analytics 4 melalui gtag.js sebagai berikut:
gtag('event', 'action_name', {'eventCategory': 'category_value',
'dimension5': 'custom data'
});
ATAU
gtag('set', {'dimension5': 'custom data'});
Ada dua peringatan yang harus diperhatikan:
- Parameter harus didaftarkan di antarmuka pengguna agar muncul di laporan. Ini adalah proses yang sebanding dengan pendaftaran dimensi kustom di Universal Analytics (batasan berlaku). Anda tidak perlu mendaftarkannya jika hanya melihat data yang diekspor atau hanya menggunakan parameter untuk pengaktifan audiens.
- Cakupan parameter kustom selalu berada pada tingkat peristiwa, yang sebanding dengan cakupan hit. Hal ini juga berlaku untuk dimensi kustom yang secara otomatis diterjemahkan menjadi parameter (untuk penerapan "UA-XXXXXXXX" gtag.js), terlepas dari setelan cakupan dimensi kustom asli.
Pemetaan dan pertimbangan yang sama berlaku untuk metrik kustom, kecuali metrik tersebut diperhitungkan terhadap batasan parameter numerik, bukan batasan parameter teks saat didaftarkan untuk pelaporan.
Secara konseptual, dimensi dan metrik kustom dari berbagai cakupan di properti Universal Analytics dipetakan ke properti Google Analytics 4 sebagai:
- Dimensi kustom cakupan hit: parameter (maks. 25 total parameter yang dicatat per peristiwa selama pengumpulan data; maks. 50 dimensi kustom/50 metrik kustom)
Perhatikan bahwa peristiwa & parameter yang dikumpulkan secara otomatis mungkin sudah mencakup beberapa kasus penggunaan yang sebelumnya telah menerapkan dimensi kustom cakupan hit - Dimensi kustom cakupan pengguna: properti pengguna (maks. 25 yang didaftarkan untuk pelaporan melalui UI). Properti pengguna yang dikumpulkan secara otomatis tidak diperhitungkan terhadap batasan ini.
- Dimensi kustom cakupan sesi: tidak ada padanan di properti Google Analytics 4; sebagai gantinya, gunakan parameter kustom atau properti pengguna.
Praktik terbaik untuk properti pengguna
Properti pengguna akan terus dikaitkan dengan seorang pengguna di berbagai platform (mis., di semua jenis aliran data), sehingga hanya boleh digunakan jika datanya harus diterapkan pada tingkat pengguna. Properti pengguna tidak boleh digunakan untuk data tingkat sesi atau data tingkat perangkat (mis., ukuran layar).
Contoh properti Google Analytics 4
gtag('set', 'user_properties', {
favorite_composer: 'Mahler',
favorite_instrument: 'double bass',
season_ticketholder: 'true'
});