Hướng dẫn này trình bày quy trình di chuyển analytics.js
phương thức triển khai Universal Analytics hiện tại để sử dụng gtag.js
.
Tổng quan
analytics.js có hai cơ chế chính để gửi dữ liệu đến Google Analytics:
-
Các trình theo dõi cho biết tài sản mà bạn đang đo lường.
-
Các loại lượt truy cập cho biết loại tương tác mà bạn đang đo lường.
Trong các thuộc tính gtag.js
được chỉ định thông qua lệnh config
hoặc dưới dạng tham số đối với lệnh.
Không giống như analytics.js, gtag.js không sử dụng trình theo dõi để gửi dữ liệu đến Google
Analytics. Phương thức này gửi dữ liệu đến các tài sản Google Analytics được xác định bằng mã nhận dạng do lệnh config
đặt. Tên sự kiện được cung cấp cho gtag.js chỉ định
các loại dữ liệu sẽ được gửi đến Google Analytics.
Để di chuyển từ analytics.js sang gtag.js, hãy làm như sau cho mỗi trang trên trang web của bạn:
Thay thế mã analytics.js bằng mã gtag.js tương đương để:
Thay thế đoạn mã analytics.js bằng đoạn mã gtag.js
Thay thế đoạn mã analytics.js trong trang web:
<!-- Google Analytics -->
<script>
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
})(window,document,'script','https://www.google-analytics.com/analytics.js','ga');
ga('create', 'TAG_ID', 'auto');
ga('send', 'pageview');
</script>
<!-- End Google Analytics -->
bằng đoạn mã gtag.js sau:
<!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=TAG_ID"></script>
<script>
window.dataLayer = window.dataLayer || [];
function gtag(){dataLayer.push(arguments);}
gtag('js', new Date());
gtag('config', 'TAG_ID');
</script>
Đo lường lượt xem trang
analytics.js sử dụng trình theo dõi để gửi lượt xem trang đến Google Analytics. Trình theo dõi có Mã đo lường của một tài sản Google Analytics. gtag.js sẽ gửi lượt xem trang đến một tài sản Google Analytics được xác định bằng TAG_ID
được chỉ định trong lệnh config
.
Đo lường lượt xem trang bằng trình theo dõi mặc định
Xoá mã analytics.js sau đây (sử dụng trình theo dõi mặc định cho lượt xem trang send
đối với Google Analytics):
// Creates the default tracker.
ga('create', 'TAG_ID', 'auto');
// Uses the default tracker to send a pageview to the
// Google Analytics property with tag ID of 'TAG_ID'.
ga('send', 'pageview');
Mã sau đây trong đoạn mã gtag.js sẽ tự động gửi một
lượt xem trang đến tài sản Google Analytics có mã thẻ là TAG_ID
:
gtag('config', 'TAG_ID');
Đo lường lượt xem trang bằng các trình theo dõi được chỉ định
Thay thế mã analytics.js sau đây (sử dụng trình theo dõi được chỉ định để gửi lượt xem trang đến Google Analytics):
ga('create', 'TAG_ID', 'auto', 'trackerName');
ga('trackerName.send', 'pageview');
bằng lệnh event
gtag.js sau đây:
gtag('event', 'page_view', { 'send_to': 'TAG_ID' });
Đo lường các sự kiện
Như đã đề cập trước đó, analytics.js sử dụng trình theo dõi để gửi sự kiện đến Google
Analytics. Trình theo dõi có mã theo dõi của một tài sản Google Analytics. Ngược lại, gtag.js sẽ gửi các sự kiện đến một tài sản Google Analytics được xác định bằng
TAG_ID
được chỉ định trong lệnh config
.
Đo lường các sự kiện bằng trình theo dõi mặc định
Thay thế mã analytics.js sau đây (sử dụng trình theo dõi mặc định cho các sự kiện send
thành Google Analytics):
ga('create', 'TAG_ID', 'auto');
ga('send', 'event', [eventCategory], [eventAction], [eventLabel], [eventValue], [fieldsObject]);
bằng lệnh gtag.js event
sau:
gtag('event', eventName, eventParameters);
trong đó eventName
là tên của sự kiện bạn muốn ghi nhật ký.
Ví dụ:
analytics.js:
// Creates the default tracker.
ga('create', 'TAG_ID', 'auto');
// Uses the default tracker to send the event to the
// Google Analytics property with a tag ID of `TAG_ID`.
ga('send', 'event', 'Videos', 'play', 'Fall Campaign');
gtag.js:
// Sends the event to the Google Analytics property with a
// tag ID of `TAG_ID` set by the config command in
// the gtag.js snippet.
gtag('event', 'play', {
'event_category': 'Videos',
'event_label': 'Fall Campaign'
});
Đo lường các sự kiện bằng trình theo dõi được chỉ định
Thay thế mã analytics.js sau đây (sử dụng trình theo dõi được chỉ định để gửi sự kiện đến Google Analytics):
ga('create', 'TAG_ID', 'auto', 'trackerName');
ga('trackerName.send', 'event', [eventCategory], [eventAction], [eventLabel], [eventValue], [fieldsObject]);
bằng lệnh event
gtag.js sau đây:
gtag('event', eventName, {
'send_to': 'TAG_ID',
'parameter1': 'value1',
'parameter2': 'value2',
// ...
});
Ví dụ:
analytics.js:
// Creates a tracker named <b>clientTracker</b>.
ga('create', 'TAG_ID', 'auto', 'clientTracker');
// Uses tracker clientTracker to send the event to the
// Google Analytics property with a tag ID of TAG_ID.
ga('clientTracker.send', 'event', 'Videos', 'play', 'Fall Campaign');
gtag.js:
// Send the event to the Google Analytics property
// with a tag ID of 'TAG_ID'.
gtag('event', 'play', {
'send_to': 'TAG_ID',
'event_category': 'Videos',
'event_label': 'Fall Campaign'
});
Gửi phương diện và chỉ số tuỳ chỉnh
Thay thế bất kỳ lệnh send
analytics.js nào trong các trang web
gửi phương diện tùy chỉnh đến Google Analytics:
ga('send', 'hitType', { 'dimension<Index>': 'dimension_value'});
bằng mã gtag.js sau đây:
gtag('config', 'TAG_ID', {
'custom_map': {'dimension<Index>': 'dimension_name'}
});
gtag('event', 'any_event_name', {'dimension_name': 'dimension_value'});
Thay thế TAG_ID
bằng mã Analytics của riêng bạn.
Thay thế bất kỳ lệnh send
analytics.js nào trong các trang web
gửi chỉ số tùy chỉnh đến Google Analytics:
ga('send', 'hitType', { 'metric<Index>': 'metric_value'});
bằng mã gtag.js sau đây:
gtag('config', 'TAG_ID', {
'custom_map': {'metric<Index>': 'metric_name'}
});
gtag('event', 'any_event_name', {'metric_name': 'metric_value'});
Thay thế TAG_ID
bằng mã thẻ.
Đo lường thời gian người dùng
Thay thế mọi lệnh send
analytics.js trong các trang web
theo dõi thời gian của người dùng:
ga('send', 'timing', 'timingCategory', 'timingVar', timingValue, 'timingLabel');
bằng lệnh gtag.js event
sau:
gtag('event', 'timing_complete', {
'name': 'timingVar',
'value': timingValue,
'event_category': 'timingCategory',
'event_label': 'timingLabel'
});
Đo lường các trường hợp ngoại lệ
Thay thế mọi lệnh send
analytics.js trong các trang web
theo dõi ngoại lệ:
ga('send', 'exception', {
'exDescription': 'error_message',
'exFatal': false // set to true if the exception is fatal
});
bằng lệnh gtag.js event
sau:
gtag('event', 'exception', {
'description': 'error_message',
'fatal': false // set to true if the exception is fatal
});
Liên kết các trường analytics.js với thông số gtag.js
Các bảng sau đây liên kết các trường analytics.js với các thông số gtag.js tương ứng.
Sự kiện
trường analytics.js | Thông số gtag.js |
---|---|
eventAction |
event_action |
eventCategory |
event_category |
eventLabel |
event_label |
eventValue |
value |
Phương diện và chỉ số tuỳ chỉnh
trường analytics.js | Thông số gtag.js |
---|---|
dimension<Index> |
dimension<Index> |
metric<Index> |
metric<Index> |
trong đó <Index>
là một số nguyên không âm biểu thị chỉ mục của thứ nguyên hoặc chỉ số tùy chỉnh.
Thời gian người dùng
trường analytics.js | Thông số gtag.js |
---|---|
timingCategory |
event_category |
timingLabel |
event_label |
timingValue |
value |
timingVar |
name |
Đo lường ngoại lệ
trường analytics.js | Thông số gtag.js |
---|---|
exDescription |
description |
exFatal |
fatal |
Dữ liệu hành động thương mại điện tử nâng cao
trường analytics.js | Thông số gtag.js |
---|---|
id |
transaction_id |
affiliation |
affiliation |
revenue |
value |
tax |
tax |
shipping |
shipping |
coupon |
coupon |
list |
list_name |
step |
checkout_step |
option |
checkout_option |
Dữ liệu khuyến mãi
trường analytics.js | Thông số gtag.js |
---|---|
creative |
creative_name |
position (lượt hiển thị, sản phẩm) |
list_position |
position (chương trình khuyến mãi) |
creative_slot |
Hành động đối với sản phẩm và chương trình khuyến mãi
trường analytics.js | Sự kiện gtag.js |
---|---|
add |
add_to_cart |
checkout (bước đầu tiên) |
begin_checkout |
checkout (bất kỳ bước tiếp theo nào) |
checkout_progress |
checkout_option |
set_checkout_option |
click |
select_content (không có chương trình khuyến mãi) |
detail |
view_item |
promo_click |
select_content (có chương trình khuyến mãi) |
purchase |
purchase |
refund |
refund |
remove |
remove_from_cart |
Client-ID và mã nhận dạng người dùng
trường analytics.js | Thông số gtag.js |
---|---|
clientId |
client_id |
userId |
user_id |