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

يمكن استخدام العنصر العام _gaq مباشرةً لتتبُّع الصفحات غير المتزامنة من خلال طريقة push(...). كما يتضمن التطبيق طرقًا لإنشاء عناصر أداة التتبع، ولكن يجب عدم استخدامها إلا في حالات نادرة.

بالنسبة إلى التتبُّع التقليدي للصفحات، استخدِم العنصر العام _gat بدلاً من ذلك.

طرق عنصر _gaq

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

_createAsyncTracker()

    _createAsyncTracker(accountId, opt_name)
    ينشئ كائن متتبّع يمكن الإشارة إليه بالاسم عند إجراء طلبات تتبُّع غير متزامنة. في حال عدم تحديد أي اسم، ستظهر السلسلة الفارغة '' التي تمثّل أداة التتبُّع التلقائية في بنية غير متزامنة. في حال توفُّر أداة تتبُّع غير متزامنة للاسم المحدَّد، سيتم استبدالها بجهاز التتبُّع الجديد.

    ملاحظة: لا يمكن استخدام هذه الطريقة بشكل عام إلا داخل دالة تم دفعها إلى _gaq. يجب عدم استخدامها إلا في حالات نادرة. 
    _gaq._createAsyncTracker('UA-65432-1');

    المَعلَمات

      String accountId رقم تعريف الموقع الإلكتروني الكامل (مثل UA-65432-1) لعنصر التتبُّع.
      String opt_name الاسم المطلوب تخزين عنصر التتبُّع تحته. يمكنك استخدام هذا الاسم للإشارة إلى عنصر المتتبّع في طلبات التتبّع غير المتزامنة لاحقًا.

    returns

      Tracker عنصر التتبّع الذي تم إنشاؤه

_getAsyncTracker()

    _getAsyncTracker(opt_name)
    لعرض كائن التتبُّع الذي تم إنشاؤه سابقًا بالاسم الذي تم إدخاله. في حال عدم تحديد اسم، سيتم استخدام اسم جهاز التتبُّع التلقائي (السلسلة الفارغة ''). في حال عدم وجود كائن متتبع بالاسم المعني، يتم إنشاء جهاز تتبع جديد وتعيينه لهذا الاسم ثم عرضه.

    ملاحظة: لا يمكن استخدام هذه الطريقة بشكل عام إلا داخل دالة تم دفعها إلى _gaq. يجب عدم استخدامها إلا في حالات نادرة. 
    _gaq._getAsyncTracker();

    المَعلَمات

      String opt_name اسم عنصر التتبُّع المطلوب استرداده.

    returns

      Tracker عنصر التتبّع الذي تم استرداده أو إنشاؤه

push

    push(commandArray)
    ينفّذ command array المحدد، وهو ببساطة مصفوفة JavaScript تتوافق مع التنسيق التالي. يجب أن يكون العنصر الأول من الصفيفة اسم طريقة كائن أداة التتبُّع التي يتم تمريرها كسلسلة. بقية عناصر الصفيف هي القيم التي سيتم تمريرها كوسيطات إلى الدالة.

    الاستخدام التالي عادي:
    var _gaq = _gaq || [];
_gaq.push(['_setAccount', 'UA-65432-1']);
_gaq.push(['_trackPageview']);

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

    يمكن تسمية أجهزة التتبُّع من خلال إضافة اسم جهاز التتبُّع (مع نقطة) في بداية اسم الطريقة. في حال كان اسم الدالة مؤهّلاً باسم جهاز التتبُّع، يتم تنفيذه على جهاز التتبُّع هذا.

    في المثال التالي، يتم إنشاء جهاز تتبُّع واستخدامه عشوائيًا يُطلق عليه اسم myTracker.
    var _gaq = _gaq || [];
_gaq.push(['myTracker._setAccount', 'UA-65432-2']);
_gaq.push(['myTracker._setDomainName', 'foo.com']);
_gaq.push(['myTracker._trackPageview']);

    ملاحظة: يتم إنشاء أدوات التتبُّع في المرة الأولى التي يشير فيها الطلب إليها. يتم إنشاء جهاز التتبُّع التلقائي من خلال الأمر الأول الذي لا يسمّيه صراحةً اسم جهاز التتبُّع. واسم أداة التتبُّع التلقائي هو السلسلة الفارغة ''.

    بالإضافة إلى دفع صفائف الأوامر، يمكنك أيضًا نشر كائنات الدوال. يمكن أن يكون ذلك مفيدًا بشكل خاص لطرق التعقب التي تعرض القيم. ويمكن أن تشير هاتان الدالتان إلى كل من _gat و_gaq.
    var _gaq = _gaq || [];
_gaq.push(function() {
  var tracker = _gat._getTracker('UA-65432-1');
  tracker._trackPageview();
});

    يمكنك أيضًا استخدام بنية الدفع مباشرةً في تنسيق HTML لصفحتك.
    onclick="_gaq.push(['_trackEvent', 'name', value]);"

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

    أخيرًا، بدلاً من كتابة _gaq.push(...) لكل مصفوفة أوامر، يمكنك إرسال جميع الأوامر مرة واحدة. توضح التعليمة البرمجية التالية هذا الأسلوب. اطّلِع على دليل استخدام المقتطفات غير المتزامنة للحصول على مزيد من التفاصيل. 

    _gaq.push(
  ['_setAccount', 'UA-XXXXX-X'],
  ['_setDomainName', 'example.com'],
  ['_setCustomVar', 1, 'Section', 'Life & Style', 3],
  ['_trackPageview']
);

      المَعلَمات

        Array commandArray الأمر الذي سيتم تنفيذه. يمكن إرسال عنصر واحد أو أكثر في الاستدعاء نفسه.

      returns

        Number عدد الأوامر التي تعذَّر تنفيذها