Kode Pelacakan: Domain dan Direktori

Referensi ini menjelaskan metode yang Anda gunakan untuk menyesuaikan cara kerja pelaporan Google Analytics di seluruh domain, di berbagai host, atau dalam sub-direktori situs.

Metode Domain/Direktori GATC

Detail Metode

_cookiePathCopy()

_cookiePathCopy(newPath)

Mengubah jalur semua cookie GATC ke jalur yang baru ditentukan. Gunakan fitur ini untuk melacak perilaku pengguna dari satu struktur direktori ke struktur direktori lainnya pada domain yang sama.

Saat dipanggil, fungsi ini akan langsung menyalin semua cookie ke jalur cookie baru. Oleh karena itu, jika metode _trackPageview() belum dipanggil, nilai untuk setiap cookie Analytics yang ada akan diberikan. Oleh karena itu, sebaiknya metode ini dipanggil setelah _trackPageview() serta metode konfigurasi lainnya yang mungkin memengaruhi nilai cookie atau nilai kampanye yang ingin diteruskan, seperti _setCampaignCookieTimeout() atau _setReferrerOverride().

Cuplikan Asinkron (direkomendasikan)
_gaq.push(['_cookiePathCopy', '/newSubDirectory/']);

parameter

String   newPath Jalur baru untuk menyimpan cookie GATC.

_getLinkerUrl()

_getLinkerUrl(targetUrl, useHash)

Metode ini berfungsi bersama dengan metode _setDomainName() dan _setAllowLinker() untuk mengaktifkan pelacakan pengguna lintas-domain, khususnya untuk iFrame dan link yang terbuka di jendela baru. Metode ini menampilkan string yang berisi semua data cookie GATC dari link yang memulai dengan menambahkannya ke parameter URL. Parameter ini kemudian dapat diteruskan ke situs lain atau iFrame.

Cuplikan Asinkron (direkomendasikan)
  _gaq.push(function() {
    var pageTracker = _gat._getTrackerByName(); // Gets the default tracker.
    var linkerUrl = pageTracker._getLinkerUrl('http://www.my-example-iframecontent.com/');
  });

parameter

String   targetUrl URL situs target yang akan dikirimi nilai cookie.

Boolean   useHash Tetapkan ke benar (true) untuk meneruskan variabel kode pelacakan dengan menggunakan pemisah tag anchor #, bukan default? pemisah string kueri.

akan menampilkan

String URL penaut.

_link(targetUrl, useHash)

Metode ini berfungsi bersama dengan metode _setDomainName() dan _setAllowLinker() untuk mengaktifkan pelacakan pengguna lintas-domain. Metode _link() meneruskan cookie GATC dari situs ini ke situs lain melalui parameter URL (HTTP GET). Tindakan ini juga mengubah document.location dan mengalihkan pengguna ke URL baru.

Cuplikan Asinkron (direkomendasikan)
<a href="http://example.com/test.html"
onclick="_gaq.push(['_link', 'http://example.com/test.html']); return false;">click me</a>

parameter

String   targetUrl URL situs target yang akan dikirimi nilai cookie.

Boolean   useHash Tetapkan ke benar (true) untuk meneruskan variabel kode pelacakan dengan menggunakan pemisah tag anchor #, bukan default? pemisah string kueri.


_linkByPost()

_linkByPost(formObject, useHash)

Metode ini berfungsi bersama dengan metode _setDomainName() dan _setAllowLinker() untuk mengaktifkan pelacakan pengguna lintas-domain. Metode _linkByPost() meneruskan cookie GATC dari formulir perujuk ke situs lain dalam string yang ditambahkan ke nilai tindakan formulir tersebut (HTTP POST). Metode ini biasanya digunakan saat melacak perilaku pengguna dari satu situs ke situs keranjang belanja pihak ketiga, tetapi juga dapat digunakan untuk mengirim data cookie ke domain lain di pop-up atau iFrame.

Cuplikan Asinkron (direkomendasikan)
    <form action="http://www.shoppingcartsite.com/myService/formProcessor.php"
    name="f" method="post" onsubmit="_gaq.push(['_linkByPost', this]);">
...
</form>

Selain itu, _setAllowLinker() harus ditetapkan ke true di halaman web tujuan agar dapat ditautkan berfungsi.

parameter

HTMLFormElement   formObject Objek formulir yang merangkum permintaan POST.

Boolean   useHash Tetapkan ke benar (true) untuk meneruskan variabel kode pelacakan dengan menggunakan pemisah tag anchor #, bukan default? pemisah string kueri.


_setAllowHash()

_setAllowHash(bool)

Menetapkan tanda hash domain allow. Secara default, nilai ini ditetapkan ke true. Fungsi hashing domain di Google Analytics membuat nilai hash dari domain Anda, dan menggunakan nomor ini untuk memeriksa integritas cookie bagi pengunjung. Jika Anda memiliki beberapa subdomain, seperti example1.example.com dan example2.example.com, dan ingin melacak perilaku pengguna di kedua subdomain ini, Anda harus menonaktifkan hashing domain agar pemeriksaan integritas cookie tidak menolak cookie pengguna yang datang dari satu domain ke domain lainnya. Selain itu, Anda dapat menonaktifkan fitur ini untuk mengoptimalkan performa pelacakan per halaman.

parameter

Boolean   true atau false Nilai defaultnya adalah true. Jika parameter ini ditetapkan ke true, hashing domain akan diaktifkan. Jika tidak, hashing domain akan dinonaktifkan.

_setAllowLinker()

_setAllowLinker(bool)

Menetapkan tanda fungsi penaut sebagai bagian dari pengaktifan pelacakan pengguna lintas-domain. Secara default, metode ini ditetapkan ke false dan penautan dinonaktifkan. Lihat juga metode _link(), _linkByPost(), dan _setDomainName() untuk mengaktifkan pelacakan lintas-domain. Gunakan metode _setAllowLinker di situs target, sehingga situs target menggunakan data cookie di parameter URL, bukan logika sesi standar.

Cuplikan Asinkron (direkomendasikan)
_gaq.push(['_setAllowLinker', true]); 

parameter

Nilai default
Boolean  true atau false adalah false. Jika parameter ini ditetapkan ke true, penaut akan diaktifkan. Jika tidak, penautan domain akan dinonaktifkan.

_setCookiePath()

_setCookiePath(newCookiePath)

Menetapkan jalur cookie baru untuk situs Anda. Secara default, Google Analytics menetapkan jalur cookie ke tingkat root (/). Pada umumnya, ini adalah opsi yang sesuai dan berfungsi dengan benar dengan kode pelacakan yang Anda instal di situs, blog, atau direktori web perusahaan Anda. Namun, dalam beberapa kasus ketika akses pengguna dibatasi hanya untuk subdirektori dari domain, metode ini dapat menyelesaikan masalah pelacakan dengan menetapkan sub-direktori sebagai jalur default untuk semua pelacakan.

Biasanya, Anda akan menggunakannya jika data Anda tidak dilacak dan Anda berlangganan layanan blog dan hanya memiliki akses ke sub-direktori yang Anda tentukan, atau jika Anda berada di jaringan Perusahaan atau Universitas dan hanya memiliki akses ke direktori utama Anda.

Cuplikan Asinkron (direkomendasikan)
_gaq.push(['_setCookiePath', '/myBlogDirectory']); 

parameter

String   newCookiePath Jalur cookie baru yang akan ditetapkan.

_setDomainName()

_setDomainName(newDomainName)

Menetapkan nama domain untuk cookie GATC. Ada tiga mode untuk metode ini: ("auto" | "none" | [domain]). Secara default, metode ini ditetapkan ke auto, yang berupaya me-resolve nama domain berdasarkan properti document.domain di DOM.

Menentukan Domain

Lihat Panduan Pelacakan Lintas-Domain untuk berbagai contoh yang menggambarkan waktu dan cara menentukan domain dengan metode ini. Contoh berikut menggambarkan cara menetapkan nama domain ke example.com:

Cuplikan Asinkron (direkomendasikan)
_gaq.push(['_setDomainName', 'example.com']); 

Mengisolasi Domain Level Teratas

Menetapkan metode ini ke none akan memastikan bahwa cookie dalam domain tertentu tidak dapat diakses oleh subdomain mana pun.

Cuplikan Asinkron (direkomendasikan)
_gaq.push(['_setDomainName', 'none']); 

parameter

String   newDomainName Nama domain default baru yang akan ditetapkan.

_storeGac(bool)

Menentukan apakah cookie GAC harus dibuat atau tidak. Secara default, cookie GAC ditulis oleh skrip dan Anda tidak perlu melakukan apa pun untuk menulis cookie tersebut. Anda dapat menonaktifkan setelan cookie ini menggunakan perintah di bawah.

Cuplikan Asinkron (direkomendasikan)
_gaq.push(['_storeGac', false]);