Kode Pelacakan: Objek Global _gaq

Objek global _gaq dapat digunakan secara langsung untuk pelacakan halaman asinkron melalui metode push(...). Class ini juga memiliki metode untuk membuat objek pelacak, tetapi hanya boleh digunakan dalam kasus yang jarang terjadi.

Untuk pelacakan halaman tradisional, gunakan objek global _gat.

Metode Objek _gaq

Detail Metode

{i>_createAsyncTracker()<i}

    _createAsyncTracker(accountId, opt_name)
    Membuat objek pelacak yang dapat dirujuk dengan nama saat melakukan panggilan pelacakan asinkron. Jika tidak ada nama yang diberikan, yang akan digunakan adalah string kosong '', yang mewakili pelacak default dalam sintaksis asinkron. Jika pelacak asinkron sudah ada untuk nama yang diberikan, pelacak tersebut akan ditimpa dengan pelacak baru.

    Catatan: Metode ini umumnya hanya aman untuk digunakan di dalam fungsi yang telah didorong ke _gaq. Tindakan ini hanya boleh digunakan dalam kasus yang jarang terjadi.
    _gaq._createAsyncTracker('UA-65432-1');

    parameter

      String accountId ID properti web lengkap (misalnya, UA-65432-1) untuk objek pelacak.
      String opt_name Nama untuk menyimpan objek pelacak. Gunakan nama ini untuk merujuk ke objek pelacak dalam panggilan pelacakan asinkron nanti.

    akan menampilkan

      Tracker Objek pelacakan yang dibuat.

{i>_getAsyncTracker()<i}

    _getAsyncTracker(opt_name)
    Menampilkan objek pelacak yang sebelumnya dibuat dengan nama yang diberikan. Jika tidak ada nama yang diberikan, nama pelacak default (string kosong '') akan digunakan. Jika tidak ada objek pelacak dengan nama yang diberikan, pelacak baru akan dibuat, ditetapkan ke nama tersebut, dan ditampilkan.

    Catatan: Metode ini umumnya hanya aman untuk digunakan di dalam fungsi yang telah didorong ke _gaq. Tindakan ini hanya boleh digunakan dalam kasus yang jarang terjadi.
    _gaq._getAsyncTracker();

    parameter

      String opt_name Nama objek pelacak yang akan diambil.

    akan menampilkan

      Tracker Objek pelacakan yang diambil atau dibuat.

push

    push(commandArray)
    Mengeksekusi command array yang ditentukan, yang merupakan array JavaScript yang sesuai dengan format berikut. Elemen pertama array harus berupa nama metode objek pelacak yang diteruskan sebagai string. Elemen array lainnya adalah nilai yang akan diteruskan sebagai argumen ke fungsi.

    Penggunaan berikut adalah hal yang umum:
    var _gaq = _gaq || [];
    _gaq.push(['_setAccount', 'UA-65432-1']);
    _gaq.push(['_trackPageview']);

    Fungsi ini diberi nama push sehingga array dapat digunakan sebagai pengganti _gaq sebelum Analytics dimuat sepenuhnya. Saat Analytics dimuat, perintah akan dimasukkan ke dalam antrean ke array. Setelah selesai dimuat, Analytics akan mengganti array dengan objek _gaq dan mengeksekusi semua perintah dalam antrean. Panggilan berikutnya ke _gaq.push akan ditetapkan ke fungsi ini, yang mengeksekusi perintah saat didorong.

    Pelacak dapat diberi nama dengan menambahkan nama pelacak (beserta titik) di depan nama metode. Jika nama fungsi memenuhi syarat dengan nama pelacak, nama tersebut akan dieksekusi pada pelacak tersebut.

    Contoh berikut membuat dan menggunakan pelacak yang disebut myTracker secara acak.
    var _gaq = _gaq || [];
    _gaq.push(['myTracker._setAccount', 'UA-65432-2']);
    _gaq.push(['myTracker._setDomainName', 'foo.com']);
    _gaq.push(['myTracker._trackPageview']);

    Catatan: Pelacak dibuat saat pertama kali perintah mereferensikannya. Pelacak default dibuat melalui perintah pertama yang tidak secara eksplisit memberi nama pelacaknya. Nama pelacak default adalah string kosong ''.

    Selain mengirim array perintah, Anda juga dapat mengirim objek fungsi. Hal ini dapat sangat berguna untuk metode pelacak yang menampilkan nilai. Fungsi ini dapat mereferensikan _gat dan _gaq.
    var _gaq = _gaq || [];
    _gaq.push(function() {
      var tracker = _gat._getTracker('UA-65432-1');
      tracker._trackPageview();
    });

    Anda juga dapat menggunakan sintaksis push langsung di HTML halaman Anda.
    onclick="_gaq.push(['_trackEvent', 'name', value]);"

    Selama cuplikan Analytics asinkron ada di atas link, klik akan dicatat tanpa error; meskipun Analytics belum dimuat sepenuhnya saat klik terjadi. Ini adalah salah satu dari banyak manfaat pelacakan asinkron.

    Terakhir, daripada mengetik _gaq.push(...) untuk setiap array perintah, Anda dapat mengirim semua perintah sekaligus. Kode berikut menunjukkan teknik ini. Lihat Panduan Penggunaan Cuplikan Asinkron untuk mengetahui detail selengkapnya.

    _gaq.push(
      ['_setAccount', 'UA-XXXXX-X'],
      ['_setDomainName', 'example.com'],
      ['_setCustomVar', 1, 'Section', 'Life & Style', 3],
      ['_trackPageview']
    );

      parameter

        Array commandArray Perintah yang akan dieksekusi. Satu atau beberapa instance ini dapat dikirim dalam pemanggilan yang sama.

      akan menampilkan

        Number Jumlah perintah yang gagal dijalankan.