المقاييس والسمات المخصّصة مع gtag.js

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

لإرسال قيم المَعلمات المخصّصة إلى "إحصاءات Google"، عليك ربط المَعلمات بمَعلمات السمات أو المقاييس المخصّصة التالية في "إحصاءات Google":

المعلّمة المخصّصة	نوع البيانات	الوصف
`dimension<Index>`	`string`	مَعلمة السمة المخصّصة (مثل `dimension3`)
`metric<Index>`	`string`	معلمة المقياس المخصص (مثل `metric8`)

ضبط السمات المخصّصة وإرسالها

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

لإرسال سمة مخصّصة إلى "إحصاءات Google"، عليك تعديل سمة config لموقعك لضبط المَعلمة custom_map للسمة، ثم استخدام المَعلمة المخصّصة لإرسال قيمة السمة المخصّصة:

// Configures custom dimension<Index> to use the custom parameter
// 'dimension_name' for 'GA_MEASUREMENT_ID', where <Index> is a number
// representing the index of the custom dimension.
gtag('config', 'GA_MEASUREMENT_ID', {
  'custom_map': {'dimension<Index>': 'dimension_name'}
});

// Sends the custom dimension to Google Analytics.
gtag('event', 'any_event_name', {'dimension_name': dimension_value});

استبدِل 'GA_MEASUREMENT_ID' بمعرّف "إحصاءات Google" الخاص بك.

على سبيل المثال، سيُرسِل المقتطف التالي السمة المخصّصة dimension2 مع القيمة 55 إلى "إحصاءات Google":

// Maps 'dimension2' to 'age'.
gtag('config', 'GA_MEASUREMENT_ID', {
  'custom_map': {'dimension2': 'age'}
});

// Sends an event that passes 'age' as a parameter.
gtag('event', 'age_dimension', {'age': 55});

ضبط المقاييس المخصَّصة وإرسالها

لإرسال مقياس مخصّص إلى "إحصاءات Google"، عدِّل config لموقعك من أجل ضبط مَعلمة custom_map للمقياس، ثم استخدِم المَعلمة المخصّصة لإرسال قيمة المقياس المخصّص:

// Configures custom metric<Index> to use the custom parameter
// 'metric_name' for GA_MEASUREMENT_ID, where <Index> is a number
// representing the index of the custom metric.
gtag('config', 'GA_MEASUREMENT_ID', {
  'custom_map': {'metric<Index>': 'metric_name'}
});

// Sends the custom dimension to Google Analytics.
gtag('event', 'any_event_name', {'metric_name': metric_value});

استبدِل 'GA_MEASUREMENT_ID' بمعرّف "إحصاءات Google" الخاص بك.

على سبيل المثال، سيُرسِل المقتطف التالي المقياس المخصّص metric5 بالقيمة 1 إلى "إحصاءات Google":

// Maps 'metric5' to 'avg_page_load_time'.
gtag('config', 'GA_MEASUREMENT_ID', {
  'custom_map': {'metric5': 'avg_page_load_time'}
});

// Sends an event that passes 'avg_page_load_time' as a parameter.
gtag('event', 'load_time_metric', {'avg_page_load_time': 1});

ضبط السمات والمقاييس المخصَّصة وإرسالها

يمكنك تعديل config لموقعك لربط كل من السمات والمقاييس المخصّصة:

gtag('config', 'GA_MEASUREMENT_ID', {
   'custom_map': {
     'dimension2': 'age',
     'metric5': 'avg_page_load_time'
   }
});

gtag('event', 'foo', {'age': 55, 'avg_page_load_time': 1});