โค้ดติดตาม: ออบเจ็กต์ส่วนกลาง _gaq

คุณใช้ออบเจ็กต์ส่วนกลาง _gaq ได้โดยตรงสำหรับการติดตามหน้าเว็บแบบอะซิงโครนัสผ่านเมธอด push(...) และยังมีวิธีการสร้างออบเจ็กต์ตัวติดตามอีกด้วย แต่ก็ควรใช้ในบางกรณีเท่านั้น

สำหรับการติดตามหน้าเว็บแบบดั้งเดิม ให้ใช้ออบเจ็กต์ส่วนกลาง _gat แทน

_gaq เมธอดของออบเจ็กต์

รายละเอียดของเมธอด

_createAsyncTracker()

    _createAsyncTracker(accountId, opt_name)
    สร้างออบเจ็กต์เครื่องมือติดตามที่อาจอ้างอิงด้วยชื่อได้เมื่อเรียกใช้การติดตามแบบไม่พร้อมกัน หากไม่ได้ระบุชื่อ สตริงนั้นจะเป็นสตริงว่าง '' ซึ่งแสดงเครื่องมือติดตามเริ่มต้นในไวยากรณ์อะซิงโครนัส หากมีตัวติดตามแบบอะซิงโครนัสสำหรับชื่อนั้นอยู่แล้ว ระบบจะเขียนทับแท็กนั้นด้วยตัวติดตามใหม่

    หมายเหตุ: โดยทั่วไปวิธีนี้จะปลอดภัยเมื่อใช้ภายในฟังก์ชันที่พุชไปยัง _gaq เท่านั้น ซึ่งควรใช้ในบางกรณีเท่านั้น 
    _gaq._createAsyncTracker('UA-65432-1');

    พารามิเตอร์

      String accountId รหัสเว็บพร็อพเพอร์ตี้แบบเต็ม (เช่น UA-65432-1) สำหรับออบเจ็กต์เครื่องมือติดตาม
      String opt_name ชื่อสำหรับจัดเก็บออบเจ็กต์เครื่องมือติดตาม ใช้ชื่อนี้เพื่ออ้างถึงออบเจ็กต์เครื่องมือติดตามในการเรียกใช้การติดตามแบบไม่พร้อมกันในภายหลัง

    returns

      Tracker ออบเจ็กต์การติดตามที่สร้างขึ้น

_getAsyncTracker()

    _getAsyncTracker(opt_name)
    แสดงผลออบเจ็กต์เครื่องมือติดตามที่สร้างไว้ก่อนหน้านี้ภายใต้ชื่อดังกล่าว หากไม่ได้ระบุชื่อ ระบบจะใช้ชื่อเครื่องมือติดตามเริ่มต้น (สตริงว่าง '') หากไม่มีออบเจ็กต์เครื่องมือติดตามที่มีชื่อดังกล่าว ระบบจะสร้างเครื่องมือติดตามใหม่ กำหนดให้กับชื่อดังกล่าวและแสดงผล

    หมายเหตุ: โดยทั่วไปวิธีนี้จะปลอดภัยเมื่อใช้ภายในฟังก์ชันที่พุชไปยัง _gaq เท่านั้น ซึ่งควรใช้ในบางกรณีเท่านั้น 
    _gaq._getAsyncTracker();

    พารามิเตอร์

      String opt_name ชื่อของออบเจ็กต์ตัวติดตามที่จะดึง

    returns

      Tracker ออบเจ็กต์ติดตามที่ดึงมาหรือสร้าง

push

    push(commandArray)
    เรียกใช้ command array ที่ระบุ ซึ่งเป็นอาร์เรย์ JavaScript ที่สอดคล้องกับรูปแบบต่อไปนี้ องค์ประกอบแรกของอาร์เรย์ต้องเป็นชื่อของเมธอดออบเจ็กต์เครื่องมือติดตามที่ส่งผ่านเป็นสตริง องค์ประกอบอาร์เรย์ที่เหลือคือค่าที่จะส่งเป็นอาร์กิวเมนต์ไปยังฟังก์ชัน

    การใช้งานต่อไปนี้เป็นเรื่องปกติ
    var _gaq = _gaq || [];
_gaq.push(['_setAccount', 'UA-65432-1']);
_gaq.push(['_trackPageview']);

    ฟังก์ชันนี้ชื่อ push เพื่อให้ใช้อาร์เรย์แทน _gaq ก่อนที่ Analytics จะโหลดเสร็จสมบูรณ์ ขณะที่กำลังโหลด Analytics ระบบจะพุช/จัดคิวคำสั่งลงในอาร์เรย์ เมื่อ Analytics โหลดเสร็จแล้ว Analytics จะแทนที่อาร์เรย์ด้วยออบเจ็กต์ _gaq และเรียกใช้คำสั่งที่อยู่ในคิวทั้งหมด การเรียก _gaq.push ครั้งต่อๆ ไปจะชี้ไปยังฟังก์ชันนี้ ซึ่งจะเรียกใช้คำสั่งทันทีที่มีการพุช

    คุณจะตั้งชื่อเครื่องมือติดตามได้โดยใช้ชื่อเครื่องมือติดตาม (พร้อมกับจุด) หน้าชื่อเมธอด หากชื่อฟังก์ชันเข้าเกณฑ์โดยใช้ชื่อตัวติดตาม ระบบจะดำเนินการดังกล่าวในอุปกรณ์ติดตามนั้น

    ตัวอย่างต่อไปนี้จะสร้างและใช้เครื่องมือติดตามที่เรียกว่า myTracker ตามอำเภอใจ
    var _gaq = _gaq || [];
_gaq.push(['myTracker._setAccount', 'UA-65432-2']);
_gaq.push(['myTracker._setDomainName', 'foo.com']);
_gaq.push(['myTracker._trackPageview']);

    หมายเหตุ: ระบบจะสร้างเครื่องมือติดตามในครั้งแรกที่มีคำสั่งอ้างอิงถึงเครื่องมือติดตาม ตัวติดตามเริ่มต้นสร้างขึ้นผ่านคำสั่งแรกที่ไม่ได้ตั้งชื่อตัวติดตามอย่างชัดแจ้ง ชื่อของตัวติดตามเริ่มต้นเป็นสตริงว่าง ''

    นอกจากการพุชอาร์เรย์คำสั่งแล้ว คุณยังพุชออบเจ็กต์ฟังก์ชันได้ด้วย ซึ่งจะเป็นประโยชน์อย่างยิ่งสำหรับเมธอดเครื่องมือติดตามที่แสดงผลค่า ฟังก์ชันเหล่านี้อ้างอิงได้ทั้ง _gat และ _gaq
    var _gaq = _gaq || [];
_gaq.push(function() {
  var tracker = _gat._getTracker('UA-65432-1');
  tracker._trackPageview();
});

    คุณยังใช้ไวยากรณ์พุชใน HTML ของหน้าได้โดยตรงอีกด้วย
    onclick="_gaq.push(['_trackEvent', 'name', value]);"

    ตราบใดที่ข้อมูลโค้ด Analytics แบบไม่พร้อมกันแสดงอยู่เหนือลิงก์ ระบบจะบันทึกการคลิกโดยไม่มีข้อผิดพลาด แม้ว่า Analytics จะยังโหลดไม่สมบูรณ์ในขณะที่ เกิดการคลิกก็ตาม นี่เป็นหนึ่งในประโยชน์มากมายของการติดตามแบบอะซิงโครนัส

    สุดท้าย คุณจะพุชคำสั่งทั้งหมดพร้อมกันได้ แทนที่จะพิมพ์ _gaq.push(...) สำหรับอาร์เรย์คำสั่งแต่ละรายการ โค้ดต่อไปนี้จะแสดงเทคนิคนี้ ดูรายละเอียดเพิ่มเติมในคู่มือการใช้งานข้อมูลโค้ดแบบไม่พร้อมกัน 

    _gaq.push(
  ['_setAccount', 'UA-XXXXX-X'],
  ['_setDomainName', 'example.com'],
  ['_setCustomVar', 1, 'Section', 'Life & Style', 3],
  ['_trackPageview']
);

      พารามิเตอร์

        Array commandArray คำสั่งที่จะดำเนินการ ซึ่งสามารถพุชอย่างน้อย 1 รายการได้ในการเรียกใช้เดียวกัน

      returns

        Number จำนวนคำสั่งที่ประมวลผลไม่สำเร็จ