Plugin penaut menyederhanakan proses penerapan pengukuran lintas-domain seperti yang dijelaskan di Panduan pengukuran lintas-domain untuk analytics.js.
Ringkasan
Pengukuran lintas-domain bekerja dengan membagikan client ID unik antara domain sumber dan domain tujuan. Ini adalah proses dua langkah:
- Domain sumber harus memastikan semua URL yang mengarah ke domain tujuan berisi client ID domain sumber.
- Domain tujuan perlu diketahui untuk memeriksa keberadaan client ID di URL setelah pengguna membukanya.
Plugin penaut melakukan hal ini dengan menambahkan parameter penaut ke URL yang mengarah ke domain tujuan. Parameter penaut berisi client ID serta stempel waktu saat ini dan metadata browser yang dienkode di dalamnya. Stempel waktu dan metadata digunakan untuk menghindari masalah pada pembagian URL.
Parameter penaut akan terlihat seperti ini:
_ga=1.199239214.1624002396.1440697407
Di domain tujuan, kolom allowLinker disediakan, yang ketika true menginstruksikan analytics.js untuk memeriksa parameter penaut di URL. Jika parameter penaut ditemukan dan valid, parameter tersebut akan mengekstrak client ID dari parameter dan menyimpannya.
Plugin Penaut memungkinkan penambahan parameter penaut secara otomatis dan manual ke URL dalam link dan formulir di halaman. Pada sebagian besar kasus, cara otomatis adalah cara yang direkomendasikan.
Menambahkan parameter penaut secara otomatis
Untuk menyiapkan penautan otomatis lintas-domain di domain sumber untuk URL yang mengarah ke domain tujuan, Anda harus meminta plugin penaut dan memanggil metode autoLink.
autoLink
Metode autoLink dapat dipanggil melalui antrean perintah.
Setelah berjalan, analytics.js akan memproses klik di link yang mengarah ke domain (atau beberapa domain) tujuan dan menambahkan langsung parameter penaut ke link tersebut sebelum navigasi dimulai. Anda harus menunggu hingga pengguna mengklik link untuk menambahkan parameter penaut karena parameter penaut akan berakhir masa berlakunya setelah dua menit.
Parameter decorateForms opsional harus ditentukan dan ditetapkan ke true jika Anda memiliki formulir di situs yang mengarah ke domain tujuan.
Penggunaan
ga('[trackerName.]linker:autoLink', domains, [useAnchor], [decorateForms]);
Parameter
| Nama | Jenis | Wajib diisi | Deskripsi |
|---|---|---|---|
domains |
Array[RexExp|string] |
ya | Array string atau ekspresi reguler yang akan dicocokkan dengan hostname URL yang menunjukkan penautan otomatis domain mana yang akan diterapkan. Jika string diteruskan, analytics.js akan melakukan pencocokan substring, yang berarti example.com akan mencocokkan link yang mengarah ke blog.example.com. |
useAnchor |
boolean |
tidak | Jika benar, parameter penaut akan ditambahkan ke bagian anchor URL, bukan ke bagian kueri. |
decorateForms |
boolean |
tidak | Jika benar, plugin penaut akan menambahkan parameter penaut untuk pengiriman formulir yang mengarah ke tujuan yang cocok dengan parameter domain. |
Contoh
// Loads the Linker plugin
ga('require', 'linker');
// Instructs the Linker plugin to automatically add linker parameters
// to all links and forms pointing to the domain "destination.com".
ga('linker:autoLink', ['destination.com'], false, true);
Menambahkan parameter penaut secara manual
Anda dapat menambahkan parameter penaut secara manual ke elemen <a> atau <form> tertentu melalui metode decorate. Metode ini hanya diperlukan jika tidak menggunakan metode autoLink yang dijelaskan di atas.
decorate
Metode decorate dapat dipanggil melalui antrean perintah.
Penting untuk memastikan metode decorate dipanggil sedekat mungkin saat navigasi akan terjadi, karena parameter penaut akan berakhir masa berlakunya setelah dua menit. Sering kali metode ini harus dipanggil di handler peristiwa.
Penggunaan
ga('[trackerName.]linker:decorate', element, [useAnchor]);
Parameter
| Nama | Jenis | Wajib diisi | Deskripsi |
|---|---|---|---|
element |
HTMLElement |
ya | Elemen <a> atau <form> yang akan ditambahi ke parameter penaut. |
useAnchor |
boolean |
tidak | Jika benar, parameter penaut akan ditambahkan ke bagian anchor URL, bukan ke bagian kueri. |
Contoh
// Loads the Linker plugin
ga('require', 'linker');
// Gets a reference to a link pointing to an external domain.
var destinationLink = document.getElementById('destination-link');
// Adds click handler that decorates `destinationLink`.
destinationLink.addEventListener('click', function() {
ga('linker:decorate', destinationLink);
});
linkerParam
Selain metode decorate, Anda bisa mendapatkan parameter penaut yang akan digunakan pelacak melalui kolom linkerParam secara manual.
ga(function(tracker) {
var linkerParam = tracker.get('linkerParam');
});
Mengonfigurasi situs untuk menerima parameter penaut
Setelah pengguna membuka halaman di domain tujuan dengan parameter penaut di URL, analytics.js perlu diketahui untuk mencari parameter tersebut.
Anda dapat menginstruksikan halaman tujuan untuk mencari parameter penaut dengan menetapkan kolom allowLinker ke true saat membuat pelacak:
ga('create', 'UA-XXXXXX-X', 'auto', {
allowLinker: true
});
Pengukuran lintas-domain dua arah
Alur pengguna tempat pengguna selalu memulai di domain sumber dan hanya setelah itu beralih ke domain tujuan dalam pengukuran lintas-domain satu arah yang dipilih. Petunjuk di atas mengasumsikan jenis alur pengguna ini.
Jika tidak diketahui domain mana yang akan dikunjungi pengguna pertama kali, Anda harus menerapkan pengukuran lintas-domain dua arah, dengan masing-masing domain dikonfigurasi untuk berfungsi sebagai sumber atau tujuan.
Untuk menerapkan pengukuran lintas-domain dua arah, Anda dapat mengaktifkan penautan otomatis di kedua domain dan mengonfigurasi keduanya untuk menerima parameter penaut.
Di source.com:
ga('create', 'UA-XXXXX-Y', 'auto', {allowLinker: true});
ga('require', 'linker');
ga('linker:autoLink', ['destination.com']);
Di destination.com:
ga('create', 'UA-XXXXX-Y', 'auto', {allowLinker: true});
ga('require', 'linker');
ga('linker:autoLink', ['source.com']);
Menggunakan satu cuplikan di semua domain
Untuk lebih menyederhanakannya, Anda dapat mencantumkan semua domain potensial yang ingin Anda ukur dalam metode autoLink, sehingga Anda dapat menggunakan cuplikan kode yang sama di setiap domain:
ga('create', 'UA-XXXXX-Y', 'auto', {allowLinker: true});
ga('require', 'linker');
ga('linker:autoLink', ['source.com', 'destination.com']);