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

يصف هذا المرجع الطرق المتاحة في الكائن 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
  });
});