تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

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

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

_deleteCustomVar(index)
_getName()
_getAccount()
_getVersion()
_getVisitorCustomVar(index)
_initData() متوقف
_setAccount(accountID)
_setCookiePersistence(milliseconds) متوقف
_setCustomVar(index, name, value, opt_scope)
_setSampleRate(newRate)
_setSessionTimeout(newTimeout) متوقف
_setSessionCookieTimeout(cookieTimeoutMillis)
_setSiteSpeedSampleRate(sampleRate)
_setVar(newVal) متوقف
_setVisitorCookieTimeout(cookieTimeoutMillis)
_trackPageLoadTime() متوقف
_trackPageview(opt_pageURL)

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

_deleteCustomVar()

_deleteCustomVar(index)

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

مقتطف غير متزامن (مقترَح)

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

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

pageTracker._deleteCustomVar(1);

المَعلَمات

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

_getName()

_getName()

يعرض الاسم الذي منحته أداة التتبّع عند إنشائها.

مقتطف غير متزامن (مقترَح)

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

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

pageTracker._getName();

returns

String اسم أداة التتبُّع.

_getAccount()

_getAccount()

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

مقتطف غير متزامن (مقترَح)

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

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

pageTracker._getAccount();

returns

String رقم تعريف الحساب الذي تم إنشاء مثيل له في أداة التتبع هذه.

_getVersion()

_getVersion()

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

مقتطف غير متزامن (مقترَح)

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

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

pageTracker._getVersion();

returns

رقم إصدار GATC String.

_getvisitorCustomVar()

_getVisitorCustomVar(index)

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

مقتطف غير متزامن (مقترَح)

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

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

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)

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

مقتطف غير متزامن (مقترَح)

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

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

pageTracker._setCustomVar(
    1,                   // Required - This custom var is set to slot #1
    "Section",           // Required - The top-level name for your online content categories
    "Life & Style",  // Required - Sets the value of "Section" to "Life & Style" for this particular article
    3                    // Optional - Sets the scope to page-level
);

returns

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

المَعلَمات

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

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

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

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

_setSampleRate()

_setSampleRate(newRate)

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

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

مقتطف غير متزامن (مقترَح)

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

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

pageTracker._setSampleRate("2.5"); //sets sampling rate to 2.5%

المَعلَمات

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

_setSessionTimeout()

_setSessionTimeout(newTimeout)

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

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

المعلّمات

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

_setSessionCookieTimeout()

_setSessionCookieTimeout(cookieTimeoutMillis)

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

مقتطف غير متزامن (مقترَح)

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

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

pageTracker._setSessionCookieTimeout(1800000); //number of milliseconds in 30 minutes

المَعلَمات

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

_setSiteSpeedSampleRate()

_setSiteSpeedSampleRate(sampleRate)

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

يجب استدعاء طريقة _setSiteSpeedSampleRate() قبل _trackPageview() لتكون فعّالة.

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

ملاحظة: نشجّع بشدة المواقع الإلكترونية التي تحقّق أكثر من مليون نتيجة في اليوم على إبقاء عيّنة عيّنها معدّلة على القيمة التلقائية البالغة% 1. ولن يؤدي تعديل حجم العينة إلى رقم أكبر إلى زيادة حجم العينة.

مقتطف غير متزامن (مقترَح)

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

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

pageTracker._setSiteSpeedSampleRate(5);
pageTracker._trackPageview();

المَعلَمات

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

_setvisitorCookieTimeout()

_setVisitorCookieTimeout(cookieTimeoutMillis)

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

مقتطف غير متزامن (مقترَح)

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

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

pageTracker._setVisitorCookieTimeout(63072000000); //number of milliseconds in 2 years

المَعلَمات

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

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

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

‎_trackPageview()‎

_trackPageview(opt_pagePath)

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

مقتطف غير متزامن (مقترَح)

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

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

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

المَعلَمات

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