يمكن استخدام العنصر العام _gaq
مباشرةً لتتبُّع الصفحات غير المتزامنة من خلال طريقة push(...)
. كما يتضمن التطبيق طرقًا لإنشاء عناصر أداة التتبع، ولكن يجب عدم استخدامها إلا في حالات نادرة.
بالنسبة إلى التتبُّع التقليدي للصفحات، استخدِم العنصر العام _gat
بدلاً من ذلك.
طرق عنصر _gaq
_createAsyncTracker(accountId, opt_name)
متوقّف نهائيًا_getAsyncTracker(opt_name)
متوقّف نهائيًاpush(commandArray)
تفاصيل الطريقة
_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']);
تُسمى هذه الدالة
_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
عدد الأوامر التي تعذَّر تنفيذها