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

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

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

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