الأبعاد والمقاييس المخصصة

يوضِّح هذا الدليل كيفية إرسال المقاييس والسمات المخصّصة باستخدام analytics.js.

نظرة عامة

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

للحصول على نظرة عامة كاملة عن آلية عمل هذه الميزة، اقرأ مرجع ميزات المقاييس والسمات المخصّصة.

يمكنك إرسال بيانات السمات والمقاييس المخصّصة باستخدام إحدى القيمتَين التاليتَين أو كلتيهما:

اسم الحقل	نوع القيمة	مطلوبة	الوصف
البُعد[0-9]+	text	لا	فهرس السمات. لكل سمة مخصّصة فهرس مرتبط.هناك 20 سمة مخصّصة بحدٍ أقصى (200 سمة مخصّصة لحسابات "إحصاءات Google 360"). يجب أن تكون لاحقة الفهرس عددًا صحيحًا موجبًا أكبر من 0 (على سبيل المثال، السمة 3).
مقياس[0-9]+	عدد صحيح	لا	فهرس المقياس. لكل مقياس مخصّص فهرس مرتبط. هناك 20 مقياسًا مخصّصًا بحدٍ أقصى (200 مقياس لحسابات "إحصاءات Google 360"). يجب أن تكون لاحقة الفهرس عددًا صحيحًا موجبًا أكبر من 0 (على سبيل المثال المقياس 5).

التنفيذ

يجب أولاً إعداد سمة أو مقياس مخصّصَين من خلال واجهة إدارة "إحصاءات Google". بعد الضبط، سيتمّ تعيين فهرس فريد للسمة أو المقياس المخصّص يُحدِّد سمة أو مقياسًا مخصّصًا عن الآخر ويميّزه عن الآخر. ويمكنك بعد ذلك استخدام الفهرس في مكتبة analytics.js لإرسال البيانات لسمة مخصّصة أو مقياس مخصّص معيّن.

جارٍ إرسال البيانات

لا يمكن إرسال بيانات الأبعاد أو المقاييس المخصّصة إلا مع نتيجة حالية. على سبيل المثال، لإرسال سمة مخصّصة لنتيجة من النوع pageview مع الفهرس 15، ستستخدم:

ga('send', 'pageview', {
  'dimension15':  'My Custom Dimension'
});

لإرسال مقياس مخصّص لنتيجة من النوع event مع الفهرس 18، ستستخدم:

ga('send', 'event', 'category', 'action', {
  'metric18': 8000
});

إذا تم ضبط المقياس المخصّص لاستخدام نوع عملة، يمكنك إرسال قيم عشرية:

ga('send', 'event', 'category', 'action', {
  'metric19': 24.99
});

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

ga('set', 'dimension5', 'custom data');

من أجل set قيم لكلّ سمة ومقياس، يمكنك استخدام ما يلي:

ga('set', {
  'dimension5': 'custom dimension data',
  'metric5': 'custom metric data'
});

اقرأ قسم المقاييس والسمات المخصصة في مستند مرجع الحقل للتعرف على التنسيق المحدد لكيفية إرسال هذه البيانات.

مثال

من الأمثلة الرائعة على حالات استخدام السمات المخصّصة ما إذا كان لديك موقع إلكتروني يستند إلى المحتوى يضمّ العديد من المؤلفين. كمحلل، قد ترغب في فهم المؤلفين الذين لديهم المحتوى الأكثر شعبية. للإجابة عن هذا السؤال، يمكنك عرض تقرير يقارن بين مشاهدات الصفحة حسب المؤلف. على الرغم من أنّ بيانات المؤلف غير متاحة بشكلٍ تلقائي في "إحصاءات Google"، يمكنك إرسال هذه البيانات كسمة مخصّصة مع كل مشاهدة للصفحة.

تتمثّل الخطوة الأولى في الحل في ضبط سمة مخصّصة جديدة في واجهة الإدارة. يجب أن يكون الاسم author وسيكون النطاق من النوع hit. وبعد الضبط، سيتمّ تعيين فهرس للسمة المخصّصة الجديدة. في هذا المثال، لنفترض أنّ الفهرس هو 5.

الآن بعد أن تم إعداد السمة المخصّصة author وتعيين فهرس لها، يمكن استخدامها مع مكتبة analytics.js لإرسال بيانات المؤلف كسمة مخصّصة. على سبيل المثال، إذا كانت صفحتك مكتوبة بلغة PHP، من المرجّح أن يتم تخزين المؤلف الفعلي للصفحة باستخدام متغيّر PHP مثل $author. في نموذج PHP، يمكنك استخدام متغير المؤلف هذا لتمرير قيمة المؤلف إلى السمة المخصّصة:

ga('send', 'pageview', {
  'dimension5': '<?=$author?>'
});