ปลั๊กอินคือสคริปต์ที่ปรับปรุงฟังก์ชันการทำงานของ analytics.js เพื่อช่วยวัดการโต้ตอบของผู้ใช้ โดยทั่วไปปลั๊กอินจะมีไว้สำหรับชุดของฟีเจอร์ที่ผู้ใช้ Google Analytics ทั้งหมดอาจไม่จำเป็นต้องใช้ เช่น ecommerceหรือการวัดผลแบบข้ามโดเมน จึงไม่รวมอยู่ใน analytics.js โดยค่าเริ่มต้น
คู่มือนี้จะอธิบายถึงวิธีการกำหนดให้ใช้และใช้ปลั๊กอิน analytics.js
ต้องใช้ปลั๊กอิน
คำสั่ง require
จะใช้ชื่อปลั๊กอินและลงทะเบียนปลั๊กอินนั้นเพื่อใช้กับคิวคำสั่ง ga()
หากปลั๊กอินยอมรับตัวเลือกการกำหนดค่า ระบบจะส่งตัวเลือกเหล่านี้เป็นอาร์กิวเมนต์สุดท้ายไปยังคำสั่ง require
ต่อไปนี้เป็นลายเซ็นของคำสั่ง require
แบบเต็ม
ga('[trackerName.]require', pluginName, [pluginOptions]);
ตัวอย่างเช่น คุณจะต้องมีปลั๊กอินอีคอมเมิร์ซที่เพิ่มประสิทธิภาพเพื่อใช้กับเครื่องมือติดตามเริ่มต้น ดังนี้
ga('require', 'ec');
และต่อไปนี้คือวิธีที่คุณกำหนดให้ต้องใช้ปลั๊กอินฟีเจอร์การโฆษณาสำหรับเครื่องมือติดตามชื่อ "myTracker" และส่งตัวเลือกการกำหนดค่าที่ลบล้างค่าชื่อคุกกี้เริ่มต้น
ga('myTracker.require', 'displayfeatures', {
cookieName: 'display_features_cookie'
});
กำลังโหลดโค้ดปลั๊กอิน
คำสั่ง require
จะเริ่มต้นเมธอดปลั๊กอินเพื่อใช้กับคิวคำสั่ง ga()
แต่จะไม่โหลดสคริปต์ปลั๊กอินเอง หากคุณใช้ปลั๊กอินของบุคคลที่สามหรือเขียนปลั๊กอินด้วยตนเอง คุณจะต้องเพิ่มโค้ดปลั๊กอินลงในหน้าเว็บด้วยตนเอง
วิธีที่แนะนำสำหรับการเพิ่มโค้ดปลั๊กอินลงในหน้าเว็บคือการใช้แท็ก <script>
ที่มีการตั้งค่าแอตทริบิวต์ async
เพื่อให้แน่ใจว่าไม่ได้บล็อกการโหลดฟีเจอร์อื่นๆ ในเว็บไซต์ของคุณ
โค้ดต่อไปนี้ทั้งจำเป็นต้องใช้และโหลดปลั๊กอินการติดตามลิงก์สมมติ
<script>
ga('create', 'UA-XXXXX-Y', 'auto');
ga('require', 'linkTracker');
ga('send', 'pageview');
</script>
<!--Note: plugin scripts must be included after the tracking snippet. -->
<script async src="/path/to/link-tracker-plugin.js"></script>
กำลังรอโหลดปลั๊กอิน
เนื่องจากทั้งไลบรารี analytics.js และปลั๊กอิน analytics.js ถูกโหลดไม่พร้อมกัน จึงเป็นการท้าทายที่จะทราบเมื่อปลั๊กอินโหลดอย่างสมบูรณ์และพร้อมใช้งาน
ไลบรารี analytics.js แก้ปัญหานี้โดยหยุดการดำเนินการของคิวคำสั่งเมื่อตรวจพบคำสั่ง require
สำหรับปลั๊กอินที่ยังไม่ได้โหลด เมื่อโหลดปลั๊กอินแล้ว การดำเนินการคิวจะดำเนินต่อไปตามปกติ
ด้วยเหตุนี้ คุณจึงควรทดสอบปลั๊กอินที่ใช้เพื่อให้แน่ใจว่าปลั๊กอินโหลดและทำงานได้อย่างถูกต้อง หากปลั๊กอินโหลดไม่สำเร็จหรือมีข้อผิดพลาด จะทำให้คำสั่ง analytics.js ที่ตามมาทั้งหมดไม่สามารถดำเนินการได้
การเรียกใช้ปลั๊กอิน
หลังจากต้องใช้ปลั๊กอิน เมธอดจะพร้อมใช้งานกับคิวคำสั่ง ga()
ต่อไปนี้เป็นลายเซ็นคำสั่งสำหรับการเรียกเมธอดปลั๊กอิน
ga('[trackerName.][pluginName:]methodName', ...args);
ตัวอย่างเช่น เมธอด addProduct
ของปลั๊กอินอีคอมเมิร์ซที่เพิ่มประสิทธิภาพอาจเรียกได้ดังนี้
ga('ec:addProduct', {
'id': 'P12345',
'quantity': 1
});
หรือในอุปกรณ์ติดตามที่มีชื่อโดยการเพิ่มชื่อเครื่องมือติดตามลงในสตริงคำสั่ง ดังนี้
ga('myTracker.ec:addProduct', {
'id': 'P12345',
'quantity': 1
});
ขั้นตอนถัดไป
หากคุณได้อ่านคำแนะนำทั้งหมดในส่วนนี้แล้ว คุณน่าจะคุ้นเคยกับฟีเจอร์ส่วนใหญ่ของ analytics.js คู่มือถัดไปจะอธิบายวิธีแก้ไขข้อบกพร่องการติดตั้งใช้งาน analytics.js เพื่อให้ตรวจหาข้อผิดพลาดได้ง่ายขึ้นและดูว่าโค้ดกำลังทำอะไรอยู่