رمز التتبع: الكائن _ga العام

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

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

_طرق الكائن _ga

• _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();