يصف هذا المرجع الطرق المتاحة في الكائن ga
.
ملخّص الطريقة
تتوفّر الطرق التالية على الكائن ga
بعد تحميل مكتبة analytics.js
. بما أنّ هذه الطرق غير متاحة في الوقت الحالي، يجب استدعاؤها دائمًا باستخدام معاودة الاتصال الجاهزة في قائمة انتظار الأوامر ga
.
لا تفعل: استخدام طرق عناصر ga
خارج readyCallback
لأنّ الطرق قد لا تكون متاحة بعد.
var trackers = ga.getAll();
ما يجب فعله: استخدِم طرق عناصر ga
في readyCallback
لأنّ هذه الطرق مضمونة.
ga(function() { var trackers = ga.getAll(); });
الطُرق | |
---|---|
create([trackingId], [cookieDomain], [name], [fieldsObject]); |
المرتجعات: تنشئ هذه الدالة مثيلاً جديدًا من أداة التتبُّع باستخدام الحقول المحدّدة. |
getByName(name) |
المرتجعات: يتم إيجاد مثيل جهاز التتبُّع بالاسم المحدَّد. |
getAll() |
المرتجعات: الحصول على جميع مثيلات جهاز التتبُّع |
remove(name) |
المرتجعات: لإزالة مثيل جهاز التتبُّع الذي يحمل الاسم المحدَّد. |
تفاصيل الطريقة
create
تنشئ هذه الدالة مثيلاً جديدًا من أداة التتبُّع باستخدام الحقول المحدّدة.
الاستخدام
ga.create([trackingId], [cookieDomain], [name], [fieldsObject]);
المَعلمات
اطّلِع على مرجع الحقل لمستندات حقول فردية.
المرتجعات
أمثلة
// 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 |
نعم | اسم جهاز التتبُّع الذي تريد الحصول عليه |
المرتجعات
أمثلة
// 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'); });