يمكنك استخدام قائمة انتظار الأوامر ga() تقريبًا لإجراء كل ما تحتاج إلى قياسه باستخدام analytics.js. يشرح هذا الدليل ماهية قائمة انتظار الأوامر وكيف تعمل وكيفية تنفيذ الأوامر لقياس تفاعلات المستخدم.
قائمة انتظار الأوامر ga
تحدّد علامة "إحصاءات Google" دالة ga عامة تُعرف باسم "قائمة انتظار الأوامر". ويطلق عليها قائمة انتظار الأوامر، لأنّه بدلاً من تنفيذ الأوامر التي تتلقّاها على الفور، فإنّها تضيفها إلى قائمة انتظار تؤخّر عملية التنفيذ إلى أن يتم تحميل مكتبة analytics.js بالكامل.
في JavaScript، الدوال هي أيضًا كائنات، مما يعني أنها يمكن أن تحتوي على خصائص. تحدّد علامة "إحصاءات Google" سمة q في كائن الدالة ga على أنّها مصفوفة فارغة. قبل تحميل مكتبة analytics.js، يؤدي استدعاء الدالة ga() إلى إلحاق قائمة الوسيطات التي تم تمريرها إلى الدالة ga() إلى نهاية صفيف q.
على سبيل المثال، إذا أردت تشغيل علامة "إحصاءات Google" ثم تسجيل محتوى ga.q على الفور في وحدة التحكّم، سترى مصفوفة يبلغ طولها عنصران يحتويان على مجموعتَي الوسيطات التي تم تمريرها إلى الدالة ga():
console.log(ga.q);
// Outputs the following:
// [
// ['create', 'UA-XXXXX-Y', 'auto'],
// ['send', 'pageview']
// ]
بعد تحميل مكتبة analytics.js، تفحص محتوى مصفوفة ga.q وتنفِّذ كل أمر بالترتيب. وبعد ذلك، تتم إعادة تعريف الدالة ga()، بحيث يتم تنفيذ جميع الاستدعاءات اللاحقة على الفور.
يتيح هذا النمط للمطوّرين استخدام قائمة انتظار أوامر "ga()" بدون القلق بشأن ما إذا كان تحميل مكتبة analytics.js قد انتهت أم لا. وهو يوفّر واجهة بسيطة ومتزامنة تزيل معظم تعقيدات الرمز غير المتزامن.
إضافة الأوامر إلى قائمة الانتظار
تشترك كل الطلبات الموجَّهة إلى قائمة انتظار الأوامر ga() في توقيع مشترك. المعلمة الأولى، "command"، هي سلسلة تحدّد طريقة analytics.js معيّنة. وأي معلَمات إضافية هي الوسيطات التي يتم تمريرها إلى هذه الطريقة.
يمكن أن تكون الطريقة التي يشير إليها طلب معيّن طريقة عمومية، مثل create، أو طريقة في كائن ga، أو يمكن أن تكون طريقة مثيل على كائن أداة تتبُّع، مثل send. إذا تلقت قائمة انتظار الأوامر ga() أمرًا لم تتعرّف عليه، ستتجاهله ببساطة، ما يجعل الاتصال بالدالة ga() أمرًا آمنًا للغاية، إذ إنّها في الغالب لن تؤدي إلى حدوث خطأ.
للحصول على قائمة شاملة بجميع الأوامر التي يمكن تنفيذها من خلال قائمة انتظار الأوامر، يُرجى الاطّلاع على مرجع قائمة انتظار الأوامر ga().
مَعلمات الطلبات
تقبل معظم أوامر analytics.js (وطرقها المقابلة) المَعلمات في عدد من التنسيقات المختلفة. يتم ذلك لتسهيل الأمر لتمرير الحقول الشائعة الاستخدام إلى طرق معيّنة.
كمثال، ضع في اعتبارك الأمرين في علامة "إحصاءات Google":
ga('create', 'UA-XXXXX-Y', 'auto');
ga('send', 'pageview');
في الأمر الأول، تقبل السمة create الحقول trackingId وcookieDomain وname لتحديدها اختياريًا كمَعلمات ثانية وثالثة ورابعة على التوالي. يقبل الأمر send معلَمة hitType ثانية اختيارية.
تقبل جميع الأوامر مَعلمة fieldsObject نهائية يمكن استخدامها لتحديد أي حقول أيضًا. على سبيل المثال، يمكن إعادة كتابة الأمرين أعلاه في العلامة على النحو التالي:
ga('create', {
trackingId: 'UA-XXXXX-Y',
cookieDomain: 'auto'
});
ga('send', {
hitType: 'pageview'
});
راجِع مرجع قائمة انتظار الأوامر ga() للحصول على قائمة شاملة بالمعلَمات الاختيارية المسموح بها لكل أمر.
الخطوات التالية
بعد قراءة هذا الدليل، من المفترض أن تكون على دراية جيدة بكيفية تنفيذ الأوامر باستخدام analytics.js وكيفية عمل قائمة انتظار الأوامر. يتناول الدليل التالي كيفية إنشاء عناصر جهاز التتبُّع.