Theo dõi tiện ích

Tài liệu này mô tả cách sử dụng API tiện ích mới để theo dõi tiện ích Analytics. API này cung cấp mô hình dữ liệu và tính năng theo dõi hiệu suất được cải tiến để thu thập số liệu thống kê báo cáo Analytics cho tiện ích của bạn.

  1. Trước khi bắt đầu
  2. Theo dõi tiện ích
  3. Phương pháp theo dõi
  4. Những điều cần cân nhắc khi sử dụng
  5. Mẹo
 

Trước khi bắt đầu

Trong Google Analytics, mỗi tên miền trang web duy nhất hoặc tên miền phụ mà bạn thêm vào tài khoản của mình được theo dõi trong một chế độ xem (hồ sơ) riêng biệt và được chỉ định một ID miền riêng. Vì mỗi tiện ích hoạt động trên miền phụ riêng của nó trên trang web lưu trữ gmodules.com, bạn sẽ muốn theo dõi từng tiện ích bạn tạo trong chế độ xem (hồ sơ) riêng và bằng một ID miền duy nhất.

Cách đơn giản nhất để làm việc này là cho phép Google Analytics tạo một mã nhận dạng duy nhất cho bạn.

  1. Để bắt đầu, hãy đăng nhập vào Google Analytics hoặc đăng ký tài khoản Google Analytics.
    • Người dùng mới sẽ thấy trang Đăng ký tài khoản mới.
    • Người dùng hiện tại nên truy cập vào trang Cài đặt Analytics và nhấp vào Thêm chế độ xem trang web (Hồ sơ). (Hãy nhớ chọn miền mới.)
  2. Nhập một trong hai trang này vào URL hợp lệ của trang web.
    3. Vì URL của trang web chỉ là một chuỗi mà phần mềm Google Analytics ghép nối với mã miền của bạn, nên URL này có thể là bất kỳ chuỗi URL hợp lệ nào của trang web, cho dù là giả hay thật. Bạn sẽ không cài đặt mã theo dõi trên bất kỳ trang web nào và sẽ không cần truy cập vào bất kỳ trang web nào.
  3. Nhấp vào nút này để tiếp tục chuyển sang màn hình tiếp theo.
    4. Khi đoạn mã theo dõi xuất hiện, hãy sao chép mã miền duy nhất vào mảnh giấy nháp. Đoạn mã được tạo tự động có chứa mã miền này ở dạng UA-123456-1.
  4. Nhấp vào nút Finish (Hoàn tất).
    5. Bạn sẽ thấy tên URL trang web của mình trong danh sách chế độ xem (hồ sơ). Bạn cũng có thể thay đổi tên chế độ xem (hồ sơ) thành tên có ý nghĩa hơn bằng cách nhấp vào liên kết Chỉnh sửa cho chế độ xem (hồ sơ) đó, sau đó nhấp lại vào Chỉnh sửa.
  5. Sử dụng ID miền đã tạo trong mã theo dõi tiện ích của bạn.
    6. Mã miền Analytics có dạng:
    UA-123456-1
 

Theo dõi đồ dùng của bạn

Quá trình theo dõi tiện ích của bạn bao gồm ba phần bổ sung cho mã tiện ích:

  1. Đang bật tính năng.
  2. Tạo một đối tượng trình theo dõi.
  3. Theo dõi tiện ích của bạn bằng một trong hai phương pháp.

Mẫu mã tiện ích sau đây cho thấy từng phần bổ sung mã này, sau đó được giải thích bên dưới. Bạn có thể sử dụng tệp mẫu này để khởi động tiện ích của riêng mình.

<?xml version="1.0" encoding="UTF-8" ?>
<Module>
  <ModulePrefs title="Analytics Test">
     <!-- Sets the feature -->
     <Require feature="com.google.gadgets.analytics" /> 
     <Require feature="setprefs" /> 
  </ModulePrefs>
  <UserPref 
      name="counter"
      datatype="hidden"
      default_value="0" />
  <Content type="html"> 
  <![CDATA[ 
      <script>
      // Track this gadget using Google Analytics.

      // Creates a tracking object and uses reportPageview method to call gadget view
      var ga = new _IG_GA("UA-00000-1");
      ga.reportPageview('/view/counterGadget');

      // Suppose, for example, you have a gadget with two counter buttons.
      // You can track interactions with those counters via Analytics.

      // Increment value of "counter" user preference
      function incrementCounter() {
         var count = prefs.getInt("counter");

         prefs.set("counter", count + 1);

         // Tracks button click as an event
         ga.reportEvent("Counter Gadget", "Increment", "Button", 0);
      }

      // Reset value of "counter" userpref to 0
      function resetCounter(){
         prefs.set("counter", 0);

         // Tracks button click as an event
         ga.reportEvent("Counter Gadget", "Reset", "Button", 0);
      }
      </script>
      <form name="counter">
      <input type=button value="Reset" name="reset" onClick="resetCounter()">
      <input type=button value="Count" name="count" onClick="incrementCounter()">
      </form>
  ]]>
  </Content>
</Module>

1. Bật tính năng

Trước tiên, hãy bật tính năng này bằng cách nhập thư viện Analytics thông qua vùng chứa tên tính năng:

 <Require feature="com.google.gadgets.analytics" />

2. Tạo đối tượng công cụ theo dõi

API theo dõi Analytics tuân theo cùng một mô hình hướng đối tượng của mã theo dõi ga.js. Vì vậy, trước khi theo dõi tiện ích của bạn, hãy tạo thực thể cho một đối tượng công cụ theo dõi:

var ga = new _IG_GA("UA-123456-1");

Đây là nơi bạn sẽ chèn mã miền được tạo bằng cách làm theo các bước ở trên.

Bạn phải sử dụng mã miền đầy đủ có một chữ số đơn kết thúc; nếu không, lệnh gọi đối tượng theo dõi sẽ không thành công.

3. Theo dõi đồ dùng của bạn

API tiện ích cung cấp hai phương pháp mà bạn có thể sử dụng để theo dõi tương tác trên các tiện ích của mình:

  • Phương thức URL ảo
    • ga.reportPageview(path);

    Phương pháp này theo dõi số liệu thống kê tiện ích dưới dạng lượt xem trang đặc biệt và cũng là phương pháp được sử dụng trong phiên bản trước của API tiện ích Analytics. Khi sử dụng phương pháp này, bạn có thể cập nhật bất kỳ mã theo dõi tiện ích nào có sẵn trước đó mà không ảnh hưởng đến bố cục báo cáo Analytics hiện có. Bạn xem dữ liệu báo cáo trên các tiện ích của mình giống như bạn xem dữ liệu báo cáo cho các trang web.

    Khi bạn sử dụng phương thức URL ảo để theo dõi tương tác với tiện ích, mỗi lệnh gọi sẽ được ghi lại dưới dạng yêu cầu trang đối với chuỗi mà bạn cung cấp dưới dạng tham số cho phương thức. Bạn có thể tận dụng hành vi này để chuyển vào một đường dẫn URL được tạo, nhờ đó, bạn có thể xem các báo cáo về tiện ích trong giao diện Google Analytics giống như cách bạn thực hiện với báo cáo về trang của trang web. Ví dụ: bạn có thể sử dụng các đường dẫn riêng biệt để theo dõi cả chế độ xem tiện ích và các tương tác với tiện ích: 

    ga.reportPageview('/view/counterGadget');
ga.reportPageview('/click/increment');
ga.reportPageview('/click/reset');

  • Phương pháp theo dõi sự kiện
    • ga.reportEvent(name, action, [[]label], [[]value]);

    Phương pháp này chỉ có trong API tiện ích Analytics mới. Sử dụng phương pháp này, bạn có thể theo dõi số lần xem trang (ví dụ: hiển thị tiện ích) riêng biệt với tương tác của người dùng trên tiện ích của bạn.

    Lưu ý: Hiện tại, tính năng Theo dõi sự kiện đang ở giai đoạn phát hành beta kín. Sử dụng phương pháp URL ảo nếu bạn không có quyền truy cập vào tính năng Theo dõi sự kiện.

    Phương thức sự kiện cung cấp một mô hình khác để bạn sử dụng với tính năng theo dõi tiện ích. Trước tiên, lệnh gọi sự kiện được tính toán riêng biệt với lệnh gọi lượt xem trang và dữ liệu kết quả sẽ hiển thị trong một phần riêng của báo cáo Nội dung Google Analytics. Do đó, bạn có thể theo dõi lượt xem tiện ích một cách riêng biệt từ hoạt động tương tác của người dùng trên tiện ích mà không làm tăng tổng số lượt xem tiện ích. Thứ hai, phương pháp này sử dụng mô hình theo dõi sự kiện, có cấu trúc được thiết kế đặc biệt để phân tích tương tác của người dùng trên các tiện ích. Trong mô hình này, cả nhãn và giá trị đều là tham số không bắt buộc.

    Trong ví dụ về bộ đếm, chúng ta có thể sử dụng phương thức sự kiện để theo dõi chức năng tiện ích nào được kích hoạt và chúng ta có thể chuyển vào loại điều khiển, là một nút trong cả hai trường hợp. 

    ga.reportEvent("Counter Gadget", "Increment", "Button");
ga.reportEvent("Counter Gadget", "Reset", "Button");

    Đây là một ví dụ rất đơn giản, nhưng mô hình theo dõi sự kiện là một cấu trúc có tính linh hoạt cao mà bạn có thể tinh chỉnh để tận dụng các yêu cầu theo dõi riêng biệt của tiện ích của bạn. Để biết thêm thông tin, hãy xem tài liệu về Sự kiện theo dõi.

 

Phương pháp theo dõi

Hiện tại, tính năng Analytics cung cấp các phương pháp sau. Cách sử dụng của các tính năng này được thảo luận ở trên.

  • reportPageview()
    • Yêu cầu một chuỗi để điền chính xác các báo cáo nội dung. Thông thường, chuỗi này ở dạng đường dẫn mà bạn xác định cho mục đích báo cáo của mình. Giá trị chuyển vào phương thức này được gửi trong yêu cầu GIF thông qua biến utmp. Sử dụng phương pháp này để theo dõi lượt tải tiện ích và tương tác với tiện ích. 
    ga.reportPageview("/view/gadgetName");
    parameter
    String  path Đường dẫn để cung cấp URL ảo của phần tử này.

  • reportEvent()
    • Yêu cầu tên của tiện ích và thông số hành động để chèn chính xác dữ liệu theo dõi vào báo cáo Theo dõi sự kiện. Các tham số khác là không bắt buộc. Các giá trị được truyền qua phương thức này được gửi trong chế độ xem yêu cầu GIF của biến utme.

    tham số
    String  name  Bắt buộc.Chuỗi được sử dụng ở cấp cao nhất của báo cáo Theo dõi sự kiện. Ví dụ: nếu bạn đang theo dõi tương tác trên một số phần tử tiện ích, bạn có thể sẽ sử dụng tên của chính tiện ích cho tham số này, để tất cả theo dõi tương tác cho tiện ích sẽ được tổng hợp trong cùng một phần của báo cáo Google Analytics.

    String  action  Bắt buộc. Chuỗi để phân đoạn tiếp tương tác tiện ích trong các báo cáo Theo dõi sự kiện. Để biết thêm thông tin, hãy xem tài liệu về Sự kiện theo dõi.

    String  label  Không bắt buộc. Chuỗi bạn có thể sử dụng làm phân đoạn phụ cho tiện ích của mình.

    Int  value  Không bắt buộc. Số mà bạn có thể cung cấp dưới dạng giá trị cho hoạt động tương tác với tiện ích. Số liệu này được tổng hợp cho mỗi lần phương thức này được gọi.

 

Những điều cần cân nhắc khi sử dụng

API tiện ích Google Analytics có một số điểm cần cân nhắc về cách sử dụng:

  • Vùng chứa được hỗ trợ
    • Nhiều loại vùng chứa được hỗ trợ với API tiện ích Google Analytics, bao gồm nhưng không giới hạn ở:
    • iGoogle
    • Phân phối mở
    • Mở mạng xã hội
    • Tiện ích
  • Các loại tiện ích không được hỗ trợ
    • API tiện ích Google Analytics không hỗ trợ các loại tiện ích sau:
    • Tiện ích cùng dòng (type=html-inline)
    • Mapplets
    • Tiện ích loại URL (type-url)
    • Quảng cáo Tiện ích trên Google AdSense
  • Những điểm cần lưu ý đối với miền
    • Khi bạn cần tính năng Analytics cho tiện ích của mình, tiện ích sẽ chuyển hướng đến <subdomain>.gmodules.com, trong đó <subdomain> là miền phụ duy nhất, ngẫu nhiên. Do đó, tất cả nội dung trong tiện ích đều được hiển thị trong miền phụ đó. Ví dụ: 3nvma227-a.gmodules.com. Ngoài ra, tất cả cookie theo dõi của Google Analytics đều được đặt thành tên miền phụ duy nhất này. Vì lý do này, mapplet không được tính năng theo dõi Analytics hỗ trợ và bạn phải cho phép nội dung Flash truy cập đặc biệt vào tính năng theo dõi một cách cụ thể (xem bên dưới).
  • Tiện ích sử dụng nội dung Flash
    • Các tiện ích sử dụng nội dung Flash phải cho phép giao tiếp cụ thể giữa URL Flash và URL của tiện ích bằng cách đặt tham số allowScriptAccess thành luôn luôn. 
    _IG_EmbedFlash("example.swf", "wrapper", {allowScriptAccess: "always"});
 

Mẹo

Cách tốt nhất để sử dụng phương pháp URL ảo

Nếu bạn không có quyền truy cập vào phương pháp theo dõi sự kiện cho tiện ích của bạn, hãy làm theo các đề xuất sau để theo dõi tiện ích của bạn bằng phương pháp URL ảo:

  • Phân đoạn tải tiện ích của bạn một cách rõ ràng.
    • Bạn có thể gọi ga.reportPageview() khi tải tiện ích bằng cách cung cấp một đường dẫn phân đoạn số liệu thống kê lượt tải/xem tiện ích một cách riêng biệt với chỉ số tương tác của tiện ích. Thao tác này sẽ lưu dữ liệu báo cáo nội dung cho tiện ích trong một "thư mục" riêng biệt với các lượt tương tác trên tiện ích, để bạn có thể thấy số lượt xem tổng thể tách biệt với số lượt tương tác trên chính tiện ích đó. Ví dụ: đoạn mã sau đây có thể được sử dụng trong tiện ích của bạn để hiển thị tất cả số liệu thống kê về lần tải tiện ích của bạn: 
      ga.reportPageview('/view/gadgetName');
  • Phân chia các loại tương tác khác nhau.
    • Gọi ga.reportPageview() bằng một đường dẫn phân đoạn các lượt tương tác khác nhau của người dùng. Bằng cách này, bạn có thể nhận được báo cáo nội dung riêng biệt cho các đường liên kết đến tiện ích, nút tiện ích hoặc các tiện ích khác mà bạn có thể muốn theo dõi để biết dữ liệu tương tác. Ví dụ:
    • ga.reportPageview('/link/click');
    • ga.reportPageview('/link/submit');

Sử dụng phương pháp theo dõi sự kiện

Nếu có quyền truy cập vào tính năng Theo dõi sự kiện trong báo cáo Google Analytics, bạn có thể tận dụng lợi thế của mô hình dữ liệu có tính linh hoạt cao để tận dụng tối đa việc theo dõi các đối tượng của mình. Dưới đây là một số mẹo hay:

  • Theo dõi lượt hiển thị hoặc lượt xem tiện ích bằng ga.reportPageview() và theo dõi hoạt động tương tác với tiện ích bằng ga.reportEvent().
    • Chế độ xem tiện ích sẽ hiển thị trong phần Nội dung cho dữ liệu trang, còn các lượt tương tác với tiện ích sẽ hiển thị trong phần Sự kiện trong báo cáo Nội dung.
  • Sử dụng document.referrer làm tham số để biết vị trí đặt tiện ích của bạn.
    • Trong tiện ích, document.referrer thường là URL trang của vùng chứa, vì vậy bạn có thể truyền URL này vào phương thức ga.reportEvent() dưới dạng tham số nhãn:
    var containerPage = document.referrer;
ga.reportEvent("Counter Gadget", "Increment", containerPage, 0);

Khắc phục sự cố

Bạn có thể sử dụng công cụ của bên thứ ba để phân tích chuỗi yêu cầu GIF cho tiện ích của bạn nhằm xác minh rằng dữ liệu sẽ được gửi đến báo cáo Google Analytics theo cách bạn mong đợi. Khi bạn có tiện ích được lưu trữ và hoạt động đúng trên trang kiểm tra của mình, hãy phân tích chuỗi yêu cầu GIF như sau:

  • Phương thức xem trang
    • Tìm biến utmp trong các tham số yêu cầu ảnh GIF. Thông tin liên kết với biến đó sẽ được gửi đến báo cáo Google Analytics dưới dạng "đường dẫn" cho tiện ích.
  • Phương pháp theo dõi sự kiện
    • Tìm biến utme trong các tham số yêu cầu ảnh GIF. Thông tin này phải có dạng 5(object*action*label)(value).

Để biết thêm thông tin về cách khắc phục sự cố mã theo dõi, hãy xem Hướng dẫn khắc phục sự cố của GATC.