ปลั๊กอินคือสคริปต์ที่ช่วยปรับปรุงฟังก์ชันการทํางานของ analytics.js เพื่อช่วยในการวัดการโต้ตอบของผู้ใช้ โดยปกติแล้วปลั๊กอินจะมีไว้เฉพาะชุดฟีเจอร์ที่ผู้ใช้ Google Analytics บางส่วนอาจไม่จําเป็นต้องใช้ เช่น อีคอมเมิร์ซหรือการวัดผลแบบข้ามโดเมน จึงไม่ได้รวมอยู่ใน 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 เพื่อให้ตรวจหาข้อผิดพลาดได้ง่ายขึ้นและดูประสิทธิภาพการทํางานของโค้ด