เกือบทุกอย่างที่คุณต้องการวัดด้วย analytics.js ได้โดยใช้คิวคําสั่ง ga() คู่มือนี้จะอธิบายความหมายของคิวคําสั่ง วิธีการทํางาน และวิธีใช้คําสั่งในการวัดการโต้ตอบของผู้ใช้
คิวคําสั่ง ga
แท็ก Google Analytics กําหนดฟังก์ชัน ga ส่วนกลางที่เรียกว่า "commandQueue" เราเรียกคําสั่งนี้ว่าคิวคําสั่ง เพราะจะเป็นการดําเนินการตามคําสั่งที่ได้รับทันที แต่จะเพิ่มคําสั่งนั้นลงในคิวที่ทําให้การดําเนินการล่าช้าจนกว่าไลบรารี analytics.js จะโหลดอย่างสมบูรณ์
นอกจากนี้ ใน JavaScript ฟังก์ชันต่างๆ ยังเป็นวัตถุ ซึ่งหมายความว่ามีพร็อพเพอร์ตี้ด้วย แท็ก Google Analytics กําหนดพร็อพเพอร์ตี้ q ในออบเจ็กต์ฟังก์ชัน ga เป็นอาร์เรย์ว่างเปล่า ก่อนที่จะมีการโหลดไลบรารี analytics.js การเรียกฟังก์ชัน ga() จะเพิ่มรายการอาร์กิวเมนต์ที่ส่งผ่านไปยังฟังก์ชัน ga() ต่อท้ายอาร์เรย์ q
ตัวอย่างเช่น หากคุณจะเรียกใช้แท็ก Google Analytics แล้วบันทึกเนื้อหาของ ga.q ลงในคอนโซลทันที คุณจะเห็นอาร์เรย์ ความยาว 2 รายการ ซึ่งมีอาร์กิวเมนต์ 2 ชุดที่ส่งไปยังฟังก์ชัน ga() อยู่แล้ว
console.log(ga.q);
// Outputs the following:
// [
// ['create', 'UA-XXXXX-Y', 'auto'],
// ['send', 'pageview']
// ]
เมื่อโหลดไลบรารี analytics.js แล้ว ไลบรารีนี้จะตรวจสอบเนื้อหาของอาร์เรย์ ga.q และดําเนินการแต่ละคําสั่งตามลําดับ หลังจากนั้นจะกําหนดฟังก์ชัน ga() ใหม่เพื่อให้การเรียกใช้ครั้งต่อๆ ไปทั้งหมดทํางานทันที
รูปแบบนี้จะช่วยให้นักพัฒนาแอปใช้คิวคําสั่ง ga() ได้โดยไม่ต้องกังวลว่าไลบรารี analytics.js จะโหลดเสร็จแล้ว โดยมีอินเทอร์เฟซที่เรียบง่ายและมีลักษณะเป็นซิงโครนัส ซึ่งจะตัดความซับซ้อนของโค้ดแบบอะซิงโครนัสออกไปได้เกือบทั้งหมด
การเพิ่มคําสั่งในคิว
การเรียกไปยังคิวคําสั่ง ga() ทั้งหมดจะใช้ลายเซ็นเดียวกัน พารามิเตอร์แรก คือ "command" คือสตริงที่ระบุเมธอด analytics.js ที่เฉพาะเจาะจง พารามิเตอร์เพิ่มเติมคืออาร์กิวเมนต์ที่ส่งไปยังเมธอดนั้น
คําสั่งหนึ่งๆ ที่อ้างถึงอาจเป็นเมธอดส่วนกลาง เช่น create, เมธอดใน ga ออบเจ็กต์ หรืออาจเป็นเมธอดอินสแตนซ์ในออบเจ็กต์เครื่องมือติดตาม เช่น send หากคิวคําสั่ง ga() ได้รับคําสั่งที่ไม่รู้จัก ก็จะไม่สนใจคําสั่งดังกล่าว การเรียกใช้ฟังก์ชัน ga() จะปลอดภัยอย่างยิ่งเพราะแทบจะไม่มีข้อผิดพลาดเกิดขึ้น
ดูรายการคําสั่งทั้งหมดที่ดําเนินการผ่านคิวคําสั่งได้โดยละเอียดที่การอ้างอิงคิวคําสั่ง ga()
พารามิเตอร์คําสั่ง
คําสั่ง analytics.js ส่วนใหญ่ (และวิธีที่เกี่ยวข้อง) ยอมรับพารามิเตอร์ในรูปแบบต่างๆ มากมาย เพื่อเป็นการอํานวยความสะดวกให้คุณส่งช่องที่ใช้บ่อยไปยังบางวิธีได้ง่ายขึ้น
ตัวอย่างเช่น พิจารณาคําสั่ง 2 รายการในแท็ก Google Analytics ดังนี้
ga('create', 'UA-XXXXX-Y', 'auto');
ga('send', 'pageview');
ในคําสั่งแรก create จะยอมรับช่อง trackingId, cookieDomain และ name ซึ่งคุณเลือกที่จะระบุเป็นพารามิเตอร์ที่ 2, 3 และ 4 ตามลําดับก็ได้ คําสั่ง send ยอมรับพารามิเตอร์วินาทีที่ hitType ไม่บังคับ
คําสั่งทั้งหมดยอมรับพารามิเตอร์ fieldsObject สุดท้ายที่สามารถใช้ระบุช่องใดก็ได้ด้วย ตัวอย่างเช่น คุณสามารถเขียนคําสั่ง 2 รายการข้างต้นในแท็กเป็น
ga('create', {
trackingId: 'UA-XXXXX-Y',
cookieDomain: 'auto'
});
ga('send', {
hitType: 'pageview'
});
ดูข้อมูลอ้างอิงคิวคําสั่ง ga() สําหรับรายการพารามิเตอร์ที่ไม่บังคับซึ่งอนุญาตให้ใช้กับคําสั่งแต่ละรายการ
ขั้นตอนถัดไป
หลังจากอ่านคู่มือนี้แล้ว คุณจะเข้าใจวิธีเรียกใช้คําสั่งด้วย analytics.js และวิธีการทํางานของคิวคําสั่งได้ดี คู่มือถัดไปจะครอบคลุมวิธีสร้างออบเจ็กต์เครื่องมือติดตาม