การตั้งค่า Adobe Flash

เอกสารนี้ครอบคลุมทุกอย่างที่จำเป็นต้องทราบในการตั้งค่าการติดตามของ Google Analytics สำหรับ Adobe Flash สำหรับสภาพแวดล้อมในการพัฒนาซอฟต์แวร์ Adobe Flash

รับไฟล์คอมโพเนนต์

ระบบจะบีบอัดไฟล์คอมโพเนนต์การติดตาม Flash เป็นไฟล์ ZIP ไฟล์เดียว ซึ่งคุณดาวน์โหลดได้จาก http://code.google.com/p/gaforflash/downloads/list

ทำตามวิธีการในไฟล์ readme.txt เพื่อติดตั้งคอมโพเนนต์ Flash

  1. หากปัจจุบันคุณเปิด Adobe Flash CS3 อยู่ ให้ออกจากแอปพลิเคชัน
  2. สร้างไดเรกทอรี Google ในตำแหน่งใดตำแหน่งหนึ่งต่อไปนี้
    • สำหรับ Windows: C:\Program Files\Adobe\ Adobe Flash CS3\language\Configuration\Components
    • สำหรับ Mac OS X: Macintosh HD/Applications/Adobe Flash CS3/Configuration/Components
  3. ไปที่ตำแหน่งที่คุณแตกไฟล์ ZIP ของคอมโพเนนต์ แล้วคัดลอกไฟล์ต่อไปนี้ไปยังไดเรกทอรีที่สร้างไว้ในขั้นตอนก่อนหน้า
    • lib/analytics_flash.swc — คอมโพเนนต์ Analytics
    • lib/analytics.swc — คอมโพเนนต์ไลบรารี Analytics

คอมโพเนนต์ทั้งสองมีฟังก์ชันการทำงานเหมือนกัน แต่มีไว้เพื่ออำนวยความสะดวกสำหรับรูปแบบการพัฒนาที่แตกต่างกัน

คอมโพเนนต์ Analytics หากคุณพัฒนาเนื้อหา Flash แต่ไม่คุ้นเคยกับ ActionScript 3 ให้ใช้คอมโพเนนต์นี้ คอมโพเนนต์ Analytics เป็นแพ็กเกจการติดตามที่สมบูรณ์ เพียงแค่ลากและวางคอมโพเนนต์ลงในพื้นที่งานโดยตรง กำหนดค่าง่ายๆ เพียงไม่กี่ขั้นตอนในเครื่องมือตรวจสอบคอมโพเนนต์ คุณก็พร้อมที่จะติดแท็กการควบคุมด้วยการติดตาม Analytics แล้ว

คอมโพเนนต์ไลบรารี Analytics หากคุณคุ้นเคยกับ ActionScript 3 คุณสามารถใช้คอมโพเนนต์ AnalyticLibrary ได้ ลากคอมโพเนนต์ไปยังไลบรารี Flash และนำเข้าคลาสการติดตามลงในโค้ด ActionScript โดยตรง

การใช้คอมโพเนนต์ Analytics

ใช้ analytics_flash.swc เพื่อใช้งานการติดตามผ่านคอมโพเนนต์ Analytics วางคอมโพเนนต์ในไดเรกทอรีคอมโพเนนต์ที่ถูกต้อง และคอมโพเนนต์จะปรากฏในแผงคอมโพเนนต์ (หน้าต่าง - คอมโพเนนต์)

  1. ลากคอมโพเนนต์ไปยังพื้นที่งานและตั้งชื่ออินสแตนซ์ในกล่องโต้ตอบคุณสมบัติ
  2. กำหนดค่าคอมโพเนนต์ในแผงเครื่องมือตรวจสอบคอมโพเนนต์ (Windows - เครื่องมือตรวจสอบคอมโพเนนต์) ดังนี้
    • เพิ่มรหัสเว็บพร็อพเพอร์ตี้ Analytics
    • เลือกโหมด Bridge หรือโหมด AS3
    • ระบุว่าการแก้ไขข้อบกพร่องแบบภาพเปิดหรือปิดอยู่
  3. ในโค้ด ActionScript ให้เพิ่มการเรียกใช้การติดตาม GA มาตรฐานลงในอินสแตนซ์ของคอมโพเนนต์ที่คุณเพิ่งสร้างขึ้น

เนื่องจากวิธีที่ Flash ทำงานร่วมกับองค์ประกอบภาพ โดยปกติแล้ววิธีที่ดีที่สุดคือเริ่มติดตามในเฟรมที่ 2 ของแอปพลิเคชัน Flash ถ้าคุณจำเป็นต้องเริ่มต้นการติดตามในเฟรมแรก ให้วางการเรียกใช้การติดตามภายในเครื่องจัดการเหตุการณ์เพื่อให้แน่ใจว่าคอมโพเนนต์เริ่มต้นโดยสมบูรณ์ภายในเนื้อหา Flash

ตัวอย่างคอมโพเนนต์ Flash ของ Analytics อย่างง่าย

ข้อมูลโค้ดต่อไปนี้แสดงวิธีติดตามปุ่มใน Flash เมื่อมีคนคลิกปุ่มนั้น ในตัวอย่างนี้ อินสแตนซ์ของปุ่มมีชื่อว่า playGame ใน Screencast ของคุณ เมื่อมีการคลิกปุ่ม ระบบจะเรียกใช้เมธอด onButtonClick ซึ่งจะส่งผลให้เรียกใช้เมธอด trackPageview() ซึ่งจะเพิ่มจำนวนการดูหน้าเว็บสำหรับหน้าเสมือน /myGame1

playGame.addEventListener( MouseEvent.CLICK, onButtonClick );
function onButtonClick( event:Event ):void
{
  tracker.trackPageview( "/myGame1");
}

การใช้คอมโพเนนต์ AnalyticsLibrary

ใช้ไฟล์ analytics.swc เพื่อใช้งานการติดตามผ่านคอมโพเนนต์ AnalyticsLibrary คอมโพเนนต์นี้ช่วยให้คุณสร้างอินสแตนซ์การติดตามได้ในโค้ด AS3 โดยตรง เมื่อคอมโพเนนต์ AnalyticsLibrary อยู่ในตำแหน่งที่เหมาะสมแล้ว คอมโพเนนต์จะปรากฏในแผงคอมโพเนนต์ จากนั้นคุณสามารถลากคอมโพเนนต์จากแผงคอมโพเนนต์ไปยังไลบรารีของคุณ และนำเข้าไลบรารีจากที่นั่นไปยังโค้ด ActionScript

เริ่มต้นออบเจ็กต์ติดตาม

เริ่มต้นออบเจ็กต์การติดตามด้วยพารามิเตอร์ต่อไปนี้โดยใช้สภาพแวดล้อม Adobe Flash

  • อ้างอิงออบเจ็กต์การแสดงผลปัจจุบัน ในตัวอย่างด้านล่าง this จะอ้างอิงออบเจ็กต์การแสดงผล
  • รหัสเว็บพร็อพเพอร์ตี้ รหัสเว็บพร็อพเพอร์ตี้คือสตริงที่ไม่ซ้ำกันที่ใช้ในการติดตามกิจกรรมในเนื้อหา Flash ของคุณ และส่งไปยังข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์) ที่ถูกต้องในบัญชี Analytics ของคุณ
  • โหมดการติดตาม พารามิเตอร์ที่ถูกต้องคือ Bridge หรือ AS3
  • โหมดแก้ไขข้อบกพร่อง ตั้งค่า debug เป็น false สำหรับการใช้งานจริงและ true สำหรับการตรวจสอบความถูกต้องและการแก้ปัญหา

ตัวอย่างไลบรารี Analytics อย่างง่าย

ในตัวอย่างต่อไปนี้ มีคลิปภาพยนตร์ที่ชื่อว่า playGame อยู่บนพื้นที่งาน ระบบจะสร้างออบเจ็กต์การติดตามใหม่ที่ชื่อ tracker พร้อมกับเครื่องจัดการเหตุการณ์ที่รับข้อมูลการคลิกเมาส์ เมื่อมีการคลิกปุ่ม ระบบจะเรียกใช้ฟังก์ชัน onButtonClick สำหรับแต่ละคลิก เมธอด trackPageview() จะเพิ่มจำนวนการดูหน้าเว็บสำหรับหน้าเสมือน /myGame1

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");
}