Menggunakan Plugin

Plugin adalah skrip yang meningkatkan fungsi analytics.js untuk membantu mengukur interaksi pengguna. Plugin biasanya hanya mencakup serangkaian fitur yang mungkin tidak diperlukan oleh semua pengguna Google Analytics, seperti e-commerce atau pengukuran lintas-domain, sehingga tidak disertakan dalam analisis.js secara default.

Panduan ini menjelaskan cara mewajibkan dan menggunakan plugin analytics.js.

Mewajibkan plugin

Perintah require menggunakan nama plugin dan mendaftarkannya untuk digunakan dengan antrean perintah ga(). Jika plugin menerima opsi konfigurasi, opsi tersebut dapat diteruskan sebagai argumen terakhir ke perintah require.

Berikut adalah signature perintah require yang lengkap:

ga('[trackerName.]require', pluginName, [pluginOptions]);

Misalnya, berikut adalah cara mewajibkan plugin Enhanced E-commerce untuk digunakan bersama pelacak default:

ga('require', 'ec');

Dan berikut adalah cara mewajibkan plugin Fitur Iklan untuk pelacak yang bernama "myTracker" dan meneruskan opsi konfigurasi yang mengganti nilai nama cookie default:

ga('myTracker.require', 'displayfeatures', {
  cookieName: 'display_features_cookie'
});

Memuat kode plugin

Perintah require menginisialisasi metode plugin untuk digunakan bersama antrean perintah ga(), tetapi tidak memuat skrip plugin itu sendiri. Jika Anda menggunakan plugin pihak ketiga, atau menulis plugin sendiri, Anda harus menambahkan kode plugin ke halaman secara manual.

Metode yang direkomendasikan untuk menambahkan kode plugin ke halaman adalah melalui tag <script> dengan penetapan atribut async untuk memastikannya tidak memblokir pemuatan fitur lainnya di situs Anda.

Kode berikut mewajibkan dan memuat plugin pelacakan link hipotetis:

<script>
ga('create', 'UA-XXXXX-Y', 'auto');
ga('require', 'linkTracker');
ga('send', 'pageview');
</script>

<!--Note: plugin scripts must be included after the tracking snippet. -->
<script async src="/path/to/link-tracker-plugin.js"></script>

Catatan: Plugin Google Analytics resmi untuk analytics.js dimuat secara otomatis saat diwajibkan; Anda tidak perlu menambahkan tag skrip untuk plugin tersebut. Daftar lengkap plugin analytics.js resmi dapat dilihat di bagian Plugin resmi di navigasi sebelah kiri.

Menunggu plugin dimuat

Karena library analytics.js dan plugin analytics.js dimuat secara asinkron, mengetahui kapan plugin dimuat sepenuhnya dan siap digunakan bukanlah hal mudah.

Library analytics.js mengatasi masalah ini dengan menghentikan eksekusi antrean perintah saat menemukan perintah require untuk plugin yang belum dimuat. Setelah plugin dimuat, eksekusi antrean akan dilanjutkan seperti biasa.

Oleh karenanya, penting sekali Anda menguji plugin yang digunakan untuk memastikan plugin dimuat dan berjalan dengan benar. Jika plugin gagal dimuat atau mengalami error, semua perintah analytics.js berikutnya tidak akan berjalan.

Memanggil metode plugin

Setelah mewajibkan plugin, metode plugin akan tersedia untuk digunakan dengan antrean perintah ga(). Berikut adalah signature perintah untuk memanggil metode plugin:

ga('[trackerName.][pluginName:]methodName', ...args);

Misalnya, metode addProduct plugin Enhanced E-commerce dapat dipanggil seperti ini:

ga('ec:addProduct', {
  'id': 'P12345',
  'quantity': 1
});

Atau di suatu pelacak bernama dengan menambahkan nama pelacak ke string perintah:

ga('myTracker.ec:addProduct', {
  'id': 'P12345',
  'quantity': 1
});

Langkah berikutnya

Jika Anda telah membaca semua panduan di bagian ini, Anda seharusnya sudah memahami sebagian besar fitur analytics.js. Panduan berikutnya menjelaskan cara men-debug penerapan analytics.js untuk mendeteksi error dengan lebih mudah dan melihat secara persis cara kerja kode Anda