Thiết lập Adobe Flash

Tài liệu này bao gồm mọi thông tin bạn cần biết để thiết lập tính năng Theo dõi Google Analytics cho Adobe Flash trong môi trường phát triển Adobe Flash.

Lấy tệp thành phần

Các tệp thành phần theo dõi Flash được nén vào một tệp ZIP mà bạn có thể tải xuống từ http://code.google.com/p/gaforflash/downloads/list.

Làm theo hướng dẫn trong tệp readme.txt để cài đặt các thành phần Flash.

1. Nếu bạn đang mở Adobe Flash CS3, hãy thoát khỏi ứng dụng này.
2. Tạo thư mục Google ở một trong những vị trí sau:
   • Đối với Windows: C:\Program Files\Adobe\ Adobe Flash CS3\language\Configuration\Components
   • Đối với Mac OS X: Macintosh HD/Applications/Adobe Flash CS3/Configuration/Components
3. Chuyển đến vị trí bạn đã giải nén tệp ZIP thành phần rồi sao chép các tệp sau đây vào thư mục mà bạn đã tạo ở bước trước:
   • lib/analytics_flash.swc — Thành phần Analytics
   • lib/analytics.swc — Thành phần Thư viện Analytics

Cả hai thành phần đều có chức năng giống nhau, nhưng được cung cấp để thuận tiện cho các kiểu phát triển khác nhau.

Thành phần Analytics. Nếu bạn phát triển nội dung Flash nhưng không quen thuộc với ActionScript 3, hãy sử dụng thành phần này. Thành phần Analytics là một gói theo dõi hoàn chỉnh. Chỉ cần kéo và thả các thành phần trực tiếp vào vùng hiển thị của bạn, tạo một vài cấu hình đơn giản trong trình kiểm tra thành phần là bạn đã sẵn sàng để gắn thẻ các chế độ kiểm soát bằng tính năng theo dõi của Analytics.

Thành phần AnalyticsLibrary. Nếu bạn quen với ActionScript 3, bạn có thể sử dụng thành phần AnalyticsLibrary. Kéo thành phần vào Thư viện Flash và nhập trực tiếp các lớp theo dõi vào mã ActionScript của bạn.

Sử dụng thành phần Analytics

Sử dụng analytics_flash.swc để triển khai tính năng theo dõi thông qua thành phần Analytics. Đặt thành phần vào đúng thư mục Thành phần và thành phần đó sẽ xuất hiện trong bảng điều khiển Thành phần (Cửa sổ – Thành phần).

1. Kéo thành phần vào vùng hiển thị và đặt tên cho thành phần đó trong hộp thoại Thuộc tính.
2. Định cấu hình thành phần trong bảng điều khiển Component Inspector (Trình kiểm tra thành phần) (Windows – Component Inspector (Trình kiểm tra thành phần)):
   • Thêm mã thuộc tính web Analytics.
   • Chọn chế độ Cầu hoặc chế độ AS3.
   • Cho biết liệu tính năng gỡ lỗi bằng hình ảnh đang bật hay tắt.
3. Trong mã ActionScript, hãy thêm lệnh gọi theo dõi GA chuẩn vào trường hợp của thành phần bạn vừa tạo.

Do cách Flash hoạt động với các thành phần hình ảnh, thông thường tốt nhất bạn nên bắt đầu theo dõi trên khung thứ hai của ứng dụng Flash. Nếu bạn cần khởi chạy theo dõi trên khung đầu tiên, hãy đặt lệnh gọi theo dõi bên trong trình xử lý sự kiện để đảm bảo thành phần được khởi chạy đầy đủ trong nội dung Flash.

Ví dụ đơn giản về thành phần Flash Analytics

Đoạn mã sau đây cho biết cách theo dõi một nút trong Flash khi có người nhấp vào nút đó. Trong ví dụ này, bản sao của nút được đặt tên là playGame trong ActionScript của bạn. Khi người dùng nhấp vào nút này, phương thức onButtonClick sẽ được gọi, sau đó phương thức này sẽ gọi phương thức trackPageview(). Việc này sẽ làm tăng số lượt xem trang cho trang ảo /myGame1.

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

Trở lại đầu trang

Sử dụng thành phần AnalyticsLibrary

Sử dụng tệp analytics.swc để triển khai tính năng theo dõi thông qua thành phần AnalyticsLibrary. Thành phần này cho phép bạn tạo thực thể cho đối tượng theo dõi ngay trong mã AS3 của mình. Khi thành phần AnalyticsLibrary nằm ở vị trí thích hợp, nó sẽ xuất hiện trong bảng điều khiển Thành phần. Sau đó, bạn có thể kéo thành phần từ bảng điều khiển Thành phần vào thư viện của mình và từ đó, nhập thư viện vào mã ActionScript.

Khởi chạy Đối tượng theo dõi

Sử dụng môi trường Adobe Flash, hãy khởi tạo đối tượng theo dõi bằng các tham số sau:

• Tham chiếu đến đối tượng hiển thị hiện tại. Trong ví dụ dưới đây, this tham chiếu đến đối tượng hiển thị.
• Mã tài sản web. ID thuộc tính web là chuỗi duy nhất được sử dụng để theo dõi hoạt động trên nội dung Flash và phân phối nó đến chế độ xem (hồ sơ) chính xác trong tài khoản Analytics của bạn.
• Chế độ theo dõi. Các thông số hợp lệ là Bridge hoặc AS3.
• Chế độ gỡ lỗi. Thiết lập debug thành false để dùng cho phiên bản công khai và thành true để xác thực và khắc phục sự cố.

Một ví dụ đơn giản về AnalyticsLibrary

Trong ví dụ sau, một đoạn phim có tên playGame xuất hiện trên vùng hiển thị. Một đối tượng theo dõi mới có tên là tracker được tạo cùng với một trình xử lý sự kiện sẽ theo dõi lượt nhấp chuột. Khi người dùng nhấp vào nút này, hàm onButtonClick sẽ được gọi. Đối với mỗi lượt nhấp, phương thức trackPageview() sẽ làm tăng số lượt xem trang cho trang ảo /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");
} 

Trở lại đầu trang