การอ้างอิงออบเจ็กต์เครื่องมือติดตาม

การอ้างอิงนี้อธิบายถึงเมธอดที่พร้อมใช้งานในออบเจ็กต์ Tracker

สรุปเมธอด

วิธีการ
get(fieldName)

ไปกลับ: *

รับค่าของช่องที่เก็บไว้ในเครื่องมือติดตาม

set(fieldName|fieldsObject, [fieldValue])

ไปกลับ: undefined

ตั้งค่าคู่ช่อง/ค่าหรือกลุ่มคู่ของช่อง/ค่าในเครื่องมือติดตาม

send([hitType], [...fields], [fieldsObject])

ไปกลับ: undefined

ส่ง Hit ไปยัง Google Analytics

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

get

รับค่าของช่องที่เก็บไว้ในเครื่องมือติดตาม

การใช้งาน

tracker.get(fieldName);

พารามิเตอร์

ชื่อ ประเภท จำเป็น คำอธิบาย
fieldName string yes ชื่อช่องที่มีค่า

การคืนสินค้า

*

ตัวอย่าง

// Creates a default tracker.
ga('create', 'UA-XXXXX-Y', auto);

// Gets the client ID of the default tracker and logs it.
ga(function(tracker) {
  var clientId = tracker.get('clientId');
  console.log(clientId);
});

set

ตั้งค่าคู่ช่อง/ค่าหรือกลุ่มคู่ของช่อง/ค่าในเครื่องมือติดตาม

การใช้งาน

// Sets a single field/value pair.
tracker.set(fieldName, fieldValue);
// Sets a group of field/value pairs.
tracker.set(fieldsObject);

พารามิเตอร์

ดูเอกสารประกอบของช่องแต่ละช่องได้ในข้อมูลอ้างอิงช่อง

การคืนสินค้า

undefined

ตัวอย่าง

// Creates a default tracker.
ga('create', 'UA-XXXXX-Y', auto);

ga(function(tracker) {
  // Sets the page field to "/about.html".
  tracker.set('page', '/about.html');
});
// Creates a default tracker.
ga('create', 'UA-XXXXX-Y', auto);

ga(function(tracker) {
  // Sets both the page and title fields.
  tracker.set({
    page: '/about.html',
    title: 'About'
  });
});

send

ส่ง Hit ไปยัง Google Analytics

การใช้งาน

tracker.send([hitType], [...fields], [fieldsObject]);

ช่องที่ส่งคือค่าที่ระบุไว้ในพารามิเตอร์ ...fields และ fieldsObject ซึ่งผสานอยู่กับช่องที่เก็บไว้ในเครื่องมือติดตาม

พารามิเตอร์

ช่องที่ระบุโดยพารามิเตอร์ ...fields จะแตกต่างกันไปตามประเภท Hit ตารางต่อไปนี้จะแสดงช่องที่สอดคล้องกับ Hit แต่ละประเภท ประเภท Hit ที่ไม่อยู่ในรายการไม่ยอมรับพารามิเตอร์ ...fields แต่มีเฉพาะ fieldsObject

ประเภท Hit ...fields
pageview page
event eventCategory, eventAction, eventLabel, eventValue
social socialNetwork, socialAction, socialTarget
timing timingCategory, timingVar, timingValue, timingLabel

ดูเอกสารประกอบของช่องแต่ละช่องได้ในข้อมูลอ้างอิงช่อง

การคืนสินค้า

undefined

ตัวอย่าง

// Creates a default tracker.
ga('create', 'UA-XXXXX-Y', auto);

ga(function(tracker) {
  // Sends a pageview hit.
  tracker.send('pageview');
});
// Creates a default tracker.
ga('create', 'UA-XXXXX-Y', auto);

ga(function(tracker) {
  // Sends an event hit for the tracker named "myTracker" with the
  // following category, action, and label, and sets the nonInteraction
  // field value to true.
  tracker.send('event', 'link', 'click', 'http://example.com', {
    nonInteraction: true
  });
});