โค้ดติดตาม: การกำหนดค่าพื้นฐาน

ข้อมูลอ้างอิงนี้อธิบายวิธีที่คุณใช้ในการปรับแต่งการรายงาน Google Analytics ทุกด้าน

เมธอดพื้นฐาน ga.js

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

_deleteCustomVar()

_deleteCustomVar(index)

เมธอดนี้จะลบตัวแปรที่กำหนดให้กับดัชนีที่ให้มา หากมี ตัวอย่างเช่น คุณอาจตั้งค่าตัวแปรที่กำหนดเองระดับผู้เข้าชม และภายหลังตัดสินใจว่าคุณไม่ต้องการใช้ตัวแปรระดับผู้เข้าชมนี้อีกต่อไป

ข้อมูลโค้ดแบบไม่พร้อมกัน (แนะนำ)

_gaq.push(['_deleteCustomVar', 1]);

พารามิเตอร์

Int   index ดัชนีของตัวแปรที่กำหนดเองที่จะลบ


_getName()

_getName()

แสดงผลชื่อเครื่องมือติดตามที่ระบุเมื่อสร้าง

ข้อมูลโค้ดแบบไม่พร้อมกัน (แนะนำ)

_gaq.push(function() {
  var pageTracker = _gat._getTrackerByName(); // Gets the default tracker.
  var trackerName = pageTracker._getName();
});

returns

String ชื่ออุปกรณ์ติดตาม


_getAccount()

_getAccount()

แสดงผลรหัส Google Analytics สำหรับออบเจ็กต์เครื่องมือติดตามนี้ หากคุณกำลังติดตามหน้าในเว็บไซต์ในหลายบัญชี คุณสามารถใช้วิธีนี้ในการระบุบัญชีที่เชื่อมโยงกับออบเจ็กต์ติดตามที่เฉพาะเจาะจง

ข้อมูลโค้ดแบบไม่พร้อมกัน (แนะนำ)

_gaq.push(function() {
  var pageTracker = _gat._getTrackerByName(); // Gets the default tracker.
  var accountId = pageTracker._getAccount();
});

returns

String รหัสบัญชีออบเจ็กต์เครื่องมือติดตามนี้


_getVersion()

_getVersion()

แสดงหมายเลขเวอร์ชัน GATC

ข้อมูลโค้ดแบบไม่พร้อมกัน (แนะนำ)

_gaq.push(function() {
  var pageTracker = _gat._getTrackerByName(); // Gets the default tracker.
  var version = pageTracker._getVersion();
});

returns

หมายเลขเวอร์ชัน GATC String รายการ


_getVisitorCustomVar()

_getVisitorCustomVar(index)

แสดงผลค่าตัวแปรที่กำหนดเองระดับผู้เข้าชมซึ่งกำหนดสำหรับดัชนีที่ระบุ

ข้อมูลโค้ดแบบไม่พร้อมกัน (แนะนำ)

_gaq.push(function() {
  var pageTracker = _gat._getTrackerByName(); // Gets the default tracker.
  var visitorCustomVar1Value = pageTracker._getVisitorCustomVar(1);
});

พารามิเตอร์

Int   index ดัชนีของตัวแปรที่กำหนดเองระดับผู้เข้าชม

returns

String ค่าของตัวแปรที่กำหนดเองระดับผู้เข้าชม แสดงผล "ไม่ได้กำหนด" หากไม่สามารถเรียกตัวแปรสำหรับดัชนีที่ระบุ


_initData()

_initData()เลิกใช้งาน. initData() จะทำงานโดยอัตโนมัติในโค้ดติดตาม ga.js

เริ่มต้นอ็อบเจ็กต์ GATC (Google Analytics Tracker Code) อีกครั้ง

var pageTracker = _gat._getTracker("UA-12345-1");
pageTracker._trackPageview();

_setAccount()

_setAccount(accountId)

ใช้ในการติดตามแบบอะซิงโครนัสเท่านั้น ตั้งค่ารหัสเว็บพร็อพเพอร์ตี้สำหรับออบเจ็กต์การติดตาม

_gaq.push(['_setAccount', 'UA-XXXXX-X']);

พารามิเตอร์

String accountID รหัสเว็บพร็อพเพอร์ตี้แบบเต็ม (เช่น UA-65432-1) สำหรับออบเจ็กต์เครื่องมือติดตาม


_setCookiePersistence()

_setCookiePersistence(milliseconds)

วิธีนี้เลิกใช้งานแล้ว โปรดใช้ _setVisitorCookieTimeout(cookieTimeoutMillis) แทน

ตั้งค่าการหมดอายุของคุกกี้ผู้เข้าชม Google Analytics เป็นมิลลิวินาที โดยค่าเริ่มต้น คุกกี้ผู้เข้าชมจะถูกตั้งค่าให้หมดอายุใน 2 ปี คุณเปลี่ยนวันที่หมดอายุของคุกกี้ผู้เข้าชมโดยใช้วิธีนี้ได้หากต้องการ ตัวอย่างเช่น หากต้องการตั้งค่าการหมดอายุของคุกกี้ผู้เข้าชมเป็น 7 วัน คุณจะใช้โค้ดต่อไปนี้

pageTracker._setCookiePersistence(604800000); 

พารามิเตอร์

Number   milliseconds เวลาหมดอายุของคุกกี้ผู้เข้าชมใหม่


_setCustomVar()

_setCustomVar(index, name, value, opt_scope)

ตั้งค่าตัวแปรที่กำหนดเองด้วยชื่อ ค่า และขอบเขตที่ระบุสำหรับตัวแปร มีการจำกัดจำนวนอักขระสูงสุด 128 ไบต์สำหรับ name และ value รวมกัน

ข้อมูลโค้ดแบบไม่พร้อมกัน (แนะนำ)

_gaq.push(['_setCustomVar', 1, 'Section', 'Life & Style', 3]);

returns

Boolean เมธอดนี้จะแสดง true หากตั้งค่าตัวแปรที่กำหนดเองสำเร็จแล้ว และแสดงผล false หากตัวแปรที่กำหนดเองไม่ตรงตาม (เช่น หากสตริงชื่อ/ค่ามีความยาวเกิน 128 ไบต์หรือหากคุณใช้ช่องที่ไม่ถูกต้อง)

พารามิเตอร์

Int      index       ต้องระบุ ช่องโฆษณาที่ใช้สำหรับตัวแปรที่กำหนดเอง ค่าที่เป็นไปได้คือ 1-5 โดยรวมไว้ด้วย

String   name        ต้องระบุ ชื่อของตัวแปรที่กำหนดเอง

String   value       ต้องระบุ ค่าสำหรับตัวแปรที่กำหนดเอง

Int      opt_scope   ไม่บังคับ ขอบเขตที่ใช้สำหรับตัวแปรที่กำหนดเอง ค่าที่เป็นไปได้คือ 1 สำหรับระดับผู้เข้าชม 2 สำหรับระดับเซสชัน และ 3 สำหรับระดับหน้าเว็บ


_setSampleRate()

_setSampleRate(newRate)

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

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

ข้อมูลโค้ดแบบไม่พร้อมกัน (แนะนำ)

_gaq.push(['_setSampleRate', '2.5']);

พารามิเตอร์

String newRate อัตราการสุ่มตัวอย่างใหม่ที่จะตั้งค่า ระบุสตริงตัวเลขระหว่าง 0 ถึง 100 (ทศนิยม 2 ตำแหน่ง)


_setSessionระยะหมดเวลา()

_setSessionTimeout(newTimeout)

วิธีนี้เลิกใช้งานแล้ว โปรดใช้ _setSessionCookieTimeout(cookieTimeoutMillis) แทน

กำหนดระยะหมดเวลาใหม่เป็นวินาที โดยค่าเริ่มต้น ระยะหมดเวลาของเซสชันจะตั้งไว้ที่ 30 นาที (1, 800 วินาที) ระยะหมดเวลาของเซสชันใช้ในการคำนวณการเข้าชม (ดูวิธีกำหนดเซสชันใน Analytics) หากต้องการเปลี่ยนคำจำกัดความของ "เซสชัน" สำหรับความต้องการที่เฉพาะเจาะจง คุณสามารถส่งจำนวนวินาทีเพื่อกำหนดมูลค่าใหม่ ซึ่งจะส่งผลต่อรายงานการเข้าชมในทุกๆ ส่วนที่คํานวณจํานวนการเข้าชม และมีการใช้การเข้าชมในการคำนวณค่าอื่นๆ ตัวอย่างเช่น จำนวนการเข้าชมจะเพิ่มขึ้นหากคุณลดระยะหมดเวลาของเซสชัน และมักจะลดลงหากเพิ่มระยะหมดเวลาของเซสชัน

พารามิเตอร์

String newTimeout ระยะหมดเวลาใหม่ของเซสชันที่จะตั้งเป็นวินาที


_setSessionCookieTimeout()

_setSessionCookieTimeout(cookieTimeoutMillis)

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

ข้อมูลโค้ดแบบไม่พร้อมกัน (แนะนำ)

_gaq.push(['_setSessionCookieTimeout', 1800000]);


พารามิเตอร์

Number cookieTimeoutMillis ระยะหมดเวลาของเซสชันใหม่เป็นมิลลิวินาทีหรือ 0 เพื่อลบคุกกี้เมื่อปิดเบราว์เซอร์


_setSiteSpeedSampleRate()

_setSiteSpeedSampleRate(sampleRate)

กำหนดขนาดชุดตัวอย่างใหม่สำหรับการรวบรวมข้อมูลความเร็วไซต์ โดยค่าเริ่มต้น การสุ่มตัวอย่างผู้เข้าชมเว็บไซต์ 1% แบบคงที่จะประกอบขึ้นเป็นกลุ่มข้อมูลซึ่งเป็นที่มาของเมตริกความเร็วเว็บไซต์ หากมีผู้เข้าชมเว็บไซต์รายวันค่อนข้างน้อย เช่น ไม่เกิน 100,000 คน คุณอาจต้องปรับการสุ่มตัวอย่างให้มีอัตราสูงขึ้น วิธีนี้จะช่วยเพิ่มรายละเอียดของเวลาในการโหลดหน้าเว็บและเมตริกความเร็วเว็บไซต์อื่นๆ (ดูรายละเอียดเกี่ยวกับรายงานความเร็วเว็บไซต์ได้ที่ความเร็วเว็บไซต์ในศูนย์ช่วยเหลือ)

คุณต้องเรียกใช้เมธอด _setSiteSpeedSampleRate() ก่อน _trackPageview() เพื่อให้มีผล

Analytics จำกัด Hit การรวบรวมความเร็วเว็บไซต์สำหรับพร็อพเพอร์ตี้เดียวไว้ที่ผู้ใช้ 1% มากกว่า 1% หรือ 10,000 Hit ต่อวันเพื่อให้มั่นใจว่าจะมีการกระจายทรัพยากรระบบอย่างเท่าเทียมสำหรับฟีเจอร์นี้

หมายเหตุ: เราขอแนะนำให้เว็บไซต์ที่มี Hit มากกว่า 1 ล้านครั้งต่อวันตั้งค่าการเลือกตัวอย่างไว้ที่อัตราเริ่มต้น 1% การปรับขนาดการสุ่มตัวอย่างให้ใหญ่ขึ้นจะไม่เพิ่มขนาดการสุ่มตัวอย่าง

ข้อมูลโค้ดแบบไม่พร้อมกัน (แนะนำ)

_gaq.push(['_setSiteSpeedSampleRate', 5]);
_gaq.push(['_trackPageview']);

พารามิเตอร์

Number sampleRate ค่าระหว่าง 0 - 100 เพื่อกำหนดเปอร์เซ็นต์ของผู้เข้าชมเว็บไซต์ที่จะวัดตามความเร็วเว็บไซต์ เช่น ค่า 5 จะตั้งค่าตัวอย่างการรวบรวมความเร็วเว็บไซต์เป็น 5%


_setVisitorCookieTimeout()

_setVisitorCookieTimeout(cookieTimeoutMillis)

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

ข้อมูลโค้ดแบบไม่พร้อมกัน (แนะนำ)

_gaq.push(['_setVisitorCookieTimeout', 63072000000]);

พารามิเตอร์

Number cookieTimeoutMillis เวลาหมดอายุของคุกกี้ผู้เข้าชมใหม่เป็นมิลลิวินาที หรือ 0 เพื่อลบคุกกี้เมื่อปิดเบราว์เซอร์


_setVar()

_setVar(newVal)

วิธีนี้เลิกใช้งานแล้ว โปรดใช้ _setCustomVar() แทน

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

พารามิเตอร์

String newVal ค่าที่กำหนดโดยผู้ใช้ใหม่ที่จะตั้งค่า


_trackPageLoadTime()

_trackPageLoadTime()

เลิกใช้งานวิธีนี้แล้วเนื่องจากมีการเปิดใช้การรายงานความเร็วเว็บไซต์โดยอัตโนมัติสำหรับผู้ใช้ทั้งหมด โปรดใช้ _setSiteSpeedSampleRate() เพื่อปรับอัตราการสุ่มตัวอย่างสำหรับการรายงานความเร็วเว็บไซต์

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

การยืนยันการเปลี่ยนแปลงของคุณ

หากคุณเห็นข้อมูลปรากฏในรายงาน แสดงว่าการตั้งค่าของคุณถูกต้อง หากคุณไม่เห็นข้อมูลหลังจากผ่านไป 24 ชั่วโมง ให้ตรวจสอบการปรับแต่งเพื่อให้แน่ใจว่าคุณไม่ได้ทําข้อผิดพลาด ดูรายการข้อผิดพลาดที่พบบ่อยเกี่ยวกับโค้ดติดตามได้ที่การแก้ปัญหาโค้ดติดตาม คู่มือการแก้ปัญหานี้ยังมีขั้นตอนการแก้ไขข้อบกพร่องพื้นฐานและข้อมูลเพิ่มเติมเกี่ยวกับการแก้ไขข้อบกพร่องด้วย

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

ข้อมูลโค้ดแบบไม่พร้อมกัน (แนะนำ)

_gaq.push(['_setAccount', 'UA-12345-1']);
_gaq.push(['_trackPageview']);
_gaq.push(['_trackPageLoadTime']);

_trackPageview()

_trackPageview(opt_pagePath)

ตรรกะหลักสําหรับ GATC (Google Analytics Tracker Code) หากเปิดใช้ฟังก์ชัน Linker จะเป็นการพยายามดึงค่าคุกกี้จาก URL มิเช่นนั้น ระบบจะพยายามดึงค่าคุกกี้จาก document.cookie และยังอัปเดตหรือสร้างคุกกี้ตามที่จำเป็น จากนั้นเขียนกลับไปยังออบเจ็กต์เอกสาร รวบรวมเมตริกที่เหมาะสมทั้งหมดเพื่อส่งไปยัง UCFE (Urchin Collector Front-end)

ข้อมูลโค้ดแบบไม่พร้อมกัน (แนะนำ)

_gaq.push(['_setAccount', 'UA-12345-1']);
_gaq.push(['_trackPageview', '/home/landingPage']);

พารามิเตอร์

String opt_pagePath พารามิเตอร์ที่ไม่บังคับสำหรับระบุเส้นทางของหน้าเว็บเพื่อติดตามเมตริก เมื่อใช้ตัวเลือกนี้ ให้ใช้เครื่องหมายทับ (/) เริ่มต้นเพื่อระบุเส้นทางหน้าเว็บ