การใช้ปลั๊กอิน

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