مرجع عنصر أداة التتبّع

يصف هذا المرجع الطرق المتاحة على الكائن Tracker.

ملخّص الطريقة

الطُرق
get(fieldName)	طلبات الإرجاع: * يحصل على قيمة الحقل المُخزّن على أداة التتبع.
set(fieldName|fieldsObject, [fieldValue])	طلبات الإرجاع: undefined تُحدِّد زوجًا من الحقول/القيمة أو مجموعة من أزواج الحقول/القيمة في أداة التتبُّع.
send([hitType], [...fields], [fieldsObject])	طلبات الإرجاع: undefined إرسال نتيجة إلى "إحصاءات Google".

تفاصيل الطريقة

get

يحصل على قيمة الحقل المُخزّن على أداة التتبع.

الاستخدام

tracker.get(fieldName);

المَعلمات

الاسم	النوع	مطلوب	الوصف
fieldName	string	نعم	اسم الحقل الذي يتم فيه الحصول على القيمة.

المرتجعات

*

أمثلة

// Creates a default tracker.
ga('create', 'UA-XXXXX-Y', auto);

// Gets the client ID of the default tracker and logs it.
ga(function(tracker) {
  var clientId = tracker.get('clientId');
  console.log(clientId);
});

---

set

تُحدِّد زوجًا من الحقول/القيمة أو مجموعة من أزواج الحقول/القيمة في أداة التتبُّع.

الاستخدام

// Sets a single field/value pair.
tracker.set(fieldName, fieldValue);

// Sets a group of field/value pairs.
tracker.set(fieldsObject);

ملاحظة: ننصحك لاستدعاء طريقة set باستخدام قائمة أوامر ga. يمكنك الاطّلاع على مرجع الطريقة المحدَّدة للحصول على مزيد من التفاصيل.

المَعلمات

اطّلِع على مرجع الحقل للحصول على مستندات الحقول الفردية.

المرتجعات

undefined

أمثلة

// Creates a default tracker.
ga('create', 'UA-XXXXX-Y', auto);

ga(function(tracker) {
  // Sets the page field to "/about.html".
  tracker.set('page', '/about.html');
});

// Creates a default tracker.
ga('create', 'UA-XXXXX-Y', auto);

ga(function(tracker) {
  // Sets both the page and title fields.
  tracker.set({
    page: '/about.html',
    title: 'About'
  });
});

---

send

إرسال نتيجة إلى "إحصاءات Google".

الاستخدام

tracker.send([hitType], [...fields], [fieldsObject]);

تمثّل الحقول التي تم إرسالها القيم المحدّدة في المَعلمتَين ...fields وfieldsObject، وقد تم دمجها مع الحقول المخزّنة حاليًا في أداة التتبّع.

ملاحظة: يتم إرسال القيم المحدّدة في ...fields وfieldsObject مع النتيجة الحالية، ولكن لا يتم تخزينها في عنصر أداة التتبّع. استخدم الطريقة set لتحديث أداة تتبُّع.

المَعلمات

تختلف الحقول التي يمكن تحديدها بواسطة المعلمات ...fields بناءً على نوع النتيجة. يسرد الجدول التالي الحقول التي تتوافق مع كل نوع نتيجة. لا تقبل أنواع النتائج غير المدرَجة معلَمات ...fields، بل تقبل fieldsObject فقط.

نوع النتيجة	...fields
pageview	page
event	eventCategory، eventAction، eventLabel، eventValue
social	socialNetwork، socialAction، socialTarget
timing	timingCategory، timingVar، timingValue، timingLabel

اطّلِع على مرجع الحقل للحصول على مستندات الحقول الفردية.

ملاحظة: نقترح عليك استدعاء طريقة send باستخدام قائمة أوامر ga. يمكنك الاطّلاع على مرجع طريقة الإرسال لمعرفة مزيد من التفاصيل.

المرتجعات

undefined

أمثلة

// Creates a default tracker.
ga('create', 'UA-XXXXX-Y', auto);

ga(function(tracker) {
  // Sends a pageview hit.
  tracker.send('pageview');
});

// Creates a default tracker.
ga('create', 'UA-XXXXX-Y', auto);

ga(function(tracker) {
  // Sends an event hit for the tracker named "myTracker" with the
  // following category, action, and label, and sets the nonInteraction
  // field value to true.
  tracker.send('event', 'link', 'click', 'http://example.com', {
    nonInteraction: true
  });
});