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

ปลั๊กอินคือสคริปต์ที่ปรับปรุงฟังก์ชันการทำงานของ 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>

หมายเหตุ: ระบบจะโหลดปลั๊กอิน Google Analytics อย่างเป็นทางการสำหรับ analytics.js โดยอัตโนมัติเมื่อจำเป็นต้องใช้ คุณไม่จำเป็นต้องเพิ่มแท็กสคริปต์สำหรับปลั๊กอินดังกล่าว คุณสามารถดูรายการปลั๊กอิน analytics.js อย่างเป็นทางการทั้งหมดได้ในส่วนปลั๊กอินอย่างเป็นทางการในแถบนำทางด้านซ้าย

กำลังรอโหลดปลั๊กอิน

เนื่องจากทั้งไลบรารี 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 เพื่อให้ตรวจหาข้อผิดพลาดได้ง่ายขึ้นและดูว่าโค้ดกำลังทำอะไรอยู่