Mendapatkan dan Menetapkan Data Kolom

Mendapatkan dan menetapkan data kolom pada pelacak terkadang membutuhkan referensi ke objek pelacak itu sendiri. Karena perintah yang ditambahkan ke antrean perintah ga() dieksekusi secara asinkron dan tidak menampilkan nilai, dan karena pelacak paling sering dibuat menggunakan perintah create, referensi ke objek pelacak baru diperoleh setelah perintah create selesai dieksekusi. Anda dapat melakukannya melalui siap callback.

Siap callback

Siap callback adalah fungsi yang dapat Anda tambahkan ke antrean perintah ga(). Fungsi ini akan dipanggil segera setelah library analytics.js dimuat sepenuhnya, dan semua perintah sebelumnya yang ditambahkan ke antrean telah dieksekusi.

Karena semua perintah ke antrean dieksekusi secara berurutan, menambahkan siap callback ke antrean setelah menambahkan perintah create akan memastikan bahwa siap callback akan dieksekusi setelah pelacak dibuat. Jika pelacak default telah dibuat saat siap callback dipanggil, ini akan diteruskan sebagai argumen pertama (dan satu-satunya) dari callback.

Kode berikut menunjukkan cara mengakses objek pelacak default dan mencatatnya ke konsol:

ga('create', 'UA-XXXXX-Y', 'auto');

ga(function(tracker) {
  // Logs the tracker created above to the console.
  console.log(tracker);
});

Mendapatkan pelacak melalui metode Objek ga

Jika tidak menggunakan pelacak default, atau jika sudah memiliki lebih dari satu pelacak pada halaman, Anda dapat mengakses pelacak tersebut melalui salah satu metode objek ga.

Setelah library analytics.js dimuat sepenuhnya, library ini akan menambahkan metode lain ke objek ga itu sendiri. Dua dari metode tersebut, getByName dan getAll, digunakan untuk mengakses objek pelacak.

Catatan: Metode objek ga hanya tersedia saat analytics.js dimuat sepenuhnya, jadi sebaiknya Anda hanya mereferensikannya dalam siap callback.

getByName

Jika mengetahui nama pelacak yang ingin diakses, Anda dapat melakukannya menggunakan metode getByName:

ga('create', 'UA-XXXXX-Y', 'auto', 'myTracker');

ga(function() {
  // Logs the "myTracker" tracker object to the console.
  console.log(ga.getByName('myTracker'));
});

getAll

Untuk mendapatkan array dari semua pelacak yang dibuat, gunakan metode getAll:

ga('create', 'UA-XXXXX-Y', 'auto', 'tracker1');
ga('create', 'UA-XXXXX-Z', 'auto', 'tracker2');

ga(function() {
  // Logs an array of all tracker objects.
  console.log(ga.getAll());
});

Mendapatkan data yang disimpan di pelacak

Setelah memiliki referensi ke objek pelacak, Anda dapat menggunakan metode get untuk mengakses nilai kolom yang saat ini disimpan di pelacak.

ga('create', 'UA-XXXXX-Y', 'auto');

ga(function(tracker) {
  // Logs the trackers name.
  // (Note: default trackers are given the name "t0")
  console.log(tracker.get('name'));

  // Logs the client ID for the current user.
  console.log(tracker.get('clientId'));

  // Logs the URL of the referring site (if available).
  console.log(tracker.get('referrer'));
});

Memperbarui data

Objek pelacak dapat diperbarui menggunakan metode set. Metode set pelacak dapat dipanggil di objek pelacak itu sendiri atau dengan menambahkan perintah set ke antrean perintah ga().

Karena penggunaan siap callback adalah syarat untuk mendapatkan referensi ke objek pelacak, menggunakan antrean perintah ga() adalah cara yang direkomendasikan untuk memperbarui pelacak.

Antrean perintah ga()

Perintah set dapat dipanggil dengan dua cara: dengan meneruskan dua parameter, kolom dan nilainya yang sesuai, atau dengan meneruskan objek dari pasangan kolom/nilai.

Contoh berikut menetapkan kolom page ke '/about' di pelacak default:

ga('set', 'page', '/about');

Contoh ini menetapkan kolom page dan title secara bersamaan:

ga('set', {
  page: '/about',
  title: 'About Us'
});

Menggunakan pelacak bernama

Jika menggunakan pelacak bernama, Anda dapat meneruskan namanya di string perintah, bukan pelacak default.

Panggilan berikut menetapkan kolom page pada pelacak yang bernama "myTracker":

ga('myTracker.set', 'page', '/about');

Di objek pelacak itu sendiri

Jika memiliki referensi ke objek pelacak, Anda dapat memanggil metode set pelacak secara langsung:

ga(function(tracker) {
  tracker.set('page', '/about');
});

Catatan: objek pelacak tidak diperbarui secara otomatis. Jika pengguna mengubah ukuran jendela, atau jika kode yang berjalan di halaman memperbarui URL, objek pelacak tidak secara otomatis menangkap informasi ini. Agar objek pelacak merefleksikan perubahan ini, Anda harus memperbaruinya secara manual.

Sintaksis ampersand

Kolom pelacak biasanya didapat dan ditetapkan menggunakan nama kolomnya. (Lihat referensi kolom untuk melihat daftar lengkap kolom analytics.js beserta namanya.)

Cara lain untuk mendapatkan dan menetapkan kolom adalah dengan mereferensikannya melalui nama parameter Measurement Protocol-nya yang sesuai.

Misalnya, dua ekspresi console.log berikut akan mencatat judul dokumen ke dalam konsol:

ga(function(tracker) {
  // Gets the title using the analytics.js field name.
  console.log(tracker.get('title'));

  // Gets the title using the measurement protocol
  // parameter name, prefixed with an ampersand.
  console.log(tracker.get('&dt'));
});

Secara umum, sintaksis ampersand tidak direkomendasikan dan hanya boleh digunakan saat nama kolom analytics.js untuk parameter Measurement Protocol tidak ada (ini sesekali terjadi jika fitur baru ditambahkan ke Measurement Protocol sebelum diterapkan di analytics.js).

Langkah berikutnya

Setelah Anda mengetahui cara membuat pelacak dan memperbarui data yang disimpan di dalamnya, langkah berikutnya adalah mempelajari cara mengirim data tersebut ke Google Analytics untuk diproses.