شفرة التتبع: الكائن العالمي _gat

ga.js مكتبة قديمة. إذا كنت بصدد بدء عملية تنفيذ جديدة، ننصحك باستخدام أحدث إصدار من هذه المكتبة، وهو analytics.js. وبالنسبة إلى عمليّات التنفيذ الحالية، تعرَّف على كيفية النقل من ga.js إلى analytics.js.

يُستخدم الكائن العمومي _gat لإنشاء كائنات متتبع واستردادها، والتي يتم استدعاء جميع الطرق الأخرى منها. وبالتالي، يجب تشغيل الطرق الواردة في هذه القائمة فقط من كائن متتبع تم إنشاؤه باستخدام المتغير العمومي _gat. ويجب استدعاء جميع الطرق الأخرى باستخدام الكائن العام _gaq من أجل التتبّع غير المتزامن.

طرق الكائنات _gat

• _getTracker(account) متوقّف نهائيًا
• _createTracker(opt_account, opt_name)
• _getTrackerByName(opt_name)
• _anonymizeIp()
• _forceSSL(bool)

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

_getTracker()

_getTracker(account)

تم إيقاف هذه الطريقة نهائيًا. يُرجى استخدام _gat._createTracker(opt_account, opt_name) بدلاً منها.

ينشئ كائن تتبُّع لمعرّف الموقع الإلكتروني المحدّد. وفي حال طلب هذه الطريقة أكثر من مرة لرقم تعريف حساب "إحصاءات 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']);

المقتطف التقليدي (ga.js)

<script type="text/javascript">
var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
</script>
<script type="text/javascript">
try{
var pageTracker = _gat._getTracker("UA-xxxxxx-x");
_gat._anonymizeIp();
pageTracker._trackPageview();
} catch(err) {}</script>

---

_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']);

المقتطف التقليدي (ga.js)

var pageTracker = _gat._getTracker("UA-12345-1");
// Send all hits using SSL even from insecure (HTTP) pages.
_gat._forceSSL();
pageTracker._trackPageview();