การติดตามของ Google Analytics สำหรับ Adobe Flash

คอมโพเนนต์การติดตาม Adobe Flash ของ Google Analytics ช่วยให้คุณติดตั้งใช้งาน Google Analytics ในเนื้อหา Flash ได้อย่างง่ายดาย คอมโพเนนต์นี้พัฒนาโดย Adobe Systems, Inc. มีฟังก์ชันการทำงานทั้งหมดของโค้ด JavaScript ของ Google Analytics คอมโพเนนต์การติดตาม Flash คือออบเจ็กต์ติดตามที่คอมไพล์สร้างขึ้นซึ่งมีอยู่แล้วใน Crashlytics 3 ซึ่งทำให้การติดตั้งใช้งาน Analytics นั้นใช้งานง่ายในสภาพแวดล้อมการพัฒนาซอฟต์แวร์แบบ Flash และ Flex

เหตุใดจึงควรใช้การติดตาม Flash

หากไม่มีคอมโพเนนต์การติดตาม Adobe Flash ของ Google Analytics การติดตามเนื้อหา Adobe Flash ด้วย Google Analytics อาจต้องใช้อุปสรรคทางเทคนิคหลายประการ ขั้นแรก คุณต้องพัฒนาอินเทอร์เฟซที่กำหนดเองสำหรับ ga.js เพื่อให้แอปพลิเคชัน Flash ของคุณสามารถเรียกใช้เมธอด Analytics ที่เหมาะสม เช่น trackPageview() หรือ trackEvent() ได้ นอกจากนี้ คุณต้องคาดการณ์ด้วยว่าเนื้อหา Flash ของคุณจะมีสิทธิ์เข้าถึง Document Object Model (DOM) ของเบราว์เซอร์หรือไม่ เนื่องจากการติดตามไม่สำเร็จสำหรับออบเจ็กต์เหล่านั้นที่การเข้าถึง DOM ถูกปฏิเสธ (โดยปกติเมื่อเนื้อหาของคุณอยู่บนไซต์ของบุคคลที่สาม) ขั้นตอนนี้เกี่ยวข้องกับการทำความเข้าใจวิธีใช้การเรียก ExternalInterface ใน ActionScript 3 เพื่อเข้าถึง DOM ของเบราว์เซอร์และลดระดับเมื่อถูกปฏิเสธการเข้าถึง

ส่วนประกอบ Google Analytics for Adobe Flash จะช่วยลดความยุ่งยากในการติดตามเนื้อหา Flash และจัดการการเข้าถึง DOM ได้อย่างน่าพอใจ ซึ่งมีประโยชน์ในการติดตามทั่วไปจำนวนมากใน Flash เช่น

  • Flash Widget ที่ฝังอยู่ในหน้า HTML
  • แอปพลิเคชัน Flex แบบสแตนด์อโลน หรือไซต์ที่ใช้ Flash อย่างเดียวในหน้า HTML
  • เกมหรือโปรแกรม Flex/Flash ที่แจกจ่ายซึ่งผู้พัฒนาไม่สามารถควบคุมว่าจะวาง Widget ไว้ที่ใด

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

หมายเหตุ: ปัจจุบันการติดตาม Flash ใช้ได้กับเนื้อหา Flash ใดๆ ที่ฝังอยู่ในหน้าเว็บ ปัจจุบันยังไม่รองรับการติดตามข้อมูลที่ส่งจาก Adobe Air, ShockWave หรือผ่าน Flash IDE (เช่น การใช้ Test Movie)

สภาพแวดล้อมในการพัฒนาซอฟต์แวร์ที่รองรับ

คุณสามารถพัฒนาการติดตาม Analytics สำหรับ Flash ในสภาพแวดล้อมแบบ Adobe Flash หรือ Adobe Flex ได้ สภาพแวดล้อมแต่ละแบบต้องการคอมโพเนนต์ที่แตกต่างกัน ซึ่งคุณสามารถดาวน์โหลดได้จาก http://code.google.com/p/gaforflash/ องค์ประกอบเหล่านี้ทำงานตาม ActionScript 3 และสามารถตั้งค่าด้วยวิธีใดวิธีหนึ่งจาก 2 วิธีสำหรับแต่ละสภาพแวดล้อม:

ใน Adobe Flash

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

ใน Adobe Flex

  • รวมคอมโพเนนต์ MXML ที่คุณกำหนดค่าจากไฟล์ MXML
  • นำเข้าไลบรารีการติดตาม Flash ลงในแท็กสคริปต์/ไฟล์ AS3 ของคุณ

ส่วนประกอบนี้ทำงานอย่างไร

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

  • รหัสเว็บพร็อพเพอร์ตี้ ซึ่งเรียกว่าหมายเลข UA ของโค้ดติดตาม และมีลักษณะดังนี้ UA-xxxxx-yy โดย x และ y จะถูกแทนที่ด้วยหมายเลขที่สอดคล้องกับบัญชีและข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์) ของออบเจ็กต์ที่คุณกำลังติดตาม ดูผลิตภัณฑ์และบริการบนอินเทอร์เน็ตสำหรับข้อมูลเพิ่มเติม
  • โหมดติดตาม - เลือกโหมดบริดจ์หรือโหมด AS3 โหมดนี้จะกำหนดวิธีที่การติดตามของคุณสื่อสารกับเซิร์ฟเวอร์ Analytics และมีคำอธิบายโดยละเอียดด้านล่าง
  • โหมดการแก้ไขข้อบกพร่อง - ไม่ว่าจะใช้สภาพแวดล้อมหรือโหมดการติดตามใด คุณจะเปิดการแก้ไขข้อบกพร่องเพื่อตรวจสอบและทดสอบการติดตามได้

โหมดการติดตาม

คอมโพเนนต์ Analytics สำหรับ Flash จะสื่อสารกับเซิร์ฟเวอร์ Analytics ด้วยการเชื่อมการสื่อสารระหว่างเนื้อหา Flash ในการติดตั้งการติดตาม Analytics ที่มีอยู่ หรือด้วยการสื่อสารโดยตรงกับเซิร์ฟเวอร์ Analytics ทั้งนี้ขึ้นอยู่กับวิธีที่คุณเผยแพร่เนื้อหา Flash โหมด 2 นี้เรียกว่า Bridge Mode และ โหมด AS3 ตามลำดับ ทั้งสองโหมดใช้ฟังก์ชันการติดตามของ Analytics เดียวกัน และคุณสลับแอปพลิเคชัน Flash จากโหมดหนึ่งไปเป็นอีกโหมดหนึ่งได้อย่างง่ายดาย นอกจากการเลือกโหมดการสื่อสารสําหรับการติดตาม Analytics แล้ว คุณยังใช้โหมดแก้ไขข้อบกพร่องเพื่อแก้ปัญหาหรือตรวจสอบการติดตามได้ด้วย

ทั้งสองโหมด allowscriptaccess ต้องเท่ากับ always เพื่อให้การติดตามแคมเปญทำงานได้ พารามิเตอร์นี้จะเปิดสิทธิ์การอ่าน URL ของหน้าเว็บและข้อมูลผู้อ้างอิงที่โค้ดติดตาม Flash กำหนด หากไม่ใช้ allowscriptaccess โค้ดติดตาม Analytics จะมีประสิทธิภาพลดลงอย่างค่อยเป็นค่อยไป โดยยังคงให้ข้อมูลกิจกรรมของผู้ใช้ส่วนใหญ่ แต่จะไม่ยืนยันรูปแบบการระบุแหล่งที่มาของแคมเปญ Google Analytics

โหมดบริดจ์

ใช้โหมดนี้หากคุณควบคุมทั้งหน้า HTML และเนื้อหา Flash โหมดนี้เหมาะสมที่สุดหากคุณใช้การติดตามของ Google Analytics (ga.js) ในเว็บไซต์อยู่แล้ว และต้องการเพิ่มการติดตามให้กับเนื้อหา Flash ที่ฝัง โหมดบริดจ์ช่วยให้การสื่อสาร Flash ไปยัง JavaScript ง่ายขึ้นโดยจัดเตรียมอินเทอร์เฟซ ActionScript 3 แบบรวมให้กับโค้ด ga.js โดยให้การเชื่อมต่อจากการเรียก Crashlytics 3 ไปยัง JavaScript ของ Analytics เพื่อให้การติดตามทำงานได้

คุณสามารถกำหนดค่าการเชื่อมต่อกับโค้ดติดตาม Google Analytics ผ่านพารามิเตอร์รหัสเว็บพร็อพเพอร์ตี้ได้ด้วยวิธีใดวิธีหนึ่งจาก 2 วิธีดังนี้

  • วิธีที่ใช้กันมากที่สุด มีออบเจ็กต์โค้ดติดตาม Google Analytics อยู่แล้วในหน้าเว็บโดยใช้ชื่อเอง เช่น pageTracker ในกรณีนี้ คุณจะต้องระบุการอ้างอิง DOM ที่สมบูรณ์ไปยังออบเจ็กต์การติดตาม เช่น หากออบเจ็กต์มีชื่อว่า pageTracker คุณจะอ้างอิงออบเจ็กต์นั้นในโค้ดเป็น window.pageTracker ตัวอย่างเช่น ข้อมูลโค้ดต่อไปนี้แสดงวิธีกำหนดค่าโดยใช้สภาพแวดล้อม Adobe Flex กับ ActionScript 3 
    tracker = new GATracker( this, "window.pageTracker", "Bridge", false );

  • วิธีอื่น หากคุณยังไม่ได้สร้างอ็อบเจ็กต์การติดตามหน้าเว็บบนหน้าเว็บของคุณ คุณเพียงแค่ส่งผ่านรหัสเว็บพร็อพเพอร์ตี้ของคุณ แล้วระบบจะสร้างออบเจ็กต์โค้ดติดตาม JavaScript ให้คุณ เมื่อใช้วิธีนี้ คุณยังคงต้องอ้างอิงไฟล์ต้นฉบับ JavaScript ga.js ในหน้า HTML ข้อมูลโค้ดต่อไปนี้จะแสดงวิธีกำหนดค่าโดยใช้สภาพแวดล้อม Adobe Flex กับ ActionScript 3 
    tracker = new GATracker( this, "UA-12345-22", "Bridge", false );

หากต้องการให้โหมดบริดจ์ทำงานอย่างถูกต้อง ต้องตั้งค่า ExternalInterface.available เป็น "จริง" ในโค้ด ActionScript 3 ซึ่งหมายความว่าควรตั้งค่า allowScriptAccess เป็น always ในหน้า HTML ที่ฝังเนื้อหา Flash ไว้ด้วย ตัวอย่างต่อไปนี้แสดงโค้ด HTML ที่กำหนดค่าไว้สำหรับโหมด 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>

 

โหมด AS3

ใช้โหมดนี้หากคุณควบคุมโค้ด Adobe Flash action 3 แต่คุณไม่ได้ควบคุมสภาพแวดล้อมการโฮสต์ของแอปพลิเคชัน Adobe Flash ตัวอย่างเช่น หากคุณกำลังพัฒนาเนื้อหา Flash เพื่อกระจายไปในหลายเว็บไซต์ คุณควรใช้โหมด AS3 โหมด AS3 เป็นอิสระจากโค้ดติดตาม ga.js โดยสิ้นเชิง และมีฟังก์ชันการติดตามทั้งหมดของ Analytics จึงไม่จำเป็นต้องติดตั้งการติดตาม ga.js แยกต่างหากเมื่อใช้โหมดนี้ นอกจากนี้ โหมด AS3 ยังใช้กลไกพื้นที่เก็บข้อมูล Flash เพื่อติดตามข้อมูลเซสชันสำหรับผู้ใช้

สำหรับพารามิเตอร์ DOM บางอย่าง เช่น ภาษา คอมโพเนนต์ AS3 จะพยายามเรียกค่าจากเบราว์เซอร์ หากไม่มีค่า คอมโพเนนต์จะใช้ค่าที่เทียบเท่าของ Flash หรือค่าเริ่มต้นเป็น no

การแก้ปัญหาและการตรวจสอบความถูกต้อง

คอมโพเนนต์การติดตามของ Google Analytics สำหรับ Adobe Flash มีโหมดแก้ไขข้อบกพร่องที่ช่วยให้การตรวจสอบและการแก้ปัญหาทำได้ง่ายขึ้น เมื่อเปิดใช้ ระบบจะดักจับข้อมูลการติดตามทั้งหมดและนำไปยังหน้าจอในกล่องข้อความแทนเซิร์ฟเวอร์ Analytics ในโหมดนี้ คุณจะเห็นข้อมูลที่เซิร์ฟเวอร์รวบรวมได้แบบเรียลไทม์ ฟีเจอร์นี้ยังช่วยให้เก็บข้อมูลการทดสอบอยู่นอกข้อมูลเวอร์ชันที่ใช้งานจริงด้วย คุณเปิดใช้ฟีเจอร์การแก้ปัญหาได้โดยตั้งค่าตัวเลือก visualDebug เป็น true ในเครื่องมือตรวจสอบคอมโพเนนต์

ตัวอย่าง

ดูตัวอย่างโดยละเอียดเกี่ยวกับการใช้การติดตามในสภาพแวดล้อมการพัฒนาต่างๆ ได้ที่ด้านล่างนี้

แฟลช

Flex

การกำหนดเวอร์ชัน

คุณสามารถค้นหาเวอร์ชันล่าสุดของคอมโพเนนต์การติดตามเป็นไฟล์ ZIP ได้ที่ http://code.google.com/p/gaforflash/downloads/list การดาวน์โหลดแต่ละครั้งจะมีคอมโพเนนต์การติดตามทั้งหมดพร้อมเอกสารที่เกี่ยวข้อง ชื่อไฟล์ของไฟล์ที่ดาวน์โหลดจะแสดงหมายเลขเวอร์ชันของรหัสในไฟล์

คุณสามารถใช้ข้อความต่อไปนี้ในโค้ดเพื่อพิมพ์หมายเลขเวอร์ชันปัจจุบันของคอมโพเนนต์ลงในคอนโซลเอาต์พุตได้ด้วย

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