مرجع شی ردیاب

این مرجع روش های موجود در شی Tracker را شرح می دهد.

خلاصه روش

مواد و روش ها
get(fieldName)

برمی گرداند: *

مقدار یک فیلد ذخیره شده در ردیاب را دریافت می کند.

set(fieldName|fieldsObject, [fieldValue])

بازده: undefined

یک جفت فیلد/مقدار یا گروهی از جفت‌های فیلد/مقدار را روی ردیاب تنظیم می‌کند.

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

بازده: undefined

یک ضربه به Google Analytics ارسال می کند.

جزئیات روش

get

مقدار یک فیلد ذخیره شده در ردیاب را دریافت می کند.

استفاده

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

یک جفت فیلد/مقدار یا گروهی از جفت‌های فیلد/مقدار را روی ردیاب تنظیم می‌کند.

استفاده

// 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 ارسال می کند.

استفاده

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
  });
});