رمز التتبّع: الإعداد الأساسي

يصف هذا المرجع الطرق التي تستخدِمها لتخصيص جميع جوانب إعداد تقارير "إحصاءات Google".

الطرق الأساسية لـ ga.js

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

_deleteCustomVar()

_deleteCustomVar(index)

تحذف هذه الطريقة المتغيّر المعيّن للفهرس المقدّم، إن توفّر. على سبيل المثال، يمكنك تحديد متغير مخصّص على مستوى الزائر ثم اتخاذ قرار بعدم استخدام هذا المتغير على مستوى الزائر بعد الآن.

مقتطف غير متزامن (يُنصح به)

_gaq.push(['_deleteCustomVar', 1]);

المَعلَمات

Int   index فهرس المتغيّر المخصّص المطلوب حذفه.

_getName()

_getName()

تعرض هذه السمة الاسم الذي تسمّى به جهاز التتبُّع عند إنشائه.

مقتطف غير متزامن (يُنصح به)

_gaq.push(function() {
  var pageTracker = _gat._getTrackerByName(); // Gets the default tracker.
  var trackerName = pageTracker._getName();
});

returns

String اسم جهاز التتبُّع

_getAccount()

_getAccount()

تعرض رقم تعريف "إحصاءات Google" لعنصر التتبُّع هذا. إذا كنت تتتبّع الصفحات على موقعك الإلكتروني في حسابات متعددة، يمكنك استخدام هذه الطريقة لتحديد الحساب المرتبط بعنصر تتبُّع معيّن.

مقتطف غير متزامن (يُنصح به) 

_gaq.push(function() {
  var pageTracker = _gat._getTrackerByName(); // Gets the default tracker.
  var accountId = pageTracker._getAccount();
});

returns

String رقم تعريف الحساب الذي تم إنشاء مثيل لعنصر التتبُّع هذا باستخدامه.

_getVersion()

_getVersion()

لعرض رقم إصدار GATC.

مقتطف غير متزامن (يُنصح به) 

_gaq.push(function() {
  var pageTracker = _gat._getTrackerByName(); // Gets the default tracker.
  var version = pageTracker._getVersion();
});

returns

String رقم إصدار GATC

_getvisitorCustomVar()

_getVisitorCustomVar(index)

تعرض قيمة المتغيّر المخصّص على مستوى الزائر التي تم تعيينها للفهرس المحدّد.

مقتطف غير متزامن (يُنصح به) 

_gaq.push(function() {
  var pageTracker = _gat._getTrackerByName(); // Gets the default tracker.
  var visitorCustomVar1Value = pageTracker._getVisitorCustomVar(1);
});

المَعلَمات

Int   index فهرس المتغيّر المخصّص على مستوى الزائر.

returns

String قيمة المتغيّر المخصّص على مستوى الزائر. تعرض القيمة غير معرَّفة إذا تعذّر استرداد المتغيّر للفهرس المحدّد.

_initData()

_initData()تم الإيقاف. يتم الآن تنفيذ initData() تلقائيًا في رمز التتبع ga.js.

يقوم بتهيئة كائن GATC (رمز متتبع "إحصاءات Google") أو إعادة تهيئته.

var pageTracker = _gat._getTracker("UA-12345-1");
pageTracker._trackPageview();

_setAccount()

_setAccount(accountId)

تُستخدَم حصريًا في التتبُّع غير المتزامن. يضبط رقم تعريف موقع الويب لكائن التتبع.

_gaq.push(['_setAccount', 'UA-XXXXX-X']);

المَعلَمات

String accountID رقم تعريف الموقع الإلكتروني الكامل (مثل UA-65432-1) لعنصر التتبُّع.

_setCookiePersistence()

_setCookiePersistence(milliseconds)

تم إيقاف هذه الطريقة نهائيًا. يُرجى استخدام _setVisitorCookieTimeout(cookieTimeoutMillis) بدلاً منها.

ضبط تاريخ انتهاء صلاحية ملف تعريف ارتباط الزائر في "إحصاءات Google" بالمللي ثانية. يتم تلقائيًا ضبط ملف تعريف الارتباط الخاص بالزائر على أن تنتهي صلاحيته خلال عامَين. يمكنك تغيير تاريخ انتهاء صلاحية ملف تعريف ارتباط الزائر باستخدام هذه الطريقة إذا كنت تفضّل ذلك. على سبيل المثال، لتحديد تاريخ انتهاء صلاحية ملف تعريف ارتباط الزائر على 7 أيام، يجب استخدام الرمز التالي:

pageTracker._setCookiePersistence(604800000);

المَعلمات

Number   milliseconds وقت انتهاء صلاحية ملف تعريف ارتباط الزائر الجديد

_setCustomVar()

_setCustomVar(index, name, value, opt_scope)

تضبط متغيّرًا مخصَّصًا بالاسم والقيمة والنطاق للمتغير المذكورَين. الحد الأقصى لعدد الأحرف المسموح به هو 128 بايت لكل من name وvalue معًا.

مقتطف غير متزامن (يُنصح به) 

_gaq.push(['_setCustomVar', 1, 'Section', 'Life & Style', 3]);

returns

Boolean تعرض هذه الطريقة القيمة true إذا تم ضبط المتغيّر المخصَّص بنجاح، وتعرض false إذا لم يتم ضبطه (على سبيل المثال، إذا تجاوز طول سلسلة الاسم/القيمة 128 بايت، أو إذا استخدمت خانة غير صحيحة).

المَعلَمات

Int      index       مطلوب. الخانة المستخدَمة للمتغير المخصّص. القيم المحتملة هي 1-5، بشكل شامل.

String   name        مطلوب. اسم المتغيّر المخصَّص.

String   value       مطلوب. قيمة المتغيّر المخصَّص.

Int      opt_scope   اختيارية: النطاق المستخدَم للمتغير المخصّص. القيم المحتملة هي 1 على مستوى الزائر، و2 على مستوى الجلسة، و3 على مستوى الصفحة.

_setعيّنRate()

_setSampleRate(newRate)

ضبط معدل العينة الجديد. إذا كان موقعك الإلكتروني كبيرًا بشكلٍ خاص ويتعرض لارتفاع كبير في عدد الزيارات، يضمن ضبط معدّل العيّنة تتبُّع التقارير بدون انقطاع. يحدث أخذ العينات في Google Analytics باستمرار على مستوى الزوّار الفريدين؛ وبالتالي هناك نزاهة في المؤشرات وإعداد التقارير حتى عند تفعيل أخذ العينات، وذلك؛ نظرًا لأن الزائرين الفريدين يظلون مدرجين أو مستبعدين من العيّنة، كما هو محدد من بدء أخذ العينات.

تحتاج فقط إلى تحديد هذه الطريقة في وقت استدعاء _setAccount() ، عادةً مرة واحدة في كل صفحة أو تطبيق (حيثما يتم تهيئة شفرة التتبع نفسها). تذكَّر أنّ قيمة معدّل العيّنة التي تحدّدها تظل سارية طوال مدّة كائن التتبّع نفسه.

مقتطف غير متزامن (يُنصح به) 

_gaq.push(['_setSampleRate', '2.5']);

المَعلَمات

String newRate معدّل البيانات النموذجي الجديد المطلوب ضبطه قدِّم سلسلة رقمية بين 0 و100 (بدقة مربّعتَين عشريتَين).

_setSessionمهلة()

_setSessionTimeout(newTimeout)

تم إيقاف هذه الطريقة نهائيًا. يُرجى استخدام _setSessionCookieTimeout(cookieTimeoutMillis) بدلاً منها.

ضبط مهلة الجلسة الجديدة بالثواني يتم ضبط مهلة الجلسة تلقائيًا على 30 دقيقة (1800 ثانية). يتم استخدام مهلة الجلسة لحساب الزيارات (راجِع كيفية تحديد الجلسة في "إحصاءات Google"). إذا أردت تغيير تعريف "جلسة" حسب احتياجاتك الخاصة، يمكنك تحديد قيمة جديدة ضمن عدد الثواني. سيؤثر ذلك في تقارير "الزيارات" في كل قسم يتم فيه احتساب عدد الزيارات وحيث يتم استخدام الزيارات في حساب القيم الأخرى. على سبيل المثال، سيزداد عدد الزيارات بشكل عام في حال تقليل مهلة الجلسة، وفي حال زيادة مهلة الجلسة بشكل عام.

المَعلمات

String newTimeout مهلة جديدة للجلسة لضبطها بالثواني.

_setSessionCookieSession()

_setSessionCookieTimeout(cookieTimeoutMillis)

لضبط مهلة ملف تعريف الارتباط للجلسة الجديدة بالمللي ثانية. بشكل افتراضي، يتم ضبط مهلة الجلسة على 30 دقيقة. تُستخدم مهلة الجلسة لحساب الزيارات، نظرًا لأن الزيارة تنتهي بعد 30 دقيقة من عدم نشاط المتصفح أو عند خروج المتصفح. إذا كنت تريد تغيير تعريف "جلسة" لتلبية احتياجاتك الخاصة، فيمكنك تمرير عدد المللي ثانية لتعريف قيمة جديدة. وسيؤثر هذا في تقارير "الزيارات" في كل قسم يتم فيه احتساب عدد الزيارات، وحيث تُستخدم الزيارات في حساب القيم الأخرى. على سبيل المثال، سيزداد عدد الزيارات في حال تقليل مهلة الجلسة، وفي حال زيادة مهلة الجلسة. يمكنك تغيير مهلة انتهاء الصلاحية إلى 0 للإشارة إلى ضرورة حذف ملف تعريف الارتباط هذا عند إغلاق المتصفح.

مقتطف غير متزامن (يُنصح به) 

_gaq.push(['_setSessionCookieTimeout', 1800000]);


المَعلَمات

Number cookieTimeoutMillis انتهاء مهلة الجلسة الجديدة بالمللي ثانية أو 0 لحذف ملف تعريف الارتباط عند إغلاق المتصفِّح.

_setSiteSpeedعيّنRate()

_setSiteSpeedSampleRate(sampleRate)

تُحدد حجمًا جديدًا لمجموعة بيانات "سرعة الموقع". وبشكلٍ تلقائي، تشكّل نسبة 1% الثابتة من زوّار موقعك الإلكتروني مجمع البيانات الذي يتم الحصول منه على مقاييس سرعة الموقع. إذا كان لديك عدد قليل نسبيًا من الزوّار اليوميين إلى موقعك الإلكتروني، مثل 100,000 زائر أو أقل، قد يكون من الأفضل ضبط العيّنات على معدّل أكبر. وسيؤدي ذلك إلى زيادة الدقّة في وقت تحميل الصفحة ومقاييس سرعة الموقع الإلكتروني الأخرى. (راجِع سرعة الموقع الإلكتروني في مركز المساعدة للحصول على تفاصيل حول تقارير "سرعة الموقع").

يجب طلب طريقة _setSiteSpeedSampleRate() قبل _trackPageview() لتكون سارية.

تقصِر "إحصاءات Google" نتائج جمع سرعة الموقع الإلكتروني لموقع واحد إلى أكبر من 1% من المستخدمين أو 10 آلاف نتيجة في اليوم لضمان التوزيع العادل لموارد النظام لهذه الميزة.

ملاحظة: ننصح المواقع الإلكترونية التي تسجِّل أكثر من مليون نتيجة في اليوم بإبقاء اختيار تلك النماذج على المعدّل التلقائي وهو% 1. وإنّ تعديل حجم العيّنة وضبطها على عدد أكبر لن يؤدي إلى زيادة حجمها.

مقتطف غير متزامن (يُنصح به) 

_gaq.push(['_setSiteSpeedSampleRate', 5]);
_gaq.push(['_trackPageview']);

المَعلَمات

Number sampleRate القيمة بين 0 و100 لتحديد النسبة المئوية لزوّار موقعك الإلكتروني الذين سيتم قياسهم لأغراض "سرعة الموقع". على سبيل المثال، تضبط القيمة 5 نموذج جمع سرعة الموقع الإلكتروني على %5.

_setSeeorCookieمهلة()

_setVisitorCookieTimeout(cookieTimeoutMillis)

ضبط تاريخ انتهاء صلاحية ملف تعريف ارتباط الزائر في "إحصاءات Google" بالمللي ثانية. يتم ضبط ملف تعريف الارتباط الخاص بالزائر تلقائيًا على أن تنتهي صلاحيته خلال عامَين يمكنك تغيير تاريخ انتهاء صلاحية ملفّ تعريف ارتباط الزائر باستخدام هذه الطريقة إذا كنت تفضّل ذلك. يمكنك تغيير مهلة انتهاء الصلاحية إلى 0 للإشارة إلى ضرورة حذف ملف تعريف الارتباط هذا عند إغلاق المتصفّح.

مقتطف غير متزامن (يُنصح به) 

_gaq.push(['_setVisitorCookieTimeout', 63072000000]);

المَعلَمات

Number cookieTimeoutMillis وقت انتهاء صلاحية ملف تعريف ارتباط الزائر الجديد بالمللي ثانية أو 0 لحذف ملف تعريف الارتباط عند إغلاق المتصفّح.

_setVar()

_setVar(newVal)

تم إيقاف هذه الطريقة نهائيًا. يُرجى استخدام "_setCustomVar()" بدلاً من ذلك.

تعمل على ضبط أو تحديد شريحة زائر مخصّصة باستخدام السلسلة المقدَّمة. ويمكنك استخدام هذه القيمة لتقديم تصنيف إضافي لمستخدمي موقعك الإلكتروني. على سبيل المثال، يمكنك إنشاء صفحة لتسجيل الدخول أو نموذج يؤدّي إلى ظهور قيمة استنادًا إلى البيانات التي يُدخلها الزائر، مثل خيار مفضّل يختاره الزائر أو أحد خيارات الخصوصية. ويتمّ بعد ذلك تعديل هذا المتغيّر في ملفّ تعريف الارتباط لذلك الزائر. وعند تنفيذها على موقعك الإلكتروني وجمع البيانات بهذه الطريقة، تظهر الشريحة المحدّدة حديثًا في تقارير من تحديد المستخدم ضمن قسم "الزائرون" ضمن تقارير "إحصاءات Google". إضافةً إلى ذلك، يمكنك الوصول إلى قسم القيمة المحدّدة من قِبل المستخدم في تقرير "تفاصيل المحتوى" لمعرفة النسبة المئوية لزوّار إحدى الصفحات التي ينتمون إلى شريحة معيّنة تحدّدها أنت.

المَعلمات

String newVal قيمة من تحديد المستخدم الجديد المطلوب ضبطها.

_trackPageLoadTime()

_trackPageLoadTime()

تم إيقاف هذه الطريقة نهائيًا بسبب تفعيل ميزة إعداد تقارير "سرعة الموقع" تلقائيًا لجميع المستخدمين. يُرجى استخدام _setSiteSpeedSampleRate() لضبط معدّل أخذ العينات لإعداد تقارير سرعة الموقع.

لتفعيل تقارير سرعة الموقع لهذه الصفحة. أدخِل هذه الطريقة لكل صفحة على موقعك الإلكتروني تريد إعداد تقارير لسرعة الموقع فيها. لمزيد من المعلومات حول تقارير "سرعة الموقع" في "إحصاءات Google"، يمكنك الاطّلاع على مقالة سرعة الموقع الإلكتروني في مركز المساعدة.

التحقق من التغييرات

إذا ظهرت لك بيانات في التقارير، يعني ذلك أنّ إعداداتك صحيحة. وإذا لم تظهر لك أي بيانات بعد 24 ساعة، تحقّق من تخصيصاتك للتأكّد من عدم حدوث أي أخطاء. اطّلع على تحديد المشاكل في رمز التتبّع وحلّها للحصول على قائمة بالأخطاء الشائعة في رمز التتبّع. يتضمّن دليل تحديد المشاكل وحلّها هذا أيضًا الخطوات الأساسية لتصحيح الأخطاء ومعلومات إضافية عن تصحيح الأخطاء.

يرجى الانتباه إلى أن تمكين تتبع سرعة الموقع في موقعك يؤدي إلى زيادة الطلب على خوادم Google Analytics، هذا بخلاف طلب GIF لتتبع الصفحة الذي يتم إنشاؤه لمشاهدات الصفحة. للحد من تأثير ذلك في وقت استجابة الموقع بوجه عام، يتم إرسال هذا الطلب إلى موقعك في شكل عينات من مشاهدات الصفحة فقط؛ ولهذا السبب، قد لا يظهر لك طلب GIF لسرعة الموقع عند محاولة تصحيح أخطاء هذه الميزة في Firebug أو الأدوات الأخرى. وهذا أمر طبيعي ومتوقع.

مقتطف غير متزامن (يُنصح به) 

_gaq.push(['_setAccount', 'UA-12345-1']);
_gaq.push(['_trackPageview']);
_gaq.push(['_trackPageLoadTime']);

_trackPageview()

_trackPageview(opt_pagePath)

المنطق الرئيسي لخدمة GATC (رمز أداة تتبع Google Analytics). في حال تفعيل وظائف الرابط، ستحاول استخراج قيم ملفات تعريف الارتباط من عنوان URL. وإلا، فإنه يحاول استخراج قيم ملفات تعريف الارتباط من document.cookie. كما أنه يحدّث ملفات تعريف الارتباط أو ينشئها حسب الضرورة، ثم يعيد كتابتها في كائن المستند. يجمع كل المقاييس المناسبة لإرسالها إلى الواجهة الأمامية لمجمع Urchin Collector.

مقتطف غير متزامن (يُنصح به) 

_gaq.push(['_setAccount', 'UA-12345-1']);
_gaq.push(['_trackPageview', '/home/landingPage']);

المَعلَمات

String opt_pagePath مَعلمة اختيارية للإشارة إلى مسار الصفحة المطلوب تتبُّع المقاييس ضمنها. عند استخدام هذا الخيار، استخدِم شرطة مائلة في البداية (/) للإشارة إلى مسار الصفحة.