คู่มือนี้จะแนะนําขั้นตอนการย้ายข้อมูลการติดตั้งใช้งาน analytics.js
Universal Analytics ที่มีอยู่ไปใช้ gtag.js
ภาพรวม
analytics.js มีกลไกหลัก 2 อย่างในการส่งข้อมูลไปยัง Google Analytics ได้แก่
-
เครื่องมือติดตามจะระบุพร็อพเพอร์ตี้ที่คุณกำลังวัด
-
ประเภท Hit จะระบุประเภทการโต้ตอบที่คุณวัด
ในพร็อพเพอร์ตี้ gtag.js
จะมีการระบุผ่านคำสั่ง config
หรือแสดงเป็นพารามิเตอร์ในคำสั่ง
gtag.js ต่างจาก analytics.js ตรงที่ไม่ต้องใช้เครื่องมือติดตามเพื่อส่งข้อมูลไปยัง Google Analytics โดยจะส่งข้อมูลไปยังพร็อพเพอร์ตี้ Google Analytics ที่ระบุโดยรหัสซึ่งกำหนดโดยคำสั่ง config
ชื่อเหตุการณ์ที่ส่งไปยัง gtag.js จะระบุประเภทของข้อมูลที่ส่งไปยัง Google Analytics
หากต้องการย้ายข้อมูลจาก analytics.js ไปยัง gtag.js ให้ทำตามขั้นตอนต่อไปนี้สำหรับทุกหน้าในเว็บไซต์
แทนที่โค้ด analytics.js ด้วยโค้ด gtag.js ที่เทียบเท่าเป็นโค้ดต่อไปนี้
แทนที่ข้อมูลโค้ด analytics.js ด้วยข้อมูลโค้ด gtag.js
แทนที่ข้อมูลโค้ด analytics.js ในหน้าเว็บ โดยทำดังนี้
<!-- 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 -->
ด้วยข้อมูลโค้ด gtag.js ต่อไปนี้
<!-- 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>
วัดการดูหน้าเว็บ
analytics.js ใช้เครื่องมือติดตามเพื่อส่งการดูหน้าเว็บไปยัง Google Analytics เครื่องมือติดตามมีรหัสการวัดของพร็อพเพอร์ตี้ Google Analytics โดย gtag.js จะส่งการดูหน้าเว็บไปยังพร็อพเพอร์ตี้ Google Analytics ที่ระบุโดย TAG_ID
ที่ระบุในคำสั่ง config
วัดการดูหน้าเว็บด้วยตัวติดตามเริ่มต้น
นำโค้ด analytics.js ต่อไปนี้ที่ใช้เครื่องมือติดตามเริ่มต้นออกจากการดูหน้าเว็บ send
ไปยัง 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');
โค้ดต่อไปนี้ในข้อมูลโค้ด gtag.js จะส่งการดูหน้าเว็บไปยังพร็อพเพอร์ตี้ Google Analytics โดยอัตโนมัติที่มีรหัสแท็ก TAG_ID
gtag('config', 'TAG_ID');
วัดการดูหน้าเว็บด้วยเครื่องมือติดตามที่ระบุ
แทนที่โค้ด analytics.js ต่อไปนี้ที่ใช้เครื่องมือติดตามที่ระบุเพื่อส่งการดูหน้าเว็บไปยัง Google Analytics
ga('create', 'TAG_ID', 'auto', 'trackerName');
ga('trackerName.send', 'pageview');
ด้วยคําสั่ง event
ของ gtag.js ต่อไปนี้
gtag('event', 'page_view', { 'send_to': 'TAG_ID' });
วัดเหตุการณ์
ตามที่กล่าวไว้ก่อนหน้านี้ analytics.js ใช้ตัวติดตามเพื่อส่งเหตุการณ์ไปยัง Google Analytics เครื่องมือติดตามมีรหัสติดตามของพร็อพเพอร์ตี้ Google Analytics ในทางตรงกันข้าม gtag.js จะส่งเหตุการณ์ไปยังพร็อพเพอร์ตี้ Google Analytics ที่ TAG_ID
ระบุไว้ในคำสั่ง config
วัดเหตุการณ์ด้วยตัวติดตามเริ่มต้น
แทนที่โค้ด analytics.js ต่อไปนี้ที่ใช้เครื่องมือติดตามเริ่มต้นในการบันทึกเหตุการณ์ send
ไปยัง Google Analytics
ga('create', 'TAG_ID', 'auto');
ga('send', 'event', [eventCategory], [eventAction], [eventLabel], [eventValue], [fieldsObject]);
ด้วยคำสั่ง
gtag.js event
ต่อไปนี้
gtag('event', eventName, eventParameters);
โดยที่ eventName
คือชื่อของเหตุการณ์ที่ต้องการบันทึก
ตัวอย่าง
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'
});
วัดเหตุการณ์ด้วยเครื่องมือติดตามที่ระบุ
แทนที่โค้ด analytics.js ต่อไปนี้ที่ใช้เครื่องมือติดตามที่ระบุเพื่อส่งเหตุการณ์ไปยัง Google Analytics
ga('create', 'TAG_ID', 'auto', 'trackerName');
ga('trackerName.send', 'event', [eventCategory], [eventAction], [eventLabel], [eventValue], [fieldsObject]);
ด้วยคําสั่ง event
ของ gtag.js ต่อไปนี้
gtag('event', eventName, {
'send_to': 'TAG_ID',
'parameter1': 'value1',
'parameter2': 'value2',
// ...
});
ตัวอย่าง
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'
});
ส่งมิติข้อมูลและเมตริกที่กําหนดเอง
แทนที่คำสั่ง send
ของ analytics.js ในหน้าเว็บที่ส่งมิติข้อมูลที่กำหนดเองมายัง Google Analytics ดังนี้
ga('send', 'hitType', { 'dimension<Index>': 'dimension_value'});
ด้วยรหัส gtag.js ต่อไปนี้
gtag('config', 'TAG_ID', {
'custom_map': {'dimension<Index>': 'dimension_name'}
});
gtag('event', 'any_event_name', {'dimension_name': 'dimension_value'});
แทนที่ TAG_ID
ด้วยรหัส Analytics ของคุณเอง
แทนที่คำสั่ง send
ใน analytics.js ในหน้าเว็บที่ส่งเมตริกที่กำหนดเองไปยัง Google Analytics ดังนี้
ga('send', 'hitType', { 'metric<Index>': 'metric_value'});
ด้วยรหัส gtag.js ต่อไปนี้
gtag('config', 'TAG_ID', {
'custom_map': {'metric<Index>': 'metric_name'}
});
gtag('event', 'any_event_name', {'metric_name': 'metric_value'});
แทนที่ TAG_ID
ด้วยรหัสแท็ก
วัดระยะเวลาของผู้ใช้
แทนที่คำสั่ง send
analytics.js ในหน้าเว็บที่ติดตามระยะเวลาของผู้ใช้ โดยทำดังนี้
ga('send', 'timing', 'timingCategory', 'timingVar', timingValue, 'timingLabel');
ด้วยคำสั่ง
gtag.js event
ต่อไปนี้
gtag('event', 'timing_complete', {
'name': 'timingVar',
'value': timingValue,
'event_category': 'timingCategory',
'event_label': 'timingLabel'
});
วัดข้อยกเว้น
แทนที่คำสั่ง send
ใน analytics.js ในหน้าเว็บที่ติดตามข้อยกเว้น โดยทำดังนี้
ga('send', 'exception', {
'exDescription': 'error_message',
'exFatal': false // set to true if the exception is fatal
});
ด้วยคําสั่ง gtag.js event
ต่อไปนี้
gtag('event', 'exception', {
'description': 'error_message',
'fatal': false // set to true if the exception is fatal
});
แมปช่อง analytics.js กับพารามิเตอร์ gtag.js
ตารางต่อไปนี้แมปช่อง analytics.js กับพารามิเตอร์ gtag.js ที่เกี่ยวข้อง
กิจกรรม
ช่อง analytics.js | พารามิเตอร์ gtag.js |
---|---|
eventAction |
event_action |
eventCategory |
event_category |
eventLabel |
event_label |
eventValue |
value |
มิติข้อมูลและเมตริกที่กำหนดเอง
ช่อง analytics.js | พารามิเตอร์ gtag.js |
---|---|
dimension<Index> |
dimension<Index> |
metric<Index> |
metric<Index> |
โดยที่ <Index>
เป็นจำนวนเต็มที่ไม่เป็นลบซึ่งแสดงดัชนีของมิติข้อมูลหรือเมตริกที่กำหนดเอง
ระยะเวลาของผู้ใช้
ช่อง analytics.js | พารามิเตอร์ gtag.js |
---|---|
timingCategory |
event_category |
timingLabel |
event_label |
timingValue |
value |
timingVar |
name |
การวัดข้อยกเว้น
ช่อง analytics.js | พารามิเตอร์ gtag.js |
---|---|
exDescription |
description |
exFatal |
fatal |
ข้อมูลการดำเนินการของอีคอมเมิร์ซที่เพิ่มประสิทธิภาพ
ช่อง analytics.js | พารามิเตอร์ gtag.js |
---|---|
id |
transaction_id |
affiliation |
affiliation |
revenue |
value |
tax |
tax |
shipping |
shipping |
coupon |
coupon |
list |
list_name |
step |
checkout_step |
option |
checkout_option |
ข้อมูลโปรโมชัน
ช่อง analytics.js | พารามิเตอร์ gtag.js |
---|---|
creative |
creative_name |
position (การแสดงผล, ผลิตภัณฑ์) |
list_position |
position (โปรโมชัน) |
creative_slot |
การดำเนินการเกี่ยวกับผลิตภัณฑ์และโปรโมชัน
ช่อง analytics.js | เหตุการณ์ gtag.js |
---|---|
add |
add_to_cart |
checkout (ขั้นตอนแรก) |
begin_checkout |
checkout (ขั้นตอนอื่นๆ ที่ตามมา) |
checkout_progress |
checkout_option |
set_checkout_option |
click |
select_content (ไม่มีโปรโมชัน) |
detail |
view_item |
promo_click |
select_content (มีโปรโมชัน) |
purchase |
purchase |
refund |
refund |
remove |
remove_from_cart |
Client-ID และ User-ID
ช่อง analytics.js | พารามิเตอร์ gtag.js |
---|---|
clientId |
client_id |
userId |
user_id |