يُستخدم الكائن العمومي _gat
لإنشاء كائنات متتبع واستردادها، والتي يتم استدعاء جميع الطرق
الأخرى منها. وبالتالي، يجب تشغيل الطرق الواردة في هذه القائمة فقط من كائن متتبع تم إنشاؤه باستخدام المتغير العمومي _gat. ويجب استدعاء جميع الطرق الأخرى باستخدام الكائن العام _gaq
من أجل التتبّع غير المتزامن.
طرق الكائنات _gat
_getTracker(account)
متوقّف نهائيًا_createTracker(opt_account, opt_name)
_getTrackerByName(opt_name)
_anonymizeIp()
_forceSSL(bool)
تفاصيل الطريقة
_getTracker()
_getTracker(account)
-
ينشئ كائن تتبُّع لمعرّف الموقع الإلكتروني المحدّد. وفي حال طلب هذه الطريقة أكثر من مرة لرقم تعريف حساب "إحصاءات Google" نفسه، سيتم إنشاء عنصر جديد لكل استدعاء.
_gat._getTracker('UA-65432-1');
المَعلَمات
String account
رقم تعريف الموقع الإلكتروني الكامل (مثل UA-65432-1
) لكائن أداة التتبُّع.
returns
Tracker
عنصر التتبّع الذي تم إنشاؤه_createTracker()
_createTracker(opt_account, opt_name)
-
ينشئ عنصر تتبُّع جديدًا ويحدّد له الاسم المعني. في حال عدم ذكر أي اسم، سيتم إنشاء اسم. ويتم تخزين عناصر التتبُّع
بأسمائها لتتمكّن من استردادها من خلال
_getTrackerByName
.
إذا تم إنشاء جهازي تتبُّع بالاسم نفسه، سيتم استبدال الجهاز الأول بالجهاز الأول ولن يكون بالإمكان استرداده من خلال
_getTrackerByName
.
_gat._createTracker('UA-65432-1');
_gat._createTracker('UA-65432-2', 't2');
المَعلَمات
String opt_account
رقم تعريف الموقع الإلكتروني الكامل (مثل UA-XXXXX-X
) لعنصر التتبُّعString opt_name
اسم اختياري لتخزين جهاز التتبُّع تحته استخدِم هذا الاسم لاسترداد جهاز التتبُّع من خلال _getTrackerByName
returns
Tracker
عنصر التتبّع الذي تم إنشاؤه_getTrackerByName()
_getTrackerByName(opt_name)
-
يسترد كائن التتبُّع بالاسم الذي تم إدخاله. في حال عدم تحديد أي اسم، سيتم استخدام القيمة التلقائية، وهي السلسلة الفارغة ('').
في حال عدم توفّر جهاز تتبُّع بالاسم المحدَّد، يتم إنشاء جهاز تتبُّع جديد وسيتم تخصيصه لهذا الاسم ثم يتم عرضه.
_gat._getTrackerByName();
_gat._getTrackerByName('t2');
المَعلَمات
String opt_name
الاسم الاختياري لجهاز التتبُّع المطلوب استرداده. يتم ضبط القيمة التلقائية على السلسلة الفارغة (').
returns
Tracker
عنصر التتبُّع الذي تم استرداده أو إنشاؤه
_anonymizeIp()
_anonymizeIp()
يطلب من "إحصاءات Google" حجب المعلومات التي ترسلها أجهزة التتبُّع عن طريق إزالة آخر ثماني بتات من عنوان IP قبل تخزينها. وتجدر الإشارة إلى أن هذا الأمر يقلل بشكلٍ طفيف من دقة إعداد التقارير الجغرافية.
عند استخدام هذه الوظيفة لإخفاء التتبُّع، عليك استخدام دالة push
وربطها بشكل صحيح بكائن التتبُّع، على النحو الموضّح في ما يلي.
var _gaq = _gaq || []; _gaq.push (['_setAccount', 'UA-XXXXXXX-YY']); _gaq.push (['_gat._anonymizeIp']); _gaq.push (['_trackPageview']);
_forceSSL()
_forceSSL(bool)
تُحدِّد خدمة "إحصاءات Google" لإرسال جميع النتائج باستخدام طبقة المقابس الآمنة، حتى من الصفحات غير الآمنة (HTTP).
مقتطف غير متزامن (يُنصح به)
_gaq.push(['_setAccount', 'UA-12345-1']); _gaq.push(['_gat._forceSSL']); // Send all hits using SSL, even from insecure (HTTP) pages. _gaq.push(['_trackPageview']);