Pelacakan Google Analytics untuk Adobe Flash

Pelacakan Google Analytics untuk komponen Adobe Flash memudahkan Anda menerapkan Google Analytics dalam konten yang berbasis Flash. Komponen ini, yang dikembangkan oleh Adobe Systems, Inc., berisi semua fungsi kode JavaScript Google Analytics. Komponen Pelacakan Flash adalah objek pelacakan yang dikompilasi native dari BoM 3, yang menjadikan penerapan Analytics intuitif di lingkungan pengembangan Flash dan Flex.

Mengapa Menggunakan Pelacakan Flash?

Tanpa komponen Pelacakan Google Analytics untuk Adobe Flash, pelacakan konten Adobe Flash dengan Google Analytics melibatkan sejumlah rintangan teknis. Pertama, Anda harus mengembangkan antarmuka kustom untuk ga.js sehingga aplikasi Flash Anda dapat menjalankan metode Analytics yang sesuai, seperti trackPageview() atau trackEvent(). Selain itu, Anda juga harus mengantisipasi apakah konten Flash akan memiliki akses ke Document Object Model (DOM) browser, karena pelacakan akan gagal untuk objek yang akses ke DOM-nya ditolak (biasanya bila konten Anda berada di situs pihak ketiga). Hal ini melibatkan pemahaman tentang cara menggunakan panggilan ExternalInterface di BoM 3 untuk mengakses DOM browser dan menurunkan tingkat saat akses ditolak.

Google Analytics untuk komponen Adobe Flash menyederhanakan pelacakan konten Flash dan menangani akses DOM dengan mulus. Ini berguna untuk sejumlah tujuan pelacakan umum di Flash, seperti: :

widget Flash tersemat pada laman HTML
aplikasi Flex mandiri atau situs hanya Flash yang diinangi pada laman HTML
permainan atau program Flex/Flash tersebar yang penempatan widgetnya tidak dikendalikan oleh pengembang

Perlu diketahui bahwa aplikasi pelacakan di Flash memiliki beberapa variasi struktural dari pelacakan halaman situs. Pemahaman tentang Pelacakan Analytics sangat penting untuk memahami cara kerja plugin ini. Anda juga dapat melihat Dokumentasi Desain untuk project ini untuk informasi mendetail tentang bagaimana model Pelacakan Analytics telah ditransfer untuk komponen ini.

Catatan: Saat ini, pelacakan Flash tersedia untuk setiap konten Flash yang disematkan di halaman web. Pelacakan data yang dikirim dari Adobe Air, Shockwave, atau melalui Flash IDE (mis. menggunakan Test Movie) tidak didukung untuk saat ini.

Lingkungan Pengembangan yang Didukung

Anda dapat mengembangkan Pelacakan Analytics untuk Flash di lingkungan Adobe Flash atau Adobe Flex. Setiap lingkungan memerlukan komponen berbeda, yang dapat Anda download dari http://code.google.com/p/gaforflash/. Komponen ini didasarkan pada BoM 3 dan dapat disiapkan dengan salah satu dari dua cara untuk setiap lingkungan:

Di Adobe Flash

Menambahkan dan mengonfigurasi komponen sederhana di {i>component inspector<i}, dan menariknya ke {i>stage<i}.
Impor library Pelacakan Flash langsung ke koleksi Anda dan mulai coding.

Di Adobe Flex

Sertakan komponen MXML yang Anda konfigurasi dari file am MXML.
Impor library Pelacakan Flash ke file AS3/tag skrip.

Kembali ke Atas

Bagaimana Cara Kerja Komponen?

Untuk menggunakan komponen pelacakan Flash di lingkungan Anda, gunakan alat visual di dalam Flash atau siapkan objek pelacakan langsung di kode Anda. Terlepas dari apakah Anda menyiapkan komponen secara visual atau melalui kode, Anda memberikan elemen berikut:

ID properti web—ID ini juga dikenal sebagai nomor UA kode pelacakan Anda dan terlihat seperti UA-xxxxx-yy, dengan x dan y diganti dengan angka yang sesuai dengan akun dan informasi tampilan (profil) untuk objek yang Anda lacak. Lihat Properti Web untuk informasi selengkapnya.
mode pelacakan—Pilih mode bridge atau mode AS3. Mode ini menentukan cara pelacakan berkomunikasi dengan server Analytics dan dijelaskan secara mendetail di bawah.
mode proses debug—Apa pun mode pelacakan atau lingkungan yang digunakan, Anda dapat mengaktifkan proses debug untuk memvalidasi dan menguji pelacakan.

Mode Pelacakan

Bergantung pada cara Anda menyebarkan konten Flash, komponen Analytics untuk Flash berkomunikasi ke server Analytics baik dengan menjembatani komunikasi di antara konten Flash pada penginstalan pelacakan Analytics yang ada atau dengan berkomunikasi langsung ke server Analytics. Kedua mode ini masing-masing disebut mode bridge dan mode AS3. Kedua mode tersebut menggunakan fungsi pelacakan Analytics yang sama, dan mudah untuk mengalihkan aplikasi Flash dari satu mode ke mode lainnya. Selain memilih mode komunikasi untuk pelacakan Analytics, Anda juga dapat menggunakan mode debug untuk memecahkan masalah atau memvalidasi pelacakan.

Dalam kedua mode tersebut, allowscriptaccess harus sama dengan always agar pelacakan kampanye berfungsi. Parameter ini mengaktifkan akses baca ke URL halaman dan informasi perujuk yang diperlukan oleh kode pelacakan Flash. Tanpa allowscriptaccess, kode pelacakan Analytics akan mengalami penurunan secara halus. Model atribusi ini tetap memberikan sebagian besar data aktivitas pengguna, tetapi tidak akan mengonfirmasi model atribusi kampanye Google Analytics.

Mode Jembatan

Gunakan mode ini jika Anda mengontrol halaman HTML dan konten Flash. Mode ini paling baik jika Anda telah menerapkan pelacakan Google Analytics (ga.js) di situs dan ingin menambahkan pelacakan ke konten Flash yang disematkan. Mode bridge menyederhanakan komunikasi Flash-ke-JavaScript dengan menyediakan antarmuka BoM 3 terpadu ke kode ga.js. Alat ini menyediakan koneksi dari panggilan BoM 3 ke JavaScript Analytics untuk membuat pelacakan berfungsi.

Penautan ke Kode Pelacakan Google Analytics dapat dikonfigurasi melalui parameter ID properti web dengan salah satu dari dua cara berikut:

Metode yang paling umum. Objek Kode Pelacakan Google Analytics sudah ada di halaman Anda dengan namanya sendiri, seperti pageTracker. Dalam kasus ini, Anda memberikan referensi DOM lengkap ke objek pelacakan. Misalnya, jika objek Anda dipanggil pageTracker, Anda akan mereferensikan objek tersebut dalam kode Anda sebagai window.pageTracker. Misalnya, cuplikan kode berikut mengilustrasikan cara mengonfigurasi menggunakan lingkungan Adobe Flex dengan BoM 3:
```
tracker = new GATracker( this, "window.pageTracker", "Bridge", false );
```
Metode alternatif. Jika Anda belum membuat objek pelacakan halaman pada halaman, Anda cukup meneruskan ID properti web Anda, dan objek kode pelacakan JavaScript akan dibuat untuk Anda. Dengan metode ini, referensi ke file sumber JavaScript ga.js dasar tetap diperlukan di halaman HTML Anda. Cuplikan kode berikut mengilustrasikan cara mengonfigurasinya menggunakan lingkungan Adobe Flex dengan BoM 3:
```
tracker = new GATracker( this, "UA-12345-22", "Bridge", false );
```

Agar mode bridge berfungsi dengan benar, ExternalInterface.available harus disetel ke true dalam kode BoM 3 Anda. Artinya, allowScriptAccess juga harus ditetapkan ke always di halaman HTML yang menyematkan konten Flash. Contoh berikut mengilustrasikan kode HTML yang dikonfigurasi untuk mode bridge:

<object classid="clsid:D27CDB6E-AE6D-11cf-96B8-444553540000"
     id="flex_component" width="800" height="600"
     codebase="http://fpdownload.macromedia.com/get/flashplayer/current/swflash.cab">
     <param name="movie" value="flex_component.swf" />
     <param name="quality" value="high" />
     <param name="bgcolor" value="#869ca7" />
     <param name="allowScriptAccess" value="always" />
     <embed src="flex_component.swf" quality="high" bgcolor="#869ca7"
         width="800" height="600" name="flex_component" align="middle"
         play="true"
         loop="false"
         quality="high"
         allowScriptAccess="always"
         type="application/x-shockwave-flash"
         pluginspage="http://www.adobe.com/go/getflashplayer">
      </embed>
</object>

Kembali ke Atas

Mode AS3

Gunakan mode ini jika Anda mengontrol kode Adobe FlashJavaScript 3, tetapi Anda tidak mengontrol lingkungan hosting aplikasi Adobe Flash Anda. Misalnya, jika Anda mengembangkan konten Flash untuk didistribusikan di banyak situs, Anda akan menggunakan mode AS3. Mode AS3 sepenuhnya independen dari kode pelacakan ga.js dan berisi semua fungsi pelacakan Analytics. Tidak diperlukan penginstalan pelacakan ga.js terpisah dengan mode ini. Selain itu, mode AS3 menggunakan mekanisme penyimpanan Flash untuk melacak informasi sesi bagi pengguna.

Untuk parameter DOM tertentu seperti bahasa, komponen AS3 mencoba mengambil nilai dari browser. Jika nilai tidak ada, komponen akan menggunakan nilai yang setara dengan Flash atau ditetapkan secara default ke no.

Pemecahan Masalah dan Validasi

Pelacakan Google Analytics untuk komponen Adobe Flash menyediakan mode debug untuk menyederhanakan validasi dan pemecahan masalah. Saat diaktifkan, semua data pelacakan akan disadap dan diarahkan ke layar di kotak teks, bukan ke server Analytics. Dalam mode ini, Anda dapat melihat data secara real-time yang seharusnya dikumpulkan oleh server. Fitur ini juga membantu menyimpan data pengujian di luar data produksi Anda. Anda dapat mengaktifkan fitur pemecahan masalah dengan menyetel opsi visualDebug ke true di pemeriksa komponen.

Contoh

Untuk contoh detail tentang cara menerapkan pelacakan di berbagai lingkungan pengembangan, lihat yang berikut ini:

Flash

Flex

Pembuatan versi

Anda dapat menemukan versi terbaru komponen pelacakan dalam bentuk file ZIP di http://code.google.com/p/gaforflash/downloads/list. Setiap download berisi semua komponen pelacakan beserta dokumentasi terkait. Nama file untuk file download akan menampilkan nomor versi kode yang dimilikinya.

Anda juga dapat menggunakan pernyataan berikut dalam kode untuk mencetak nomor versi komponen saat ini ke dalam konsol output.

import com.google.analytics.API;
trace(API.version);

Kembali ke Atas