إنشاء أدوات تتبُّع

عناصر التتبُّع (المعروفة أيضًا باسم "أدوات التتبُّع") هي عناصر يمكنها جمع البيانات وتخزينها ثم إرسالها إلى "إحصاءات 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.

الخطوات التالية

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