Penyiapan Adobe Flash

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.

1. Jika saat ini Anda membuka Adobe Flash CS3, keluar dari aplikasi.
2. 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
3. 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 Analytics
   • lib/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).

1. Tarik komponen ke bidang dan beri nama instance pada dialog Properties.
2. 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.
3. 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");
} 

Kembali ke Atas

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 atau AS3.
• Mode debug. Tetapkan debug ke false untuk penggunaan produksi dan ke true 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");
} 

Kembali ke Atas