[UA→GA4] Cara gtag.js untuk UA dipetakan ke GA4

Ini adalah panduan penerapan bagi pemilik situs yang menggunakan koleksi gtag.js dan ingin memahami cara gtag.js Universal Analytics (UA) dipetakan ke Google Analytics 4. Hal ini didasarkan pada asumsi bahwa Anda telah membuat properti Google Analytics 4. Jika Anda hanya perlu menambahkan kode pengukuran dasar ke situs, baca artikel ini.

Dalam artikel ini:

• Tentang cuplikan gtag.js
• Pengumpulan data dasar
• Setelan konfigurasi untuk gtag.js
• Peristiwa
• Dimensi dan metrik kustom

Tentang cuplikan gtag.js dan ID properti

Cuplikan gtag.js untuk properti Universal Analytics dan properti Google Analytics 4 pada dasarnya sama. Kedua cuplikan tersebut 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 1: Jika Anda telah menerapkan properti Universal Analytics melalui gtag.js, baris kode ini mungkin sudah ada di situs Anda. Anda akan melihat "UA-" yang diikuti dengan serangkaian angka, bukan <Contoh ID Properti A>. Jika Anda telah menerapkan gtag.js untuk Google Ads atau produk Google Marketing Platform lainnya, baris kode ini mungkin juga sudah ada di situs Anda, tetapi <Contoh ID Properti A> akan diawali dengan "AW-" atau "DC-".

ID properti (atau ID tag, untuk properti Google Analytics 4) yang ditunjukkan oleh <Contoh ID Properti A> "mengontrol" cuplikan gtag.js ini. Hal ini penting karena:

1. Jika sudah ada, baris ini tidak perlu diterapkan untuk kedua kalinya. Anda hanya perlu menambahkan baris "config" untuk menentukan ID tag.
2. ID properti pada baris ini adalah "pengontrol" cuplikan gtag.js. Jika ID properti Universal Analytics ("UA-XXXXXXXX") mengontrol tag, Anda dapat menggunakan tag situs yang terhubung untuk mengirim data pengukuran ke properti Google Analytics 4, tanpa harus menambahkan kode baru ke halaman.

Baris 7: Perintah "config" gtag mengaktifkan pengumpulan data untuk properti yang terkait dengan <Contoh ID Properti A>. Misalnya, di properti Google Analytics 4, penambahan perintah ini dengan ID tag akan mengirim peristiwa page_view ke properti tersebut.

ID properti mungkin mewakili pengukuran untuk berbagai produk Google, termasuk properti Universal Analytics ("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 mengirimkan peristiwa terkait ke properti tertentu. Dengan kata lain, peristiwa ini hanya akan dikirim ke properti yang ditunjukkan oleh <Contoh ID Properti B>.

Perintah config gtag akan mengaktifkan pengukuran dasar.

• Untuk properti Universal Analytics, "config" dengan ID properti Universal Analytics akan mengirim hit kunjungan halaman.
• Untuk properti Google Analytics 4, "config" dengan ID tag akan mengaktifkan pengumpulan peristiwa page_view (sebagai peristiwa yang dikumpulkan secara otomatis) saat dimuat di halaman.

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 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

Pengaktifan pengumpulan data dasar untuk properti Google Analytics 4 memungkinkan pengumpulan hal-hal berikut:

• peristiwa page_view
• peristiwa yang dikumpulkan secara otomatis
• peristiwa pengukuran yang ditingkatkan (jika diaktifkan di UI)

Jika properti Universal Analytics yang ada menggunakan penerapan gtag.js, Anda dapat mengaktifkan pengumpulan data dasar untuk properti Google Analytics 4 dengan:

• Opsi 1: Menambahkan perintah "config" baru dengan ID tag yang relevan
  ATAU
• Opsi 2: Mengaktifkan tag situs yang terhubung (jika penerapan gtag.js yang ada memenuhi syarat)

Terlepas dari opsi yang Anda pilih, properti Universal Analytics yang ada tetap tidak terpengaruh dan akan terus mengumpulkan data.

Opsi 1: Menambahkan perintah "config" baru

Jika sudah ada kode gtag.js pada halaman, cukup berikan perintah "config" tambahan dengan ID Pengukuran properti Google Analytics 4 yang relevan. Pada contoh di bawah, baris 8 telah ditambahkan ke penerapan gtag.js yang ada. Ini merujuk ke ID Pengukuran properti Google Analytics 4. Tindakan ini akan mengirim peristiwa page_view ke properti Google Analytics 4. Ini juga mengaktifkan peristiwa yang dikumpulkan secara otomatis dan peristiwa pengukuran yang ditingkatkan (jika Anda telah mengaktifkan pengukuran yang ditingkatkan) di properti Google Analytics 4.

1: <script async src="https://www.googletagmanager.com/gtag/js?id=<Contoh ID Properti A>"></script>

2: <script>

3: window.dataLayer = window.dataLayer || [];

4: function gtag(){dataLayer.push(arguments);}

5: gtag('js', new Date());

6:

7: gtag('config', '<Contoh ID Properti A>');

8: gtag('config', 'G-XXXXXXXX');

9: </script>

Opsi 2: Mengaktifkan tag situs yang terhubung

Anda dapat menggunakan tag situs yang terhubung jika:

• Cuplikan gtag.js yang ada pada halaman tempat Anda ingin mengukur interaksi pengguna "dikontrol" oleh properti Universal Analytics (yaitu ID berawalan "UA-" yang direferensikan di baris berikut dalam cuplikan gtag.js):

<script async src="https://www.googletagmanager.com/gtag/js?id=<Contoh ID Properti A>"></script>

(Tag situs yang terhubung juga akan berfungsi jika cuplikan gtag.js yang ada dikontrol oleh properti Google Analytics 4. Namun, Anda hanya akan mengalami situasi ini jika properti Google Analytics 4 telah diterapkan.)

• DAN Anda memiliki akses admin ke properti Universal Analytics yang direferensikan oleh ID dalam cuplikan.

Jika Anda memiliki tag gtag.js dan penampung GTM yang diterapkan pada halaman, tag gtag.js harus ditempatkan di atas penampung GTM agar tag situs yang terhubung berfungsi.

Setelan konfigurasi untuk gtag.js

Anda dapat mengonfigurasi cuplikan gtag.js dasar untuk mengontrol setelan pengumpulan data seperti anonimisasi IP, penyesuaian cookie, dan Sinyal Google. Anda dapat melakukannya melalui perintah "config" atau "set" di gtag.js.

Properti Universal Analytics ("UA-XXXXXXXX") dan Google Analytics 4 ("G-XXXXXXXX") mendukung penerapan setelan konfigurasi ini melalui gtag.js. Namun, ada beberapa perbedaan antara setelan ini untuk properti Universal Analytics dan properti Google Analytics 4. 

• Anonimisasi IP ditetapkan secara default ke "true" dan tidak dapat dikonfigurasi di properti Google Analytics 4. Dengan demikian, alamat IP secara 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" harus digunakan untuk melakukan penerapan ke semua ID Pengukuran dan/atau ID Properti, termasuk yang diterapkan melalui tag situs yang terhubung.
• Perhatikan dengan cermat fitur Nonaktifkan Personalisasi Iklan, yang paling sering diterapkan dengan baris "config".
• Saat menggunakan tag situs yang terhubung: Konfigurasi apa pun yang dibuat di kode gtag.js menggunakan "config" hanya berlaku untuk properti yang terkait dengan ID Pengukuran dalam baris kode tersebut; ini tidak akan secara otomatis dikirim ke properti Google Analytics 4 yang terhubung. Jika Anda ingin konfigurasi diterapkan ke properti Google Analytics 4 yang terhubung,
  • Buat perintah "config" terpisah dan terapkan ke properti Google Analytics 4 yang relevan dengan mereferensikan ID Pengukuran
    ATAU
  • Konfigurasikan setelan menggunakan perintah "set", sehingga konfigurasi akan diterapkan ke semua properti yang dikonfigurasi.

Contoh konfigurasi

Mengaktifkan pengumpulan data dasar; mengonfigurasi User-ID

gtag('config', 'GA_MEASUREMENT_ID', {

'user_id': 'USER_ID'

});

Mengonfigurasi setelan cookie

gtag('config', 'GA_MEASUREMENT_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', 'MEASUREMENT_ID', {

'user_id': 'USER_ID',

'send_page_view': false

});

Peristiwa

Lihat Panduan migrasi peristiwa.

Dimensi dan metrik kustom

Dimensi dan metrik kustom dapat digunakan untuk memperluas informasi dan mengimpor data offline, mis., dari sistem CRM.

Jika menggunakan tag Google (gtag.js) pengukuran Dimensi dan metrik kustom akan otomatis diterjemahkan menjadi parameter jika tag situs yang terhubung atau properti Google Analytics 4 (mis., “G-XXXXXXXX”) digunakan.

Pelajari lebih lanjut dimensi dan metrik kustom.