Pelacakan Gadget

Dokumen ini menjelaskan cara menggunakan API gadget baru untuk pelacakan gadget Analytics. API ini menawarkan model data dan pelacakan kinerja yang ditingkatkan untuk mengumpulkan statistik laporan Analytics untuk gadget Anda.

  1. Sebelum Anda Memulai
  2. Melacak Gadget Anda
  3. Metode Pelacakan
  4. Pertimbangan Penggunaan
  5. Tips
 

Sebelum Memulai

Di Google Analytics, setiap domain situs atau subdomain yang unik yang Anda tambahkan ke akun Anda dilacak dalam tampilan (profil) terpisah dan diberi ID domain terpisah. Karena setiap gadget beroperasi pada subdomainnya sendiri di situs host gmodules.com, Anda dapat melacak setiap gadget yang Anda buat dalam tampilan (profilnya) sendiri dan dengan ID domain yang unik.

Cara paling mudah untuk melakukannya adalah dengan mengizinkan Google Analytics membuat ID unik untuk Anda.

  1. Untuk memulai, login ke Google Analytics atau daftar untuk membuat akun Google Analytics.
    • Pengguna baru akan melihat halaman Pendaftaran Akun Baru.
    • Pengguna yang ada harus membuka halaman Setelan Analytics dan mengklik Tambahkan Tampilan Situs (Profil). (Pastikan untuk memilih domain baru.)
  2. Dari salah satu halaman ini, masukkan URL situs yang valid.
    3. Karena URL situs hanyalah string yang dipasangkan oleh software Google Analytics dengan ID domain Anda, URL ini dapat berupa string URL situs yang valid, baik buatan maupun asli. Anda tidak akan menginstal kode pelacakan pada halaman web mana pun, dan tidak akan memerlukan akses ke halaman situs apa pun.
  3. Klik tombol tersebut untuk melanjutkan ke layar berikutnya.
    4. Saat cuplikan kode pelacakan muncul, salin ID domain unik ke coretan. Cuplikan kode yang dibuat secara otomatis berisi ID domain ini dalam bentuk UA-123456-1.
  4. Klik tombol Selesai.
    5. Anda akan melihat nama URL situs Anda dalam daftar tampilan (profil). Anda juga dapat mengubah nama tampilan (profil) menjadi sesuatu yang lebih bermakna dengan mengklik link Edit untuk tampilan tersebut (profil), lalu mengklik Edit lagi.
  5. Gunakan ID domain yang dihasilkan di kode pelacakan gadget Anda.
    6. ID domain Analytics berupa:
    UA-123456-1
 

Melacak Gadget Anda

Proses pelacakan gadget mencakup tiga penambahan pada kode gadget Anda:

  1. Mengaktifkan fitur.
  2. Membuat objek pelacak.
  3. Melacak gadget Anda menggunakan salah satu dari dua metode berikut.

Contoh kode gadget berikut menunjukkan setiap penambahan kode tersebut, yang akan dijelaskan di bawah. Anda dapat menggunakan file contoh ini untuk mulai membuat gadget sendiri.

<?xml version="1.0" encoding="UTF-8" ?>
<Module>
  <ModulePrefs title="Analytics Test">
     <!-- Sets the feature -->
     <Require feature="com.google.gadgets.analytics" /> 
     <Require feature="setprefs" /> 
  </ModulePrefs>
  <UserPref 
      name="counter"
      datatype="hidden"
      default_value="0" />
  <Content type="html"> 
  <![CDATA[ 
      <script>
      // Track this gadget using Google Analytics.

      // Creates a tracking object and uses reportPageview method to call gadget view
      var ga = new _IG_GA("UA-00000-1");
      ga.reportPageview('/view/counterGadget');

      // Suppose, for example, you have a gadget with two counter buttons.
      // You can track interactions with those counters via Analytics.

      // Increment value of "counter" user preference
      function incrementCounter() {
         var count = prefs.getInt("counter");

         prefs.set("counter", count + 1);

         // Tracks button click as an event
         ga.reportEvent("Counter Gadget", "Increment", "Button", 0);
      }

      // Reset value of "counter" userpref to 0
      function resetCounter(){
         prefs.set("counter", 0);

         // Tracks button click as an event
         ga.reportEvent("Counter Gadget", "Reset", "Button", 0);
      }
      </script>
      <form name="counter">
      <input type=button value="Reset" name="reset" onClick="resetCounter()">
      <input type=button value="Count" name="count" onClick="incrementCounter()">
      </form>
  ]]>
  </Content>
</Module>

1. Mengaktifkan fitur

Pertama, aktifkan fitur dengan mengimpor library Analytics menggunakan namespace fitur:

 <Require feature="com.google.gadgets.analytics" />

2. Membuat Objek Pelacak

Analytics tracking API mematuhi model kode pelacakan ga.js berorientasi objek yang sama. Jadi, sebelum melacak gadget Anda, buat instance objek pelacak:

var ga = new _IG_GA("UA-123456-1");

Di sinilah Anda akan memasukkan ID domain yang dibuat dengan mengikuti langkah-langkah di atas.

Anda harus menggunakan ID domain lengkap dengan angka tunggal di akhir; jika tidak, panggilan objek pelacakan akan gagal.

3. Melacak Gadget Anda

API gadget menyediakan dua metode yang dapat Anda gunakan untuk melacak interaksi pada gadget:

  • Metode URL virtual
    • ga.reportPageview(path);

    Metode ini melacak statistik gadget sebagai tampilan halaman khusus, dan merupakan metode yang sama yang digunakan di API gadget Analytics versi sebelumnya. Dengan metode ini, Anda dapat memperbarui kode pelacakan gadget yang ada tanpa mempengaruhi tata letak laporan Analytics yang ada. Anda melihat data pelaporan di gadget Anda sama seperti Anda melihat data pelaporan untuk halaman web.

    Bila Anda menggunakan metode URL virtual untuk melacak interaksi gadget, setiap panggilan dicatat sebagai permintaan halaman untuk string yang Anda berikan sebagai parameter ke metode tersebut. Anda dapat memanfaatkan perilaku ini untuk meneruskan jalur URL buatan sehingga Anda dapat melihat laporan untuk gadget di antarmuka Google Analytics seperti yang dilakukan pada laporan halaman situs. Misalnya, Anda dapat menggunakan jalur terpisah untuk melacak tampilan gadget dan interaksi gadget: 

    ga.reportPageview('/view/counterGadget');
ga.reportPageview('/click/increment');
ga.reportPageview('/click/reset');

  • Metode pelacakan peristiwa
    • ga.reportEvent(name, action, [[]label], [[]value]);

    Metode ini hanya tersedia di API gadget Analytics yang baru. Dengan metode ini, Anda dapat melacak tampilan halaman (mis. rendering gadget) secara terpisah dari interaksi pengguna di gadget Anda.

    Catatan: Saat ini, Pelacakan Peristiwa masih dalam rilis beta tertutup. Gunakan metode URL virtual jika Anda tidak memiliki akses ke Pelacakan Peristiwa.

    Metode peristiwa menyediakan model lain untuk Anda gunakan dengan pelacakan gadget. Pertama, panggilan peristiwa dihitung secara terpisah dari panggilan tampilan halaman, dan data yang dihasilkan ditampilkan di bagian terpisah dalam laporan Konten Google Analytics. Dengan demikian, Anda dapat melacak tampilan gadget hanya dari interaksi pengguna pada gadget, tanpa harus ada interaksi pengguna yang meningkatkan jumlah keseluruhan tampilan gadget. Kedua, metode ini menggunakan model pelacakan peristiwa, yang strukturnya dirancang khusus untuk menganalisis interaksi pengguna pada gadget. Pada model ini, label dan nilai merupakan parameter opsional.

    Dengan menggunakan contoh penghitung, kita dapat menggunakan metode peristiwa untuk melacak fungsi gadget mana yang dipicu, dan kita dapat meneruskan jenis kontrol, yang merupakan sebuah tombol dalam kedua kasus tersebut. 

    ga.reportEvent("Counter Gadget", "Increment", "Button");
ga.reportEvent("Counter Gadget", "Reset", "Button");

    Ini adalah contoh yang sangat sederhana, tetapi model pelacakan peristiwa adalah struktur yang sangat fleksibel yang dapat Anda sempurnakan untuk memanfaatkan persyaratan pelacakan gadget Anda yang unik. Untuk informasi selengkapnya, lihat dokumentasi Peristiwa Pelacakan.

 

Metode Pelacakan

Saat ini, fitur Analytics menawarkan metode berikut. Penggunaannya dibahas di atas.

  • reportPageview()
    • Memerlukan string untuk mengisi laporan konten dengan benar. Biasanya string ini berbentuk jalur yang Anda tetapkan untuk tujuan pelaporan. Nilai yang diteruskan ke metode ini dikirim dalam permintaan GIF melalui variabel utmp. Gunakan metode ini untuk melacak pemuatan gadget dan interaksi gadget. 
    ga.reportPageview("/view/gadgetName");
    parameter
    String  path Jalur untuk menyediakan URL virtual elemen ini.

  • reportEvent()
    • Memerlukan nama gadget dan parameter tindakan agar dapat menyisipkan data yang dilacak ke laporan Pelacakan Peristiwa dengan benar. Parameter lainnya bersifat opsional. Nilai yang diteruskan melalui metode ini dikirim dalam tampilan permintaan GIF untuk variabelU utme.

    parameter
    String  name  Wajib.String yang digunakan di tingkat teratas laporan Pelacakan Peristiwa. Misalnya, jika Anda melacak interaksi pada sejumlah elemen gadget, Anda mungkin akan menggunakan nama gadget itu sendiri untuk parameter ini, sehingga semua pelacakan interaksi untuk gadget tersebut akan digabungkan di bagian yang sama dalam laporan Google Analytics.

    String  action  Wajib. String untuk mengelompokkan interaksi gadget lebih lanjut dalam laporan Pelacakan Peristiwa. Untuk informasi selengkapnya, lihat dokumentasi Peristiwa Pelacakan.

    String  label  Opsional. String yang dapat digunakan sebagai segmen sekunder untuk gadget Anda.

    Int  value  Opsional. Angka yang dapat Anda berikan sebagai nilai untuk interaksi gadget. Jumlah ini diagregasi setiap kali metode dipanggil.

 

Pertimbangan Penggunaan

API gadget Google Analytics memiliki sejumlah pertimbangan penggunaan:

  • Penampung yang Didukung
    • Banyak jenis penampung yang didukung dengan Google Analytics gadget API, termasuk, tetapi tidak terbatas pada:
    • iGoogle
    • Sindikasi Terbuka
    • Buka Sosial
    • Gadget
  • Jenis Gadget yang Tidak Didukung
    • Google Analytics gadget API tidak mendukung jenis gadget berikut:
    • Gadget sebaris (type=html-inline)
    • Mapplet
    • Gadget jenis URL (type-url)
    • Iklan Gadget di Google AdSense
  • Pertimbangan domain
    • Jika Anda memerlukan fitur Analytics untuk gadget, gadget akan dialihkan ke <subdomain>.gmodules.com, dengan <subdomain> adalah subdomain acak yang unik. Karenanya, semua konten di gadget ditampilkan pada subdomain tersebut. Contoh: 3nvma227-a.gmodules.com. Selain itu, semua cookie pelacakan Google Analytics ditetapkan ke subdomain unik ini. Karena alasan ini, mapplet tidak didukung oleh fitur pelacakan Analytics, dan Anda harus mengizinkan secara khusus konten Flash akses khusus ke fitur pelacakan (lihat di bawah).
  • Gadget yang menggunakan konten Flash
    • Pengiklan yang menggunakan konten Flash harus secara khusus mengaktifkan komunikasi antara URL Flash dan URL gadget dengan menyetel parameter allowScriptAccess ke selalu. 
    _IG_EmbedFlash("example.swf", "wrapper", {allowScriptAccess: "always"});
 

Tips

Cara Terbaik Menggunakan Metode URL Virtual

Jika Anda tidak memiliki akses ke metode pelacakan peristiwa untuk gadget Anda, ikuti saran berikut untuk melacak gadget Anda dengan metode URL virtual:

  • Segmentasikan beban gadget Anda dengan jelas.
    • Anda dapat memanggil ga.reportPageview() pada pemuatan gadget yang menyediakan jalur yang mengelompokkan statistik pemuatan/tampilan gadget secara terpisah dari metrik interaksi gadget. Ini akan menyimpan data pelaporan konten untuk gadget di "direktori" yang terpisah dari interaksi pada gadget, sehingga Anda dapat melihat keseluruhan tampilan secara terpisah dari jumlah interaksi pada gadget itu sendiri. Misalnya, cuplikan kode berikut dapat digunakan di gadget Anda untuk menampilkan semua statistik pemuatan gadget Anda: 
      ga.reportPageview('/view/gadgetName');
  • Segmentasikan jenis interaksi yang berbeda satu sama lain.
    • Panggil ga.reportPageview() dengan jalur yang menyegmentasikan interaksi pengguna yang berbeda. Dengan cara ini, Anda bisa mendapatkan pelaporan konten terpisah untuk link gadget, tombol gadget, atau widget lain yang mungkin ingin dilacak untuk data interaksi. Contoh:
    • ga.reportPageview('/link/click');
    • ga.reportPageview('/link/submit');

Menggunakan Metode Pelacakan Peristiwa

Jika memiliki akses ke fitur Pelacakan Peristiwa dalam laporan Google Analytics, Anda dapat memanfaatkan model data yang sangat fleksibel untuk mendapatkan hasil maksimal dari pelacakan objek. Berikut ini beberapa tips:

  • Lacak tampilan gadget atau tayangan menggunakan ga.reportPageview(), dan lacak interaksi gadget menggunakan ga.reportEvent().
    • Tampilan gadget akan ditampilkan di bagian Konten untuk data halaman, dan interaksi gadget akan ditampilkan di bagian Peristiwa dalam laporan Konten.
  • Gunakan document.referrer sebagai parameter untuk mengetahui di mana gadget Anda diletakkan.
    • Dalam gadget, document.referrer biasanya berupa URL halaman penampung, sehingga Anda dapat meneruskannya sebagai parameter label dalam metode ga.reportEvent():
    var containerPage = document.referrer;
ga.reportEvent("Counter Gadget", "Increment", containerPage, 0);

Pemecahan masalah

Anda dapat menggunakan alat pihak ketiga untuk menganalisis string permintaan GIF untuk gadget guna memastikan bahwa data akan dikirim ke laporan Google Analytics sesuai harapan. Setelah gadget dihosting dan berfungsi dengan baik pada halaman pengujian, analisis string permintaan GIF sebagai berikut:

  • Metode tayangan halaman
    • Cari variabel utmp di parameter permintaan GIF. Informasi yang terkait dengan variabel tersebut akan dikirim ke laporan Google Analytics sebagai "jalur" untuk gadget.
  • Metode Pelacakan Peristiwa
    • Cari variabel utme di parameter permintaan GIF. Informasi ini harus dalam bentuk 5(object*action*label)(value).

Untuk informasi lebih lanjut tentang pemecahan masalah kode pelacakan, lihat Panduan Pemecahan Masalah GATC.