Theo dõi Google Analytics cho Adobe Flash

Thành phần Theo dõi Google Analytics cho Adobe Flash giúp bạn dễ dàng triển khai Google Analytics trong nội dung dựa trên Flash. Thành phần này do Adobe Systems, Inc. phát triển, chứa tất cả chức năng của mã JavaScript của Google Analytics. Thành phần Theo dõi Flash là đối tượng theo dõi được biên dịch dựa trên ActionScript 3, giúp việc triển khai Analytics trở nên trực quan trong môi trường phát triển Flash và Flex.

Tại sao bạn nên sử dụng tính năng theo dõi bằng Flash?

Nếu không có thành phần Theo dõi Google Analytics cho Adobe Flash, việc theo dõi nội dung Adobe Flash bằng Google Analytics bao gồm một số trở ngại kỹ thuật. Trước tiên, bạn phải phát triển giao diện tùy chỉnh cho ga.js để ứng dụng Flash của bạn có thể thực thi phương pháp Analytics thích hợp, chẳng hạn như trackPageview() hoặc trackEvent(). Ngoài ra, bạn cũng phải dự đoán liệu nội dung Flash của bạn có quyền truy cập vào Mô hình đối tượng tài liệu (DOM) của trình duyệt hay không, vì việc theo dõi không thành công đối với các đối tượng trong đó quyền truy cập vào DOM bị từ chối (thường là khi nội dung của bạn nằm trên trang web của bên thứ 3). Điều này bao gồm việc hiểu cách sử dụng lệnh gọi ExternalInterface trong ActionScript 3 để truy cập DOM trình duyệt và hạ cấp khi quyền truy cập bị từ chối.

Thành phần Google Analytics cho Adobe Flash làm đơn giản hoá việc theo dõi nội dung Flash của bạn và xử lý quyền truy cập DOM một cách uyển chuyển. Điều này hữu ích cho một số mục đích theo dõi phổ biến trong Flash, chẳng hạn như: :

  • một tiện ích Flash nhúng trên một trang HTML
  • một ứng dụng Flex độc lập hoặc trang web thuần Flash được lưu trữ trên trang HTML
  • một trò chơi hoặc chương trình Flex/Flash được phân phối ở nơi mà người phát triển không có quyền kiểm soát đối với việc tiện ích sẽ được đặt ở đâu

Hãy nhớ rằng các ứng dụng theo dõi trong Flash có một số thay đổi về cấu trúc từ việc theo dõi các trang trên trang web. Bạn cần am hiểu về tính năng Theo dõi của Analytics để hiểu cách hoạt động của trình bổ trợ này. Bạn cũng có thể xem Tài liệu thiết kế cho dự án này để biết thông tin chi tiết về cách chuyển mô hình Theo dõi Analytics cho thành phần này.

Lưu ý: Hiện tại, bạn có thể sử dụng tính năng theo dõi Flash cho bất kỳ nội dung Flash nào được nhúng trong một trang web. Tính năng theo dõi dữ liệu được gửi từ Adobe Air, TrueView hoặc qua Flash IDE (ví dụ: sử dụng Test Movie) hiện không được hỗ trợ.

Môi trường phát triển được hỗ trợ

Bạn có thể phát triển tính năng Theo dõi Analytics cho Flash trong môi trường Adobe Flash hoặc Adobe Flex. Mỗi môi trường yêu cầu một thành phần khác nhau mà bạn có thể tải xuống từ http://code.google.com/p/gaforflash/. Các thành phần này dựa trên ActionScript 3 và có thể được thiết lập theo một trong hai cách cho từng môi trường:

Trong Adobe Flash

  • Thêm và định cấu hình một thành phần đơn giản trong trình kiểm tra thành phần và kéo thành phần đó vào vùng hiển thị.
  • Nhập trực tiếp thư viện Theo dõi Flash vào thư viện của bạn và bắt đầu lập trình.

Trong Adobe Flex

  • Bao gồm một thành phần MXML mà bạn định cấu hình từ tệp MXML.
  • Nhập thư viện Theo dõi Flash vào thẻ tập lệnh/tệp AS3 của bạn.

Thành phần hoạt động như thế nào?

Để sử dụng thành phần theo dõi Flash trong môi trường của mình, bạn sử dụng các công cụ trực quan bên trong Flash hoặc bạn thiết lập đối tượng theo dõi trực tiếp trong mã của mình. Bất kể đang thiết lập thành phần này theo cách trực quan hay thông qua mã, bạn đều cung cấp các phần tử sau đây:

  • ID thuộc tính web—Đây còn được gọi là số UA của mã theo dõi và trông giống như UA-xxxxx-yy, trong đó x và y được thay thế bằng các số tương ứng với thông tin tài khoản và chế độ xem (hồ sơ) của bạn cho đối tượng bạn đang theo dõi. Hãy xem bài viết về Tài sản web để biết thêm thông tin.
  • chế độ theo dõi – Chọn chế độ cầu nối hoặc chế độ AS3. Chế độ này xác định cách tính năng theo dõi giao tiếp với máy chủ Analytics và được mô tả chi tiết bên dưới.
  • chế độ gỡ lỗi – Bất kể bạn sử dụng môi trường hay chế độ theo dõi nào, bạn đều có thể bật tính năng gỡ lỗi để xác thực và kiểm tra hoạt động theo dõi.

Chế độ theo dõi

Tuỳ thuộc vào cách bạn phân phối nội dung Flash, thành phần Analytics cho Flash sẽ liên lạc với các máy chủ Analytics bằng cách bắc cầu liên lạc giữa nội dung Flash trên một chế độ cài đặt theo dõi Analytics hiện có hoặc bằng cách giao tiếp trực tiếp với các máy chủ Analytics. Hai chế độ này được gọi là chế độ cầu nối và chế độ AS3. Cả hai chế độ này đều sử dụng cùng một chức năng theo dõi Analytics và bạn có thể dễ dàng chuyển đổi ứng dụng Flash của mình từ chế độ này sang chế độ khác. Ngoài việc chọn chế độ liên lạc để theo dõi Analytics, bạn cũng có thể sử dụng chế độ gỡ lỗi để khắc phục sự cố hoặc xác thực theo dõi của mình.

Ở cả hai chế độ, allowscriptaccess phải bằng always để tính năng theo dõi chiến dịch hoạt động. Thông số này bật quyền truy cập đọc vào URL của trang và thông tin liên kết giới thiệu mà mã theo dõi Flash yêu cầu. Nếu không có allowscriptaccess, mã theo dõi Analytics sẽ xuống cấp nhẹ. Trạng thái này vẫn cung cấp hầu hết dữ liệu hoạt động của người dùng, nhưng sẽ không xác nhận với mô hình phân bổ của chiến dịch trên Google Analytics.

Chế độ cầu nối

Sử dụng chế độ này nếu bạn kiểm soát cả trang HTML và nội dung Flash. Chế độ này phù hợp nhất nếu bạn đã triển khai tính năng theo dõi của Google Analytics (ga.js) trên trang web của mình và muốn thêm tính năng theo dõi vào nội dung Flash được nhúng. Chế độ cầu nối đơn giản hoá quá trình giao tiếp Flash với JavaScript bằng cách cung cấp giao diện ActionScript 3 hợp nhất cho mã ga.js. Nó cung cấp kết nối từ các lệnh gọi ActionScript 3 đến JavaScript của Analytics để tính năng theo dõi hoạt động.

Mối kết nối với Mã theo dõi Google Analytics có thể được định cấu hình thông qua thông số ID thuộc tính web theo một trong hai cách:

  • Phương pháp phổ biến nhất. Đối tượng Mã theo dõi Google Analytics đã tồn tại trên trang của bạn với tên riêng, chẳng hạn như pageTracker. Trong trường hợp này, bạn cung cấp tham chiếu DOM đầy đủ cho đối tượng theo dõi. Ví dụ: nếu đối tượng của bạn có tên là pageTracker, thì bạn sẽ tham chiếu đối tượng đó trong mã của mình dưới dạng window.pageTracker. Ví dụ: đoạn mã sau đây minh hoạ cách định cấu hình quy trình này bằng môi trường Adobe Flex với ActionScript 3: 
    tracker = new GATracker( this, "window.pageTracker", "Bridge", false );

  • Phương pháp thay thế. Nếu chưa tạo đối tượng theo dõi trang trên trang của mình, bạn chỉ cần chuyển mã thuộc tính web vào và đối tượng mã theo dõi JavaScript sẽ được tạo cho bạn. Với phương pháp này, bạn vẫn phải tham chiếu đến tệp nguồn JavaScript ga.js cơ sở trên trang HTML của mình. Đoạn mã sau minh hoạ cách định cấu hình quy trình này bằng môi trường Adobe Flex với ActionScript 3: 
    tracker = new GATracker( this, "UA-12345-22", "Bridge", false );

Để chế độ cầu nối hoạt động chính xác, bạn phải đặt ExternalInterface.available thành true trong mã ActionScript 3. Điều này cũng có nghĩa là bạn phải đặt allowScriptAccess thành always trong trang HTML nhúng nội dung Flash. Ví dụ sau minh hoạ mã HTML được định cấu hình cho chế độ cầu nối:

<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>

 

Chế độ AS3

Sử dụng chế độ này nếu bạn kiểm soát mã Adobe Flash ActionScript 3 nhưng không kiểm soát môi trường lưu trữ của ứng dụng Adobe Flash. Ví dụ: nếu đang phát triển nội dung Flash để phân phối trên nhiều trang web, bạn sẽ sử dụng chế độ AS3. Chế độ AS3 hoàn toàn độc lập với mã theo dõi ga.js và chứa tất cả chức năng theo dõi của Analytics. Bạn không cần cài đặt theo dõi ga.js riêng biệt với chế độ này. Ngoài ra, chế độ AS3 sử dụng cơ chế lưu trữ Flash để theo dõi thông tin phiên cho người dùng.

Đối với một số tham số DOM nhất định, chẳng hạn như ngôn ngữ, thành phần AS3 cố gắng truy xuất các giá trị từ trình duyệt. Nếu không có các giá trị này thì thành phần sẽ sử dụng giá trị tương đương Flash hoặc mặc định là no.

Khắc phục sự cố và xác thực

Thành phần Theo dõi Google Analytics cho Adobe Flash cung cấp chế độ gỡ lỗi để đơn giản hoá việc xác thực và khắc phục sự cố. Khi bật, tất cả dữ liệu theo dõi sẽ được chặn và chuyển đến một màn hình trong hộp văn bản thay vì đến các máy chủ của Analytics. Ở chế độ này, bạn có thể xem dữ liệu theo thời gian thực mà máy chủ sẽ thu thập. Tính năng này cũng giúp giữ dữ liệu thử nghiệm nằm ngoài dữ liệu thực tế của bạn. Bạn có thể bật tính năng khắc phục sự cố bằng cách đặt tuỳ chọn visualDebug thành true trong trình kiểm tra thành phần.

Ví dụ

Để biết các ví dụ chi tiết về cách triển khai tính năng theo dõi trong các môi trường phát triển, hãy xem các phần sau:

Đèn flash

Flex

Lập phiên bản

Bạn có thể tìm phiên bản mới nhất của thành phần theo dõi dưới dạng tệp ZIP tại http://code.google.com/p/gaforflash/downloads/list. Mỗi tệp tải xuống chứa tất cả các thành phần theo dõi cùng với tài liệu liên quan. Tên tệp của tệp tải xuống sẽ hiển thị số phiên bản của mã trong tệp đó.

Bạn cũng có thể sử dụng các câu lệnh sau trong mã để in số phiên bản hiện tại của thành phần vào bảng điều khiển đầu ra.

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