مرجع طرق عناصر ga

يصف هذا المرجع الطرق المتاحة في الكائن ga.

ملخّص الطريقة

تتوفّر الطرق التالية على الكائن ga بعد تحميل مكتبة analytics.js. بما أنّ هذه الطرق غير متاحة في الوقت الحالي، يجب استدعاؤها دائمًا باستخدام معاودة الاتصال الجاهزة في قائمة انتظار الأوامر ga.

لا تفعل: استخدام طرق عناصر ga خارج readyCallback لأنّ الطرق قد لا تكون متاحة بعد.

var trackers = ga.getAll();

ما يجب فعله: استخدِم طرق عناصر ga في readyCallback لأنّ هذه الطرق مضمونة.

ga(function() {
  var trackers = ga.getAll();
});
الطُرق
create([trackingId], [cookieDomain], [name], [fieldsObject]);

المرتجعات: Tracker

تنشئ هذه الدالة مثيلاً جديدًا من أداة التتبُّع باستخدام الحقول المحدّدة.

getByName(name)

المرتجعات: Tracker

يتم إيجاد مثيل جهاز التتبُّع بالاسم المحدَّد.

getAll()

المرتجعات: Array<Tracker>

الحصول على جميع مثيلات جهاز التتبُّع

remove(name)

المرتجعات: undefined

لإزالة مثيل جهاز التتبُّع الذي يحمل الاسم المحدَّد.

تفاصيل الطريقة

create

تنشئ هذه الدالة مثيلاً جديدًا من أداة التتبُّع باستخدام الحقول المحدّدة.

الاستخدام

ga.create([trackingId], [cookieDomain], [name], [fieldsObject]);

المَعلمات

اطّلِع على مرجع الحقل لمستندات حقول فردية.

المرتجعات

Tracker

أمثلة

// Creates a default tracker for the property UA-XXXXX-Y
// and uses automatic cookie domain configuration.
ga(function() {
  var tracker = ga.create('UA-XXXXX-Y', 'auto');
})

// Creates a tracker with the name "myTracker" for the property
// UA-XXXXX-Y, sets the cookieDomain to "example.com" and specifies
// a site speed sample rate of 10%.
ga(function() {
  var myTracker = ga.create('UA-XXXXX-Y', 'example.com', 'myTracker', {
    siteSpeedSampleRate: 10
  });
});

getByName

يتم إيجاد مثيل جهاز التتبُّع بالاسم المحدَّد.

الاستخدام

ga.getByName(name);

المَعلمات

الاسم النوع مطلوبة الوصف
name string نعم اسم جهاز التتبُّع الذي تريد الحصول عليه

المرتجعات

Tracker

أمثلة

// Gets the default tracker.
ga(function() {
  ga.getByName('t0');
});

// Gets the tracker with the name "myTracker".
ga(function() {
  ga.getByName('myTracker');
});

getAll

الحصول على جميع مثيلات جهاز التتبُّع

ga.getAll();

المرتجعات

Array<Tracker>

مثال

// Logs a list of all tracker names to the console.
ga(function() {
  var trackers = ga.getAll();
  trackers.forEach(function(tracker) {
    console.log(tracker.get('name'));
  });
});

remove

لإزالة مثيل جهاز التتبُّع الذي يحمل الاسم المحدَّد.

الاستخدام

ga.remove(name);

المَعلمات

الاسم النوع مطلوبة الوصف
name string نعم اسم جهاز التتبُّع المطلوب إزالته

المرتجعات

undefined

أمثلة

// Removes the default tracker.
ga(function() {
  // Note that, unlike the ga command queue's remove method,
  // this method requires passing a tracker name, even when
  // removing the default tracker.
  ga.remove('t0');
});

// Removes the tracker with the name "myTracker".
ga(function() {
  ga.remove('myTracker');
});