הפניה לאובייקט מעקב

בהפניה הזו מתוארות השיטות הזמינות באובייקט Tracker.

סיכום שיטה

שיטות
get(fieldName)

החזרות: *

הפונקציה מקבלת את הערך של שדה שמאוחסן במכשיר המעקב.

set(fieldName|fieldsObject, [fieldValue])

החזרות: undefined

מגדיר צמד של שדה/ערך או קבוצה של צמדי שדה/ערך בכלי המעקב.

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

החזרות: undefined

שולחת היט ל-Google Analytics.

פרטי השיטה

get

הפונקציה מקבלת את הערך של שדה שמאוחסן במכשיר המעקב.

Usage

tracker.get(fieldName);

פרמטרים

שם סוג חובה תיאור
fieldName string כן שם השדה שעבורו רוצים לקבל את הערך.

החזרות

*

דוגמאות

// 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

מגדיר צמד של שדה/ערך או קבוצה של צמדי שדה/ערך בכלי המעקב.

Usage

// 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

שולחת היט ל-Google Analytics.

Usage

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

השדות שנשלחים הם הערכים שצוינו בפרמטרים ...fields ו-fieldsObject, שממוזגים עם השדות שמאוחסנים כרגע בכלי המעקב.

פרמטרים

השדות שאפשר לציין באמצעות הפרמטרים ...fields משתנים בהתאם לסוג ההיט. הטבלה הבאה מציגה את השדות שתואמים לכל סוג היט. סוגי היטים שלא מופיעים ברשימה לא מקבלים פרמטרים של ...fields, אלא רק fieldsObject.

סוג היט ...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
  });
});