الحصول على بيانات الحقل وإعدادها

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

رد الاتصال الجاهز

دالة معاودة الاتصال الجاهزة هي وظيفة يمكنك إضافتها إلى قائمة انتظار الأوامر ga(). سيتم استدعاء الدالة فور تحميل مكتبة analytics.js بالكامل، وتنفيذ جميع الأوامر السابقة المضافة إلى قائمة الانتظار.

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

يوضح الرمز التالي كيفية الوصول إلى كائن التتبع التلقائي وتسجيله في وحدة التحكم:

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

ga(function(tracker) {
  // Logs the tracker created above to the console.
  console.log(tracker);
});

الحصول على أجهزة التتبع من خلال طرق ga Object

في حال عدم استخدام جهاز التتبُّع التلقائي أو ظهور أكثر من جهاز تتبُّع واحد في الصفحة، يمكنك الوصول إلى أجهزة التتبُّع هذه من خلال إحدى طريقتَي ga.

بعد تحميل مكتبة analytics.js بالكامل، تضيف طرقًا إضافية إلى العنصر ga نفسه. تُستخدَم اثنتان من هذه الطرق، getByName وgetAll، للوصول إلى عناصر جهاز التتبُّع.

ملاحظة: لا تتوفر طرق عناصر ga إلا عند تحميل analytics.js بالكامل، لذا يجب عليك الإشارة إليها فقط داخل معاودة اتصال جاهزة.

getByName

إذا كنت تعرف اسم جهاز التتبُّع الذي تريد الوصول إليه، يمكنك إجراء ذلك باستخدام طريقة getByName:

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

ga(function() {
  // Logs the "myTracker" tracker object to the console.
  console.log(ga.getByName('myTracker'));
});

getAll

للحصول على مجموعة تضم جميع أدوات التتبُّع التي تم إنشاؤها، استخدِم الإجراء getAll:

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

ga(function() {
  // Logs an array of all tracker objects.
  console.log(ga.getAll());
});

الحصول على البيانات المخزَّنة على جهاز التتبُّع

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

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

ga(function(tracker) {
  // Logs the trackers name.
  // (Note: default trackers are given the name "t0")
  console.log(tracker.get('name'));

  // Logs the client ID for the current user.
  console.log(tracker.get('clientId'));

  // Logs the URL of the referring site (if available).
  console.log(tracker.get('referrer'));
});

تعديل البيانات

يمكن تعديل عناصر أداة التتبُّع باستخدام طريقة set. يمكن استدعاء طريقة set في جهاز التتبُّع على عنصر التتبُّع نفسه أو من خلال إضافة أمر set إلى قائمة انتظار الأوامر ga().

بما أنّ الحصول على مرجع إلى عنصر أداة تتبُّع يتطلّب استخدام ميزة "معاودة الاتصال الجاهزة"، ننصح باستخدام قائمة انتظار الأوامر ga() لتعديل جهاز التتبُّع.

قائمة انتظار الأوامر ga()

يمكن استدعاء الأمر set بطريقتَين: من خلال تمرير مَعلمتَين، وهما حقل وقيمته المقابلة، أو عن طريق تمرير كائن من أزواج الحقل/القيمة.

في المثال التالي، يتم ضبط الحقل page على '/about' في جهاز التتبُّع التلقائي:

ga('set', 'page', '/about');

يحدّد هذا المثال الحقلَين page وtitle في الوقت نفسه:

ga('set', {
  page: '/about',
  title: 'About Us'
});

استخدام جهاز تتبُّع يحمل اسمًا

إذا كنت تستخدم جهاز تتبُّع مُسمّى بدلاً من جهاز التتبُّع التلقائي، يمكنك إدخال اسمه في سلسلة الأوامر.

يضبط الاستدعاء التالي الحقل page في جهاز التتبُّع الذي يحمل اسم "myTracker":

ga('myTracker.set', 'page', '/about');

على جهاز التتبُّع نفسه

إذا كان لديك إشارة إلى عنصر التتبُّع، يمكنك استدعاء طريقة set الخاصة بجهاز التتبُّع مباشرةً باتّباع الخطوات التالية:

ga(function(tracker) {
  tracker.set('page', '/about');
});

ملاحظة: لا يتم تعديل عناصر جهاز التتبُّع بنفسها. إذا غيَّر المستخدم حجم النافذة، أو إذا عدَّل الرمز الذي يعمل على الصفحة عنوان URL، لن ترصد عناصر أداة التتبُّع هذه المعلومات تلقائيًا. يجب تعديل هذه التغييرات يدويًا في عنصر التتبُّع.

بنية علامة العطف

عادةً ما يتم الحصول على حقول أداة التتبع وإعدادها باستخدام أسماء الحقول. (يُرجى الرجوع إلى المرجع الحقلي للحصول على قائمة كاملة بحقول analytics.js وأسمائها).

هناك طريقة بديلة للحصول على الحقول وإعدادها، وهي الرجوع إليها حسب أسماء أسماء مَعلمات Measurement Protocol المقابلة لها.

على سبيل المثال، يسجِّل تعبيرا console.log التاليان عنوان المستند في وحدة التحكّم:

ga(function(tracker) {
  // Gets the title using the analytics.js field name.
  console.log(tracker.get('title'));

  // Gets the title using the measurement protocol
  // parameter name, prefixed with an ampersand.
  console.log(tracker.get('&dt'));
});

بوجهٍ عام، لا يُنصح باستخدام بنية علامة العطف ويجب ألا يتم استخدامها إلا عند عدم توفّر اسم حقل analytics.js لمَعلمة Measurement Protocol (يحدث هذا الأمر من حين لآخر عند إضافة ميزة جديدة إلى Measurement Protocol قبل تنفيذها في analytics.js).

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

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