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

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

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

_gaq Object Methods (كائن gaga)

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

_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(commandArray)
    ينفِّذ الإجراء command array المحدّد، وهو عبارة عن مصفوفة JavaScript تتوافق مع التنسيق التالي. يجب أن يكون العنصر الأول للمصفوفة هو اسم طريقة عنصر أداة التتبّع التي يتم تمريرها كسلسلة بيانات. بقية عناصر الصفيف هي القيم التي يتم تمريرها كوسيطات للدالة.

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

    تتم تسمية هذه الدالة Push بحيث يمكن استخدام مصفوفة بدلاً من _gaq قبل تحميل "إحصاءات 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 عدد الأوامر التي تعذّر تنفيذها