Mã theo dõi: Cấu hình cơ bản

Tài liệu tham khảo này mô tả các phương pháp mà bạn sử dụng để tuỳ chỉnh tất cả các khía cạnh của báo cáo Google Analytics.

Phương pháp cơ bản của ga.js

Thông tin chi tiết về phương pháp

_deleteCustomVar()

_deleteCustomVar(index)

Phương thức này sẽ xoá biến được gán cho chỉ mục đã cung cấp, nếu có. Ví dụ: bạn có thể đặt một biến tùy chỉnh cấp khách truy cập và sau đó quyết định rằng bạn không muốn sử dụng biến cấp khách truy cập này nữa.

Đoạn mã không đồng bộ (được đề xuất)

_gaq.push(['_deleteCustomVar', 1]);

tham số

Int   index Chỉ mục của biến tuỳ chỉnh cần xoá.

_getName()

_getName()

Trả về tên của trình theo dõi được đặt khi tạo.

Đoạn mã không đồng bộ (được đề xuất)

_gaq.push(function() {
  var pageTracker = _gat._getTrackerByName(); // Gets the default tracker.
  var trackerName = pageTracker._getName();
});

giá trị trả về

String Tên của thiết bị theo dõi.

_getAccount()

_getAccount()

Trả về mã Google Analytics cho đối tượng công cụ theo dõi này. Nếu đang theo dõi các trang trên trang web của mình trong nhiều tài khoản, bạn có thể sử dụng phương pháp này để xác định tài khoản được liên kết với một đối tượng trình theo dõi cụ thể.

Đoạn mã không đồng bộ (được đề xuất) 

_gaq.push(function() {
  var pageTracker = _gat._getTrackerByName(); // Gets the default tracker.
  var accountId = pageTracker._getAccount();
});

giá trị trả về

String Mã tài khoản mà đối tượng theo dõi này được tạo thực thể.

_getVersion()

_getVersion()

Trả về số phiên bản GATC.

Đoạn mã không đồng bộ (được đề xuất) 

_gaq.push(function() {
  var pageTracker = _gat._getTrackerByName(); // Gets the default tracker.
  var version = pageTracker._getVersion();
});

giá trị trả về

String Số phiên bản GATC.

_getVisitorCustomVar()

_getVisitorCustomVar(index)

Trả về giá trị biến tùy chỉnh cấp khách truy cập được chỉ định cho chỉ mục đã chỉ định.

Đoạn mã không đồng bộ (được đề xuất) 

_gaq.push(function() {
  var pageTracker = _gat._getTrackerByName(); // Gets the default tracker.
  var visitorCustomVar1Value = pageTracker._getVisitorCustomVar(1);
});

tham số

Int   index Chỉ mục của biến tuỳ chỉnh cấp khách truy cập.

giá trị trả về

String Giá trị của biến tuỳ chỉnh cấp khách truy cập. Trả về giá trị không xác định nếu không thể truy xuất biến cho chỉ mục đã chỉ định.

_initData()

_initData()Không dùng nữa. initData() hiện tự động thực thi trong mã theo dõi ga.js.

Khởi động hoặc khởi động lại đối tượng GATC (Mã theo dõi Google Analytics).

var pageTracker = _gat._getTracker("UA-12345-1");
pageTracker._trackPageview();

_setAccount()

_setAccount(accountId)

Chỉ dùng trong tính năng theo dõi không đồng bộ. Đặt mã thuộc tính web cho đối tượng theo dõi.

_gaq.push(['_setAccount', 'UA-XXXXX-X']);

tham số

String accountID Mã thuộc tính web đầy đủ (ví dụ: UA-65432-1) cho đối tượng trình theo dõi.

_setCookiePersistence()

_setCookiePersistence(milliseconds)

Phương pháp này không được dùng nữa. Thay vào đó, vui lòng sử dụng _setVisitorCookieTimeout(cookieTimeoutMillis).

Đặt thời hạn của cookie khách truy cập Google Analytics tính bằng mili giây. Theo mặc định, cookie khách truy cập được đặt sẽ hết hạn sau 2 năm. Nếu muốn, bạn có thể thay đổi ngày hết hạn của cookie của khách truy cập bằng cách sử dụng phương thức này. Ví dụ: để đặt thời hạn của cookie khách truy cập thành 7 ngày, bạn sẽ sử dụng mã sau:

pageTracker._setCookiePersistence(604800000);

tham số

Number   milliseconds Thời gian hết hạn của cookie khách truy cập mới.

_setCustomVar()

_setCustomVar(index, name, value, opt_scope)

Đặt một biến tuỳ chỉnh bằng tên, giá trị và phạm vi đã cung cấp cho biến đó. Có giới hạn ký tự là 128 byte cho kết hợp name và value.

Đoạn mã không đồng bộ (được đề xuất) 

_gaq.push(['_setCustomVar', 1, 'Section', 'Life & Style', 3]);

giá trị trả về

Boolean Phương thức này trả về true nếu biến tuỳ chỉnh đã được đặt thành công và false nếu chưa đặt thành công (ví dụ: nếu độ dài chuỗi tên/giá trị của bạn vượt quá 128 byte hoặc nếu bạn sử dụng vị trí không chính xác).

tham số

Int      index       Bắt buộc. Vị trí được dùng cho biến tuỳ chỉnh. Các giá trị có thể là 1-5 (bao gồm cả hai giá trị này).

String   name        Bắt buộc. Tên của biến tuỳ chỉnh.

String   value       Bắt buộc. Giá trị cho biến tuỳ chỉnh.

Int      opt_scope   Không bắt buộc. Phạm vi dùng cho biến tuỳ chỉnh. Các giá trị có thể là 1 cho cấp khách truy cập, 2 cho cấp phiên và 3 cho cấp trang.

_setSampleRate()

_setSampleRate(newRate)

Đặt tốc độ lấy mẫu mới. Nếu trang web của bạn đặc biệt lớn và có lưu lượng truy cập tăng đột biến, việc đặt tốc độ lấy mẫu đảm bảo hoạt động theo dõi báo cáo không bị gián đoạn. Việc lấy mẫu trong Google Analytics xảy ra một cách nhất quán trên số lượng khách truy cập duy nhất, do đó, tính toàn vẹn trong xu hướng và báo cáo ngay cả khi lấy mẫu được bật, bởi vì số lượng khách truy cập vẫn được bao gồm hoặc bị loại trừ khỏi mẫu, như được đặt từ lúc bắt đầu lấy mẫu.

Bạn chỉ cần chỉ định phương pháp này cùng lúc với thời điểm _setAccount() được gọi, thường là một lần cho mỗi trang hoặc ứng dụng (bất kể bạn khởi chạy chính mã theo dõi). Xin lưu ý rằng giá trị tốc độ lấy mẫu mà bạn chỉ định sẽ vẫn có hiệu lực trong khoảng thời gian đối tượng theo dõi đó vẫn tồn tại.

Đoạn mã không đồng bộ (được đề xuất) 

_gaq.push(['_setSampleRate', '2.5']);

tham số

String newRate Tốc độ lấy mẫu mới cần đặt. Cung cấp một chuỗi số trong khoảng từ 0 đến 100 (chính xác đến hai chữ số thập phân).

_setSessionTiming()

_setSessionTimeout(newTimeout)

Phương pháp này không được dùng nữa. Thay vào đó, vui lòng sử dụng _setSessionCookieTimeout(cookieTimeoutMillis).

Đặt thời gian chờ mới của phiên tính bằng giây. Theo mặc định, thời gian chờ của phiên được đặt thành 30 phút (1800 giây). Thời gian chờ của phiên được dùng để tính số lượt truy cập (xem bài viết Cách xác định một phiên trong Analytics). Nếu muốn thay đổi định nghĩa của một "phiên" cho nhu cầu cụ thể của mình, bạn có thể chuyển số giây để xác định một giá trị mới. Điều này sẽ ảnh hưởng đến các Báo cáo lượt truy cập trong mọi mục dùng để tính toán số lượt truy cập và khi số lượt truy cập được dùng để tính toán các giá trị khác. Ví dụ: số lượt truy cập thường sẽ tăng lên khi bạn rút ngắn thời gian chờ của phiên và thường sẽ giảm nếu bạn tăng thời gian chờ của phiên.

tham số

String newTimeout Thời gian chờ mới của phiên sử dụng tính bằng giây.

_setSessionCookieTiming()

_setSessionCookieTimeout(cookieTimeoutMillis)

Đặt thời gian chờ mới của cookie của phiên tính bằng mili giây. Theo mặc định, thời gian chờ của phiên được đặt thành 30 phút. Thời gian chờ của phiên được sử dụng để tính số lượt truy cập, vì lượt truy cập kết thúc sau 30 phút trình duyệt không hoạt động hoặc khi trình duyệt thoát. Nếu muốn thay đổi định nghĩa của một "phiên" cho nhu cầu cụ thể của mình, bạn có thể chuyển số mili giây để xác định một giá trị mới. Điều này sẽ ảnh hưởng đến các báo cáo Lượt truy cập trong mỗi phần mà số lượt truy cập được tính toán và nơi số lượt truy cập được sử dụng để tính toán các giá trị khác. Ví dụ: số lượt truy cập sẽ tăng nếu bạn rút ngắn thời gian chờ của phiên và sẽ giảm nếu bạn tăng thời gian chờ của phiên. Bạn có thể thay đổi thời gian chờ hết hạn thành 0 để cho biết rằng cần xoá cookie này khi trình duyệt đóng.

Đoạn mã không đồng bộ (được đề xuất) 

_gaq.push(['_setSessionCookieTimeout', 1800000]);


tham số

Number cookieTimeoutMillis Thời gian chờ của phiên mới tính bằng mili giây hoặc 0 để xoá cookie khi trình duyệt đóng.

_setSiteSpeedSampleRate()

_setSiteSpeedSampleRate(sampleRate)

Xác định kích thước tập hợp mẫu mới để thu thập dữ liệu Tốc độ trang web. Theo mặc định, lấy mẫu 1% cố định khách truy cập trang web của bạn sẽ tạo nhóm dữ liệu để tạo ra chỉ số Tốc độ trang web. Nếu số lượng khách truy cập hằng ngày vào trang web của bạn tương đối ít, chẳng hạn như 100.000 lượt trở xuống, bạn nên điều chỉnh tỷ lệ lấy mẫu ở mức cao hơn. Điều này sẽ làm tăng độ chi tiết của thời gian tải trang và các chỉ số khác về Tốc độ trang web. (Hãy xem bài viết Tốc độ trang web trong Trung tâm trợ giúp để biết thông tin chi tiết về báo cáo Tốc độ trang web.)

Phương thức _setSiteSpeedSampleRate() phải được gọi trước _trackPageview() thì mới có hiệu lực.

Analytics giới hạn số lượt truy cập thu thập Tốc độ trang web cho một tài sản ở mức tối đa là 1% người dùng hoặc 10.000 lượt truy cập mỗi ngày để đảm bảo phân bổ tài nguyên hệ thống một cách công bằng cho tính năng này.

Lưu ý: Chúng tôi đặc biệt khuyến khích các trang web có hơn 1 triệu lượt truy cập mỗi ngày nên đặt lựa chọn mẫu ở tỷ lệ 1% mặc định. Việc điều chỉnh kích thước mẫu lên một số lớn hơn sẽ không làm tăng kích thước mẫu của bạn.

Đoạn mã không đồng bộ (được đề xuất) 

_gaq.push(['_setSiteSpeedSampleRate', 5]);
_gaq.push(['_trackPageview']);

tham số

Number sampleRate Giá trị nằm trong khoảng từ 0 đến 100 để xác định tỷ lệ phần trăm khách truy cập vào trang web của bạn sẽ được đo lường cho mục đích Tốc độ trang web. Ví dụ: giá trị 5 sẽ thiết lập mẫu thu thập Tốc độ trang web thành 5%.

_setVisitorCookieHTTPS()

_setVisitorCookieTimeout(cookieTimeoutMillis)

Đặt thời hạn của cookie khách truy cập Google Analytics tính bằng mili giây. Theo mặc định, cookie của khách truy cập được đặt sẽ hết hạn sau 2 năm. Nếu muốn, bạn có thể thay đổi ngày hết hạn của cookie của khách truy cập bằng phương pháp này. Bạn có thể thay đổi thời gian chờ hết hạn thành 0 để cho biết rằng cần xoá cookie này khi trình duyệt đóng.

Đoạn mã không đồng bộ (được đề xuất) 

_gaq.push(['_setVisitorCookieTimeout', 63072000000]);

tham số

Number cookieTimeoutMillis Thời gian hết hạn của cookie cho khách truy cập mới tính bằng mili giây hoặc 0 để xoá cookie khi trình duyệt đóng.

_setVar()

_setVar(newVal)

Phương pháp này không được dùng nữa. Thay vào đó, hãy sử dụng _setCustomVar().

Đặt hoặc xác định phân đoạn khách truy cập tùy chỉnh bằng chuỗi được cung cấp. Bạn có thể sử dụng giá trị này để cung cấp phân đoạn bổ sung về người dùng cho trang web của mình. Ví dụ: bạn có thể có một trang đăng nhập hoặc một biểu mẫu kích hoạt giá trị dựa trên thông tin mà khách truy cập nhập, chẳng hạn như lựa chọn ưu tiên mà khách truy cập chọn hoặc tuỳ chọn về quyền riêng tư. Sau đó, biến này sẽ được cập nhật trong cookie cho khách truy cập đó. Khi được triển khai trên trang web của bạn và dữ liệu được thu thập thông qua phương thức này, phân khúc mới xác định sẽ xuất hiện trong báo cáo Người dùng xác định trong mục Khách truy cập của Báo cáo Analytics. Ngoài ra, bạn có thể truy cập vào phân đoạn Giá trị do người dùng xác định trong báo cáo Chi tiết nội dung để xem tỷ lệ phần trăm khách truy cập vào một trang thuộc về một phân đoạn cụ thể mà bạn xác định.

tham số

String newVal Giá trị mới do người dùng xác định cần đặt.

_trackPageLoadTime()

_trackPageLoadTime()

Phương thức này không được dùng nữa vì tính năng báo cáo Tốc độ trang web được bật tự động cho tất cả người dùng. Vui lòng sử dụng _setSiteSpeedSampleRate() để điều chỉnh tốc độ lấy mẫu cho báo cáo Tốc độ trang web.

Bật báo cáo Tốc độ trang web cho trang này. Chèn phương thức này cho mọi trang trên trang web của bạn mà bạn muốn báo cáo Tốc độ trang web. Để biết thêm thông tin về báo cáo Tốc độ trang web trong Analytics, hãy xem bài viết về Tốc độ trang web trong Trung tâm trợ giúp của chúng tôi.

Xác minh các thay đổi của bạn

Nếu bạn thấy dữ liệu xuất hiện trong các báo cáo, thì tức là bạn đã thiết lập đúng. Nếu bạn không thấy dữ liệu sau 24 giờ, hãy kiểm tra chế độ tuỳ chỉnh của bạn để đảm bảo bạn không tạo lỗi. Xem phần Khắc phục sự cố mã theo dõi để biết danh sách các lỗi mã theo dõi phổ biến. Hướng dẫn khắc phục sự cố này cũng cung cấp Các bước gỡ lỗi cơ bản và thông tin khác về cách gỡ lỗi.

Hãy lưu ý rằng việc kích hoạt theo dõi Tốc độ trang web cho trang web của bạn sẽ tạo ra một yêu cầu bổ sung cho các máy chủ của Google Analytics, ngoài yêu cầu GIF theo dõi trang được tạo đối với số lần xem trang. Để giảm thiểu tác động đến thời gian chờ tổng thể của trang, yêu cầu này chỉ được gửi đi vào một lần lấy mẫu số lần xem trang đối với trang web của bạn. Vì lý do này, bạn không thể luôn nhìn thấy yêu cầu GIF tốc độ trang web khi cố gắng gỡ lỗi tính năng này bằng Firebug hoặc các công cụ khác. Đây là điều bình thường và được dự kiến.

Đoạn mã không đồng bộ (được đề xuất) 

_gaq.push(['_setAccount', 'UA-12345-1']);
_gaq.push(['_trackPageview']);
_gaq.push(['_trackPageLoadTime']);

_trackPageview()

_trackPageview(opt_pagePath)

Logic chính cho GATC (Mã theo dõi phân tích của Google). Nếu bạn bật chức năng liên kết, hệ thống sẽ cố gắng trích xuất các giá trị cookie từ URL. Nếu không, trình phân tích cú pháp sẽ cố trích xuất các giá trị cookie từ document.cookie. Lớp này cũng cập nhật hoặc tạo cookie khi cần, sau đó ghi lại các cookie này vào đối tượng tài liệu. Thu thập tất cả chỉ số thích hợp để gửi đến UCFE (Giao diện người dùng Urchin Collector).

Đoạn mã không đồng bộ (được đề xuất) 

_gaq.push(['_setAccount', 'UA-12345-1']);
_gaq.push(['_trackPageview', '/home/landingPage']);

tham số

String opt_pagePath Tham số không bắt buộc để cho biết đường dẫn của trang cần theo dõi các chỉ số. Khi sử dụng tuỳ chọn này, hãy dùng dấu gạch chéo ở đầu (/) để biểu thị đường dẫn trang.