إنشاء أدوات التتبع

كائنات أداة التتبُّع (المعروفة أيضًا باسم &&;;quot;trackers") هي عناصر يمكنها جمع البيانات وتخزينها ثم إرسالها إلى "إحصاءات Google".

عند إنشاء أداة تتبّع جديدة، عليك تحديد رقم تعريف تتبّع (هو نفسه رقم تعريف الموقع الذي يتوافق مع واحد من مواقع "إحصاءات Google") بالإضافة إلى نطاق ملفات تعريف الارتباط الذي يحدد كيفية تخزين ملفات تعريف الارتباط. (تحدّد القيمة المُقترَحة 'auto' الإعداد التلقائي لنطاق ملفات تعريف الارتباط).

وفي حال عدم وجود ملف تعريف ارتباط للنطاق المحدَّد، يتم إنشاء معرِّف عميل ويتم تخزينه في ملف تعريف الارتباط، ويتم تحديد المستخدم على أنه جديد. وفي حال توفُّر ملف تعريف ارتباط يحتوي على قيمة معرِّف العميل، يتم ضبط معرِّف العميل هذا على أداة التتبُّع، ويتم تحديد المستخدم على أنه مكرِّر الزيارة.

عند الإنشاء، تجمع عناصر أداة التتبّع أيضًا معلومات حول سياق التصفّح الحالي، مثل عنوان الصفحة وعنوان URL، ومعلومات عن الجهاز، مثل درجة دقة الشاشة وحجم إطار العرض وترميز المستند. عندما يحين وقت إرسال البيانات إلى "إحصاءات Google"، يتم إرسال جميع المعلومات المخزّنة حاليًا على أداة التتبّع.

طريقة الإنشاء

توفّر مكتبة analytics.js طرقًا متنوعة لإنشاء أدوات التتبّع، ولكن الطريقة الأكثر شيوعًا هي استخدام الأمر create وتمرير حقلَي رقم تعريف التتبّع ونطاق ملف تعريف الارتباط كمعلّمتين ثانية وثالثة:

ga('create', 'UA-XXXXX-Y', 'auto');

أدوات تتبّع التسمية

يمكنك أيضًا اختيار تسمية أداة التتبّع من خلال تمرير الحقل name كوسيطة رابعة في الأمر create. يكون من الضروري تسمية أداة تتبّع في الحالات التي تحتاج فيها إلى إنشاء أكثر من أداة تتبّع واحدة للصفحة نفسها. لمزيد من التفاصيل عن سبب الحاجة إلى ذلك، يُرجى الاطّلاع على القسم أدناه حول العمل مع برامج تتبُّع متعددة.

ga('create', 'UA-XXXXX-Y', 'auto', 'myTracker');

يُعرَف إنشاء أداة تتبُّع بدون ضبط الحقل name باسم "إنشاء أداة تتبُّع" &"التلقائية". يتم تلقائيًا إعطاء أداة التتبع التلقائية الاسم "t0".

تحديد الحقول في وقت الإنشاء

وقد يتم أيضًا تمرير كائن حقول اختياري يسمح لك بضبط أيٍّ من حقول analytics.js في وقت الإنشاء، حتى يتم تخزينها على أداة التتبّع وتطبيقها على جميع النتائج التي يتم إرسالها.

ga('create', 'UA-XXXXX-Y', 'auto', 'myTracker', {
  userId: '12345'
});

وكما هو الحال مع جميع عمليات الاستدعاء للدالة ga()، يمكن أيضًا استخدام كائن الحقول لتحديد جميع الحقول معًا:

ga('create', {
  trackingId: 'UA-XXXXX-Y',
  cookieDomain: 'auto',
  name: 'myTracker',
  userId: '12345'
});

يمكنك الاطّلاع على مرجع طريقة create للحصول على تفاصيل أكثر شمولاً.

استخدام أدوات تتبّع متعددة

في بعض الحالات، قد تريد إرسال البيانات إلى مواقع متعددة من صفحة واحدة. ويُعدّ هذا الأمر مفيدًا للمواقع الإلكترونية التي تضمّ عدة مالكين يشرفون على أقسام من الموقع الإلكتروني، ويمكن لكل مالك الاطّلاع على موقعه الإلكتروني الخاص.

لتتبُّع بيانات موقعين منفصلين، عليك إنشاء برنامجَي تتبُّع منفصلَين، ويجب أن يكون أحدهما على الأقل أداة تتبُّع مُسمّاة. يُنشئ الأمران التاليان أداة تتبُّع تلقائية أداة تتبُّع باسم &"clientTracker":

ga('create', 'UA-XXXXX-Y', 'auto');
ga('create', 'UA-XXXXX-Z', 'auto', 'clientTracker');

تنفيذ الأوامر لأداة تتبُّع محدّدة

لتشغيل أوامر analytics.js لبرنامج تتبّع محدّد، يجب إضافة اسم الأمر إلى اسم التتبّع متبوعًا بنقطة. عند عدم تحديد اسم أداة التتبّع، يتم تشغيل الأمر في أداة التتبّع التلقائية.

لإرسال مرات مشاهدة الصفحة على مستوى المسارين أعلاه، يجب تشغيل الأمرين التاليين:

ga('send', 'pageview');
ga('clientTracker.send', 'pageview');

ستناقش الأدلة المستقبلية المزيد من التفاصيل حول بنية تنفيذ أوامر معيَّنة. يمكنك أيضًا الرجوع إلى مرجع قائمة انتظار الأوامر للاطّلاع على بنية الأمر الكاملة لجميع أوامر analytics.js.

الخطوات اللاحقة

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