Dokumen ini mencakup semua hal yang perlu Anda ketahui untuk menyiapkan Pelacakan Google Analytics untuk Adobe Flash untuk lingkungan pengembangan Adobe Flash.
Mendapatkan File Komponen
File komponen pelacakan Flash dikompresi menjadi satu file ZIP yang dapat Anda download dari http://code.google.com/p/gaforflash/downloads/list.
Ikuti petunjuk dalam file readme.txt
untuk menginstal komponen Flash.
- Jika saat ini Anda membuka Adobe Flash CS3, keluar dari aplikasi.
- Buat direktori
Google
di salah satu lokasi berikut:- Untuk Windows:
C:\Program Files\Adobe\ Adobe Flash CS3\language\Configuration\Components
- Untuk Mac OS X:
Macintosh HD/Applications/Adobe Flash CS3/Configuration/Components
- Untuk Windows:
- Buka lokasi tempat Anda mengekstrak file ZIP komponen dan salin file berikut ke direktori yang Anda buat di langkah sebelumnya:
lib/analytics_flash.swc
— Komponen Analyticslib/analytics.swc
— Komponen Library Analytics
Kedua komponen memiliki fungsionalitas yang sama, tetapi disediakan untuk memudahkan gaya pengembangan yang berbeda.
Komponen Analytics. Jika Anda mengembangkan konten Flash, tetapi belum terbiasa dengan BoM 3, gunakan komponen ini. Komponen Analytics adalah paket pelacakan lengkap. Cukup tarik lalu lepas komponen langsung ke tahapan, buat beberapa konfigurasi sederhana di pemeriksa komponen, dan Anda siap memberi tag pada kontrol dengan pelacakan Analytics.
Komponen AnalyticsLibrary. Jika Anda sudah terbiasa dengan BoM 3, Anda dapat menggunakan komponen AnalyticLibrary. Seret komponen ke Pustaka Flash Anda dan impor kelas pelacakan langsung ke kode BoM Anda.
Menggunakan Komponen Analytics
Gunakan analytics_flash.swc
untuk menerapkan pelacakan melalui komponen Analytics. Tempatkan komponen di direktori Komponen yang benar, dan komponen tersebut akan muncul di panel Komponen (Window - Components).
- Tarik komponen ke bidang dan beri nama instance pada dialog Properties.
- Konfigurasikan komponen di panel Component Inspector (Windows - Component Inspector):
- Tambahkan ID properti web Analytics Anda.
- Pilih mode Bridge atau mode AS3.
- Tunjukkan apakah debug visual diaktifkan atau dinonaktifkan.
- Di kode BoM Anda, tambahkan panggilan pelacakan GA standar ke instance komponen yang baru saja Anda buat.
Karena cara kerja Flash dengan komponen visual, sebaiknya mulai pelacakan pada bingkai kedua aplikasi Flash Anda. Jika Anda perlu melakukan inisialisasi pelacakan pada frame pertama, tempatkan panggilan pelacakan di dalam pengendali peristiwa untuk memastikan komponen diinisialisasi sepenuhnya dalam konten Flash.
Contoh Komponen Flash Analytics Sederhana
Cuplikan kode berikut menunjukkan cara tombol di Flash dapat dilacak saat seseorang mengkliknya. Dalam contoh ini, instance tombol diberi nama playGame
di BoM Anda. Saat tombol diklik, metode onButtonClick
akan dipanggil, yang kemudian akan memanggil metode trackPageview()
. Tindakan ini akan meningkatkan jumlah tayangan halaman untuk halaman virtual /myGame1
.
playGame.addEventListener( MouseEvent.CLICK, onButtonClick ); function onButtonClick( event:Event ):void { tracker.trackPageview( "/myGame1"); }
Menggunakan Komponen AnalyticsLibrary
Gunakan file analytics.swc
untuk menerapkan pelacakan melalui komponen AnalyticsLibrary. Komponen ini memungkinkan Anda membuat instance objek pelacakan langsung di kode AS3. Setelah komponen AnalyticsLibrary berada di lokasi yang tepat, komponen tersebut akan muncul di panel {i>Components<i}. Kemudian Anda dapat menyeret komponen dari panel Komponen ke pustaka, dan dari sana mengimpor pustaka ke dalam kode Bagian Anda.
Melakukan inisialisasi Objek Pelacakan
Dengan menggunakan lingkungan Adobe Flash, inisialisasi objek pelacakan dengan parameter berikut:
- Referensikan objek tampilan saat ini. Dalam contoh di bawah,
this
mereferensikan objek tampilan. - ID properti web. ID properti web adalah string unik yang digunakan untuk melacak aktivitas di konten Flash dan mengirimkannya ke tampilan (profil) yang benar di akun Analytics Anda.
- Mode pelacakan. Parameter yang valid adalah
Bridge
atauAS3
. - Mode debug. Tetapkan
debug
kefalse
untuk penggunaan produksi dan ketrue
untuk validasi dan pemecahan masalah.
Contoh AnalyticsLibrary Sederhana
Pada contoh berikut, klip film bernama playGame ada di atas panggung. Objek pelacakan baru yang disebut tracker
dibuat bersama dengan pengendali peristiwa yang memproses klik mouse. Saat tombol diklik, fungsi onButtonClick
dipanggil. Untuk setiap klik, metode trackPageview()
akan menambah jumlah tayangan halaman untuk /myGame1
halaman virtual.
import com.google.analytics.AnalyticsTracker; import com.google.analytics.GATracker; var tracker:AnalyticsTracker = new GATracker( this, "UA-111-222", "AS3", true ); playGame.addEventListener( MouseEvent.CLICK, onButtonClick ); function onButtonClick ( event:Event ):void { tracker.trackPageview("/myGame1"); }