ويمكنك إجراء أي شيء تريد قياسه باستخدام analytics.js باستخدام قائمة الأوامر ga(). يوضّح هذا الدليل قائمة انتظار الأوامر وآلية عملها وكيفية تنفيذ الأوامر لقياس تفاعلات المستخدمين.
قائمة انتظار الأوامر ga
تحدّد علامة "إحصاءات Google" دالة ga عامة تُعرَف باسم &&;;;;command.". ويسمى هذا العنصر قائمة انتظار الأوامر، لأنه بدلاً من تنفيذ الأوامر التي يتلقاها على الفور، يضيفها إلى قائمة انتظار تؤخِّر التنفيذ إلى أن يتم تحميل مكتبة 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 وآلية عمل قائمة الأوامر. سيتناول الدليل التالي كيفية إنشاء عناصر أداة التتبُّع.