Kể từ ngày 1 tháng 7 năm 2023, các tài sản Universal Analytics (UA) chuẩn đã ngừng xử lý dữ liệu. Tài sản UA 360 sẽ ngừng xử lý dữ liệu kể từ ngày 1 tháng 7 năm 2024, và một số tính năng của UA 360 sẽ ngừng hoạt động trước thời điểm đó khi chúng tôi chuyển sang Google Analytics 4. Thêm Google Analytics 4 vào phương thức triển khai hiện tại.

Trang này được dịch bởi Cloud Translation API.

So sánh cú pháp

Tài liệu này trình bày hình minh hoạ mã theo dõi cho nhiều cách tuỳ chỉnh hoạt động theo dõi phổ biến. Nếu đoạn mã theo dõi Google Analytics của bạn chứa đánh dấu urchin.js hoặc cú pháp ga.js truyền thống, hãy sử dụng hướng dẫn này để di chuyển theo dõi của bạn sang đoạn mã Không đồng bộ được cải tiến.

Di chuyển sang tính năng theo dõi không đồng bộ

Tốt nhất là bạn nên sao chép và lưu các nội dung tuỳ chỉnh mã theo dõi hiện có vào một tệp văn bản (không phải tài liệu trình xử lý văn bản). Với bản sao dự phòng, bạn có thể đảm bảo rằng mình đã di chuyển tất cả các yếu tố tuỳ chỉnh cho trang web của mình.

Để chuyển đổi các trang của bạn nhằm sử dụng đoạn mã không đồng bộ:

Xóa đoạn mã theo dõi hiện tại của bạn và bất kỳ tùy chỉnh nào bạn đã thực hiện.
Để giảm lỗi, bạn nên xóa đoạn mã theo dõi hiện có khỏi tệp include hoặc cơ chế chèn đoạn mã đó vào các trang web của mình. Bạn có thể dán đoạn mã theo dõi hiện có vào tệp văn bản để theo dõi bất kỳ phương pháp tuỳ chỉnh nào mà bạn sử dụng.
Chèn đoạn mã không đồng bộ ở cuối mục <head> của trang, sau bất kỳ tập lệnh nào khác mà trang hoặc mẫu của bạn có thể sử dụng.
Một trong các ưu điểm chính của đoạn mã không đồng bộ là bạn có thể đặt đoạn mã ở đầu tài liệu HTML. Điều này làm tăng khả năng biểu tượng theo dõi sẽ được gửi trước khi người dùng rời khỏi trang. Chúng tôi nhận thấy rằng trên hầu hết các trang, vị trí tối ưu cho đoạn mã không đồng bộ là ở cuối phần <head>, ngay trước thẻ đóng </head>.
Sửa đổi phương thức _setAccount bằng mã tài sản web.

Để biết thêm thông tin về mã thuộc tính web, hãy xem phần "Thuộc tính web" trong tài liệu về Tài khoản và chế độ xem (Hồ sơ).
Thêm lại các nội dung tuỳ chỉnh của bạn bằng cách sử dụng cú pháp không đồng bộ. Sử dụng các cách tuỳ chỉnh được mô tả trong phần còn lại của hướng dẫn này. Xem Hướng dẫn sử dụng tính năng theo dõi không đồng bộ để biết thông tin chi tiết về mã theo dõi không đồng bộ.

Lưu ý: Để đảm bảo đoạn mã không đồng bộ hoạt động hợp lý nhất so với các tập lệnh khác, bạn nên đặt các tập lệnh khác trong trang web của mình theo một trong những cách sau:

Trước đoạn mã theo dõi trong phần <head> của HTML
Sau cả đoạn mã theo dõi và tất cả nội dung trang (ví dụ: ở cuối nội dung HTML)

Nếu không thể, bạn vẫn có thể đặt đoạn mã không đồng bộ ở cuối trang. Bạn cũng có thể phân tách đoạn mã để giữ lại một số lợi ích của tính năng theo dõi không đồng bộ.

Theo dõi trang cơ bản

Tính năng theo dõi trang cơ bản là nơi tốt nhất để tự làm quen với cú pháp không đồng bộ. Các ví dụ này giúp thiết lập đối tượng theo dõi bằng đúng tài khoản và gọi phương thức theo dõi trang.

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

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

Đoạn mã truyền thống (ga.js)

var pageTracker = _gat._getTracker('UA-XXXXX-X');
pageTracker._trackPageview();

Theo dõi urchin.js

_uacct = "UA-XXXXX-X";
urchinTracker();

Trở lại đầu trang

Phát hiện chế độ cài đặt của trình duyệt

Các ví dụ này minh hoạ các tuỳ chỉnh cài đặt của trình duyệt như tắt tính năng phát hiện Flash, tắt tính năng phát hiện phiên bản/tên trình duyệt, v.v.

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

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_setClientInfo', false]);
_gaq.push(['_setAllowHash', false]);
_gaq.push(['_setDetectFlash', false]);
_gaq.push(['_setDetectTitle', false]);
_gaq.push(['_trackPageview']);

Đoạn mã truyền thống (ga.js)

var pageTracker = _gat._getTracker('UA-XXXXX-X');
pageTracker._setClientInfo(false);
pageTracker._setAllowHash(false);
pageTracker._setDetectFlash(false);
pageTracker._setDetectTitle(false);
pageTracker._trackPageview();

Theo dõi urchin.js

_uacct = "UA-XXXXX-X";
_ufsc = 0;    // track browser info
_uhash = "on"; // (on|off) unique domain hash for cookies
_uflash = 0;  // detect Flash version
_utitle = 0;  // track title in reports
urchinTracker();

Trở lại đầu trang

Thời gian của chiến dịch

Theo mặc định, thời hạn của một chiến dịch trên Google Ads được đặt là 6 tháng. Bạn có thể điều chỉnh thời lượng của chiến dịch bằng cách sử dụng phương thức _setCampaignCookieTimeout().

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

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

Đoạn mã truyền thống (ga.js)

var pageTracker = _gat._getTracker('UA-XXXXX-X');
pageTracker._setCampaignCookieTimeout(31536000000);
pageTracker._trackPageview();

Theo dõi urchin.js

_uacct = "UA-XXXXX-X";
_ucto = "31536000"; // the number of seconds in 1 year
urchinTracker();
</script>

Trở lại đầu trang

Trường chiến dịch — Tuỳ chỉnh

Google Analytics tự động thu thập dữ liệu Google Ads nếu bạn đã liên kết tài khoản Google Ads với tài khoản Analytics của mình. Để theo dõi đường liên kết từ khoá qua các nguồn quảng cáo khác hoặc từ chiến dịch tiếp thị qua email hay các nguồn tương tự, bạn có thể tạo trường chiến dịch tuỳ chỉnh bằng cách sử dụng các phương thức bên dưới. Để biết thêm thông tin chi tiết, hãy xem phần "Theo dõi chiến dịch" trong hướng dẫn Nguồn lưu lượng truy cập.

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

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_setCampNameKey', 'ga_campaign']);    // name
_gaq.push(['_setCampMediumKey', 'ga_medium']);    // medium
_gaq.push(['_setCampSourceKey', 'ga_source']);    // source
_gaq.push(['_setCampTermKey', 'ga_term']);        // term/keyword
_gaq.push(['_setCampContentKey', 'ga_content']);  // content
_gaq.push(['_setCampNOKey', 'ga_nooverride']);    // don't override
_gaq.push(['_trackPageview']);

Đoạn mã truyền thống (ga.js)

var pageTracker = _gat._getTracker('UA-XXXXX-X');
pageTracker._setCampNameKey('ga_campaign');       // name
pageTracker._setCampMediumKey('ga_medium');       // medium
pageTracker._setCampSourceKey('ga_source');       // source
pageTracker._setCampTermKey('ga_term');           // term/keyword
pageTracker._setCampContentKey('ga_content');     // content
pageTracker._setCampNOKey('ga_nooverride');       // don't override
pageTracker._trackPageview();

Theo dõi urchin.js

_uacct = "UA-12345-1";
_uccn = "ga_campaign"; // name [default: utm_campaign]
_ucmd = "ga_medium"; // medium [default: utm_medium]
_ucsr = "ga_source"; // source [default: utm_source]
_uctr = "ga_term"; // term/keyword [default: utm_term]
_ucct = "ga_content"; // content [default: utm_content]
_ucid = "ga_id"; // id number [default: utm_id]
_ucno = "ga_nooverride"; // don't override [default: utm_nooverride]
urchinTracker();

Trở lại đầu trang

Theo dõi chiến dịch — Bị vô hiệu

Google Analytics tự động bật tính năng theo dõi chiến dịch, nhưng bạn có thể tắt tính năng này bằng cách sử dụng phương pháp _setCampaignTrack().

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

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_setCampaignTrack', false]);    // Turn off campaign tracking
_gaq.push(['_trackPageview']);

Đoạn mã truyền thống (ga.js)

var pageTracker = _gat._getTracker('UA-XXXXX-X');
pageTracker._setCampaignTrack(false);       // Turn off campaign tracking
pageTracker._trackPageview();

Theo dõi urchin.js

_uacct = "UA-12345-1";
_uctm = "disable";
urchinTracker();

Trở lại đầu trang

Liên kết nhiều miền

Để theo dõi lưu lượng truy cập trên nhiều miền, bạn có thể sử dụng hàm _setAllowLinker() để theo dõi lượt nhấp của người dùng giữa hai miền. Để biết thông tin chi tiết về cách thiết lập tính năng theo dõi trên nhiều miền, hãy xem bài viết Theo dõi trên nhiều miền.

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

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_setDomainName', 'none']);
_gaq.push(['_setAllowLinker', true]);
_gaq.push(['_trackPageview']);
...
<a href="http://example.com/test.html"
onclick="_gaq.push(['_link', 'http://example.com/test.html']); return false;">click me</a>

Đoạn mã truyền thống (ga.js)

var pageTracker = _gat._getTracker('UA-XXXXX-X');
pageTracker._setDomainName('none');
pageTracker._setAllowLinker(true);
pageTracker._trackPageview();
...
<a href="http://example.com/test.html"
onclick="pageTracker._link('http://example.com/test.html'); return false;">click me</a>

Theo dõi urchin.js

_uacct = "UA-12345-1";
_udn = "none";
_ulink = 1;
urchinTracker();

...
<a href="http://newsite.com/test.html"
onclick="__utmLinker('http://newsite.com/test.html'); return false;">click me</a>

Trở lại đầu trang

Dữ liệu trong biểu mẫu trên nhiều miền

Bạn có thể sử dụng phương thức _linkByPost() để chuyển dữ liệu người dùng từ một miền sang một miền khác, trong đó tính năng theo dõi tên miền chéo được bật cho cả hai miền. Để biết thông tin chi tiết về cách thiết lập tính năng theo dõi trên nhiều miền, hãy xem bài viết Theo dõi trên nhiều miền.

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

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_setDomainName', 'none']);
_gaq.push(['_setAllowLinker', true]);
_gaq.push(['_trackPageview']);
...
<form name="f" method="post" onsubmit="_gaq.push(['_linkByPost', this]);">
...
</form>

Đoạn mã truyền thống (ga.js)

var pageTracker = _gat._getTracker('UA-XXXXX-X');
pageTracker._setDomainName('none');
pageTracker._setAllowLinker(true);
pageTracker._trackPageview();
...
<form name="f" method="post" onsubmit="pageTracker._linkByPost(this);">
...
</form>

Theo dõi urchin.js

_uacct = "UA-12345-1";
_udn = "none";
_ulink = 1;
urchinTracker();
...
<form name="f" method="post" onsubmit="__utmLinkPost(this)">
...
</form>

Trở lại đầu trang

Theo dõi thương mại điện tử

Theo dõi thương mại điện tử bao gồm việc gọi ba phương thức chính trong thiết lập theo dõi. Hãy xem phần Theo dõi thương mại điện tử để biết thông tin chi tiết.

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

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_trackPageview']);
_gaq.push(['_addTrans',
  '1234',           // order ID - required
  'Mountain View',  // affiliation or store name
  '11.99',          // total - required
  '1.29',           // tax
  '5',              // shipping
  'San Jose',       // city
  'California',     // state or province
  'USA'             // country
]);
_gaq.push(['_addItem',
  '1234',           // order ID - required
  'DD44',           // SKU/code
  'T-Shirt',        // product name
  'Green Medium',   // category or variation
  '11.99',          // unit price - required
  '1'               // quantity - required
]);
_gaq.push(['_trackTrans']);

Đoạn mã truyền thống (ga.js)

var pageTracker = _gat._getTracker('UA-XXXXX-X');
pageTracker._trackPageview();
pageTracker._addTrans(
  '1234',           // order ID - required
  'Mountain View',  // affiliation or store name
  '11.99',          // total - required
  '1.29',           // tax
  '5',              // shipping
  'San Jose',       // city
  'California',     // state or province
  'USA'             // country
);
pageTracker._addItem(
  '1234',           // order ID - required
  'DD44',           // SKU/code
  'T-Shirt',        // product name
  'Green Medium',   // category or variation
  '11.99',          // unit price - required
  '1'               // quantity - required
);
pageTracker._trackTrans();

Theo dõi urchin.js

_uacct = "UA-12345-1";
urchinTracker();
</script>
<form name="utmform" id="utmform">
<textarea name="utmtrans" id="utmtrans" style="display:none">
UTM:T|1234|Mountain View|11.99|1.29|5|San Jose|California|USA
UTM:I|1234|DD44|T-Shirt|Green Medium|11.99|1
</textarea>
</form>
<script type="text/javascript">
__utmSetTrans();

Trở lại đầu trang

Theo dõi sự kiện

Khi sử dụng tính năng Theo dõi sự kiện, bạn cần thực hiện một lệnh gọi sự kiện ở vị trí thích hợp trong các trang, chẳng hạn như trong trình xử lý onclick. Để biết thêm thông tin về tính năng Theo dõi sự kiện, hãy xem Hướng dẫn theo dõi sự kiện. Lưu ý: Tính năng Theo dõi sự kiện không khả dụng với mã theo dõi urchin.js.

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

Phần này cho thấy hai cách để thiết lập tính năng theo dõi bằng cú pháp Không đồng bộ. Với tính năng Theo dõi sự kiện, trình xử lý onclick cũng sử dụng cú pháp giống như vậy.

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_trackPageview']);
...
<a onclick="_gaq.push(['_trackEvent', 'category', 'action', 'opt_label', opt_value]);">click me</a>

Đoạn mã truyền thống (ga.js)

var pageTracker = _gat._getTracker('UA-XXXXX-X');
pageTracker._trackPageview();
...
<a onclick="pageTracker._trackEvent('category', 'action', 'opt_label', opt_value);">click me</a>

Trở lại đầu trang

Hết thời gian chờ

Theo mặc định, phiên người dùng sẽ hết thời gian chờ sau 30 phút không hoạt động trên trang web của bạn. Những ví dụ này cho thấy cách sửa đổi đối tượng này bằng phương thức _setSessionCookieTimeout().

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

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

Đoạn mã truyền thống (ga.js)

var pageTracker = _gat._getTracker('UA-XXXXX-X');
pageTracker._setSessionCookieTimeout(3600000);
pageTracker._trackPageview();

Theo dõi urchin.js

<script type="text/javascript">
_uacct = "UA-12345-1";
_utimeout = "3600"; // the number of seconds in 1 hour
urchinTracker();
</script>

Trở lại đầu trang

Nguồn — Công cụ tìm kiếm, từ khoá, đường liên kết giới thiệu

Theo mặc định, Google Analytics sẽ xác định một danh sách các trang web dưới dạng lượt giới thiệu của công cụ tìm kiếm trong báo cáo của bạn. Bạn có thể sử dụng các phương thức này để thay đổi danh sách công cụ tìm kiếm. Để biết thêm thông tin, hãy xem phần "Công cụ tìm kiếm" trong hướng dẫn về Nguồn lưu lượng truy cập. Bạn cũng có thể định cấu hình Google Analytics để bỏ qua các lượt giới thiệu từ một số miền nhất định hoặc để coi các lượt tìm kiếm theo từ khoá cụ thể là lưu lượng truy cập trực tiếp.

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

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_addIgnoredOrganic', 'ignore']);
_gaq.push(['_addIgnoredRef', 'urchin.com']);
_gaq.push(['_addOrganic', 'new_search_engine', 'q']);
_gaq.push(['_trackPageview']);

Đoạn mã truyền thống (ga.js)

var pageTracker = _gat._getTracker('UA-XXXXX-X');
pageTracker._addIgnoredOrganic('ignore');
pageTracker._addIgnoredRef('urchin.com');
pageTracker._addOrganic('new_search_engine','q');
pageTracker._trackPageview();

Theo dõi urchin.js

_uacct = "UA-12345-1";
_uOno[0] = "ignore"; // keyword to treat as referral
_uRno[0] = "urchin.com"; // referral to treat as direct
_uOsr[41] = "new_search_engine"; // new search engine to treat as referral
_uOkw[41] = "query"; // keyword query parameter for new search engine

urchinTracker();

Trở lại đầu trang

Theo dõi bị giới hạn trong một thư mục con

Sử dụng phương thức _setCookiePath() để đặt thư mục con làm đường dẫn mặc định cho tất cả hoạt động theo dõi. Bạn sẽ thực hiện việc này để giới hạn tất cả theo dõi tới một thư mục con của trang web.

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

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_setCookiePath', '/path/of/cookie/']);
_gaq.push(['_trackPageview']);

Đoạn mã truyền thống (ga.js)

var pageTracker = _gat._getTracker('UA-XXXXX-X');
pageTracker._setCookiePath('/path/of/cookie/');
pageTracker._trackPageview();

Theo dõi urchin.js

<script type="text/javascript">
_uacct = "UA-12345-1";
_utcp = "/path/of/cookie/";
urchinTracker();
</script>

Trở lại đầu trang

Sử dụng Máy chủ cục bộ

Sử dụng các phương pháp này nếu bạn đang theo dõi trang web của mình bằng cách sử dụng phần mềm Pointy độc lập và cũng sử dụng Google Analytics. Để biết thông tin chi tiết, hãy xem phần Máy chủUrchin trong tài liệu tham khảo về API theo dõi.

Đoạn mã không đồng bộ

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

Đoạn mã truyền thống (ga.js)

var pageTracker = _gat._getTracker('UA-XXXXX-X');
pageTracker._setLocalRemoteServerMode();
pageTracker._trackPageview();

Theo dõi urchin.js

_uacct = "UA-12345-1";
_userv = 0;
urchinTracker();

Trở lại đầu trang

Số lần xem trang ảo

Hãy sử dụng phương thức _trackPageview() cùng với một URL mà bạn đặt ra để theo dõi các lượt nhấp của những người dùng không dẫn đến các trang thực sự thuộc trang web của bạn. Nói chung, bạn nên sử dụng tính năng Theo dõi sự kiện để theo dõi các lượt tải xuống, đường liên kết ra ngoài, tệp PDF hoặc các loại tương tác tương tự của người dùng. Lý do là số lượt xem trang ảo sẽ làm tăng tổng số lượt xem trang của bạn.

Đoạn mã không đồng bộ

_gaq.push(['_trackPageview', '/downloads/pdfs/corporateBrief.pdf']);

Đoạn mã truyền thống (ga.js)

var pageTracker = _gat._getTracker('UA-XXXXX-X');
pageTracker._trackPageview('/downloads/pdfs/corporateBrief.pdf');

Theo dõi urchin.js

urchinTracker('/downloads/pdfs/corporateBrief.pdf');

Trở lại đầu trang